From owner-freebsd-doc Mon Oct 1 17:30:24 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 4553037B40E for ; Mon, 1 Oct 2001 17:30:01 -0700 (PDT) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.4/8.11.4) id f920U1571112; Mon, 1 Oct 2001 17:30:01 -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 D9FC537B408 for ; Mon, 1 Oct 2001 17:28:17 -0700 (PDT) Received: from hades.hell.gr (patr530-a185.otenet.gr [212.205.215.185]) by mailsrv.otenet.gr (8.11.5/8.11.5) with ESMTP id f920SDV17956 for ; Tue, 2 Oct 2001 03:28:13 +0300 (EEST) Received: (from charon@localhost) by hades.hell.gr (8.11.6/8.11.6) id f920SDv01100; Tue, 2 Oct 2001 03:28:13 +0300 (EEST) (envelope-from charon) Message-Id: <200110020028.f920SDv01100@hades.hell.gr> Date: Tue, 2 Oct 2001 03:28:13 +0300 (EEST) From: Giorgos Keramidas Reply-To: Giorgos Keramidas To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.113 Subject: docs/30977: various whitespace fixes that would be nice to have applied to books/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: 30977 >Category: docs >Synopsis: various whitespace fixes that would be nice to have applied to books/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:30:01 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'm probably being a style freak now, but the patch included corrects various whitespace related things in the fdp-primer book. Forgive me for sending so many changes in one batch, but I did not know if it was proper to send in one big diff or many small ones. >How-To-Repeat: >Fix: --- patch begins here --- Index: examples/appendix.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/fdp-primer/examples/appendix.sgml,v retrieving revision 1.5 diff -u -r1.5 appendix.sgml --- examples/appendix.sgml 29 Aug 2001 00:34:27 -0000 1.5 +++ examples/appendix.sgml 1 Oct 2001 23:30:20 -0000 @@ -240,9 +240,9 @@ Specifies the file that Jade should process. The - stylesheets determine how the individual HTML files will be - named, and the name of the root file (i.e., the - one that contains the start of the document. + stylesheets determine how the individual HTML files will be + named, and the name of the root file (i.e., the + one that contains the start of the document. @@ -294,14 +294,14 @@ &prompt.user; tex "&jadetex" file.tex You have to run tex at - least three times. The first run processes the + least three times. The first run processes the document, and determines areas of the document which are referenced from other parts of the document, for use in indexing, and so on. Do not be alarmed if you see warning messages such as LaTeX Warning: Reference `136' on page 5 undefined on input - line 728. at this point. + line 728. at this point. The second run reprocesses the document now that certain pieces of information are known (such as the document's page length). This Index: 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 --- overview/chapter.sgml 26 Sep 2001 21:49:28 -0000 1.8 +++ overview/chapter.sgml 1 Oct 2001 23:31:14 -0000 @@ -39,15 +39,15 @@ is produced. Your contributions are very valuable. This document's main purpose is to clearly explain how - the FDP is organised, how to write and submit - documentation to the FDP, and how to - effectively use the tools available to you when writing - documentation. + the FDP is organised, how to write and submit + documentation to the FDP, and how to + effectively use the tools available to you when writing + documentation. Membership -Every one is welcome to join the FDP. There is no minimum + Every one is welcome to join the FDP. There is no minimum membership requirement, no quota of documentation you need to produce per month. All you need to do is subscribe to the freebsd-doc@FreeBSD.org mailing list. Index: sgml-markup/chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml,v retrieving revision 1.29 diff -u -r1.29 chapter.sgml --- sgml-markup/chapter.sgml 12 Aug 2001 19:41:44 -0000 1.29 +++ sgml-markup/chapter.sgml 1 Oct 2001 23:40:50 -0000 @@ -546,7 +546,7 @@ Use font with the size - attribute set to a number between 1 and 7. The default font size + attribute set to a number between 1 and 7. The default font size is 3. This approach is deprecated. Index: sgml-primer/chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml,v retrieving revision 1.19 diff -u -r1.19 chapter.sgml --- sgml-primer/chapter.sgml 17 Jul 2001 20:51:51 -0000 1.19 +++ sgml-primer/chapter.sgml 1 Oct 2001 23:47:09 -0000 @@ -88,12 +88,12 @@ markup from the user, so the user is not distracted by it. The extra information stored in the markup adds - value to the document. Adding the markup to the document + value to the document. Adding the markup to the document must typically be done by a person—after all, if computers could recognise the text sufficiently well to add the markup then there would be no need to add it in the first place. This increases the - cost (i.e., the effort required) to create the - document. + cost (i.e., the effort required) to create the + document. The previous example is actually represented in this document like this; @@ -117,7 +117,7 @@ in turn, would be very different from a markup language used to describe poetry. What you really need is a first language that you use to write these other markup languages. A meta markup - language. + language. This is exactly what the Standard Generalised Markup Language (SGML) is. Many markup languages have been written in SGML, including the two @@ -198,7 +198,7 @@ A tag is used to identify where a particular element starts, and where the element ends. The tag is not part of the element - itself. Because each DTD was normally written to mark up + itself. Because each DTD was normally written to mark up specific types of information, each one will recognise different elements, and will therefore have different names for the tags. @@ -398,10 +398,10 @@ Part of textproc/docproj is the &man.nsgmls.1; validating - parser. Normally, &man.nsgmls.1; reads in a document - marked up according to an SGML DTD and returns a copy of the - document's Element Structure Information Set (ESIS, but that is - not important right now). + parser. Normally, &man.nsgmls.1; reads in a document + marked up according to an SGML DTD and returns a copy of the + document's Element Structure Information Set (ESIS, but that is + not important right now). However, when &man.nsgmls.1; is given the parameter, &man.nsgmls.1; will suppress its normal output, and @@ -564,7 +564,7 @@ Lists the Formal Public Identifier (FPI) Formal Public Identifier - for the DTD that this + for the DTD that this document conforms to. Your SGML parser will use this to find the correct DTD when processing this document. @@ -1147,7 +1147,7 @@ You could list the entities at the top of each book, but this quickly becomes cumbersome to manage. - Instead, place the general entity definitions inside one file, + Instead, place the general entity definitions inside one file, and use a parameter entity to include that file within your document. Index: structure/chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/fdp-primer/structure/chapter.sgml,v retrieving revision 1.6 diff -u -r1.6 chapter.sgml --- structure/chapter.sgml 11 Jun 2001 01:16:47 -0000 1.6 +++ structure/chapter.sgml 1 Oct 2001 23:50:00 -0000 @@ -270,12 +270,12 @@ own DOCTYPE lines at the start of the files. This is unfortunate as - it makes it impossible to treat these as generic SGML - files and simply convert them to HTML, RTF, PS, and other - formats in the same way the main Handbook is generated. This - would force you to rebuild the Handbook - every time you want to see the effect a change has had on just - one chapter. + it makes it impossible to treat these as generic SGML + files and simply convert them to HTML, RTF, PS, and other + formats in the same way the main Handbook is generated. This + would force you to rebuild the Handbook + every time you want to see the effect a change has had on just + one chapter. Index: the-website/chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/fdp-primer/the-website/chapter.sgml,v retrieving revision 1.5 diff -u -r1.5 chapter.sgml --- the-website/chapter.sgml 19 Aug 2001 23:54:35 -0000 1.5 +++ the-website/chapter.sgml 1 Oct 2001 23:50:52 -0000 @@ -86,7 +86,8 @@ &prompt.root; cvs -R co www doc - Change in to the www directory, and + + Change in to the www directory, and run the &man.make.1; links target, to create the necessary symbolic links. --- 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