From owner-freebsd-doc Wed Aug 21 8: 0:21 2002 Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 9166437B401; Wed, 21 Aug 2002 08:00:15 -0700 (PDT) Received: from abigail.blackend.org (blackend.org [212.11.50.35]) by mx1.FreeBSD.org (Postfix) with ESMTP id 8D63743E42; Wed, 21 Aug 2002 08:00:13 -0700 (PDT) (envelope-from marc@blackend.org) Received: from marduk.blackend.org (marduk.blackend.org [192.168.1.202]) by abigail.blackend.org (8.12.3/8.12.3/ - 15/04/02) with ESMTP id g7LEx0G4091192; Wed, 21 Aug 2002 16:59:00 +0200 (CEST) (envelope-from marc@abigail.blackend.org) Received: from marduk.blackend.org (localhost [127.0.0.1]) by marduk.blackend.org (8.12.5/8.12.5) with ESMTP id g7LF0jLV001203; Wed, 21 Aug 2002 17:00:45 +0200 (CEST) (envelope-from marc@localhost.blackend.org) Received: (from marc@localhost) by marduk.blackend.org (8.12.5/8.12.5/Submit) id g7LF0jJq001202; Wed, 21 Aug 2002 17:00:45 +0200 (CEST) (envelope-from marc) Date: Wed, 21 Aug 2002 17:00:45 +0200 From: Marc Fonvieille To: Giorgos Keramidas Cc: freebsd-doc@FreeBSD.org Subject: Re: Entities for some   instances (was: cvs commit: doc/en_US.ISO8859-1/books/faq book.sgml) Message-ID: <20020821170044.B1056@marduk.blackend.org> References: <200208131114.g7DBEjVW065709@freefall.freebsd.org> <20020821115929.GB81256@hades.hell.gr> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5.1i In-Reply-To: <20020821115929.GB81256@hades.hell.gr>; from keramida@FreeBSD.org on Wed, Aug 21, 2002 at 02:59:29PM +0300 X-Useless-Header: blackend.org X-Operating-System: FreeBSD 4.6-STABLE Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org On Wed, Aug 21, 2002 at 02:59:29PM +0300, Giorgos Keramidas wrote: > On 2002-08-13 04:14 +0000, Marc Fonvieille wrote: > > Log: > > Explain how a partition can be more than 100% full. > > While I'm there: > > -stable/-STABLE, Windows-95 and Windows95 --> Windows 95 > > > Revision Changes Path > > 1.463 +26 -3 doc/en_US.ISO8859-1/books/faq/book.sgml > > I'd probably prefer &ms.win.95; that expands to something like: > > Microsoft Windows 95 Indeed it's a better solution. > > and similar entities that ensure that when our documents are typeset > and beautifuly printed on paper, there is absolutely *no* chance of > something like this appearing on paper (depending on existing margins > and paper size, of course): > > ... Microsoft Windows > 95 ... > > The &ms.*; entities could also include stuff like: > > &ms.dos.6; > &ms.office.97; > > But I'm very skeptical about introducing entities for stuff like this. > The main intention would be to make it easier to type consistently > something that looks prettier than "foo bar" and is not as hard > to remember. Does this sound crazy to anyone? Entities creation is maybe not needed for something not used "on every page", but the code is easier to read, and I think about people using many sgml codes: have a look to one sgml file of the french Handbook for example :))) It's a really nightmare :))) As you said entities have another benefit: the consistency between all docs. But I should *shut up* cause I forgot to use &os.current; and &os.stable; in a previous commit :) Marc To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message