From owner-freebsd-doc@FreeBSD.ORG  Tue Aug 10 00:10:24 2004
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
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 7007916A4D1
	for <freebsd-doc@freebsd.org>; Tue, 10 Aug 2004 00:10:24 +0000 (GMT)
Received: from aiolos.otenet.gr (aiolos.otenet.gr [195.170.0.23])
	by mx1.FreeBSD.org (Postfix) with ESMTP id ACFA843D3F
	for <freebsd-doc@freebsd.org>; Tue, 10 Aug 2004 00:10:23 +0000 (GMT)
	(envelope-from keramida@freebsd.org)
Received: from gothmog.gr (patr530-b195.otenet.gr [212.205.244.203])
	i7A0AJ64005756;	Tue, 10 Aug 2004 03:10:21 +0300
Received: from gothmog.gr (gothmog [127.0.0.1])
	by gothmog.gr (8.13.1/8.13.1) with ESMTP id i7A09YGR038901;
	Tue, 10 Aug 2004 03:09:34 +0300 (EEST)
	(envelope-from keramida@freebsd.org)
Received: (from giorgos@localhost)
	by gothmog.gr (8.13.1/8.13.1/Submit) id i7A09Xn0038900;
	Tue, 10 Aug 2004 03:09:33 +0300 (EEST)
	(envelope-from keramida@freebsd.org)
Date: Tue, 10 Aug 2004 03:09:32 +0300
From: Giorgos Keramidas <keramida@freebsd.org>
To: Hilko Meyer <Hilko.Meyer@gmx.de>
Message-ID: <20040810000932.GA23836@gothmog.gr>
References: <4q0gh05ot2512gvv7hjjm6q6so4bbof3er@smtp.compuserve.de>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <4q0gh05ot2512gvv7hjjm6q6so4bbof3er@smtp.compuserve.de>
cc: freebsd-doc@freebsd.org
Subject: Re: Handbook-appearance in Opera
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
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: Tue, 10 Aug 2004 00:10:24 -0000

On 2004-08-10 01:43, Hilko Meyer <Hilko.Meyer@gmx.de> wrote:
> I've spotted some some problems in
> http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/network-nis.html
> [...]
> And there is another nit. Around "NIS domainname" some tags are missing.
> The other entries are shown bold. If I understand the sgml-code correct,
> the following should fix that.

The rest of the entries are shown in bold because they are "application
names".  The string "NIS domainname" is not an application name so it
shouldn't be marked up as one.

> --- chapter.sgml        Mon Aug  9 20:21:21 2004
> +++ chapter-mod.sgml    Mon Aug  9 20:27:00 2004
> @@ -1195,7 +1195,7 @@
>           </thead>
>           <tbody>
>             <row>
> -             <entry>NIS domainname</entry>
> +             <entry><application>NIS domainname</application></entry>
>  
>               <entry>An NIS master server and all of its clients
>                 (including its slave servers) have a NIS domainname.

No, please.  The semantics of the <application> element should be not
abused just to get a "look and feel that we like".  If the rest of the
application names look odd because of their bold font we should probably
consider removing the application tags from the rest instead.  A lot of
bold words sprinkled in a seemingly random manner among running text
look worse than something that abuses the <application> element IMHO.

This is, of course, my own personal opinion and should be taken with a
grain of salt ;-)

- Giorgos