Fernando de Oliveira wrote: > 1. Doxygen-1.8.5 > > I do not know how helpful is the API docs, for people using BLFS. But if > it is maintained in the page, should be listed in Optional Requirements. > Furthermore, it required Graphviz to run correctly, thus, Graphviz > should be listed, too.
Most users don't want or need API docs, but some do. We have normally added the procedures for those who want them, but say they are optional. > 2. DocBook-utils-0.6.14 > > "Testing the DocBook SGML Toolchain (Optional)", from > docbook-dsssl-1.79, was perfect. > > Despite many messages, the command: > > docbook2html --nochunks rsync.sgml > > apparently worked, the file "usr/share/doc/rsync-3.1.0/rsync.html" can > be browsed with firefox. > > But > > docbook2pdf rsync.sgml > > generated a .tex file (and many error messages), but no pdf, and the > other ones, generated only error messages. I do not know if these are > due to not having other corresponding packages installed. > > I found that old versions of rsync only generated the rsync.html (only > the docbook2html command), and no doxygen was used. > > Anyway, DocBook-utils-0.6.14 should be listed in "Optional", too, if the > suggestion to generate those docs remain in the page. If it's generating a .tex file, then texlive is needed, or at least the portion that has TeX, dvi, etc. docbook2pdf is a script that calls jw, another script. Specifically, the programs needed are tex and pdfjadetex (a link topdftex). All are a part of texlive. > 3. Summary > > I have a feeling that the docs are not so useful to spend so much time > with their generation. The man page is already very good. > > Either remove all docs generation, or: > > a) Add Doxygen-1.8.5, Graphviz-2.34.0 and DocBook-utils-0.6.14 as > "Optional" requirements. > > b) Remove or comment out the lines > > docbook2pdf rsync.sgml && > docbook2ps rsync.sgml && > docbook2dvi rsync.sgml && > docbook2txt rsync.sgml && > > But keep the "Estimated disk space required: 9.4 MB", not with the docs, > as you have done, so next updates would be simpler. > > Hope I have written all the observations I did when studying this problem. Just add the programs needed for doc generation, including texlive. -- Bruce -- http://linuxfromscratch.org/mailman/listinfo/blfs-dev FAQ: http://www.linuxfromscratch.org/blfs/faq.html Unsubscribe: See the above information page
