bugfindutils - Bugs: bug #14459, xargs --show-limits is undocumented

 
 

bug #14459: xargs --show-limits is undocumented

Submitter:  None
Submitted:  Wed 07 Sep 2005 02:39:27 PM UTC
   
 
Category:  documentation Severity:  3 - Normal
Item Group:  None Status:  Fixed
Privacy:  Public Assigned to:  jay
Originator Name:  Eric Blake Originator Email:  -email is unavailable-
Open/Closed:  Closed Release:  4.2.25
Fixed Release:  4.2.27
* Mandatory Fields

Add a New Comment Rich Markup
   

Sun 04 Dec 2005 03:06:36 AM UTC, comment #1: 

The --show-limits option is now documented (the 4.2.27 release will  include this documentation) and xargs now issues a reminder message if stdin is a tty and you specified --show-limits.

James Youngman <jay>
Group administrator
Wed 07 Sep 2005 02:39:27 PM UTC, original submission:  

When debugging a recent xargs failure on cygwin, caused by a bug in cygwin's sysconf(_SC_ARG_MAX), I found in the source code that xargs supports --show-limits, and it turned out to be very useful in diagnosing the problem.  This option is not documented anywhere, in xargs --help, the man page, or the info docs.  Also, the source code builds the --show-limits longopt as mapping to 'S', but does not accept a short opt -S.

For the remainder of this bug report, you can feel free to ignore my requests, so long as the documentation accurately reflects the actual behavior (as long as it is undocumented, the behavior can be considered a bug, but if it is well documented, then I wouldn't be confused in the first place):
I thought it was rather confusing that --show-limits still insisted on reading stdin.  I had to execute 'echo | xargs --show-limits' for a non-blocking printout of the current limits.  I think it might be more intuitive if --show-limits printed the limits, then quit without doing any further action (thinking of --show-limits as a form of --help, but correctly taking into account the affects of -s or other options).  On the other hand, the limit information could also usefully be printed during --verbose, where --verbose does imply continuing with execution by reading stdin.

Anonymous

 

(Note: upload size limit is set to 16384 kB, after insertion of the required escape characters.)

Attach Files:
   
   
Comment:
   

No files currently attached

 

Depends on the following items: None found

Items that depend on this one: None found

 

CC list is empty

 

There are 0 votes so far. Votes easily highlight which items people would like to see resolved in priority, independently of the priority of the item set by tracker managers.

Only logged-in users can vote.

 

Follow 5 latest changes.

Date Changed by Updated Field Previous Value => Replaced by
2005-12-06 jay Assigned toNone jay
    Open/ClosedOpen Closed
    Fixed ReleaseNone 4.2.27
2005-12-04 jay StatusNone Fixed
2005-09-07 None Carbon-Copy- Added ebb9 --AT-- byu --DOT-- net

Back to the top

Powered by Savane 3.13-02a9.
Corresponding source code