tdf#156273 tdf#155882 update Navigate By documentation

- update since changes in:
- 7.0: from icon that opens a toolbar, to listbox
- 7.1: commands hidden by default in Find toolbar
- 7.2: Recency added to Navigate By
- hyperlink relevant pages and embed sections
- correct command labels
- add bookmarks
- related tdf#156332: remove space breaking HID linking
- paragraphs for categories that need explanations
- remove obsolete <ahelp> and bookmarks

Remaining doubts:
- how "Wrong table formula" works (broken?)

Change-Id: I1de013be320d31396076f4ccec991a52a14e1db5
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/166096
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
Tested-by: Jenkins

2 files changed, 56 insertions, 63 deletions

diff --git a/source/text/swriter/01/02110000.xhp b/source/text/swriter/01/02110000.xhp
index 803bd84d4f..0f24de8c07 100644
--- a/source/text/swriter/01/02110000.xhp
+++ b/source/text/swriter/01/02110000.xhp
@@ -48,7 +48,7 @@
 <paragraph id="par_id3149490" role="paragraph">Click the expander icon (+) next to a category in the Navigator to view the items in the category. Click on an expanded category to collapse it.</paragraph>
 <paragraph role="paragraph" id="par_id611683893638800">To view the number of items in a category, rest your mouse pointer over the category in the Navigator.</paragraph>
 <paragraph role="paragraph" id="par_id941683893643631">To jump to an item in the document, double-click the item in the Navigator.</paragraph>
-<paragraph id="par_id3149106" role="paragraph">To jump to the next or previous item in a document, use the <emph>Navigate by</emph> box to select the item category, and then click the up or down arrows.</paragraph>
+<paragraph id="par_id3149106" role="paragraph">To jump to the next or previous item in a document, use the <link href="text/swriter/01/02110100.xhp"><emph>Navigate By</emph></link> list to select the item category, and then click the <emph>Previous</emph> or <emph>Next</emph> arrows.</paragraph>
 
 <paragraph role="paragraph" id="par_id571655653825780">The navigator shows the correspondence between the current document cursor location element and the navigator view, according to different categories: Headings, Tables, Hyperlinks and more. The element is displayed and highlighted in the Navigator content view. If the element is located in a collapsed layer, the required layers above it are automatically expanded and remain expanded afterwards.</paragraph>
 
@@ -64,6 +64,7 @@
 <section id="navigateby">
   <h2 id="hd_id321603114930016">Navigate By</h2>
 <paragraph role="paragraph" id="par_id171603114951991">Use selection box to choose which type of item should be navigated, when using the Previous and Next buttons.</paragraph>
+  <section id="navigateby_arrows">
 <h2 id="hd_id3150096">Previous</h2>
 <paragraph id="par_id3148784" role="paragraph">Jumps to the previous item in the document. To specify the type of item to jump to, click the <emph>Navigate By</emph> list, and then click an item category - for example, "Images".</paragraph>
 <table id="tbl_id3150044">
@@ -89,11 +90,14 @@
     </tablecell>
   </tablerow>
 </table>
+    </section>
 </section>
 
 <bookmark branch="hid/modules/swriter/ui/navigatorpanel/numericfield" id="bm_id3148726" localize="false"/>
+  <section id="navigateby_pages">
 <h2 id="hd_id3148715">Page number</h2>
 <paragraph id="par_id3155548" role="paragraph"><ahelp hid="modules/swriter/ui/navigatorpanel/numericfield">Type the number of the page that you want to jump to, and then press Enter. Use the spin buttons to navigate.</ahelp></paragraph>
+  </section>
 
 <h2 id="hd_id3146891">Content Navigation View</h2>
 <paragraph id="par_id3145596" role="paragraph"><ahelp hid="modules/swriter/ui/navigatorpanel/root">Switches between the display of all categories in the Navigator and the selected category.</ahelp></paragraph>
@@ -175,7 +179,7 @@
 <bookmark branch="hid/modules/swriter/ui/navigatorpanel/reminder" id="bm_id3155392" localize="false"/>
 
 <h2 id="hd_id3155381">Set Reminder</h2>
