From phk@critter.freebsd.dk  Fri Dec 23 12:34:45 2005
Return-Path: <phk@critter.freebsd.dk>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id E00F116A420
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 23 Dec 2005 12:34:45 +0000 (GMT)
	(envelope-from phk@critter.freebsd.dk)
Received: from phk.freebsd.dk (phk.freebsd.dk [130.225.244.222])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 1CCBB43D5E
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 23 Dec 2005 12:34:45 +0000 (GMT)
	(envelope-from phk@critter.freebsd.dk)
Received: from critter.freebsd.dk (unknown [192.168.48.2])
	by phk.freebsd.dk (Postfix) with ESMTP id 679FEBC66
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 23 Dec 2005 12:34:43 +0000 (UTC)
Received: from critter.freebsd.dk (localhost [127.0.0.1])
	by critter.freebsd.dk (8.13.4/8.13.4) with ESMTP id jBNCYgl7027511
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 23 Dec 2005 13:34:42 +0100 (CET)
	(envelope-from phk@critter.freebsd.dk)
Received: (from phk@localhost)
	by critter.freebsd.dk (8.13.4/8.13.4/Submit) id jBNCYgUu027510;
	Fri, 23 Dec 2005 13:34:42 +0100 (CET)
	(envelope-from phk)
Message-Id: <200512231234.jBNCYgUu027510@critter.freebsd.dk>
Date: Fri, 23 Dec 2005 13:34:42 +0100 (CET)
From: Poul-Henning Kamp <phk@critter.freebsd.dk>
Reply-To: Poul-Henning Kamp <phk@critter.freebsd.dk>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: mdoc(7) manpage needs more FreeBSD versions
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         90851
>Category:       docs
>Synopsis:       mdoc(7) manpage needs more FreeBSD versions
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    remko
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Dec 23 12:40:03 GMT 2005
>Closed-Date:    Mon Mar 13 19:44:26 GMT 2006
>Last-Modified:  Mon Mar 13 19:44:26 GMT 2006
>Originator:     Poul-Henning Kamp
>Release:        FreeBSD 7.0-CURRENT i386
>Organization:
>Environment:
System: FreeBSD critter.freebsd.dk 7.0-CURRENT FreeBSD 7.0-CURRENT #9: Thu Dec 15 12:04:28 CET 2005 root@critter.freebsd.dk:/freebsd/src/sys/i386/compile/CRITTER i386


	
>Description:

	The mdoc(7) manual enumerates (pointlessly in my opinion) the 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, 2.1, 2.1.5,
                            2.1.6, 2.1.7, 2.2, 2.2.1, 2.2.2, 2.2.5, 2.2.6,
                            2.2.7, 2.2.8, 3.0, 3.1, 3.2, 3.3, 3.4, 3.5, 4.0,
                            4.1, 4.1.1, 4.2, 4.3, 4.4, 4.5, 4.6, 4.6.2, 4.7,
                            4.8, 4.9, 4.10, 5.0, 5.1, 5.2, 5.2.1, 5.3

	The list should either be kept up to date, or more sensibly be replaced with

		FreeBSD  1.0, 1.1, 1.1.5, 2.0, 2.0.5, etc. etc.


>How-To-Repeat:
	
>Fix:

	


>Release-Note:
>Audit-Trail:

From: Remko Lodder <remko@elvandar.org>
To: Poul-Henning Kamp <phk@critter.freebsd.dk>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/90851: mdoc(7) manpage needs more FreeBSD versions
Date: Sun, 1 Jan 2006 20:44:13 +0100

 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 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, 2.1, 2.1.5,
 >                             2.1.6, 2.1.7, 2.2, 2.2.1, 2.2.2, 2.2.5, 2.2.6,
 >                             2.2.7, 2.2.8, 3.0, 3.1, 3.2, 3.3, 3.4, 3.5, 4.0,
 >                             4.1, 4.1.1, 4.2, 4.3, 4.4, 4.5, 4.6, 4.6.2, 4.7,
 >                             4.8, 4.9, 4.10, 5.0, 5.1, 5.2, 5.2.1, 5.3
 > 
 > 	The list should either be kept up to date, or more sensibly be 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?
 
    (Added NetBSD release 3.0 as well).
 
 Index: groff_mdoc.man
 ===================================================================
 RCS file: /home/ncvs/src/contrib/groff/tmac/groff_mdoc.man,v
 retrieving revision 1.1.1.19
 diff -u -r1.1.1.19 groff_mdoc.man
 --- groff_mdoc.man	20 Oct 2005 10:45:18 -0000	1.1.1.19
 +++ groff_mdoc.man	1 Jan 2006 19:42:03 -0000
 @@ -863,12 +863,12 @@
  .It NetBSD
  0.8, 0.8a, 0.9, 0.9a, 1.0, 1.0a, 1.1, 1.2, 1.2a, 1.2b, 1.2c, 1.2d, 1.2e,
  1.3, 1.3a, 1.4, 1.4.1, 1.4.2, 1.4.3, 1.5, 1.5.1, 1.5.2, 1.5.3, 1.6, 1.6.1,
 -1.6.2, 2.0, 2.0.1, 2.0.2, 2.1
 +1.6.2, 2.0, 2.0.1, 2.0.2, 2.1, 3.0
  .It FreeBSD
  1.0, 1.1, 1.1.5, 1.1.5.1, 2.0, 2.0.5, 2.1, 2.1.5, 2.1.6, 2.1.7, 2.2, 2.2.1,
  2.2.2, 2.2.5, 2.2.6, 2.2.7, 2.2.8, 3.0, 3.1, 3.2, 3.3, 3.4, 3.5, 4.0, 4.1,
  4.1.1, 4.2, 4.3, 4.4, 4.5, 4.6, 4.6.2, 4.7, 4.8, 4.9, 4.10, 5.0, 5.1, 5.2,
 -5.2.1, 5.3
 +5.2.1, 5.3, 5.4, 6.0
  .El
  .Ed
  .Pp
 
 -- 
 Kind regards,
 
      Remko Lodder               ** remko@elvandar.org
      FreeBSD                    ** remko@FreeBSD.org

