Skip site navigation (1)Skip section navigation (2)
Date:      Fri, 31 May 2002 01:48:19 -0700
From:      Tom Rhodes <darklogik@pittgoth.com>
To:        Nik Clayton <nik@FreeBSD.ORG>
Cc:        Tom Rhodes <trhodes@FreeBSD.ORG>, Chris Pepper <pepper@reppep.com>, keramida@FreeBSD.ORG, freebsd-doc@FreeBSD.ORG
Subject:   Re: (man page || manpage) => manual page
Message-ID:  <3CF738D3.4070205@pittgoth.com>
References:  <20020529214746.GA67346@hades.hell.gr> <p05111a1bb91affba8a28@[129.85.219.160]> <20020529183350.314b0f2a.trhodes@FreeBSD.org> <20020530081201.M64264@canyon.nothing-going-on.org>

next in thread | previous in thread | raw e-mail | index | archive | help
Nik Clayton wrote:

>On Wed, May 29, 2002 at 06:33:50PM -0400, Tom Rhodes wrote:
>
>>Entities allow you to assign a name to some chunk of data, and
>>
>[...]
>
>>file.
>>
>
>This bit's correct.
>
>>Our man tags are custom to the FreeBSD project, taking the user/reader
>>to our version of the specified manual page.  Many manual pages differ from
>>operating system to operating system (for instance, drivers) and this
>>lets us define a link to a man page search engine...
>>
>>This also differs in fact that, the man entity is not standard in
>>html or DocBook for that matter (unless you define it), unlike the
>>usual: &copy; &trade; that works in HTML and DocBook (others?)
>>
>
>This bit isn't.
>
>The various entities that we use (&man., &a., &os., &rel., &gui., ...)
>are purely to cut down the amount of typing the document author has to
>do, and to try and ensure consistency between different documents.  It's
>got nothing to do with any links that might be automatically generated
>in the documentation.
>
>N
>
Well, its sort of correct in the fact that, you can define your own 
entities...  But I did get
why the docproj uses em wrong ;)

--
Tom (who's fighting with his new laptop and may be difficult to reach)



To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message




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