From gad@santropez.netel.rpi.edu  Mon Oct 14 17:19:37 2002
Return-Path: <gad@santropez.netel.rpi.edu>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 13A1737B401
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 14 Oct 2002 17:19:37 -0700 (PDT)
Received: from santropez.netel.rpi.edu (santropez.netel.rpi.edu [128.113.24.162])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 704D343EB2
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 14 Oct 2002 17:19:36 -0700 (PDT)
	(envelope-from gad@santropez.netel.rpi.edu)
Received: from santropez.netel.rpi.edu (localhost [127.0.0.1])
	by santropez.netel.rpi.edu (8.12.6/8.12.5) with ESMTP id g9F0JY0N026163
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 14 Oct 2002 20:19:34 -0400 (EDT)
	(envelope-from gad@santropez.netel.rpi.edu)
Received: (from gad@localhost)
	by santropez.netel.rpi.edu (8.12.6/8.12.6/Submit) id g9F0JXiQ026162;
	Mon, 14 Oct 2002 20:19:33 -0400 (EDT)
Message-Id: <200210150019.g9F0JXiQ026162@santropez.netel.rpi.edu>
Date: Mon, 14 Oct 2002 20:19:33 -0400 (EDT)
From: Garance A Drosehn <gad@santropez.netel.rpi.edu>
Reply-To: Garance A Drosehn <gad@gilead.netel.rpi.edu>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: Minor corrections to release notes for 4.7
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         44070
>Category:       docs
>Synopsis:       Minor corrections to release notes for 4.7
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    bmah
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Oct 14 17:20:09 PDT 2002
>Closed-Date:    Fri Oct 18 12:57:18 PDT 2002
>Last-Modified:  Fri Oct 18 12:57:18 PDT 2002
>Originator:     Garance A Drosehn
>Release:        FreeBSD 5.0-CURRENT i386
>Organization:
RPI; Troy NY
>Environment:
System: FreeBSD santropez.netel.rpi.edu 5.0-CURRENT FreeBSD 5.0-CURRENT #0: Sat Oct 5 21:56:57 EDT 2002 root@santropez.netel.rpi.edu:/usr/obj/usr/src/sys/Dual-650P3-LessWit i386


	Users of freebsd-4.7 release
>Description:
	The release notes at:
	    http://www.FreeBSD.org/releases/4.7R/relnotes-i386.html
	and http://www.FreeBSD.org/releases/4.7R/relnotes-alpha.html
	imply that 'xargs -J' is depreciated.  This is not true.  It
	does not do the same thing as -I, and therefore it is still
	very useful.  It is a freebsd-only option (at least for now),
	but it is not depreciated.

	Also, the release notes do not mention some improvements to
	the 'lpc' command.  Several new options are now available on
	the 'lpc topq' command, and an 'lpc bottomq' command has been
	added.  Also, an 'lpc setstatus' command has been added.

	Details of the new 'lpc topq' options are at:
	    http://www.freebsd.org/cgi/cvsweb.cgi/src/usr.sbin/lpr/common_source/matchjobs.c
	(scroll down to revision 1.2), but that's way too detailed
	for the release notes.

>How-To-Repeat:
	
>Fix:

	


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->bmah 
Responsible-Changed-By: bmah 
Responsible-Changed-When: Tue Oct 15 10:01:28 PDT 2002 
Responsible-Changed-Why:  
I'll take this. 

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

From: "Bruce A. Mah" <bmah@FreeBSD.ORG>
To: Garance A Drosehn <gad@gilead.netel.rpi.edu>
Cc: FreeBSD-gnats-submit@FreeBSD.ORG, freebsd-doc@FreeBSD.ORG
Subject: Re: docs/44070: Minor corrections to release notes for 4.7 
Date: Tue, 15 Oct 2002 15:16:06 -0700

 --==_Exmh_691056360P
 Content-Type: text/plain; charset=us-ascii
 
 If memory serves me right, Garance A Drosehn wrote:
 
 > 	The release notes at:
 > 	    http://www.FreeBSD.org/releases/4.7R/relnotes-i386.html
 > 	and http://www.FreeBSD.org/releases/4.7R/relnotes-alpha.html
 > 	imply that 'xargs -J' is depreciated.  This is not true.  It
 > 	does not do the same thing as -I, and therefore it is still
 > 	very useful.  It is a freebsd-only option (at least for now),
 > 	but it is not depreciated.
 
 See for example the commit message for revision 1.16 of src/usr.sbin/
 xargs/xargs.1.  I interpeted that to mean "xargs -J is deprecated".
 
 > 	Also, the release notes do not mention some improvements to
 > 	the 'lpc' command.  Several new options are now available on
 > 	the 'lpc topq' command, and an 'lpc bottomq' command has been
 > 	added.  Also, an 'lpc setstatus' command has been added.
 > 
 > 	Details of the new 'lpc topq' options are at:
 > 	    http://www.freebsd.org/cgi/cvsweb.cgi/src/usr.sbin/lpr/common_sourc
 > e/matchjobs.c
 > 	(scroll down to revision 1.2), but that's way too detailed
 > 	for the release notes.
 
 At the time, it wasn't clear to me how significant these changes were.
 I'm happy to be corrected, but this is why I like to get heads-up
 messages (or text or direct commits) from developers regarding changes
 they consider to be important.
 
 If you want, I can figure out something to add to -CURRENT's release
 notes.  Is this important enough to also warrant an entry in the 4.7
 errata?
 
 Cheers,
 
 Bruce.
 
 
 
 
 --==_Exmh_691056360P
 Content-Type: application/pgp-signature
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.0.7 (FreeBSD)
 Comment: Exmh version 2.5+ 20020506
 
 iD8DBQE9rJOm2MoxcVugUsMRAs2pAKDGGBa+ypBrXSuXGYptyqCY2oFnRACgqbOd
 Ph9lAxHqpVr+JODrotxswhk=
 =zBVd
 -----END PGP SIGNATURE-----
 
 --==_Exmh_691056360P--

