[GNC-dev] Documentation update problems

[Geert Janssens]

Op vrijdag 17 augustus 2018 08:41:05 CEST schreef David T. via gnucash-devel:
> Hello,
> 
> If I am working on updating the documentation, it must be time for me to
> bang my head against some command line hiccup! <looks at wrist> Yup! Right
> on time.
> 
> Following my handy-dandy git cheat sheet, I’ve pulled from
> github.com/gnucash/gnucash-docs <http://github.com/gnucash/gnucash-docs>
> and pushed to github.com/sunfish62/gnucash-docs
> <http://github.com/sunfish62/gnucash-docs>. I then entered all my edits to
> ch_basics.xml and saved.
> 
> Next, I went to the wiki
> (https://wiki.gnucash.org/wiki/Documentation_Update_Instructions#Validate_Y
> our_Changes
> <https://wiki.gnucash.org/wiki/Documentation_Update_Instructions#Validate_Y
> our_Changes>) and found the instructions to “make check” the guide. So, in
> Terminal, I cd to my build directory for the guide
> (/Volumes/Media/Development/Gnucash/gnucash-docs/build/guide) and issue
> “make clean”
> 
> This is what I get:
> 
> cd .. && /Applications/Xcode.app/Contents/Developer/usr/bin/make 
> am--refresh CDPATH="${ZSH_VERSION+.}:" && cd .. && /bin/sh
> /Volumes/Media/Development/Gnucash/gnucash-docs/missing aclocal-1.15 cd ..
> && /bin/sh /Volumes/Media/Development/Gnucash/gnucash-docs/missing
> automake-1.15 --gnu configure.ac:6: error: required file './config.guess'
> not found
> configure.ac:6:   'automake --add-missing' can install 'config.guess'
> configure.ac:6: error: required file './config.sub' not found
> configure.ac:6:   'automake --add-missing' can install 'config.sub'
> xmldocs.make:54: warning: shell ls ${srcdir}/${figdir}/*.png: non-POSIX
> variable name xmldocs.make:54: (probably a GNU make extension)
> guide/C/Makefile.am:42:   'xmldocs.make' included from here
> xmldocs.make:85: warning: shell ls ${srcdir}/${figdir}/*.png: non-POSIX
> variable name xmldocs.make:85: (probably a GNU make extension)
> guide/C/Makefile.am:42:   'xmldocs.make' included from here
> xmldocs.make:54: warning: shell ls ${srcdir}/${figdir}/*.png: non-POSIX
> variable name xmldocs.make:54: (probably a GNU make extension)
> guide/de/Makefile.am:40:   'xmldocs.make' included from here
> xmldocs.make:85: warning: shell ls ${srcdir}/${figdir}/*.png: non-POSIX
> variable name xmldocs.make:85: (probably a GNU make extension)
> guide/de/Makefile.am:40:   'xmldocs.make' included from here
> xmldocs.make:54: warning: shell ls ${srcdir}/${figdir}/*.png: non-POSIX
> variable name xmldocs.make:54: (probably a GNU make extension)
> guide/it/Makefile.am:11:   'xmldocs.make' included from here
> xmldocs.make:85: warning: shell ls ${srcdir}/${figdir}/*.png: non-POSIX
> variable name xmldocs.make:85: (probably a GNU make extension)
> guide/it/Makefile.am:11:   'xmldocs.make' included from here
> xmldocs.make:54: warning: shell ls ${srcdir}/${figdir}/*.png: non-POSIX
> variable name xmldocs.make:54: (probably a GNU make extension)
> guide/ja/Makefile.am:37:   'xmldocs.make' included from here
> xmldocs.make:85: warning: shell ls ${srcdir}/${figdir}/*.png: non-POSIX
> variable name xmldocs.make:85: (probably a GNU make extension)
> guide/ja/Makefile.am:37:   'xmldocs.make' included from here
> xmldocs.make:54: warning: shell ls ${srcdir}/${figdir}/*.png: non-POSIX
> variable name xmldocs.make:54: (probably a GNU make extension)
> guide/pt/Makefile.am:43:   'xmldocs.make' included from here
> xmldocs.make:85: warning: shell ls ${srcdir}/${figdir}/*.png: non-POSIX
> variable name xmldocs.make:85: (probably a GNU make extension)
> guide/pt/Makefile.am:43:   'xmldocs.make' included from here
> xmldocs.make:54: warning: shell ls ${srcdir}/${figdir}/*.png: non-POSIX
> variable name xmldocs.make:54: (probably a GNU make extension)
> guide/ru/Makefile.am:37:   'xmldocs.make' included from here
> xmldocs.make:85: warning: shell ls ${srcdir}/${figdir}/*.png: non-POSIX
> variable name xmldocs.make:85: (probably a GNU make extension)
> guide/ru/Makefile.am:37:   'xmldocs.make' included from here
> xmldocs.make:54: warning: shell ls ${srcdir}/${figdir}/*.png: non-POSIX
> variable name xmldocs.make:54: (probably a GNU make extension)
> help/C/Makefile.am:33:   'xmldocs.make' included from here
> xmldocs.make:85: warning: shell ls ${srcdir}/${figdir}/*.png: non-POSIX
> variable name xmldocs.make:85: (probably a GNU make extension)
> help/C/Makefile.am:33:   'xmldocs.make' included from here
> xmldocs.make:54: warning: shell ls ${srcdir}/${figdir}/*.png: non-POSIX
> variable name xmldocs.make:54: (probably a GNU make extension)
> help/de/Makefile.am:20:   'xmldocs.make' included from here
> xmldocs.make:85: warning: shell ls ${srcdir}/${figdir}/*.png: non-POSIX
> variable name xmldocs.make:85: (probably a GNU make extension)
> help/de/Makefile.am:20:   'xmldocs.make' included from here
> xmldocs.make:54: warning: shell ls ${srcdir}/${figdir}/*.png: non-POSIX
> variable name xmldocs.make:54: (probably a GNU make extension)
> help/it/Makefile.am:11:   'xmldocs.make' included from here
> xmldocs.make:85: warning: shell ls ${srcdir}/${figdir}/*.png: non-POSIX
> variable name xmldocs.make:85: (probably a GNU make extension)
> help/it/Makefile.am:11:   'xmldocs.make' included from here
> xmldocs.make:54: warning: shell ls ${srcdir}/${figdir}/*.png: non-POSIX
> variable name xmldocs.make:54: (probably a GNU make extension)
> help/pt/Makefile.am:28:   'xmldocs.make' included from here
> xmldocs.make:85: warning: shell ls ${srcdir}/${figdir}/*.png: non-POSIX
> variable name xmldocs.make:85: (probably a GNU make extension)
> help/pt/Makefile.am:28:   'xmldocs.make' included from here
> make[1]: *** [../Makefile.in] Error 1
> make: *** [../../aclocal.m4] Error 2
> 
> I’m not sure why there’s a “missing” in the initial command, and I don’t
> know where config.guess is supposed to be—and I won’t even try to guess.
> 
> I would love to have some guidance.
> 

I went to look at the wiki page and unfortunately it's incomplete. You get 
this error because a few essential commands have been omitted.

I have added a section that should fill the gap. Can you proofread this:
https://wiki.gnucash.org/wiki/
Documentation_Update_Instructions#Prepare_The_Build_Directory
And report back any issues you experience ?

It's written these steps are usually done early in in the set up process, but 
you can still run them right now and then retry the validation.

Geert