From owner-freebsd-doc@FreeBSD.ORG  Tue Jul 16 02:25:43 2013
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115])
 by hub.freebsd.org (Postfix) with ESMTP id B849B5BE
 for <doc@freebsd.org>; Tue, 16 Jul 2013 02:25:43 +0000 (UTC)
 (envelope-from wblock@wonkity.com)
Received: from wonkity.com (wonkity.com [67.158.26.137])
 by mx1.freebsd.org (Postfix) with ESMTP id 7AB548A4
 for <doc@freebsd.org>; Tue, 16 Jul 2013 02:25:43 +0000 (UTC)
Received: from wonkity.com (localhost [127.0.0.1])
 by wonkity.com (8.14.7/8.14.7) with ESMTP id r6G2PbCD075028
 for <doc@freebsd.org>; Mon, 15 Jul 2013 20:25:37 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
 by wonkity.com (8.14.7/8.14.7/Submit) with ESMTP id r6G2Pbso075025
 for <doc@freebsd.org>; Mon, 15 Jul 2013 20:25:37 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Date: Mon, 15 Jul 2013 20:25:37 -0600 (MDT)
From: Warren Block <wblock@wonkity.com>
To: doc@freebsd.org
Subject: Entities: DocBook versus XHTML
Message-ID: <alpine.BSF.2.00.1307152011350.74094@wonkity.com>
User-Agent: Alpine 2.00 (BSF 1167 2008-08-23)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3
 (wonkity.com [127.0.0.1]); Mon, 15 Jul 2013 20:25:37 -0600 (MDT)
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Tue, 16 Jul 2013 02:25:43 -0000

The FDP Primer, which I have been bludgeoning lately, has no section 
that really tells the basic FreeBSD-specific entities available, either 
in XHTML or DocBook or both.

The XHTML section does not show the correct way to refer to a Handbook 
chapter or an article.

&os; is only used a couple of times in the entire FDP Primer, and those 
are new, and I added them!

So please, let's collect a list of the most basic entities, and add it. 
I'm also curious to know why some but not all of the DocBook entities 
can be used in XHTML.


FreeBSD DocBook Entities
   Entity Name		Expands To
   ------------------------------------
   &os;			FreeBSD
   &os.current;		FreeBSD-CURRENT
   &os.stable;		FreeBSD-STABLE
   &url.books.handbook;	../../../..

Effectively, that last one works out to 
http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook


FreeBSD XHTML Entities
   Entity Name      Expands To
   ------------------------------------
   &base;           http://www.freebsd.org