From owner-freebsd-doc Mon Oct 1 17:20: 7 2001 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id 7D2DB37B40C for ; Mon, 1 Oct 2001 17:20:00 -0700 (PDT) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.4/8.11.4) id f920K0q66367; Mon, 1 Oct 2001 17:20:00 -0700 (PDT) (envelope-from gnats) Received: from mailsrv.otenet.gr (mailsrv.otenet.gr [195.170.0.5]) by hub.freebsd.org (Postfix) with ESMTP id D6FAF37B40D for ; Mon, 1 Oct 2001 17:19:22 -0700 (PDT) Received: from hades.hell.gr (patr530-a222.otenet.gr [212.205.215.222]) by mailsrv.otenet.gr (8.11.5/8.11.5) with ESMTP id f920JJV12214 for ; Tue, 2 Oct 2001 03:19:19 +0300 (EEST) Received: (from charon@localhost) by hades.hell.gr (8.11.6/8.11.6) id f91MGw415224; Tue, 2 Oct 2001 01:16:58 +0300 (EEST) (envelope-from charon) Message-Id: <200110012216.f91MGw415224@hades.hell.gr> Date: Tue, 2 Oct 2001 01:16:58 +0300 (EEST) From: Giorgos Keramidas Reply-To: Giorgos Keramidas To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.113 Subject: docs/30975: request for minor clarification of example in the fdp-primer Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org >Number: 30975 >Category: docs >Synopsis: request for minor clarification of example in the fdp-primer >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Mon Oct 01 17:20:00 PDT 2001 >Closed-Date: >Last-Modified: >Originator: Giorgos Keramidas >Release: FreeBSD 5.0-CURRENT i386 >Organization: >Environment: System: FreeBSD hades.hell.gr 5.0-CURRENT FreeBSD 5.0-CURRENT #5: Tue Sep 4 19:49:44 EEST 2001 root@hades.hell.gr:/usr/obj/usr/src/sys/CHARON i386 >Description: I've been reading the fdp-primer book lately, paying a lot of attention to more or less important details. There is one example of building the docs, that I wanted to add a little clarification. The patch shown below describes in more detail the use of the FORMATS="..." make variable. I'm not sure if this is good enough, but here it is :-) >How-To-Repeat: >Fix: --- patch begins here --- Index: en_US.ISO8859-1/books/fdp-primer/overview/chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/fdp-primer/overview/chapter.sgml,v retrieving revision 1.8 diff -u -r1.8 chapter.sgml --- en_US.ISO8859-1/books/fdp-primer/overview/chapter.sgml 26 Sep 2001 21:49:28 -0000 1.8 +++ en_US.ISO8859-1/books/fdp-primer/overview/chapter.sgml 1 Oct 2001 22:16:19 -0000 @@ -247,11 +247,31 @@ and convert the document to other formats for review. &prompt.user; make lint -&prompt.user; make FORMATS=format +&prompt.user; make FORMATS=format-list - Where format is one of + Where format-list is one of html, html-split, - txt, or rtf + txt, or rtf, + or a space-separated list of more than one of these. + Use quotes around the list of formats when you build more + than one format in one command. + + For example, to convert the document to + html only, you would use: + + &prompt.user; make FORMATS=html + + But when you want to convert the document to both + html and txt format, + you should use either two separate &man.make.1; runs, + with: + + &prompt.user; make FORMATS=html +&prompt.user; make FORMATS=txt + + or, you can do it in one command: + + &prompt.user; make FORMATS="html txt" --- patch ends here --- >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message