From owner-svn-doc-head@FreeBSD.ORG Wed Feb 26 03:50:59 2014 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 50F64382; Wed, 26 Feb 2014 03:50:59 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 323F51516; Wed, 26 Feb 2014 03:50:59 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s1Q3oxgW082121; Wed, 26 Feb 2014 03:50:59 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s1Q3owtx082115; Wed, 26 Feb 2014 03:50:58 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201402260350.s1Q3owtx082115@svn.freebsd.org> From: Warren Block Date: Wed, 26 Feb 2014 03:50:58 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44069 - in head/en_US.ISO8859-1/books/fdp-primer: docbook-markup examples overview the-website translations X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 26 Feb 2014 03:50:59 -0000 Author: wblock Date: Wed Feb 26 03:50:57 2014 New Revision: 44069 URL: http://svnweb.freebsd.org/changeset/doc/44069 Log: Restore tags lost during the DocBook5 conversion. Modified: head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml head/en_US.ISO8859-1/books/fdp-primer/examples/appendix.xml head/en_US.ISO8859-1/books/fdp-primer/overview/chapter.xml head/en_US.ISO8859-1/books/fdp-primer/the-website/chapter.xml head/en_US.ISO8859-1/books/fdp-primer/translations/chapter.xml Modified: head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Wed Feb 26 03:27:51 2014 (r44068) +++ head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Wed Feb 26 03:50:57 2014 (r44069) @@ -196,7 +196,7 @@ - &man.command.sectionnumber; + &man.command.sectionnumber; link to command manual page in section @@ -232,7 +232,7 @@ - &a.listname; + &a.listname; link to listname Entities are defined for all the - &url.books.bookname; + &url.books.bookname; relative path to bookname Entities are defined for all the - &url.articles.articlename; + &url.articles.articlename; relative path to articlename Entities are defined for all the general entities have been created to make this easier. Each entity takes the form - &man.manual-page.manual-section;. + &man.manual-page.manual-section;. The file that contains these entities is in doc/share/xml/man-refs.ent, and can be @@ -1497,7 +1497,7 @@ This is the file called 'foo2' When referring to the same command multiple times in close proximity, it is preferred to use the - &man.command.section; + &man.command.section; notation to markup the first reference and use command to markup subsequent references. This makes the generated output, especially @@ -1549,7 +1549,7 @@ This is the file called 'foo2' Notice how the - &man.command.section; + &man.command.section; notation is easier to follow. @@ -1980,7 +1980,7 @@ This is the file called 'foo2' Appearance: The - maxusers n + maxusers n line in the kernel configuration file determines the size of many system tables, and is a rough guide to how many simultaneous logins the system will support. Modified: head/en_US.ISO8859-1/books/fdp-primer/examples/appendix.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/examples/appendix.xml Wed Feb 26 03:27:51 2014 (r44068) +++ head/en_US.ISO8859-1/books/fdp-primer/examples/appendix.xml Wed Feb 26 03:50:57 2014 (r44069) @@ -171,7 +171,7 @@ -c /usr/local/share/xml/docbook/catalog \ -c /usr/local/share/xml/jade/catalog \ -d /usr/local/share/xml/docbook/dsssl/modular/html/docbook.dsl \ - -t sgml file.xml > file.html + -t sgml file.xml > file.html @@ -226,7 +226,7 @@ -c /usr/local/share/xml/docbook/catalog \ -c /usr/local/share/xml/jade/catalog \ -d /usr/local/share/xml/docbook/dsssl/modular/html/docbook.dsl \ - -t sgml file.xml + -t sgml file.xml @@ -283,7 +283,7 @@ -c /usr/local/share/xml/docbook/catalog \ -c /usr/local/share/xml/jade/catalog \ -d /usr/local/share/xml/docbook/dsssl/modular/print/docbook.dsl \ - -t tex file.xml + -t tex file.xml @@ -319,7 +319,7 @@ run through tex, specifying the &jadetex macro package. - &prompt.user; tex "&jadetex" file.tex + &prompt.user; tex "&jadetex" file.tex tex commands must be run at least three times. The first run @@ -341,12 +341,12 @@ necessary. The output from this stage will be - file.dvi. + file.dvi. Finally, run dvips to convert the .dvi file to &postscript;. - &prompt.user; dvips -o file.ps file.dvi + &prompt.user; dvips -o file.ps file.dvi @@ -361,12 +361,12 @@ However, use the &pdfjadetex macro package instead. - &prompt.user; pdftex "&pdfjadetex" file.tex + &prompt.user; pdftex "&pdfjadetex" file.tex Again, run this command three times. This will generate - file.pdf, + file.pdf, which does not need to be processed any further. Modified: head/en_US.ISO8859-1/books/fdp-primer/overview/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/overview/chapter.xml Wed Feb 26 03:27:51 2014 (r44068) +++ head/en_US.ISO8859-1/books/fdp-primer/overview/chapter.xml Wed Feb 26 03:50:57 2014 (r44069) @@ -156,7 +156,7 @@ ~/doc (see ). - &prompt.user; svn checkout https://svn0.us-west.FreeBSD.org/doc/head ~/doc + &prompt.user; svn checkout https://svn0.us-west.FreeBSD.org/doc/head ~/doc @@ -184,7 +184,7 @@ Update the local working copy: - &prompt.user; svn up ~/doc + &prompt.user; svn up ~/doc @@ -224,7 +224,7 @@ diff file: &prompt.user; cd /usr/doc -&prompt.user; svn diff > bsdinstall.diff.txt +&prompt.user; svn diff > bsdinstall.diff.txt Give the diff file a descriptive name. In the example above, changes have been made to the Modified: head/en_US.ISO8859-1/books/fdp-primer/the-website/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/the-website/chapter.xml Wed Feb 26 03:27:51 2014 (r44068) +++ head/en_US.ISO8859-1/books/fdp-primer/the-website/chapter.xml Wed Feb 26 03:50:57 2014 (r44069) @@ -38,7 +38,7 @@ Having obtained the documentation and web site source files, the web site can be built. In this example, the build directory - is ~/doc + is ~/doc and all the required files are already in place. The web site is built from the @@ -76,7 +76,7 @@ jru in their home directory, /usr/home/jru/doc. &prompt.root; cd /home/jru/doc/en_US.ISO8859-1/htdocs -&prompt.root; env DESTDIR=/usr/local/www make install +&prompt.root; env DESTDIR=/usr/local/www make install The install process will not delete any old or outdated files that existed previously in the same directory. If a new @@ -84,7 +84,7 @@ will find and delete all files that have not been updated in three days. - &prompt.root; find /usr/local/www -ctime 3 -delete + &prompt.root; find /usr/local/www -ctime 3 -delete @@ -129,7 +129,7 @@ If set, build or install only for the languages - specified by this variable inside the ~/doc + specified by this variable inside the ~/doc directory. All other languages except English will be ignored. E.g.: Modified: head/en_US.ISO8859-1/books/fdp-primer/translations/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/translations/chapter.xml Wed Feb 26 03:27:51 2014 (r44068) +++ head/en_US.ISO8859-1/books/fdp-primer/translations/chapter.xml Wed Feb 26 03:50:57 2014 (r44069) @@ -135,7 +135,7 @@ copy of the FreeBSD Subversion repository (at least the documentation part). This can be done by running: - &prompt.user; svn checkout https://svn0.us-east.FreeBSD.org/doc/head/ head + &prompt.user; svn checkout https://svn0.us-east.FreeBSD.org/doc/head/ head svn0.us-east.FreeBSD.org is a public SVN server. @@ -158,7 +158,7 @@ en_US.ISO8859-1/books/fdp-primer/book.xml, run: - &prompt.user; svn diff -r33733:33734 en_US.ISO8859-1/books/fdp-primer/book.xml + &prompt.user; svn diff -r33733:33734 en_US.ISO8859-1/books/fdp-primer/book.xml @@ -284,7 +284,7 @@ sv_SE.ISO8859-1 is the name of the translation, in - lang.encoding + lang.encoding form. Note the two Makefiles, which will be used to build the documentation. @@ -465,7 +465,7 @@ Your translated documents should include their own $FreeBSD$ line, and change the FreeBSD Documentation Project line to - The FreeBSD language + The FreeBSD language Documentation Project. In addition, you should add a third line which indicates