bugfindutils - Bugs: bug #20552, Typos, ordering and formatting...

 
 

bug #20552: Typos, ordering and formatting issues in find manpage

Submitter:  James Youngman <jay>
Submitted:  Sat 21 Jul 2007 12:42:58 PM UTC
   
 
Category:  documentation Severity:  2 - Minor
Item Group:  None Status:  Fixed
Privacy:  Public Assigned to:  jay
Originator Name:  S.-H.Zimmermann Open/Closed:  Closed
Release:  4.3.8 Fixed Release:  4.3.9
* Mandatory Fields

Add a New Comment Rich Markup
   

Sat 21 Jul 2007 12:42:58 PM UTC, original submission:  

From a post to the bug-findutils mailing list :-

Hi, all,
the find(1) manpage looks really good.
This is rather important, since that utility is not the easiest one
to understand and to use.


Some minor details which might be fixed:

EXPRESSIONS
  -nouser
  -nogroup
  ( -context ...  non-standard extension, okay with me )
not in alphabetical order.

Same goes for
  -ok
  -print
  -okdir
  ...
  -ls

-execdir
  "This IS a much more secure method"

STANDARDS CONFORMANCE
   -name:
       period instead of comma in list in ().
       Identical under HISTORY.
   Other predicates:
       "The POSIX standard requires that<very hard break>
        The find utility shall detect ..."
       Something is wrong wiith this sentence.
   -perm /mode
      even lower importance ...
      a hyphen might be inserted before the name 'perm'
      "... with the behaviour of perm -000"

ENVIRONMENT VARIABLES
   NLSPATH
      "internationalisation"
      actually spelled with 'z', "internationalization"
      (see LANG,LC_ALL above; that's why I18N has been invented).
      LC_MESSAGES internationali*s*ed?

Splitting my last hairs now,
   "use of the -exec option"
   is actually an "action"
   (several times; mostly called 'action', should be consistent).


I've seen those on manpages and
found them also e.g. at http://linux.die.net/man/1/find
but I'm not sure who is maintaining the genuine text
and who is copying from other resources.

Greetings
Sven



James Youngman <jay>
Group administrator

 

(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 (Submitted the item)
  •  

    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 3 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2007-11-11 jay Open/ClosedOpen Closed
        Fixed ReleaseNone 4.3.9
    2007-07-22 jay StatusIn Progress Fixed

    Back to the top

    Powered by Savane 3.13-3230.
    Corresponding source code