bugfindutils - Bugs: bug #19349, doc bug on -size

 
 

bug #19349: doc bug on -size

Submitted by:  None
Submitted on:  Tue 20 Mar 2007 05:19:43 AM UTC  
 
Category: documentationSeverity: 3 - Normal
Item Group: NoneStatus: Invalid
Privacy: PublicAssigned to: None
Originator Name: Originator Email: -unavailable-
Open/Closed: ClosedRelease: 4.2.28
Fixed Release: None

Add a New Comment(Rich Markup)
   

You are not logged in

Please log in, so followups can be emailed to you.

 

Thu 19 Nov 2015 07:21:29 AM UTC, comment #4:

It's already there, both in --help output ...

$ find --help | grep ^tests
tests (N can be +N or -N or N): -amin N -anewer FILE -atime N -cmin N

... and in the man page:

Numeric arguments can be specified as
+n for greater than n,
-n for less than n,
n for exactly n.

Have a nice day,
Berny

Bernhard Voelker <berny>
Project Member
Wed 18 Nov 2015 02:44:16 PM UTC, comment #3:

Fell through the same hole today while using -size.

The +/- notation is not obvious at all when studying the syntax of a specific test expression in the find man page. There is no indication that n could include a prefix.

Thought the feature wasn't described at all after looking for it and finding the nice explanation in the docs ("info find find expression"->"Primary Index"->Size or http://www.gnu.org/software/findutils/manual/html_mono/find.html#Size).
Only after searching for -size related bugs here and finding this closed old-timer I noticed the paragraph in the beginning of TESTS.

Hinting its existence using "[+-]n" instead of just "n" in the syntax lines of the TESTS paragraph would be an improvement. Thus -size would become;

-size [+-]n[cwbkMG]

instead of

-size n[cwbkMG]

Mikkel Kirkgaard Nielsen <mikini>
Sun 15 Apr 2007 07:09:42 PM UTC, comment #2:

No response from submitter; closing the bug.

James Youngman <jay>
Project Administrator
Fri 23 Mar 2007 09:10:13 AM UTC, comment #1:

My copy of the manpage says:

TESTS
Numeric arguments can be specified as

+n for greater than n,

-n for less than n,

n for exactly n.

Is this text missing from yours? If it is not missing, is it insufficiently obvious? If so, please propose a specific change.

James Youngman <jay>
Project Administrator
Tue 20 Mar 2007 05:19:43 AM UTC, original submission:

Hi, the -size option does not explain how to find files larger than a certain amount (via the + option). The syntax in the man page is:

-size n[cwbkMG]

which makes it seem that a + prefix is illegal. A later example does demonstrate the + option but it'd be nice to fully document it in the section explaining -size (and also document a - option if any).

Anonymous

 

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

Attach File(s):
   
   
Comment:
   

No files currently attached

 

Depends on the following items: None found

Items that depend on this one: None found

 

Carbon-Copy List
  • -unavailable- added by berny (Posted a comment)
  • -unavailable- added by mikini (Posted a comment)
  • -unavailable- added by mikini
  • -unavailable- added by jay (Posted a comment)
  •  

    Do you think this task is very important?
    If so, you can click here to add your encouragement to it.
    This task has 0 encouragements so far.

    Only logged-in users can vote.

     

    Please enter the title of George Orwell's famous dystopian book (it's a date):

     

     

    Follow 4 latest changes.

    Date Changed By Updated Field Previous Value => Replaced By
    Wed 18 Nov 2015 02:44:16 PM UTCmikiniCarbon-Copy-=>Added mikini
    Sun 15 Apr 2007 07:09:42 PM UTCjayCategoryfind=>documentation
      StatusNone=>Invalid
      Open/ClosedOpen=>Closed

    Back to the top


    Powered by Savane 3.1-cleanup1