Frank,

> On Sep 17, 2018, at 10:47 AM, Frank H. Ellenberger 
> <frank.h.ellenber...@gmail.com> wrote:
> 
> Hi David,
> 
> Am 17.09.18 um 14:59 schrieb David T.:
>> Hello,
>> 
>> Can anyone give me clear language on when and why a documentation creator 
>> would need to reissue the commands in Initializing Documentation Build 
>> Environment? I’d like to clear this issue up on the wiki before it gets lost.
>> 
>> David
> 
> because of some general confusion about the term make i.e. in
> https://wiki.gnucash.org/wiki/The_Make_Utility, I created recently
> https://wiki.gnucash.org/wiki/Build_Tools. It might still be incomplete
> or contain errors, so improvements are welcome. Feel free to link it,
> where ever required.

I worked a bit on Build Tools to make the flow seem more natural; see whether 
you agree. 

With the rearrangement, I remain unclear on the last portion of the Autotools 
section, beginning with “So there remain 3 basic steps”

Does the following changed text capture your intent?


----------------
When using Autotools, there are 3 commonly-used commands:

• autogen.sh, which should be run after you check out a copy of the repository. 
• configure [options], which should be run after you install updates of your 
tools {not sure which tools?} or modify either makefile.am or configure.ac
• make <target>, which is run after making edits. Common targets are all, 
check, and install.

Note that which build directory you use will affect the scope and output of 
your command.
----------------

I will note that for me, I *still* don’t know when I am required to re-run 
autogen.sh or configure; is there any downside to simply running them every 
time I mess around with the docs?

David

P.S. - As a professionally-trained librarian, I hesitate to engage in 
categorization of the wiki. I am not prepared to develop a logical taxonomy for 
the wiki at this time, and half-baked taxonomies grate upon my sensibilities.


> 
> You might also counter check the recent changes in
> Documentation_Update_Instructions:
> https://wiki.gnucash.org/wiki/index.php?title=Documentation_Update_Instructions&type=revision&diff=14469&oldid=13948
> 
> and other pages of
> https://wiki.gnucash.org/wiki/Category:Development .
> 
> N.B.: It would be nice, if you would add categories to
> https://wiki.gnucash.org/wiki/Initializing_Documentation_Build_Environment
> 
>>> On Sep 14, 2018, at 10:21 AM, David T. <sunfis...@yahoo.com> wrote:
>>> 
>>> Frank, Geert,
>>> 
>>> I am finally following up on this thread, and I’d like to note that the 
>>> information that Frank says “got lost,” and which Geert has re-entered on 
>>> this page were actually moved to a different page 
>>> (https://wiki.gnucash.org/wiki/Initializing_Documentation_Build_Environment 
>>> <https://wiki.gnucash.org/wiki/Initializing_Documentation_Build_Environment>)
>>>  and the reference to this information was moved up to Section 2. Setting 
>>> Up Your System.
>>> 
>>> Here we have an example of how duplicative information ends up in our 
>>> ecosystem!
> 
> That is a nice example, why you should make smaller changes. Instead of
> "Major rewrite of entire page" it would be better readable, if you would
> use separate steps of logical units:
> Move Section x in a new page;
> Move section y to appropriate position;
> Rewordening of section z; ...
> 
> :
> 
> Regards
> Frank
> 

_______________________________________________
gnucash-devel mailing list
gnucash-devel@gnucash.org
https://lists.gnucash.org/mailman/listinfo/gnucash-devel

Reply via email to