From owner-svn-doc-all@FreeBSD.ORG Sun Jul 21 00:35:31 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id AE1E16E8; Sun, 21 Jul 2013 00:35:31 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 902ECB2B; Sun, 21 Jul 2013 00:35:31 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6L0ZVMg095984; Sun, 21 Jul 2013 00:35:31 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6L0ZVkt095983; Sun, 21 Jul 2013 00:35:31 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201307210035.r6L0ZVkt095983@svn.freebsd.org> From: Warren Block Date: Sun, 21 Jul 2013 00:35:31 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42333 - head/en_US.ISO8859-1/books/fdp-primer/docbook-markup X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 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: Sun, 21 Jul 2013 00:35:31 -0000 Author: wblock Date: Sun Jul 21 00:35:30 2013 New Revision: 42333 URL: http://svnweb.freebsd.org/changeset/doc/42333 Log: Add more entity definitions and a section on using acronym elements. Modified: head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/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 Sat Jul 20 20:46:28 2013 (r42332) +++ head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Sun Jul 21 00:35:30 2013 (r42333) @@ -125,7 +125,12 @@ &os; Entities - + These tables show some of the most useful entities + available in the FDP. For a complete list, + see the *.ent files in + doc/share/xml. + +
&os; Name Entities @@ -155,7 +160,48 @@
- +
+ Manual Page Entities + + + + + Name + Expands To + Notes + + + + + + &man.ls.1; + &man.ls.1; + + Usage: &man.ls.1; is the manual page for commandlscommand. + + + + &man.cp.1; + &man.cp.1; + + Usage: The manual page for commandcpcommand is &man.cp.1;. + + + + &man.command.sectionnumber; + link to + command manual page in + section + sectionnumber + Entities are defined for all the &os; manual + pages. + + + +
+ + &os; Mailing List Entities @@ -194,7 +240,7 @@
- +
&os; Document Links @@ -242,7 +288,7 @@
- +
Other Operating System Name Entities @@ -276,7 +322,7 @@
- +
Miscellaneous Entities @@ -1285,13 +1331,44 @@ This is the file called 'foo2' paraHowever, make sure that the search does not go beyond the quoteboundary between local and public administrationquote, - as RFC 1535 calls it.para + as acronymRFCacronym 1535 calls it.para Appearance: However, make sure that the search does not go beyond the boundary between local and public - administration, as RFC 1535 calls it. + administration, as RFC 1535 calls it. + + + + + Acronyms + + Many computer terms are acronyms, + words formed from the first letter of each word in a + phrase. Acronyms are marked up into + acronym elements. It is helpful to the + reader when an acronym is defined on the first use, as shown + in the example below. + + + Acronyms + + Usage: + + paraRequest For Comments (acronymRFCacronym) 1149 + defined the use of avian carriers for transmission of + Internet Protocol (acronymIPacronym) data + transmission. The quantity of acronymIPacronym data + transmitted since then is unknown.para + + Appearance: + + Request For Comments (RFC) 1149 + defined the use of avian carriers for transmission of + Internet Protocol (IP) data + transmission. The quantity of IP data + transmitted since then is unknown.