Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 10 Aug 2004 03:09:32 +0300
From:      Giorgos Keramidas <keramida@freebsd.org>
To:        Hilko Meyer <Hilko.Meyer@gmx.de>
Cc:        freebsd-doc@freebsd.org
Subject:   Re: Handbook-appearance in Opera
Message-ID:  <20040810000932.GA23836@gothmog.gr>
In-Reply-To: <4q0gh05ot2512gvv7hjjm6q6so4bbof3er@smtp.compuserve.de>
References:  <4q0gh05ot2512gvv7hjjm6q6so4bbof3er@smtp.compuserve.de>

next in thread | previous in thread | raw e-mail | index | archive | help
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



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20040810000932.GA23836>