From owner-freebsd-doc@FreeBSD.ORG Thu Jan 5 14:00:21 2006 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id D7F8316A41F for ; Thu, 5 Jan 2006 14:00:21 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7EC8943D48 for ; Thu, 5 Jan 2006 14:00:21 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.4/8.13.4) with ESMTP id k05E0LMi011716 for ; Thu, 5 Jan 2006 14:00:21 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.4/8.13.4/Submit) id k05E0L9t011715; Thu, 5 Jan 2006 14:00:21 GMT (envelope-from gnats) Date: Thu, 5 Jan 2006 14:00:21 GMT Message-Id: <200601051400.k05E0L9t011715@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Ruslan Ermilov Cc: Subject: Re: docs/90851: mdoc(7) manpage needs more FreeBSD versions X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Ruslan Ermilov List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 05 Jan 2006 14:00:22 -0000 The following reply was made to PR docs/90851; it has been noted by GNATS. From: Ruslan Ermilov To: Ceri Davies 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--