[Libreoffice-bugs] [Bug 120200] [META] Update or correct help for features

[bugzilla-daemon at bugs.documentfoundation.org]

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

Ross Johnson <ross.johnson at homemail.com.au> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |ross.johnson at homemail.com.a
                   |                            |u

--- Comment #2 from Ross Johnson <ross.johnson at homemail.com.au> ---
Created attachment 175244
  --> https://bugs.documentfoundation.org/attachment.cgi?id=175244&action=edit
List of duplicate keys in the "hid2files.js" file

This seems like an appropriate place to record this for anyone working on Help
pages.

The attachment I've uploaded is the output of:

sed -n "s;^\('[^']*'\):'.*$;\1;p" hid2file.js | sort | uniq -dc

It shows only those keys that appear more than once in the file, with the
number of occurrences shown in the left-most column.

The "hid2files.js" file is a javascript array that uses strings as the keys. It
cannot have duplicate keys in it. The documentation on the .xhp source help
files also specifically notes that bookmark hid branch values must be unique.
So, for example, there can only be one <bookmark branch="hid/.uno:MergeCells"/>
throughout all of the .xhp files.

I'm guessing that it is the last duplicate of a key whose value results in the
page seen by users. It is the case in the two examples I've seen recently. 

There are 152 separate keys that appear more than once. There are at least this
many errant bookmarks in .xhp files and possibly that many help pages that have
fallen into the cracks and never seen.

The affected pages need to be consolidated together into single .xhp files
using the <switch> element to select the content that is displayed for a given
module.

-- 
You are receiving this mail because:
You are the assignee for the bug.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.freedesktop.org/archives/libreoffice-bugs/attachments/20210924/bd44bc45/attachment.htm>