Guide Documentation

[Pedro Albuquerque]

Hi,

like I said, it was just an idea, no need for discussion. When there is
a plan, and if my help is needed, I'm available.

Meanwhile, I reset the reports files to their original state and run
another make check. You can see the result in the attached file. I also
tested C and pt with yelp and both worked fine.
I think everything is OK now.

Have a nice Sunday,
Pedro.

Sáb, 2016-02-27 às 14:52 -0800, John Ralls escreveu:

> > On Feb 26, 2016, at 1:56 PM, Pedro Albuquerque <palbuquerque73 at gmail.com> wrote:
> > 
> > Hi
> > 
> > since reports documentation is not really available, here is an idea.
> > 
> > I think it can be consensual that reports should have a dedicated
> > section, since they affect both business and personal finances, and are
> > the only way to keep our accountants happy  ;-) .
> > 
> > So, I used the existing ch_reports.xml as base and:
> > 
> > 1 - Divided it, because it seemed to me that a single file for all
> > reports documentation would be to big. There isn't any logical reason
> > for this split.
> > 2 - The split is based on the Reports Menu it self. Apart the general
> > concepts, there is a file for each sub-menu and one for the general
> > menu.
> > 3 - Another file/section could be created for the How-to's, or they
> > could be integrated in the Example section.
> > 4 - I used the existing tables and expanded them to the list of
> > available reports. 
> > 5 - I did not create anything, except some links between tables and
> > files, and the screenshots, and even those would have to be EXIF cleaned
> > and size adjusted.
> > 6 - Nothing is finished nor complete. I used Accounts Summary Report as
> > the only example to illustrate my idea.
> > 
> > 7 - I didn't use git patch because I wouldn't know how. Please forgive
> > my ignorance, but this way is easier for me, and probably for you
> > developers.
> > I think I've made my fair share of git mistakes for you to endure with.
> > 
> > As said before, I'm available to help, but never to create unnecessary
> > discussions. It's just an idea, please do completely disregard it if it
> > is not in line with the roadmap or any other existing guidelines. Since
> > it was accepted within my translation (to be changed, if needed), here
> > is the English version with one single not pt translated example.
> > 
> > Regards,
> > Pedro.
> > 
> > P.S.: my github fork is updated, I think, so the files should be also
> > available there.
> 
> Pedro,
> 
> Thanks. I made one inline comment on your last "Still the make Check" commit; with that fixed your Portuguese translation can be merged.
> 
> Unfortunately the C part fails make check, largely due to the same sort of sect2 problems.
> 
> I'm afraid I don't understand what you're trying to convey in the tables. Could you explain that please?
> 
> Regards,
> John Ralls
> 


-------------- next part --------------
Making check in help
make[1]: Entering directory `/home/pedro/Programas/GnucashGit/gnucash-docs/build/help'
Making check in C
make[2]: Entering directory `/home/pedro/Programas/GnucashGit/gnucash-docs/build/help/C'
xmllint --valid --noout ../../../help/C/gnucash-help.xml
make[2]: Leaving directory `/home/pedro/Programas/GnucashGit/gnucash-docs/build/help/C'
Making check in de
make[2]: Entering directory `/home/pedro/Programas/GnucashGit/gnucash-docs/build/help/de'
xmllint --valid --noout ../../../help/de/gnucash-help.xml
make[2]: Leaving directory `/home/pedro/Programas/GnucashGit/gnucash-docs/build/help/de'
Making check in it
make[2]: Entering directory `/home/pedro/Programas/GnucashGit/gnucash-docs/build/help/it'
xmllint --valid --noout ../../../help/it/gnucash-help.xml
make[2]: Leaving directory `/home/pedro/Programas/GnucashGit/gnucash-docs/build/help/it'
Making check in pt
make[2]: Entering directory `/home/pedro/Programas/GnucashGit/gnucash-docs/build/help/pt'
xmllint --valid --noout ../../../help/pt/gnucash-help.xml
make[2]: Leaving directory `/home/pedro/Programas/GnucashGit/gnucash-docs/build/help/pt'
make[2]: Entering directory `/home/pedro/Programas/GnucashGit/gnucash-docs/build/help'
make[2]: Nothing to be done for `check-am'.
make[2]: Leaving directory `/home/pedro/Programas/GnucashGit/gnucash-docs/build/help'
make[1]: Leaving directory `/home/pedro/Programas/GnucashGit/gnucash-docs/build/help'
Making check in guide
make[1]: Entering directory `/home/pedro/Programas/GnucashGit/gnucash-docs/build/guide'
Making check in C
make[2]: Entering directory `/home/pedro/Programas/GnucashGit/gnucash-docs/build/guide/C'
xmllint --valid --noout ../../../guide/C/gnucash-guide.xml
make[2]: Leaving directory `/home/pedro/Programas/GnucashGit/gnucash-docs/build/guide/C'
Making check in de
make[2]: Entering directory `/home/pedro/Programas/GnucashGit/gnucash-docs/build/guide/de'
xmllint --valid --noout ../../../guide/de/gnucash-guide.xml
make[2]: Leaving directory `/home/pedro/Programas/GnucashGit/gnucash-docs/build/guide/de'
Making check in it
make[2]: Entering directory `/home/pedro/Programas/GnucashGit/gnucash-docs/build/guide/it'
xmllint --valid --noout ../../../guide/it/gnucash-guide.xml
make[2]: Leaving directory `/home/pedro/Programas/GnucashGit/gnucash-docs/build/guide/it'
Making check in ja
make[2]: Entering directory `/home/pedro/Programas/GnucashGit/gnucash-docs/build/guide/ja'
xmllint --valid --noout ../../../guide/ja/gnucash-guide.xml
make[2]: Leaving directory `/home/pedro/Programas/GnucashGit/gnucash-docs/build/guide/ja'
Making check in pt
make[2]: Entering directory `/home/pedro/Programas/GnucashGit/gnucash-docs/build/guide/pt'
make[3]: Entering directory `/home/pedro/Programas/GnucashGit/gnucash-docs/build'
make[3]: Leaving directory `/home/pedro/Programas/GnucashGit/gnucash-docs/build'
xmllint --valid --noout ../../../guide/pt/gnucash-guide.xml
make[2]: Leaving directory `/home/pedro/Programas/GnucashGit/gnucash-docs/build/guide/pt'
make[2]: Entering directory `/home/pedro/Programas/GnucashGit/gnucash-docs/build/guide'
make[2]: Nothing to be done for `check-am'.
make[2]: Leaving directory `/home/pedro/Programas/GnucashGit/gnucash-docs/build/guide'
make[1]: Leaving directory `/home/pedro/Programas/GnucashGit/gnucash-docs/build/guide'
make[1]: Entering directory `/home/pedro/Programas/GnucashGit/gnucash-docs/build'
make[1]: Nothing to be done for `check-am'.
make[1]: Leaving directory `/home/pedro/Programas/GnucashGit/gnucash-docs/build'