Em 04-10-2013 12:31, Bruce Dubbs escreveu: > 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.
So long since I sent, so I did not trim. I have texlive installed (binaries). Still, same problem. Seems that it is JadeTeX-3.13 that is needed (see below). First new problem: there is no ed-0.8.tar.bz2 at http://ftp.gnu.org/pub/gnu/ed/ed-0.8.tar.bz2 First one here is ed-1.0.tar.bz2 (21-Aug-2008 15:14 66K), latest is ed-1.9.tar.gz (21-Jun-2013 07:12 65K). I have already installed, thus, ed-1.9. Is there any reason we have 0.8 in the book? I have in rsync-3.1.0/doc: {{{ $ ls profile.txt README-SGML rsync.sgml }}} $ docbook2html --nochunks rsync.sgml has many error messages, but generates rsync.html. $ docbook2pdf rsync.sgml generates rsync.tex, but fails to generate the pdf. After, I have: {{{ $ ls profile.txt README-SGML rsync.html rsync.sgml rsync.tex $ cat README-SGML Handling the rsync SGML documentation rsync documentation is now primarily in Docbook format. Docbook is an SGML/XML documentation format that is becoming standard on free operating systems. It's also used for Samba documentation. The SGML files are source code that can be translated into various useful output formats, primarily PDF, HTML, Postscript and plain text. To do this transformation on Debian, you should install the docbook-utils package. Having done that, you can say docbook2pdf rsync.sgml and so on. On other systems you probably need James Clark's "sp" and "JadeTeX" packages. Work it out for yourself and send a note to the mailing list. }}} Now I am going to install teTeX-3.0 and JadeTeX-3.13. -- []s, Fernando -- http://linuxfromscratch.org/mailman/listinfo/blfs-dev FAQ: http://www.linuxfromscratch.org/blfs/faq.html Unsubscribe: See the above information page
