Bug 116019 - the About Fields online help for F9 seems wrong for Placeholder fields.
Summary: the About Fields online help for F9 seems wrong for Placeholder fields.
Status: RESOLVED FIXED
Alias: None
Product: LibreOffice
Classification: Unclassified
Component: Documentation (show other bugs)
Version:
(earliest affected)
5.4.1.2 release
Hardware: All Windows (All)
: medium normal
Assignee: Olivier Hallot
URL:
Whiteboard: target:6.1.0
Keywords:
Depends on:
Blocks:
 
Reported: 2018-02-25 23:23 UTC by skierpage
Modified: 2018-05-05 10:49 UTC (History)
2 users (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 skierpage 2018-02-25 23:23:11 UTC
(I'm still trying to understand the placeholders in LibreOffice Writer's Modern business letter serif template.)

The online help About Fields https://help.libreoffice.org/5.4/en-US/text/swriter/guide/fields.html?&DbPAR=WRITER&System=WIN says "To update all of the fields in a document, press F9, or choose Edit - Select All, and then press F9."

However, nothing happens when you do this. Maybe this information doesn't apply to Placeholder fields. It does update e.g. Insert > Fields > Document > Sender > Street if I change my address details in Tools > Options > Libre Office > User Data

I think placeholder fields do less than other fields, so the documentation should be clearer about this, explaining separately what they do and mentioning here that they don't update.
Comment 1 Olivier Hallot 2018-02-26 10:54:06 UTC
PLaceholders do very simple thing. They are used to reserve space in the text for later content filling. 

When you click on it you must type/paste the content of the placeholder. After typing or pasting, the placeholder disappear from the document.

There is no update for placeholders.

The text in the help page is slightly inaccurate, as there is no dialog for data enter.
Comment 2 Commit Notification 2018-02-26 14:06:24 UTC
Olivier Hallot committed a patch related to this issue.
It has been pushed to "master":

http://cgit.freedesktop.org/libreoffice/help/commit/?id=bcfb5e98beb4ecd70c98e5c0add1db4da3a80670

tdf#116019 Clarify help text for placeholders
Comment 3 skierpage 2018-02-27 05:12:48 UTC
(In reply to Commit Notification from comment #2)
> Olivier Hallot committed a patch related to this issue.
> It has been pushed to "master":
> 
> http://cgit.freedesktop.org/libreoffice/help/commit/
> ?id=bcfb5e98beb4ecd70c98e5c0add1db4da3a80670

Thanks for the fast turnaround! But

"Opens a dialog to insert the corresponding object for which the placeholder was set, except for text placeholders, where text is inseted directly."

"inseted" typo :-)  FWIW I'm still confused, and the passive voice doesn't help. If I understand what it's doing I think this is clearer:

Opens a dialog to insert the object corresponding to the placeholder, except for text placeholders. You simply click on a text placeholder in the document and type over it.

I reopened so that you'll see this comment, I hope that's not considered a hostile  act in this bugzilla. (Does TDF have an alternative way to comment on git changes?) Again, thanks.
Comment 4 Xisco Faulí 2018-04-03 10:59:21 UTC
Hello skierpage,
Thanks for your comments.
Would you mind creating a patch a submitting it to gerrit as explained here? -> https://wiki.documentfoundation.org/Development/gerrit/SubmitPatch

Thanks in advance.
Comment 5 Commit Notification 2018-04-03 15:23:08 UTC
Olivier Hallot committed a patch related to this issue.
It has been pushed to "master":

http://cgit.freedesktop.org/libreoffice/help/commit/?id=aac05322db1b99099aee32e92b0a585748ac5bc6

tdf#116019 Clarify help text for placeholders (ii)
Comment 6 Xisco Faulí 2018-05-04 08:51:37 UTC
A polite ping to Olivier Hallot: is this bug fixed? if so, could you
please close it as RESOLVED FIXED ? Thanks