From: Garance A Drosehn <drosehn@rpi.edu>
To: Bruce A Mah <bmah@FreeBSD.ORG>
Cc: FreeBSD-gnats-submit@FreeBSD.ORG, freebsd-doc@FreeBSD.ORG
Subject: Re: docs/44070: Minor corrections to release notes for 4.7
Date: Tue, 15 Oct 2002 21:32:00 -0400

 Bruce Mah wrote:
 > If memory serves me right, Garance A Drosehn wrote:
 > >       The release notes at:
 > >           http://www.FreeBSD.org/releases/4.7R/relnotes-i386.html
 > >       and http://www.FreeBSD.org/releases/4.7R/relnotes-alpha.html
 > >       imply that 'xargs -J' is depreciated.  This is not true.  It
 > >       does not do the same thing as -I, and therefore it is still
 > >       very useful.  It is a freebsd-only option (at least for now),
 > >       but it is not depreciated.
 >
 > See for example the commit message for revision 1.16 of src/usr.sbin/
 > xargs/xargs.1.  I interpeted that to mean "xargs -J is deprecated".
 
 Yeah, I remember the commit message going by, and at the time I sent a 
 message off to jmallet pointing out that -J should *not* be 
 depreciated.  Also note that the man page was never changed to say -J 
 was depreciated, Juli only made that comment as part of the commit 
 entry.  I probably sent that as a private message exchange at the time.
 
 I didn't occur to me that someone else would pick up on that comment and 
 assume that -J was officially on track to be depreciated.  The -J option 
 is a very useful option which I've always wished for when I am on other 
 platforms, and I was pretty excited when it was added to freebsd.  I 
 want to see the other OS's adopt it, instead of us getting rid of it!
 
 > >     Also, the release notes do not mention some improvements
 > >     to the 'lpc' command.
 >
 > At the time, it wasn't clear to me how significant these changes were.  
 > I'm happy to be corrected, but this is why I like to get heads-up 
 > messages (or text or direct commits) from developers regarding changes 
 > they consider to be important.
 
 To be honest, I suspect that few people will find those options as 
 attractive as I do.  I would not have even mentioned them except that I 
 definitely wanted to say something about xargs, so I also added lpc as 
 long as I was writing a PR.
 
 > If you want, I can figure out something to add to -CURRENT's release
 > notes.  Is this important enough to also warrant an entry in the 4.7
 > errata?
 
 It would be nice enough to add a short blurb to -current wrt the new lpc 
 options.  They certainly are not important enough to deserve a special 
 errata entry for 4.7.
 
 I do think it would be good to have an errata item on xargs, lest people 
 think they have to start avoiding -J.  Probably should check with 
 jmallet just to make sure we're all still on the same wavelength on that.
 
 --
 Garance Alistair Drosehn     =      gad@gilead.netel.rpi.edu
 Senior Systems Programmer               or   gad@FreeBSD.org
 Rensselaer Polytechnic Institute;             Troy, NY;  USA
 

From: bmah@freebsd.org (Bruce A. Mah)
To: Garance A Drosehn <drosehn@rpi.edu>, jmallet@freebsd.org
Cc: Bruce A Mah <bmah@freebsd.org>, FreeBSD-gnats-submit@freebsd.org,
	freebsd-doc@freebsd.org
