Bug 154717 - Drop one note and revise the other in the "Refer using" section of Cross-references
Summary: Drop one note and revise the other in the "Refer using" section of Cross-refe...
Status: RESOLVED FIXED
Alias: None
Product: LibreOffice
Classification: Unclassified
Component: Documentation (show other bugs)
Version:
(earliest affected)
7.2.7.2 release
Hardware: All All
: medium normal
Assignee: sdc.blanco
URL:
Whiteboard: target:7.6.0
Keywords:
Depends on:
Blocks:
 
Reported: 2023-04-08 15:02 UTC by sdc.blanco
Modified: 2023-04-28 07:47 UTC (History)
1 user (show)

See Also:
Crash report or crash signature:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description sdc.blanco 2023-04-08 15:02:51 UTC
In Feb 2008, "Headings" and "Numbered Paragraphs" were added as types to the "Cross-references" help page [1], along with the formats "Number", "Number (no context)", and "Number (full context)".

https://opengrok.libreoffice.org/xref/help/source/text/swriter/01/04090002.xhp?r=2f5820d7

At the same time two paragraphs, which later became "notes" appear under the "Refer using" table.

Proposed changes.

1.  Drop the first note.

It repeats more or less what appears in the "Refer using" table for "Number".
It looks like original committer copied the first note into table and forgot to delete the paragraph (that is the first note).  If that note is deleted, then it would make more sense to refer to the (second) "note" under the table.

2. The second note needs improvement. For example:
a.  "sublevels" refers to a setting in Tools - Heading Numbering. This should be specified explicitly
b. note should make it clear that it is about "Number", Number (no context) and Number (full context), and Chapter formats. 
c. Maybe do not need the example with 1.2.5.  Can say more directly and generally, "the number of sublevels shown depends on the "show sublevels" setting in Tools - Heading Numbering."

3.  In the "Selection" section, delete:  In the <emph>Refer using</emph> list, click the format that you want to use.

- because it repeats the same information that appears in the paragraph immediately before and the paragraph immediately after.

[1] https://help.libreoffice.org/7.6/en-US/text/swriter/01/04090002.html
Comment 1 Commit Notification 2023-04-27 08:13:41 UTC
Seth Chaiklin committed a patch related to this issue.
It has been pushed to "master":

https://git.libreoffice.org/help/commit/a53384ca39c4423a4562583373eaaabc20e6763e

tdf#154717  improve notes about number format; simplify "refer to"