Date: Thu, 5 Jan 2006 14:00:21 GMT From: Ruslan Ermilov <ru@FreeBSD.org> To: freebsd-doc@FreeBSD.org Subject: Re: docs/90851: mdoc(7) manpage needs more FreeBSD versions Message-ID: <200601051400.k05E0L9t011715@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
The following reply was made to PR docs/90851; it has been noted by GNATS. From: Ruslan Ermilov <ru@FreeBSD.org> To: Ceri Davies <ceri@submonkey.net> Cc: freebsd-gnats-submit@FreeBSD.org, remko@FreeBSD.org, phk@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@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@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--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200601051400.k05E0L9t011715>