Subject: Re: docs/44070: Minor corrections to release notes for 4.7 
Date: Thu, 17 Oct 2002 20:19:25 -0700

 --==_Exmh_-593172532P
 Content-Type: text/plain; charset=us-ascii
 
 If memory serves me right, Garance A Drosehn wrote:
 > Bruce Mah wrote:
 > > If memory serves me right, Garance A Drosehn wrote:
 > > >       The release notes at:
 > > >           http://www.FreeBSD.org/releases/4.7R/relnotes-i386.html
 > > >       and http://www.FreeBSD.org/releases/4.7R/relnotes-alpha.html
 > > >       imply that 'xargs -J' is depreciated.  This is not true.  It
 > > >       does not do the same thing as -I, and therefore it is still
 > > >       very useful.  It is a freebsd-only option (at least for now),
 > > >       but it is not depreciated.
 > >
 > > See for example the commit message for revision 1.16 of src/usr.sbin/
 > > xargs/xargs.1.  I interpeted that to mean "xargs -J is deprecated".
 > 
 > Yeah, I remember the commit message going by, and at the time I sent a 
 > message off to jmallet pointing out that -J should *not* be 
 > depreciated.  Also note that the man page was never changed to say -J 
 > was depreciated, Juli only made that comment as part of the commit 
 > entry.  I probably sent that as a private message exchange at the time.
 > 
 > I didn't occur to me that someone else would pick up on that comment and 
 > assume that -J was officially on track to be depreciated.  The -J option 
 > is a very useful option which I've always wished for when I am on other 
 > platforms, and I was pretty excited when it was added to freebsd.  I 
 > want to see the other OS's adopt it, instead of us getting rid of it!
 
 I don't use either of these options (my loss, I suppose!).
 
 > > >     Also, the release notes do not mention some improvements
 > > >     to the 'lpc' command.
 > >
 > > At the time, it wasn't clear to me how significant these changes were.  
 > > I'm happy to be corrected, but this is why I like to get heads-up 
 > > messages (or text or direct commits) from developers regarding changes 
 > > they consider to be important.
 > 
 > To be honest, I suspect that few people will find those options as 
 > attractive as I do.  I would not have even mentioned them except that I 
 > definitely wanted to say something about xargs, so I also added lpc as 
 > long as I was writing a PR.
 > 
 > > If you want, I can figure out something to add to -CURRENT's release
 > > notes.  Is this important enough to also warrant an entry in the 4.7
 > > errata?
 > 
 > It would be nice enough to add a short blurb to -current wrt the new lpc 
 > options.  They certainly are not important enough to deserve a special 
 > errata entry for 4.7.
 
 I'll try to cobble something together for -CURRENT (probably copying
 stuff from your commit message, since that's the way I usually do it).
 
 > I do think it would be good to have an errata item on xargs, lest people 
 > think they have to start avoiding -J.  Probably should check with 
 > jmallet just to make sure we're all still on the same wavelength on that.
 
 OK, let's ask her, then.  Juli, any comment on "xargs -J"?
 
 Bruce.
 
 
 
 --==_Exmh_-593172532P
 Content-Type: application/pgp-signature
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.2.0 (FreeBSD)
 Comment: Exmh version 2.5+ 20020506
 
 iD8DBQE9r3292MoxcVugUsMRAvzpAKDSAKV9hTyUtUcSBuwknwXQBbcptACgtVea
 KR1CazmbHsERnDVoHng1GaA=
 =hVzX
 -----END PGP SIGNATURE-----
 
 --==_Exmh_-593172532P--

From: Juli Mallett <jmallett@FreeBSD.org>
To: "Bruce A. Mah" <bmah@freebsd.org>
Cc: Garance A Drosehn <drosehn@rpi.edu>, jmallet@freebsd.org,
	FreeBSD-gnats-submit@freebsd.org, freebsd-doc@freebsd.org
Subject: Re: docs/44070: Minor corrections to release notes for 4.7
Date: Thu, 17 Oct 2002 20:35:55 -0700

 * De: "Bruce A. Mah" <bmah@freebsd.org> [ Data: 2002-10-17 ]
 	[ Subjecte: Re: docs/44070: Minor corrections to release notes for 4.7 ]
 > > I do think it would be good to have an errata item on xargs, lest people 
 > > think they have to start avoiding -J.  Probably should check with 
 > > jmallet just to make sure we're all still on the same wavelength on that.
 > 
 > OK, let's ask her, then.  Juli, any comment on "xargs -J"?
 
 It's certainly not deprecated.  I've even had extensive discussion with
 gad about its implementation, along the lines of making sure that it is
 not implemented inappropriately complexly against the way -I and such
 are implemented.
 
 The semantics are different enough in a desirable way to be interesting.
 
 juli.
 -- 
 Juli Mallett <jmallett@FreeBSD.org>       | FreeBSD: The Power To Serve
 Will break world for fulltime employment. | finger jmallett@FreeBSD.org
 http://people.FreeBSD.org/~jmallett/      | Support my FreeBSD hacking!
State-Changed-From-To: open->closed 
State-Changed-By: bmah 
State-Changed-When: Fri Oct 18 12:55:28 PDT 2002 
State-Changed-Why:  
Changes committed as discussed...thanks for pointing these out! 

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