Bug 634181

[David T.]

Geert,

Thanks for that information. 

For what it’s worth, I was able to insert top level Part designations into the Guide by adding them into gnucash-guide.xml and generate what I think is a correct patch for it. It’s amazing how easy it is to edit the doc files when you follow the instructions at http://wiki.gnucash.org/wiki/Documentation_Update_Instructions ;) Of course, my opinion about the correctness is of limited value; I await the verdict from more experienced people. Please let me know if I have followed this correctly so that I can either steam ahead or learn from my errors.

On the renumbering, I note that gnucash-guide.xml has ENTITY definitions for each chapter, linking them to specific files. Changing these won’t be a major problem at this level, but I don’t understand the internals of DocBook to know whether any cross references in the individual files will require attention if the sequence changes.

David

On Jan 28, 2015, at 12:00 AM, Geert Janssens <geert.gnucash at kobaltwit.be> wrote:

> On Tuesday 27 January 2015 20:30:11 John Ralls wrote:
>>> On Jan 27, 2015, at 7:02 PM, David T. <sunfish62 at yahoo.com> wrote:
>>> 
>>> John,
>>> 
>>> Thanks for your input.
>>> 
>>> As I look at this in greater detail, I see that this bug, combined
>>> with my own recommendations in bug
>>> https://bugzilla.gnome.org/show_bug.cgi?id=687820
>>> <https://bugzilla.gnome.org/show_bug.cgi?id=687820> point toward a
>>> bigger rewrite. Looking the two bugs over (along with the
>>> interlinked bugs mentioned in the comments of the latter bug), my
>>> preference would be to work up an extensive update to many chapters
>>> of the Guide.
>>> 
>>> My question is this: assuming that I succeed in tackling the DocBook
>>> Dilemma, at what level should I submit bugs and/or patches? At the
>>> chapter level? At section levels? Should each patch go into a
>>> separate bug, or should they all be entered under one of these two
>>> bugs?
>> Let's keep it simple and just use this bug. It will be easiest to
>> apply if you make one patch per chapter since each chapter is a
>> separate file. I don't remember if you need to renumber the chapters
>> if you insert a new one; ISTR that DocBook takes care of that.
>> Further discussion should take place on the bug rather than the
>> mailing list.
>> 
> Docbook does indeed take care of the renumbering automatically.
> 
> Thanks for working on such much needed documentation updates, David !
> 
> Geert