From: "Poul-Henning Kamp" <phk@phk.freebsd.dk>
To: Remko Lodder <remko@elvandar.org>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/90851: mdoc(7) manpage needs more FreeBSD versions 
Date: Sun, 01 Jan 2006 23:53:52 +0100

 In message <20060101194413.GA73743@elvandar.org>, Remko Lodder 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 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, 2.1, 2.1.5,
 >>                             2.1.6, 2.1.7, 2.2, 2.2.1, 2.2.2, 2.2.5, 2.2.6,
 >>                             2.2.7, 2.2.8, 3.0, 3.1, 3.2, 3.3, 3.4, 3.5, 4.0,
 >>                             4.1, 4.1.1, 4.2, 4.3, 4.4, 4.5, 4.6, 4.6.2, 4.7,
 >>                             4.8, 4.9, 4.10, 5.0, 5.1, 5.2, 5.2.1, 5.3
 >> 
 >> 	The list should either be kept up to date, or more sensibly be 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 "etc" ?
 
 
 -- 
 Poul-Henning Kamp       | UNIX since Zilog Zeus 3.20
 phk@FreeBSD.ORG         | TCP/IP since RFC 956
 FreeBSD committer       | BSD since 4.3-tahoe    
 Never attribute to malice what can adequately be explained by incompetence.

From: Ceri Davies <ceri@submonkey.net>
To: freebsd-gnats-submit@FreeBSD.org
Cc: Ruslan Ermilov <ru@FreeBSD.org>,
 remko@FreeBSD.org,
 phk@FreeBSD.org
Subject: Re: docs/90851: mdoc(7) manpage needs more FreeBSD versions 
Date: Mon, 2 Jan 2006 17:23:53 +0000

 On 1 Jan 2006, at 23:00, Poul-Henning Kamp wrote:
 >  In message <20060101194413.GA73743@elvandar.org>, Remko Lodder  
 > 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  
 >>> 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,  
 >>> 2.1, 2.1.5,
 >>>                             2.1.6, 2.1.7, 2.2, 2.2.1, 2.2.2,  
 >>> 2.2.5, 2.2.6,
 >>>                             2.2.7, 2.2.8, 3.0, 3.1, 3.2, 3.3,  
 >>> 3.4, 3.5, 4.0,
 >>>                             4.1, 4.1.1, 4.2, 4.3, 4.4, 4.5, 4.6,  
 >>> 4.6.2, 4.7,
 >>>                             4.8, 4.9, 4.10, 5.0, 5.1, 5.2, 5.2.1,  
 >>> 5.3
 >>>
 >>> 	The list should either be kept up to date, or more sensibly be  
 >>> 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  
 > "etc" ?
 
 We should ask Ruslan whether we can rely on them all being supported.
 
 Ceri

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--
State-Changed-From-To: open->suspended 
State-Changed-By: remko 
State-Changed-When: Tue Jan 10 17:52:43 UTC 2006 
State-Changed-Why:  
Suspend the PR till we get a vendor import which has the 
patch which was sent upstream included. I will also grab the 
PR so that i can monitor this. 


Responsible-Changed-From-To: freebsd-doc->remko 
Responsible-Changed-By: remko 
Responsible-Changed-When: Tue Jan 10 17:52:43 UTC 2006 
Responsible-Changed-Why:  
Suspend the PR till we get a vendor import which has the 
patch which was sent upstream included. I will also grab the 
PR so that i can monitor this. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=90851 

From: Remko Lodder <remko@elvandar.org>
To: bug-followup@FreeBSD.org,  phk@critter.freebsd.dk
Cc:  
Subject: Re: docs/90851: mdoc(7) manpage needs more FreeBSD versions
Date: Tue, 10 Jan 2006 18:52:12 +0100

 Hi,
 
 ru@ submitted a patch upstream so that it can be fixed from
 top to bottom. Since this involves a /contrib file we should
 not modify this within the FreeBSD structure.  Within time a
 new vendor import will contain this change and the versions
 will get updated.
 
 I will take the PR and 'monitor' it so that the audit-trail
 keeps doing what it should.
 
 Thanks ru@ for submitting it upstream!
 -- 
 Kind regards,
 
     Remko Lodder  ** remko@elvandar.org
          FreeBSD  ** remko@FreeBSD.org
State-Changed-From-To: suspended->closed 
State-Changed-By: remko 
State-Changed-When: Mon Mar 13 19:43:15 UTC 2006 
State-Changed-Why:  
The import was done 8 weeks ago in revision 1.1.1.20 on the 
vendor branch. The commit log was: 

Merge support for new BSD releases from upstream: 

- Darwin 8.[0-3].0 
- FreeBSD 4.11, 5.4, 6.0, 6.1 
- NetBSD 3.0 

-- Thanks to ru@ for doing to update! 

Close the PR since what had been requested had been 
done. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=90851 
>Unformatted:
