After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 782423 - Help 10.2. Setting Preferences is outdated
Help 10.2. Setting Preferences is outdated
Status: RESOLVED OBSOLETE
Product: GnuCash
Classification: Other
Component: Documentation
git-maint
Other All
: Normal normal
: ---
Assigned To: gnucash-documentation-maint
gnucash-documentation-maint
Depends on:
Blocks:
 
 
Reported: 2017-05-10 06:35 UTC by Frank H. Ellenberger
Modified: 2018-06-29 23:56 UTC
See Also:
GNOME target: ---
GNOME version: ---



Description Frank H. Ellenberger 2017-05-10 06:35:03 UTC
Start GnuCash, open Edit->Preferences and compare it with e.g. https://code.gnucash.org/docs/C/gnucash-help/set-prefs.html.

You will see many differences which should be easy to fix:

Open gnucash-docs/help/C/Help_ch_Customize.xml, 
search <sect1 id="set-prefs">
For each missing add 
  <listitem>
    <para><guilabel>Name:</guilabel> Tooltip</para>
  </listitem>

An easy way to find the location in gnucahs code repository is:
make once and open po/gnucash.pot and search the name of the pref.

Example:"Include _non-currency totals" delivers 
#: ../src/gnome-utils/gtkbuilder/dialog-preferences.glade.h:15

Search "Include _non-currency totals" in src/gnome-utils/gtkbuilder/dialog-preferences.glade and you will see a few lines  below:
<property name="tooltip_text" translatable="yes">If checked, non-currency commodities will be shown in the summary bar. If clear, only currencies will be shown.</property>

Now copy the text between 'translatable="yes">' and '</property>' in above section of Help_ch_Customize.xml
Comment 1 Frank H. Ellenberger 2017-07-30 01:48:52 UTC
Some of the related images could need an update, too.
See https://wiki.gnucash.org/wiki/Documentation_Update_Instructions#Screenshots_and_Images for guidance.
Comment 2 David 2017-12-03 10:57:04 UTC
PR 105 addresses these discrepancies. As I mentioned in the request, my computer (a Mac) uses a different look from the screenshots in the docs, so someone else will need to replace screenshots for Preferences:Business, Preferences:Register and Preferences:Scheduled Transactions.
Comment 3 Frank H. Ellenberger 2018-03-07 21:16:39 UTC
Thanks, David!

Unfortunately a few things changed in between:
"Auto pay on posting" became renamed to "Process payments on posting"

I replaced a few tooltips by the more precise descriptions from their gschema files and remember: https://github.com/Gnucash/gnucash/commit/3cdac65d49999a3b7845e22ac8eb66b824108aac#diff-25d902c24283ab8cfbac54dfa101ad31
Also the label changed here. I am not completely sure if there were more.

For both sections new images are desired.

BTW I replaced "Online Quotes" and unticked "include window decoration" while creating the screenshot. So the desktop theme does not matter much. What do you think?
Comment 4 John Ralls 2018-06-29 23:56:45 UTC
GnuCash bug tracking has moved to a new Bugzilla host. The new URL for this bug is https://bugs.gnucash.org/show_bug.cgi?id=782423. Please continue processing the bug there and please update any external references or bookmarks.