bugfindutils - Bugs: bug #49640, Refer to numeric arguments as...

 
 

bug #49640: Refer to numeric arguments as n|-n|+n or [-+]n instead of n in the manpages

Submitted by:  Patrick M. <fuujuhi>
Submitted on:  Fri 18 Nov 2016 06:39:15 AM UTC  
 
Category:  documentation Severity:  3 - Normal
Item Group:  None Status:  In Progress
Privacy:  Public Assigned to:  James Youngman <jay>
Originator Name:  Open/Closed:  Open
Release:  4.6.0 Fixed Release:  None

Add a New Comment(Rich Markup)
   

You are not logged in

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

 

Wed 30 Nov 2016 05:14:14 AM UTC, comment #3:

I have a patch which I will send tomorrow.

James Youngman <jay>
Project AdministratorIn charge of this item.
Sun 27 Nov 2016 05:17:55 PM UTC, comment #2:

I agree about the value of the change. For the as you say, extremely motivated there are also opportunities to clarify the sometimes-confusing rounding behaviours, too.

James Youngman <jay>
Project AdministratorIn charge of this item.
Fri 18 Nov 2016 02:54:59 PM UTC, comment #1:

I heartily agree with this. The Gnu man pages are generally extremely accurate, and this change (especially if it includes the text change) is a significant improvement.

Dale Worley <worley>
Fri 18 Nov 2016 06:39:15 AM UTC, original submission:

Despites years of usage of find I still choke on the following subtlety of find numerical arguments, that 'n' means 'exactly n', whereas '+n' means 'greater than n' and '-n' means 'less than n'.

This is clearly stated at the start of the TESTS section, but for someone that would only cursorily read the manpage, like searching for 'mtime' directly, you might easily miss this information.

I suggest then to edit the manpage such that all numerical arguments are listed as n|-n|+n or [-+]n instead of simply n.

-amin n
File was last accessed n minutes ago.

would become

-amin n|-n|+n
File was last accessed n minutes ago.

or alternatively

-amin [-+]n
File was last accessed n minutes ago.

In case of extreme motivation, the text body could also be edited to replace 'n' by '(exactly/at least/at most) n' or something alike. But tmo changing the argument specification is already enough.

Patrick M. <fuujuhi>

 

(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

 

Carbon-Copy List
  • -email is unavailable- added by jay (Posted a comment)
  • -email is unavailable- added by worley (Posted a comment)
  • -email is unavailable- added by fuujuhi (Submitted the item)
  •  

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

    Only logged-in users can vote.

     

     

     

    Follow 2 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2016-11-30 jay StatusNone => In Progress
        Assigned toNone => jay

    Back to the top


    Powered by Savane 3.3