-<paragraph id="par_id3153011" role="paragraph"><ahelp hid="." visibility="hidden">Click here to set a reminder at the current cursor position. You can define up to five reminders. To jump to a reminder, click the <link href="text/swriter/01/02110100.xhp"><emph>Navigation</emph></link> icon, in the <emph>Navigation</emph> window click the <emph>Reminder</emph> icon, and then click the <emph>Previous</emph> or <emph>Next</emph> button.</ahelp> Click here to set a reminder at the current cursor position. You can define up to five reminders. To jump to a reminder, click the <link href="text/swriter/01/02110100.xhp">Navigation</link> icon, in the Navigation window click the Reminder icon, and then click the Previous or Next button.</paragraph>
+<paragraph id="par_id3153011" role="paragraph"><ahelp hid="." visibility="hidden">Click here to set a reminder at the current cursor position. You can define up to five reminders. To jump to a reminder, click the <link href="text/swriter/01/02110100.xhp"><emph>Navigation</emph></link> icon, in the <emph>Navigation</emph> window click the <emph>Reminder</emph> icon, and then click the <emph>Previous</emph> or <emph>Next</emph> button.</ahelp> Click here to set a reminder at the current cursor position. You can define up to five reminders. To jump to a reminder, click the <link href="text/swriter/01/02110100.xhp">Navigate By</link> list, select <menuitem>Reminder</menuitem>, and then click <emph>Previous</emph> or <emph>Next</emph>.</paragraph>
 
 <table id="tbl_id3154577">
   <tablerow>
@@ -187,7 +191,9 @@
     </tablecell>
   </tablerow>
 </table>
+  <section id="reminders_note">
 <note id="par_id3495381">Reminders are navigated in the order in which they are set. Reminders are not saved when a document is closed.</note>
+  </section>
 
 <bookmark branch="hid/modules/swriter/ui/navigatorpanel/headings" id="bm_id3150519" localize="false"/>
 <bookmark branch="hid/SW_HID_NAV_OUTLINE_LEVEL" id="bm_id3156965" localize="false"/>
diff --git a/source/text/swriter/01/02110100.xhp b/source/text/swriter/01/02110100.xhp
index 889dc2c45b..573dd2a298 100644
--- a/source/text/swriter/01/02110100.xhp
+++ b/source/text/swriter/01/02110100.xhp
@@ -33,66 +33,53 @@
 </meta>
 <body>
 <bookmark branch="hid/SW_HID_SCRL_NAVI" id="bm_id3149832" localize="false"/>
-<bookmark branch="hid/ .uno:AvailableToolbars?Toolbar:string=navigationobjectbar" id="bm_id731690546250138" localize="false"/>
-<h1 id="hd_id3147745">Navigation</h1>
-<paragraph role="paragraph" id="par_id3149844" xml-lang="en-US"><ahelp hid="HID_SCRL_NAVI">If you click this icon in the Navigator or in the lower right of the document window, a toolbar will appear which enables you to choose among the existing targets within a document.</ahelp> You can then use the up and down arrow icons to position the text cursor in the document on the previous or next target.</paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_SCRL_PAGEUP" id="bm_id3153304" localize="false"/>
-<paragraph role="paragraph" id="par_id3153293" xml-lang="en-US"><ahelp hid="HID_SCRL_PAGEUP">Click the up button to scroll to the previous page or object.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_SCRL_PAGEDOWN" id="bm_id3156109" localize="false"/>
-<paragraph role="paragraph" id="par_id3156098" xml-lang="en-US"><ahelp hid="HID_SCRL_PAGEDOWN">Click the down button to scroll to the next page or object.</ahelp></paragraph>
-<paragraph role="paragraph" id="par_id3155076" xml-lang="en-US">By default, as long as you have not selected any other entry, the arrow buttons jump to the previous or the next page in the document. The arrow buttons are black if you are browsing through pages and blue if you jump to other objects.</paragraph>
-<paragraph role="paragraph" id="par_id3154330" xml-lang="en-US">The entries largely correspond to those in the <link href="text/swriter/01/02110000.xhp">Navigator</link> selection box. You can also select other jump destinations. An example are the reminders, which you can set with the <emph>Set Reminder</emph> icon in the Navigator. You can select an object from among the following options on the <emph>Navigation</emph> toolbar: table, frame, graphics, OLE object, page, headings, reminder, drawing object, control field, section, bookmark, selection, footnote, note, index entry, table formula, wrong table formula.</paragraph>
-<paragraph role="paragraph" id="par_id3148330" xml-lang="en-US">Reminders are navigated in the order in which they are set.</paragraph>
-<paragraph role="paragraph" id="par_id3148783" xml-lang="en-US">For table formulas, you can either jump to all table formulas located within your document or only to the incorrect ones. For incorrect formulas, you jump only to formulas that have resulted in errors. The program skips over formulas with resulting errors (those that reference incorrect formulas).</paragraph>
-<h2 id="hd_id3150031">Working With the Navigation Toolbar</h2>
-<paragraph role="paragraph" id="par_id3150045" xml-lang="en-US">Open the <emph>Navigation</emph> toolbar by clicking on its top left icon located on the top of the Navigator display area. You can break the toolbar away from its place by dragging and arranging it on the screen.</paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NAVI_VS" id="bm_id3154622" localize="false"/>
-<paragraph role="paragraph" id="par_id3153141" xml-lang="en-US"><ahelp hid="HID_NAVI_VS">Click the icon for the type of objects you want to browse through. Then click one of the "Previous Object" or "Next Object" arrow buttons. The names of these buttons indicate the type of object you have selected. The text cursor is placed on whichever object you have selected.</ahelp></paragraph>
-<paragraph role="tip" id="par_id3149968" xml-lang="en-US">You can configure $[officename] according to your specific preferences for navigating within a document. To do this, choose <link href="text/shared/01/06140000.xhp"><emph>Tools - Customize</emph></link>. The various tables for adapting <link href="text/shared/01/06140100.xhp">menus</link>, <link href="text/shared/01/06140200.xhp">keyboard input</link> or toolbars contain various functions for navigation within the document under the "Navigate" area. In this way you can jump to the index tags in the document with the "To Next/Previous Index Tag" functions.</paragraph>
-<bookmark xml-lang="en-US" branch="index" id="bm_id3155338"><bookmark_value>searching; repeating a search</bookmark_value>
-</bookmark>
-<h2 id="hd_id3155338">Repeat Search</h2>
-<paragraph role="paragraph" id="par_id3155361" xml-lang="en-US">With the <emph>Repeat search</emph> icon on the <emph>Navigation</emph> toolbar you can repeat a search you started with the <emph>Search and Replace</emph> dialog. To do this, click the icon. The blue arrow buttons on the vertical scrollbar now take on the functions <emph>Continue search forwards</emph> and <emph>Continue search backwards</emph>. If you now click one of the arrow surfaces, the search will be continued for the term entered in the Search and Replace dialog.</paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_BKM" id="bm_id2258064" localize="false"/>
-<paragraph role="paragraph" id="par_idN106DD" xml-lang="en-US"><ahelp hid="." visibility="hidden">Select this icon to browse through bookmarks.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_CTRL" id="bm_id9021576" localize="false"/>
-<paragraph role="paragraph" id="par_idN106F4" xml-lang="en-US"><ahelp hid="." visibility="hidden">Select this icon to browse through control fields.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_DRW" id="bm_id4192327" localize="false"/>
-<paragraph role="paragraph" id="par_idN1070B" xml-lang="en-US"><ahelp hid="." visibility="hidden">Select this icon to browse through drawing objects.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_FRM" id="bm_id8498794" localize="false"/>
-<paragraph role="paragraph" id="par_idN10722" xml-lang="en-US"><ahelp hid="." visibility="hidden">Select this icon to browse through frames.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_FTN" id="bm_id66835" localize="false"/>
-<paragraph role="paragraph" id="par_idN10739" xml-lang="en-US"><ahelp hid="." visibility="hidden">Select this icon to browse through footnotes.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_GRF" id="bm_id7068697" localize="false"/>
-<paragraph role="paragraph" id="par_idN10750" xml-lang="en-US"><ahelp hid="." visibility="hidden">Select this icon to browse through graphics.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_INDEX_ENTRY" id="bm_id9798577.00000001" localize="false"/>
-<paragraph role="paragraph" id="par_idN10767" xml-lang="en-US"><ahelp hid="." visibility="hidden">Select this icon to browse through index entries.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_MARK" id="bm_id9345988" localize="false"/>
-<paragraph role="paragraph" id="par_idN1077E" xml-lang="en-US"><ahelp hid="." visibility="hidden">Select this icon to browse through reminders.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_NEXT" id="bm_id3960692" localize="false"/>
-<paragraph role="paragraph" id="par_idN10795" xml-lang="en-US"><ahelp hid="." visibility="hidden">Sets the cursor to the next object of the selected type.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_OLE" id="bm_id5234534" localize="false"/>
-<paragraph role="paragraph" id="par_idN107AF" xml-lang="en-US"><ahelp hid="." visibility="hidden">Select this icon to browse through OLE objects.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_OUTL" id="bm_id1883602" localize="false"/>
-<paragraph role="paragraph" id="par_idN107C6" xml-lang="en-US"><ahelp hid="." visibility="hidden">Select this icon to browse through headings.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_PGE" id="bm_id6152836" localize="false"/>
-<paragraph role="paragraph" id="par_idN107DD" xml-lang="en-US"><ahelp hid="." visibility="hidden">Select this icon to browse through pages.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_POSTIT" id="bm_id5230567" localize="false"/>
-<paragraph role="paragraph" id="par_idN107F4" xml-lang="en-US"><ahelp hid="." visibility="hidden">Select this icon to browse through comments.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_PREV" id="bm_id1692556" localize="false"/>
-<paragraph role="paragraph" id="par_idN1080B" xml-lang="en-US"><ahelp hid="." visibility="hidden">Sets the cursor to the previous object of the selected type.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_REG" id="bm_id9508651" localize="false"/>
-<paragraph role="paragraph" id="par_idN10829" xml-lang="en-US"><ahelp hid="." visibility="hidden">Select this icon to browse through sections.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_SEL" id="bm_id7225257" localize="false"/>
-<paragraph role="paragraph" id="par_idN10840" xml-lang="en-US"><ahelp hid="." visibility="hidden">Select this icon to browse through selections.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_SRCH_REP" id="bm_id1448408" localize="false"/>
-<paragraph role="paragraph" id="par_idN10857" xml-lang="en-US"><ahelp hid="." visibility="hidden">Select this icon to browse through search results.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_TABLE_FORMULA" id="bm_id7630237" localize="false"/>
-<paragraph role="paragraph" id="par_idN1086E" xml-lang="en-US"><ahelp hid="." visibility="hidden">Select this icon to browse through table formulas.</ahelp></paragraph>
-<!-- removed HID HID_NID_FORMULA_ERROR -->
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_TABLE_FORMULA_ERROR" id="bm_id8653523" localize="false"/>
-<paragraph role="paragraph" id="par_idN10885" xml-lang="en-US"><ahelp hid="." visibility="hidden">Select this icon to browse through wrong table formulas.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_TBL" id="bm_id4498428" localize="false"/>
-<paragraph role="paragraph" id="par_idN1089C" xml-lang="en-US"><ahelp hid="." visibility="hidden">Select this icon to browse through tables.</ahelp></paragraph>
+<bookmark branch="hid/.uno:AvailableToolbars?Toolbar:string=navigationobjectbar" id="bm_id731690546250138" localize="false"/>
+<bookmark branch="hid/modules/swriter/ui/navigatorpanel/.uno:NavElement" id="bm_id321713404357993" localize="false"/>
+<h1 id="hd_id3147745">Navigate By</h1>
+
+  <paragraph role="paragraph" id="par_id3149844"><ahelp hid="HID_SCRL_NAVI">The <emph>Navigate By</emph> selection box allows choosing a category to navigate the document by, including pages, headings, sections, objects, fields, comments, latest search results and recency of cursor position.</ahelp> You can then use the <emph>Previous</emph> and <emph>Next</emph> arrow icons to position the text cursor in the document on the previous or next target.</paragraph>
+  
+  <section id="howtoget">
+    <embed href="text/swriter/01/02110000.xhp#howtoget"/>
+  </section>
+
+  <h2 id="hd_id3150031">Working With Navigate By</h2>
+  <paragraph role="paragraph" id="par_id3155076">By default, as long as you have not selected any other category, the Page category is selected, and the arrows are replaced by a number field that can be used to go to the previous or the next page, or jump to a specific one.</paragraph>
+  <bookmark xml-lang="en-US" branch="hid/SW_HID_NAVI_VS" id="bm_id3154622" localize="false"/>
+  <paragraph role="paragraph" id="par_id3153141" xml-lang="en-US"><ahelp hid="HID_NAVI_VS">Once you select another category, you can use the "Previous" or "Next" arrow buttons. The labels of these buttons indicate the type of object you have selected. The text cursor is then placed on whichever object you have selected.</ahelp></paragraph>
+  
+  <bookmark xml-lang="en-US" branch="hid/SW_HID_SCRL_PAGEUP" id="bm_id3153304" localize="false"/>
+  <bookmark xml-lang="en-US" branch="hid/SW_HID_SCRL_PAGEDOWN" id="bm_id3156109" localize="false"/>
+  <bookmark  branch="hid/modules/swriter/ui/navigatorpanel/gotopage" id="bm_id641713404959460" localize="false"/>
+  <embed href="text/swriter/01/02110000.xhp#navigateby_pages"/>
+  <bookmark  branch="hid/modules/swriter/ui/navigatorpanel/.uno:ScrollToPrevious" id="bm_id331713404689417" localize="false"/>
+  <bookmark  branch="hid/modules/swriter/ui/navigatorpanel/.uno:ScrollToNext" id="bm_id311713404734071" localize="false"/>
+  <embed href="text/swriter/01/02110000.xhp#navigateby_arrows"/>
+  
+  <tip id="par_id3149968">You can configure $[officename] according to your specific preferences for navigating within a document. To do this, choose <link href="text/shared/01/06140000.xhp"><emph>Tools - Customize</emph></link>. The various tables for adapting <link href="text/shared/01/06140100.xhp">menus</link>, <link href="text/shared/01/06140200.xhp">keyboard input</link> or toolbars contain various functions for navigation within the document under the "Navigate" category. For example, you can add buttons to a toolbar to jump to the index tags in the document with the "Go to Next/Previous Index Entry" commands.</tip>
+  <paragraph role="paragraph" id="par_id3154330">The available categories largely correspond to those in the <link href="text/swriter/01/02110000.xhp">Navigator</link> selection box. However, you can select other jump destinations that are not classic Navigator categories: for example, Reminders, Repeat Search or Recency.</paragraph>
+  <paragraph role="paragraph" id="par_id561713406417133">Select from one of the following options: Bookmarks, Comments, Controls, Drawing objects, Fields by type, Fields, Footnotes, Frames, Headings, Images, Indexes, OLE objects, Page, Recency, Reminder, Repeat search, Sections, Selection, Table formula, Tables, Wrong table formula.</paragraph>
+  
+  <h2 id="hd_id1001713405229169">Footnotes</h2>
+  <paragraph role="paragraph" id="par_id541713405238672">Select the <emph>Footnotes</emph> category to jump between footnotes and endnotes. This can be used in conjunction with the <emph>Anchor ↔ Text</emph> button in the Navigator, to quickly jump between the text of the footnote/endnote and its anchor in the body.</paragraph>
+  
+  <h2 id="hd_id801713406561353">Recency</h2>
+  <paragraph role="paragraph" id="par_id141713406574059">When selecting the <emph>Recency</emph> category, the <emph>Go back</emph> and <emph>Go forward</emph> buttons can be used to jump to recent cursor positions in the document.</paragraph>
+  
+  <h2 id="hd_id701713405928808">Reminders</h2>
+  <paragraph role="paragraph" id="par_id871713405938067">Up to 5 <emph>Reminders</emph> (which are not saved when the document is closed) can be set at various locations in the document. Set a reminder with the <emph>Set Reminders</emph> button in the Navigator.</paragraph>
+  <embed href="text/swriter/01/02110000.xhp#reminders_note"/>
+  
+  <bookmark xml-lang="en-US" branch="index" id="bm_id3155338"><bookmark_value>searching; repeating a search</bookmark_value>
+  </bookmark>
+  <h2 id="hd_id3155338">Repeat Search</h2>
+  <paragraph role="paragraph" id="par_id3155361">With the <menuitem>Repeat search</menuitem> category, you can repeat a search you started with the <emph>Search and Replace</emph> dialog or the <emph>Find</emph> toolbar. If you now click one of the arrows, the search will be resumed for the term last searched.</paragraph>
+  
+  <h2 id="hd_id761713525529070">Selection</h2>
+  <paragraph role="paragraph" id="par_id961713525563573">If a multiple selection is active (for example when using <keycode>Ctrl + click and drag</keycode> or the Adding <link href="text/shared/02/20050000.xhp">selection mode</link>, or after a Find All search), <emph>Selection</emph> allows jumping from one to the other.</paragraph>
+  
+  <h2 id="hd_id731713403460395">Table Formulas</h2>
+  <paragraph role="paragraph" id="par_id3148783">For table formulas, you can either jump to all table formulas located within your document with <emph>Table formula</emph> or only to the incorrect ones with <emph>Wrong table formula</emph>. For incorrect formulas, you jump only to formulas that have resulted in errors. The program skips over formulas with resulting errors (those that reference incorrect formulas).</paragraph>
+
 </body>
 </helpdocument>