Seems there is a totally wrong description for numbering with number ranges and numbering by chapter. Don't know how to search this in LO-Help, so here is a direct link: https://help.libreoffice.org/7.4/en-US/text/swriter/01/04090005.html?System=UNIX&DbPAR=WRITER&HID=modules/swriter/ui/fldvarpage/FieldVarPage#bm_@@nowidget@@ Numbering by Chapter Sets the options for resetting chapter numbers. → Wrong! There won't be reset any chapter numbers. It will read the current chapter number up to this level. So if there is a chapter number 2.3 and the level is set to '2' it will set 2.3.1 (Chapterlevel1.Chapterlevel2.NumberRange) The level will show the first two chapters. It could also be set to '10' with the same result if numbering is following to chapter 2.3 Level Choose the heading or chapter level at which to restart numbering in the document. → Wrong! NumberRange will start after every new chapter number. Has nothing to do with the level. The level defines up to which level the chapter numbering should be leading numbers of the NumberRange. Separator Type the character that you want to use as a separator between the heading or chapter levels. → Wrong or misleading: if separator here is ',' and separator in chapter numbering is '.', it will show in the example above: 2.3,1 The separator is the separator between the chapter number and the NumberRange.
The Help page must be revisited.
(In reply to Robert Großkopf from comment #0) > Level > The level defines up to which level the chapter > numbering should be leading numbers of the NumberRange. 1. To be sure I understand the meaning of "up to which level", how would this rule apply to the following case? 1 Outline level 1 paragraph 1.1 Outline level 2 1.1.1 Outline level 3 1.1.2 Outline level 3 1.2 Outline level 2 [number range variable here] level = 3 What chapter number is shown and why? 2. Maybe the "Level" label in the field dialog should be "Up to level"?
One more case, probably pathological, but again with an interest to understand the meaning of "up to level". 1.2 Here is an outline level 2 heading 1.2.1.1.1.1 Here is heading with outline level 6 [number range variable here] with level = 3 What chapter number is shown and why?
(In reply to sdc.blanco from comment #2) > (In reply to Robert Großkopf from comment #0) > > Level > > The level defines up to which level the chapter > > numbering should be leading numbers of the NumberRange. > 1. To be sure I understand the meaning of "up to which level", > how would this rule apply to the following case? > > 1 Outline level 1 paragraph > 1.1 Outline level 2 > 1.1.1 Outline level 3 > 1.1.2 Outline level 3 > 1.2 Outline level 2 > > [number range variable here] level = 3 Will change this to level = 2 to see, what could happen: > > What chapter number is shown and why? 1 Outline level 1 paragraph 1.1 Outline level 2 1.1.1 Outline level 3 1.1.2 Outline level 3 1.1.1 New number with number range set to level 2 1.1.2 Next number with level 2 1.2 Outline level 2 1.2.1 New number with number range set to level 2 There will be read at maximum the first 2 levels. The numbering will start new in every level. So it will add '1' to the levels up to level 2. Will show wrong numbering for chapters in level 3, if there will be chapters with chapter numbering and with number range are mixed. > > 2. Maybe the "Level" label in the field dialog should be "Up to level"? Yes, this will be the right changing. > 1.2 Here is an outline level 2 heading > 1.2.1.1.1.1 Here is heading with outline level 6 > [number range variable here] with level = 3 1.2 Here is an outline level 2 heading 1.2.1 New number with number range set to level 3 1.2.1.1.1.1 Here is heading with outline level 6 1.2.1.1 New number with number range set to level 3 It will get a little bit confusing, because it will only read up to first 3 numbers and add a special numbering …
Thanks for your helpful reply Robert. I believe the actual behavior of the “level” control is complicated (see for example, bug 153560, comment 10). I believe the specified level determines which heading paragraph to select for display, according to the rule of “match the first prior heading with outline level ≤ selected value”. Using this rule to answer my question in comment 2: “1.2” is displayed, because outline level 2 is less than outline level 3. Similarly for comment 3: “1.2” is displayed, because outline level 2 is less than outline level 3, while outline level 6 is greater (and therefore not matched) In relation to "help" maybe it is better (or "ok") to give a description that is accurate in relation to presupposed typical use (e.g., where headings have an outline level that is -1, 0, +1 in relation to the headings that appear before and after them), without bringing up the complications (such as illustrated in comment 3). My current hypothesis for the help page entry is: --------------------- Up to level Choose how many levels of the immediately prior heading number to show (starting from level 1). For example, if a heading has 4 levels of numbering, such as 3.2.7.4, and “2” is selected, then “3.2” is displayed before the field number. The selected value indicates the maximum number of levels to show. The actual number may have fewer levels. For example, if the immediately prior heading number is “2.6.3”, then this number is shown when “3” or greater is selected. If “None” is selected, then no heading number is displayed. -------------------- This description handles the typical case in comment 2, but not the pathological case in comment 3. Happy to hear your comments.
I'm not so firm in English, but I would prefer to set "Choose how many levels of the immediately prior heading number should be displayed at most" instead of "Choose how many levels of the immediately prior heading number to show"
Thanks for further feedback. It is challenging to find the right words (in any language). After further analysis -- maybe it is not so hard to explain the actual behavior clearly, fully and accurately. -------------------- UI for dialog: -------------------- With Heading Number Up to level [ ] Separator [ ] ------------------ Tooltip for "Up to level" spinbox: Choose heading number to prepend to displayed field, where the number comes from the first prior heading whose outline level is equal to or less than the selected outline level. If “None” is selected, no heading number is displayed. --------------------- (This text could also be used on the help page and extended tip, with an example like: For example, select "2" to display the heading number for the first prior heading that has outline level 2 or less. (These descriptions also handle both "challenges" in comment 2 and comment 3.) It is a "different" way to think about the function of this option, but maybe just as functional (or more so), once you get used to it? Comments welcome....
Seth Chaiklin committed a patch related to this issue. It has been pushed to "master": https://git.libreoffice.org/help/commit/4dd6c878412fd650ab8db543ca45006b101933ca tdf#153243;tdf#152873 update labels; corrections to "Heading Numbering" section
The updated help page will appear at: https://help.libreoffice.org/7.6/en-US/text/swriter/01/04090005.html?System=UNIX&DbPAR=WRITER It often takes a few days before the patch appears in the online help (i.e., it is not visible yet). I will close this ticket as FIXED, but if you think small adjustments are needed in the updated version, then you are welcome to write to this ticket, rather than start a new one. Thanks for your interaction/feedback.
The revised help is online now https://help.libreoffice.org/7.6/en-US/text/swriter/01/04090005.html?System=UNIX&DbPAR=WRITER, where "Numbering by Chapter" is now "With Heading Number" (as seen in this help file). If you think there are still problems, then you are welcome to write here.