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 761025 - Guide - chapter 2.8 - "New book options" in "New Account Hierarchy" missing
Guide - chapter 2.8 - "New book options" in "New Account Hierarchy" missing
Status: RESOLVED FIXED
Product: GnuCash
Classification: Other
Component: Documentation
git-maint
Other All
: Normal normal
: ---
Assigned To: gnucash-documentation-maint
gnucash-documentation-maint
Depends on:
Blocks:
 
 
Reported: 2016-01-23 16:30 UTC by pmralbuquerque
Modified: 2018-06-29 23:46 UTC
See Also:
GNOME target: ---
GNOME version: ---


Attachments
Screenshot (29.19 KB, image/png)
2016-01-23 16:30 UTC, pmralbuquerque
  Details
Add missing sect Guide ch2.8 New book options in New Acct Hierarchy (42.85 KB, patch)
2016-03-06 07:56 UTC, Chris Good
committed Details | Review
Remove obsolete images Bug 761025 (210.88 KB, patch)
2016-03-06 07:57 UTC, Chris Good
committed Details | Review

Description pmralbuquerque 2016-01-23 16:30:56 UTC
Created attachment 319591 [details]
Screenshot

In chapter 2 - The basics, section 2.8 - Putting it all together, the screen "New book options", after "Choose Currency" is not mentioned/explained.

I couldn't find any similar bug. Attached an image (in Portuguese)

Regards.
Comment 1 Frank H. Ellenberger 2016-01-28 05:33:22 UTC
I think this page was introduced by commit commit 7cdd737:
10. Modify new file process to allow setting of num-source (actually, all) book
    option(s) during New Account Hierarchy Setup ...

and the guide got no update.

You will find the description of the elements in help/C/Help_ch_Customize.xml in  <sect1 id="set-prefs">.

But here we should add a short section of the form
Enter your name to show it in the reports 
[Are there other options important?] ...
You can skip the other settings because you can access them on demand by Edit->Preferences later.
Comment 2 Frank H. Ellenberger 2016-01-28 05:38:10 UTC
Correction:
"Edit->Preferences" should be "File->Properties" and the section <sect1 id="book-options">
Comment 3 Chris Good 2016-03-04 23:02:33 UTC
Hi Frank,

I'm thinking of updating the guide for this bug.

When you said 'Enter your name to show it in the reports', I assume you meant the Company Name on the Business tab.
As far as I know, Company Name can be updated anytime and doesn't need to be set for a non business book, so I'm thinking of only adding a screen shot, a comment that this allows you to set various options which you can also update later using File->Properties, and a link to the Help_ch_Customize.xml.

OK?

Chris
Comment 4 Chris Good 2016-03-05 06:42:17 UTC
Hi,

I've created a new image for my mod. When I ran adjust-dpi, the following images in guide/C/figures where also updated:
reports_Accounts_Summary.png
reports_Accounts_Tab.png
reports_Commodities_Tab.png
reports_Display_Tab.png
reports_General_Tab.png
These images were all recently updated in commit 913bdbe664dd45eef73a7b8b74046aca80299a42 and have grown from approx. 10 to 40k.
Should I include these new smaller unrelated files in my patch, maybe in a separate patch?
Comment 5 Chris Good 2016-03-05 06:57:28 UTC
Note that adjust-dpi hasn't made the 5 images mentioned above appreciably smaller.
Comment 6 pmralbuquerque 2016-03-05 08:04:50 UTC
(In reply to Chris Good from comment #5)
> Note that adjust-dpi hasn't made the 5 images mentioned above appreciably
> smaller.

Hi,

those images should have been deleted by me with a new commit. Please do that now, as they make no sense. Where can I find that tool, 'adjust-dpi'?

Regards,
Pedro.
Comment 7 Chris Good 2016-03-05 08:39:25 UTC
Hi Pedro, 

Ok, shall do.
Re adjust-dpi, please see http://wiki.gnucash.org/wiki/Documentation_Update_Instructions#The_Documentation_Change_Process_--_What_and_How_it_happens
section Images and screenshots.

Regards, Chris
Comment 8 pmralbuquerque 2016-03-05 10:14:21 UTC
(In reply to Chris Good from comment #7)
> Hi Pedro, 
> 
> Ok, shall do.
> Re adjust-dpi, please see
> http://wiki.gnucash.org/wiki/
> Documentation_Update_Instructions#The_Documentation_Change_Process_--
> _What_and_How_it_happens
> section Images and screenshots.
> 
> Regards, Chris

Thank you. Have a nice weekend,
Pedro.
Comment 9 Chris Good 2016-03-06 07:56:13 UTC
Created attachment 323184 [details] [review]
Add missing sect Guide ch2.8 New book options in New Acct  Hierarchy
Comment 10 Chris Good 2016-03-06 07:57:45 UTC
Created attachment 323185 [details] [review]
Remove obsolete images Bug 761025
Comment 11 Chris Good 2016-03-06 08:04:31 UTC
Hi Frank,

I've done a patch for what I said I was thinking of doing in comment 3.
If you get time and decide something else is needed, I'll be happy to change.

Regards, Chris

BTW, I have checked that the 5 images deleted in the 2nd patch are not referenced by any of the guide xml files.
Comment 12 Geert Janssens 2016-03-13 13:23:05 UTC
Thanks for the changes. I have committed them to the stable branch to appear in the next release. Note the obsolete images were already gone, so the second patch effectively did nothing.

Also worth mentioning is that I added the adjust-dpi script is now part of the gnucash-docs repository (in the util directory), so there's no need to manually copy and install it again. The instructions for use have slightly changed as well. See the above-mentioned wiki page for full details.
Comment 13 John Ralls 2018-06-29 23:46:40 UTC
GnuCash bug tracking has moved to a new Bugzilla host. This bug has been copied to https://bugs.gnucash.org/show_bug.cgi?id=761025. Please update any external references or bookmarks.