From gad@santropez.netel.rpi.edu Mon Oct 14 17:19:37 2002 Return-Path: Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 13A1737B401 for ; 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 ; 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 ; 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 Reply-To: Garance A Drosehn 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" To: Garance A Drosehn 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 To: Bruce A Mah 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 , jmallet@freebsd.org Cc: Bruce A Mah , 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 To: "Bruce A. Mah" Cc: Garance A Drosehn , 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" [ 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 | 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: