Hello Peter

Em 26/04/2016 06:01, ptoye escreveu:
> Thanks Olivier.
> I can't see from this where the problem happened (I don't know Opengrok at
> all - never heard of it before your post - more thanks).
> The files on Opengrok have the same content as the files I downloaded. But
> the help text from F1 in LO is different (and a bit better), so it looks as
> if somehow the distributed text has been cleaned up but not put onto the
> repository.

The reporsitory in opengrok has the latest changes (we call it master)
and will be the help content of LibreOffice 5.2 later this year. When
you pulled the help content with git, you downloaded the same content as
displayed in opengrok.

The distributed text is from release 5.1 or lower, which means that you
see differences between releases. If the forthcomming release 5.2 is
worse than the distributed release, we did it wrong.

If you want to check the latest content, you can download and install
the nightly builds of LibreOffice.

http://vm173.documentfoundation.org has the help content XHP file
directly rendered in the browser. Just append the path/file of the XHP
file in the url to get it displayed, e.g. to display


navigate to


> Details (if it helps):
> Under "User options - Hide menu bar" the text from the repository is "Select
> to hide...". From the help text it's "Select this option to hide..." and in
> many other places as well.
> I noticed this by chance.

I searched the text you mention and found this:

git grep Select\ to\ hide

shared/01/ref_pdf_export.xhp: <paragraph xml-lang="en-US"
id="par_id6582537" role="paragraph" l10n="NEW"><ahelp hid=".">Select to
hide the reader's menu bar when the document is active.</ahelp></paragraph>

shared/01/ref_pdf_export.xhp: <paragraph xml-lang="en-US"
id="par_id769066" role="paragraph" l10n="NEW"><ahelp hid=".">Select to
hide the reader's toolbar when the document is active.</ahelp></paragraph>

shared/01/ref_pdf_export.xhp: <paragraph xml-lang="en-US"
id="par_id43641" role="paragraph" l10n="NEW"><ahelp hid=".">Select to
hide the reader's controls when the document is active.</ahelp></paragraph>

tdf@olivier-ntbk:~/git/core/helpcontent2/source/text$ git grep Select\
this\ option

scalc/01/05070500.xhp:<paragraph role="paragraph" id="par_id3155378"
xml-lang="en-US" l10n="U" oldref="28"><ahelp
hid="modules/scalc/ui/sheetprintpage/checkBTN_PAGENO">Select this option
if you want the first page to start with a number other than

scalc/01/12090105.xhp:<paragraph role="paragraph" id="par_id3149581"
xml-lang="en-US" l10n="U" oldref="9"><ahelp
hid="modules/scalc/ui/pivotfielddialog/user">Select this option, and
then click the type of subtotal that you want to calculate in the

shared/01/05030100.xhp: <paragraph xml-lang="en-US" id="par_id3147494"
role="paragraph" l10n="U" oldref="40">Select this option and then enter
a percentage value in the box, where 100% corresponds to single line

shared/01/05030600.xhp: <paragraph xml-lang="en-US" id="par_id3153741"
role="paragraph" l10n="U" oldref="28"><ahelp
hid="cui/ui/backgroundpage/positionrb">Select this option, and then
click a location in the position grid.</ahelp></paragraph>

shared/01/05210700.xhp:<paragraph role="paragraph" id="par_id3150693"
xml-lang="en-US" l10n="U" oldref="7"><ahelp
hid="cui/ui/transparencytabpage/RBT_TRANS_LINEAR">Turns on color
transparency. Select this option, and then enter a number in the box,
where 0% is fully opaque and 100% is fully transparent.</ahelp></paragraph>

shared/01/05210700.xhp:<paragraph role="paragraph" id="par_id3155338"
xml-lang="en-US" l10n="U" oldref="12"><ahelp
hid="cui/ui/transparencytabpage/RBT_TRANS_GRADIENT">Applies a
transparency gradient to the current fill color. Select this option, and
then set the gradient properties.</ahelp></paragraph>

shared/01/06050500.xhp: <paragraph xml-lang="en-US" id="par_id3145085"
role="paragraph" l10n="U" oldref="77">Adds a bullet to the beginning of
a line. Select this option, and then click the <emph>Character</emph>
button to choose a bullet style.</paragraph>

shared/01/06050500.xhp: <paragraph xml-lang="en-US" id="par_id3157817"
role="paragraph" l10n="U" oldref="80">Displays an image for the bullet.
Select this option, and then click <emph>Select</emph> to locate the
image file that you want to use. The image gets embedded into the

shared/01/06050500.xhp: <paragraph xml-lang="en-US" id="par_id3151210"
role="paragraph" l10n="U" oldref="111">Displays an image for the bullet.
Select this option, and then click <emph>Select</emph> to locate the
image file that you want to use. The image gets inserted as a link to
the image file.</paragraph>

shared/autopi/01170000.xhp:<paragraph role="paragraph"
id="par_id3145071" xml-lang="en-US" l10n="U" oldref="11"><ahelp
hid="modules/sabpilot/ui/selecttypepage/firefox">Select this option if
you already use an address book in Firefox or Iceweasel.</ahelp></paragraph>

> My issue is that this is one of the files I cleaned up, and now some merging
> is going to be needed, which complicates life for everyone, including no
> doubt the translators.

Once you modify the file, you have done an "enhancement" to our
software. The differences between your work and the existing text is a
"patch". A patch must  be submitted to our git repository interface
named gerrit. Someone, (possibly me or another developer [1]) will
review your patch and approve, comment and ask for more work, or reject
it. Once approved your enhancement is part of LibreOffice.

How to submit a patch:


[1] https://goo.gl/lhDNGt
Gerrit: https://goo.gl/0cix0

> Olivier Hallot-4 wrote
>> Hello Peter
>> You can get the history of the file in Opengrok:
>> http://opengrok.libreoffice.org/history/help/source/text/shared/01/ref_pdf_export.xhp
>> The help content has gaps in contents and updates since long time and
>> these gaps are progressively being closed by our eforts to deliver a
>> consistent and precise documentation for users. It however does not
>> happen in a finger snap, unfortunately.
>> Regards
>> -- 
>> Olivier Hallot
> -----
> Peter
> --
> View this message in context: 
> http://nabble.documentfoundation.org/Help-files-are-inconsistent-tp4181014p4181967.html
> Sent from the Documentation mailing list archive at Nabble.com.

Olivier Hallot
Comunidade LibreOffice
Rio de Janeiro - Brazil - Local time: UTC-03

To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and cannot be deleted

Reply via email to