From owner-freebsd-doc@FreeBSD.ORG  Sat Sep 22 17:06:10 2007
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 3781116A420;
	Sat, 22 Sep 2007 17:06:10 +0000 (UTC) (envelope-from marck@rinet.ru)
Received: from woozle.rinet.ru (woozle.rinet.ru [195.54.192.68])
	by mx1.freebsd.org (Postfix) with ESMTP id AAB7C13C478;
	Sat, 22 Sep 2007 17:06:09 +0000 (UTC) (envelope-from marck@rinet.ru)
Received: from localhost (localhost [127.0.0.1])
	by woozle.rinet.ru (8.14.1/8.14.1) with ESMTP id l8MGtudS060930;
	Sat, 22 Sep 2007 20:55:56 +0400 (MSD) (envelope-from marck@rinet.ru)
Date: Sat, 22 Sep 2007 20:55:56 +0400 (MSD)
From: Dmitry Morozovsky <marck@rinet.ru>
To: Ben Kaduk <minimarmot@gmail.com>
In-Reply-To: <47d0403c0709220946q323af62ah1c4565b31f2677a@mail.gmail.com>
Message-ID: <20070922205156.K70319@woozle.rinet.ru>
References: <47d0403c0709211213n50988b33u2b9bdd15475bfcdd@mail.gmail.com>
	<1217454532.20070922005116@rulez.sk> <46F541FD.8040807@freebsd.org>
	<47d0403c0709220946q323af62ah1c4565b31f2677a@mail.gmail.com>
X-NCC-RegID: ru.rinet
X-OpenPGP-Key-ID: 6B691B03
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-3.0
	(woozle.rinet.ru [0.0.0.0]); Sat, 22 Sep 2007 20:55:56 +0400 (MSD)
Cc: "Bruce A. Mah" <bmah@freebsd.org>, freebsd-doc@freebsd.org
Subject: Re: sgml entities for CPU architectures?
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/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: Sat, 22 Sep 2007 17:06:10 -0000

On Sat, 22 Sep 2007, Ben Kaduk wrote:

BK> > >> I'm updating my patch to the FAQ (docs/115000) for danger@'s
BK> > >> (somewhat) new daily snapshot
BK> > >> builds, which are specific to x86 and amd64.  Should I just use literals for
BK> > >> these architectures, or are the entity-ified somewhere that I haven't found yet?
BK> > >
BK> > > As far as I know, we do not have entities for architectures.
BK> >
BK> > The release documents grew these entities fairly recently...see
BK> > src/release/doc/share/sgml/release.ent (on HEAD only at the moment).
BK> 
BK> But is release.ent pulled into the build of books/faq/book.sgml ?

I can see in share/sgml/freebsd.ent:

<!-- Entities for various architectures.  These are to be used
     only for denoting a variant of FreeBSD for a particular
     architecture (e.g. &os;/&arch.i386;).  Other entities should
     be used when referring generically to an architecture,
     particularly because entities such as &i386; properly
     denote trademarks and registered trademarks. -->
<!ENTITY arch.alpha "alpha">
<!ENTITY arch.amd64 "amd64">
<!ENTITY arch.arm "arm">
<!ENTITY arch.i386 "i386">
<!ENTITY arch.ia64 "ia64">
<!ENTITY arch.pc98 "pc98">
<!ENTITY arch.powerpc "powerpc">
<!ENTITY arch.sparc64 "sparc64">
<!ENTITY arch.sun4v "sun4v">

This is from rev 1.93 of freebsd.ent:

  date: 2007/08/11 19:17:41;  author: bmah;  state: Exp;  lines: +15 -0
  Add &arch.*; entities for the various architectures.  These
  should only be used when referring to a version of FreeBSD on
  a specific architecture, e.g. &os;/&arch.i386;.  Use other,
  already existing entities (such as &i386;) when talking generically
  about an architecture, in order to attribute trademarks correctly.


Sincerely,
D.Marck                                     [DM5020, MCK-RIPE, DM3-RIPN]
[ FreeBSD committer:				     marck@FreeBSD.org ]
------------------------------------------------------------------------
*** Dmitry Morozovsky --- D.Marck --- Wild Woozle --- marck@rinet.ru ***
------------------------------------------------------------------------