From owner-freebsd-questions@FreeBSD.ORG Sun Jul 1 22:13:14 2007 Return-Path: X-Original-To: freebsd-questions@freebsd.org Delivered-To: freebsd-questions@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 617AC16A400 for ; Sun, 1 Jul 2007 22:13:14 +0000 (UTC) (envelope-from keramida@ceid.upatras.gr) Received: from igloo.linux.gr (igloo.linux.gr [62.1.205.36]) by mx1.freebsd.org (Postfix) with ESMTP id D2A0713C469 for ; Sun, 1 Jul 2007 22:13:13 +0000 (UTC) (envelope-from keramida@ceid.upatras.gr) Received: from kobe.laptop (dialup229.ach.sch.gr [81.186.70.229]) (authenticated bits=128) by igloo.linux.gr (8.13.8/8.13.8/Debian-3) with ESMTP id l61MC9HG003233 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT) for ; Mon, 2 Jul 2007 01:12:39 +0300 Received: from kobe.laptop (kobe.laptop [127.0.0.1]) by kobe.laptop (8.14.1/8.14.1) with ESMTP id l61LqiMC009612 for ; Mon, 2 Jul 2007 00:53:15 +0300 (EEST) (envelope-from keramida@ceid.upatras.gr) Received: (from keramida@localhost) by kobe.laptop (8.14.1/8.14.1/Submit) id l61KAxwZ006067; Sun, 1 Jul 2007 23:10:59 +0300 (EEST) (envelope-from keramida@ceid.upatras.gr) Date: Sun, 1 Jul 2007 23:10:59 +0300 From: Giorgos Keramidas To: Zbigniew Komarnicki Message-ID: <20070701201059.GA6005@kobe.laptop> References: <200707011527.47168.cblasius@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <200707011527.47168.cblasius@gmail.com> X-Hellug-MailScanner: Found to be clean X-Hellug-MailScanner-SpamCheck: not spam, SpamAssassin (not cached, score=-3.791, required 5, autolearn=not spam, ALL_TRUSTED -1.80, AWL 0.61, BAYES_00 -2.60) X-Hellug-MailScanner-From: keramida@ceid.upatras.gr X-Spam-Status: No Cc: freebsd-questions@freebsd.org Subject: Re: Making docs X-BeenThere: freebsd-questions@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: User questions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 01 Jul 2007 22:13:14 -0000 On 2007-07-01 15:27, Zbigniew Komarnicki wrote: > Hello! > > I want to create documentation in FreeBSD. I read this article: > http://www.onlamp.com/pub/a/bsd/2001/02/08/Big_Scary_Daemons.html > then I compile and I obtain the following error: You know we regularly re-build the documentation from the CVS repository and publish the resulting documents online, right? If you are not really interested in contributing patches to the docs, then it may be a little easier for you to just download the pre-built versions :) Having said that, we could always use some more help with the current documentation, so if you are trying to learn about the build process of the documentation to help us improve the existing documents, you are certainly more than welcome to help in any way you want! > ===> books/pmake (install) > /bin/rm -f docbook.css > /bin/cat /usr/doc/share/misc/docbook.css > docbook.css > Index is disabled or no index to generate. > /usr/bin/env SP_ENCODING=ISO-8859-1 /usr/local/bin/jade -V > html-manifest -ioutput.html -d /usr/doc/share/sgml/default.dsl -ifreebsd.urls.absolute > -V %generate-legalnotice-link% -ioutput.html.images -D /usr/doc/en_US.ISO8859-1/books/pmake/.. > /../../share/images/books/pmake -D /usr/obj/usr/doc/en_US.ISO8859-1/books/pmake -c > /usr/doc/en_US.ISO8859-1/share/sgml/catalog -c /usr/doc/share/sgml/catalog -c > /usr/local/share/sgml/docbook/dsssl/modular/catalog -c /usr/local/share/sgml/iso8879/catalog > -c /usr/local/share/sgml/jade/catalog -c /usr/local/share/sgml/catalog.ports -t > sgml /usr/doc/en_US.ISO8859-1/books/pmake/book.sgml > /usr/local/bin/tidy -wrap 90 -m -raw -preserve -f /dev/null -asxml > $(/usr/bin/xargs < HTML.manifest) > *** Error code 1 (ignored) > install -C -o root -g wheel -m 444 $(/usr/bin/xargs < > HTML.manifest) /usr/share/doc/en_US.ISO8859-1/books/pmake > install -C -o root -g wheel -m 444 > docbook.css /usr/share/doc/en_US.ISO8859-1/books/pmake > > What this error "*** Error code 1 (ignored)" means? tidy(1) typically fails with a non-zero error code for things which we are not really interested to fix, or are plainly harmless. This is why the Makefile which calls tidy precedes it with a dash '-' to ignore errors from tidy's invocation. The make(1) utility catches the non-zero error status, and notifies you that it ignored it. Most of the time, it's relatively safe to ignore this error code. > I also would like to ask you how to create PDF document, not only > HTML? What command I should use to obtain PDF handbook, for example, > because I want to print it? First of all, you have to install the textproc/docproj-jadetex port, to get the jadetex utility. Then you can build a PDF version of any article or book with: $ cd doc/en_US.ISO8859-1/articles/formatting-media $ make FORMATS=pdf the ${FORMATS} option controls which output format will be produced by the make infrastructure of the documentation. Other available format options are: FORMATS=html Single-file HTML output FORMATS=html-split Multiple-file HTML output FORMATS=txt Single-file plain text output FORMATS=ps Single-file PostScript output etc. These options and other useful stuff about the build infrastructure of the FreeBSD documentation set are described in the "FreeBSD Documentation Project Primer for New Contributors" at: http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/fdp-primer/ Have fun building your own docs :-) Regards, Giorgos