From owner-svn-doc-all@FreeBSD.ORG Mon May 21 14:25:09 2012 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 90BA3106566B; Mon, 21 May 2012 14:25:09 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c]) by mx1.freebsd.org (Postfix) with ESMTP id 7ABFC8FC15; Mon, 21 May 2012 14:25:09 +0000 (UTC) Received: from svn.freebsd.org (localhost [127.0.0.1]) by svn.freebsd.org (8.14.4/8.14.4) with ESMTP id q4LEP2v9061535; Mon, 21 May 2012 14:25:02 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.4/8.14.4/Submit) id q4LEP2i6061533; Mon, 21 May 2012 14:25:02 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201205211425.q4LEP2i6061533@svn.freebsd.org> From: Warren Block Date: Mon, 21 May 2012 14:25:02 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cc: Subject: svn commit: r38869 - head/en_US.ISO8859-1/books/fdp-primer/stylesheets X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 21 May 2012 14:25:09 -0000 Author: wblock Date: Mon May 21 14:25:02 2012 New Revision: 38869 URL: http://svn.freebsd.org/changeset/doc/38869 Log: Whitespace-only commits, wrap long lines and remove whitespace from blank lines. Translators, please ignore. Modified: head/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.sgml Modified: head/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.sgml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.sgml Mon May 21 14:21:16 2012 (r38868) +++ head/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.sgml Mon May 21 14:25:02 2012 (r38869) @@ -32,50 +32,53 @@ * Stylesheets - - SGML says nothing about how a document should be displayed to the - user, or rendered on paper. To do that, various languages have been - developed to describe stylesheets, including DynaText, Panorama, SPICE, - JSSS, FOSI, CSS, and DSSSL. - - For DocBook, we are using stylesheets written in DSSSL. For HTML we - are using CSS. + + SGML says nothing about how a document should be displayed to + the user, or rendered on paper. To do that, various languages + have been developed to describe stylesheets, including DynaText, + Panorama, SPICE, JSSS, FOSI, CSS, and DSSSL. + + For DocBook, we are using stylesheets written in DSSSL. For + HTML we are using CSS. * DSSSL - - The Documentation Project uses a slightly customized version of - Norm Walsh's modular DocBook stylesheets. - - These can be found in - textproc/dsssl-docbook-modular. - - The modified stylesheets are not in the ports system. Instead they - are part of the Documentation Project source repository, and can be - found in doc/share/sgml/freebsd.dsl. It is well - commented, and pending completion of this section you are encouraged to - examine that file to see how some of the available options in the - standard stylesheets have been configured in order to customize the - output for the FreeBSD Documentation Project. That file also contains - examples showing how to extend the elements that the stylesheet - understands, which is how the FreeBSD specific elements have been - formatted. + + The Documentation Project uses a slightly customized version + of Norm Walsh's modular DocBook stylesheets. + + These can be found in textproc/dsssl-docbook-modular. + + The modified stylesheets are not in the ports system. + Instead they are part of the Documentation Project source + repository, and can be found in + doc/share/sgml/freebsd.dsl. It is well + commented, and pending completion of this section you are + encouraged to examine that file to see how some of the available + options in the standard stylesheets have been configured in + order to customize the output for the FreeBSD Documentation + Project. That file also contains examples showing how to extend + the elements that the stylesheet understands, which is how the + FreeBSD specific elements have been formatted. CSS - Cascading Stylesheets (CSS) are a mechanism for attaching style - information (font, weight, size, color, and so forth) to elements in an - HTML document without abusing HTML to do so. + Cascading Stylesheets (CSS) are a mechanism for attaching + style information (font, weight, size, color, and so forth) to + elements in an HTML document without abusing HTML to do + so. The DocBook Documents - The FreeBSD DSSSL stylesheets include a reference to a stylesheet, - docbook.css, which is expected to appear in the - same directory as the HTML files. The project-wide CSS file is copied - from doc/share/misc/docbook.css when documents + The FreeBSD DSSSL stylesheets include a reference to a + stylesheet, docbook.css, which is + expected to appear in the same directory as the HTML files. + The project-wide CSS file is copied from + doc/share/misc/docbook.css when documents are converted to HTML, and is installed automatically.