Skip site navigation (1)Skip section navigation (2)
Date:      Fri, 18 Oct 2002 13:04:25 -0700
From:      "Bruce A. Mah" <bmah@FreeBSD.ORG>
To:        Marc Fonvieille <blackend@FreeBSD.ORG>
Cc:        freebsd-doc@FreeBSD.ORG
Subject:   Re: HEADS UP: Use of -CURRENT manual pages in our docs 
Message-ID:  <200210182004.g9IK4PDE076732@intruder.bmah.org>
In-Reply-To: <20021018212220.B50649@abigail.blackend.org> 
References:  <20021018212220.B50649@abigail.blackend.org>

next in thread | previous in thread | raw e-mail | index | archive | help
--==_Exmh_-2084157920P
Content-Type: text/plain; charset=us-ascii

If memory serves me right, Marc Fonvieille wrote:

> It is now possible to make the difference between -STABLE and
> -CURRENT manual pages.
> 
> We need this for devfs, device.hints etc. manual pages in our Handbook.
> Manual pages entities for -CURRENT should have the form:
> 
> &man.current.foo.1;
> 
> Have a look to man-refs.ent and devfs(5) entity for more details.
> 
> An "old" man.devfs.5 entity is kept to allow the build of localized
> docs till their upgrade. Translation teams should upgrade their
> freebsd.dsl file and then basics and boot chapters.
> 
> Note, this does not concern release notes but only documentation.

For the curious, the reason this doesn't (or shouldn't) affect
RELNOTESng is that src/release/doc uses its own stylesheet that
explicitly sets what manpage set to use for hyperlink cross-references.
This lets the release documentation use a set of manpages appropriate to
each release.

The doc/ tree uses whatever default is defined by man.cgi.

Waitasec.  You're not going to *get rid* of the &man.devfs.5; entity 
are you?

Remember that -STABLE isn't always going to be 4-STABLE.  When 5-STABLE 
happens, it's going to be pretty weird to force authors to use 
&man.current.devfs.5;.

Bruce.



--==_Exmh_-2084157920P
Content-Type: application/pgp-signature

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.0 (FreeBSD)
Comment: Exmh version 2.5+ 20020506

iD8DBQE9sGlI2MoxcVugUsMRAqh8AKCs5hquthYLd0GX09SluHSmS4NjbACdHK6e
mLjm9MbdzRNM5kvOnOm+bgA=
=5fxG
-----END PGP SIGNATURE-----

--==_Exmh_-2084157920P--

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?200210182004.g9IK4PDE076732>