https://bugs.documentfoundation.org/show_bug.cgi?id=147004

--- Comment #15 from [email protected] ---
(In reply to Heiko Tietze from comment #14)
> the feature works well. => NAB
Not trying to report a bug necessarily. More like seeking an informed
consensus/agreement about preferred/expected behavior. Then I can finish
adjusting the labels in the relevant dialogs and try to document the behavior
clearly in the tooltip and online help.  

There are two choices, as I understand the situation.

1. This ticket started because the original extended tip seemed to indicate
that the level spinbox was to specify exactly the "outline level" of heading to
be displayed.

2. Empirical investigation (bug 153560 comment 10 summarises my understanding)
led to the discovery that "up to level" better describes the behavior of the
spinbox, where the "rule" is:

   Regardless of format, select the first previous heading that has an 
   outline level equal or less than the value specified in spinbox.

I do not have an opinion about the preferred functionality (i.e., "outline
level" or "up to level").  But whichever is chosen has consequences for how to
label the "level" option in the field dialog (along with its tooltip and help
page). 

Also, I believe the (≤) "rule" is more general than this Document field
variable, applying also to the "level" spinbox/combobox when heading numbers
are added to caption numbers and index entries.

> My take: keep the functionality as it is and rename Chapter to Heading and 
> Chapter* to Heading*.
I think this part is done already (bug 153560). Try a recent master build.

If the current functionality is left unchanged, then I believe "Up to level"
operates according to the rule:

   Regardless of format, select the first previous heading that has an 
   outline level equal or less than the value specified in spinbox.

(bug 153560, comment 12 reports an attempt to confirm via source, but would be
nice with independent confirmation).  

Note also that some "surprises" can arise with an "up to level" option (bug
153710 and attachment 185594 in bug 153560, comment 11).

The first alternative (which is also what the original extended tip seemed to
indicate) is to label the spinbox "Outline Level" and then only match the first
heading that has the outline level specified in the spinbox. Probably easier
for users to understand (and easier to document), but either way is fine with
me. (If the analysis in bug 153560, comment 12 is correct, then it would be
trivial to change.)

Dieter gave an opinion in comment 8, but I am not sure if it corresponds to
either of these two choices.

-- 
You are receiving this mail because:
You are the assignee for the bug.

Reply via email to