docs/90851: mdoc(7) manpage needs more FreeBSD versions

[Ruslan Ermilov]

The following reply was made to PR docs/90851; it has been noted by GNATS.

From: Ruslan Ermilov <ru at FreeBSD.org>
To: Ceri Davies <ceri at submonkey.net>
Cc: freebsd-gnats-submit at FreeBSD.org, remko at FreeBSD.org, phk at FreeBSD.org
Subject: Re: docs/90851: mdoc(7) manpage needs more FreeBSD versions
Date: Thu, 5 Jan 2006 15:54:09 +0200

 --rBVNTu5JXDAWzN2S
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 Content-Transfer-Encoding: quoted-printable
 
 On Mon, Jan 02, 2006 at 05:23:53PM +0000, Ceri Davies wrote:
 >=20
 > On 1 Jan 2006, at 23:00, Poul-Henning Kamp wrote:
 > > In message <20060101194413.GA73743 at elvandar.org>, Remko Lodder =20
 > >writes:
 > >>On Fri, Dec 23, 2005 at 01:34:42PM +0100, Poul-Henning Kamp wrote:
 > >>>>Description:
 > >>>
 > >>>	The mdoc(7) manual enumerates (pointlessly in my opinion) the =20
 > >>>various releases
 > >>>	of FreeBSD that can be specified to the Os and Fx macros:
 > >>>
 > >>>                  FreeBSD  1.0, 1.1, 1.1.5, 1.1.5.1, 2.0, 2.0.5, =20
 > >>>2.1, 2.1.5,
 > >>>                            2.1.6, 2.1.7, 2.2, 2.2.1, 2.2.2, =20
 > >>>2.2.5, 2.2.6,
 > >>>                            2.2.7, 2.2.8, 3.0, 3.1, 3.2, 3.3, =20
 > >>>3.4, 3.5, 4.0,
 > >>>                            4.1, 4.1.1, 4.2, 4.3, 4.4, 4.5, 4.6, =20
 > >>>4.6.2, 4.7,
 > >>>                            4.8, 4.9, 4.10, 5.0, 5.1, 5.2, 5.2.1, =20
 > >>>5.3
 > >>>
 > >>>	The list should either be kept up to date, or more sensibly be =20
 > >>>replaced with
 > >>>
 > >>>		FreeBSD  1.0, 1.1, 1.1.5, 2.0, 2.0.5, etc. etc.
 > >>>
 > >>>
 > >>
 > >>Hi Poul-Henning,
 > >>
 > >>  Does the diff below look reasonable?
 > >
 > > Is it a more future proof solution to just list a handful and add =20
 > >"etc" ?
 >=20
 > We should ask Ruslan whether we can rely on them all being supported.
 >=20
 The -mdoc warns when an incorrect version is supplied as an argument,
 and it helps improve the quality of documentation.  If we just replace
 the list with "etc. etc." it's in my opinion not different to not
 keeping it up-to-date.  We and our BSD brothers did a good job until
 now to keep the list regularly updated, so I don't see a reason to
 not continue doing it now.  You have a Groff maintainer in FreeBSD,
 me, who's also co-authoring the next-generation -mdoc code, so you
 have the point of contact.  I suggest that this discussion stops with
 the patches being sent upstream.  In fact, I already have such patches
 and will send them upstream when I have time for this.
 
 Happy New Year to you all!
 
 
 Cheers,
 --=20
 Ruslan Ermilov
 ru at FreeBSD.org
 FreeBSD committer
 
 --rBVNTu5JXDAWzN2S
 Content-Type: application/pgp-signature
 Content-Disposition: inline
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.4.2 (FreeBSD)
 
 iD8DBQFDvSUBqRfpzJluFF4RAtRcAKCXsexklh7ux96AwVQyAaWzK+9yeACeILkj
 12Paer8qu/lhTroiHoRwF8g=
 =8/N5
 -----END PGP SIGNATURE-----
 
 --rBVNTu5JXDAWzN2S--