bugfindutils - Bugs: bug #54856, A Bit Unclear -execdir...

 
 

bug #54856: A Bit Unclear -execdir Documentation

Submitter:  Ahmad ElKomey <ahmad_elkomey>
Submitted:  Wed 17 Oct 2018 04:29:04 PM UTC
   
 
Category:  documentation Severity:  3 - Normal
Item Group:  None Status:  Fixed
Privacy:  Public Assigned to:  jay
Originator Name:  Open/Closed:  Closed
Release:  4.5.11 Fixed Release:  4.7.0
* Mandatory Fields

Add a New Comment Rich Markup
   

Jump to the original submission

Sun 05 May 2019 04:35:26 PM UTC, comment #7: 

I have updated the documentation at https://www.gnu.org/software/findutils/manual/find.html to reflect the current state of the findutils documentation in the git repository (which is therefore somewhat newer than the 4.6.0 release).

James Youngman <jay>
Group administrator
Wed 09 Jan 2019 10:19:02 AM UTC, comment #6: 

Hello Bernhard,

Thank you for your great effort maintaining and responding to others reports.

I wanted to follow up on this report. I can see that you have updated the online documentation, for another issue I reported here.

However, this issue hasn't been fixed yet.

Any updates?

Best regards,
Ahmad.

Ahmad ElKomey <ahmad_elkomey>
Fri 19 Oct 2018 09:55:19 PM UTC, comment #5: 

You already did. :-)

We're working on getting the next release out soon, so the web
pages will be updated then.

Thanks & have a nice day,
Berny

Bernhard Voelker <berny>
Group administrator
Fri 19 Oct 2018 09:24:33 AM UTC, comment #4: 

So, where should I report to get the HTML version updated?

Ahmad ElKomey <ahmad_elkomey>
Thu 18 Oct 2018 09:30:32 AM UTC, comment #3: 

The HTML version is generated from the Texinfo documentation.
That in turn was improved in commit
  http://git.savannah.gnu.org/cgit/findutils.git/commit/?id=6cd5d3b1a82

  "The command is executed in the directory which find was searching at
  the time the action was executed (that is, {} will expand to a file
  in the local directory)."


Unfortunately, the new HTML pages seem not to have been uploaded after the
last release. ;-(

Bernhard Voelker <berny>
Group administrator
Wed 17 Oct 2018 06:39:26 PM UTC, comment #2: 

This is the documentation I am referring to.

Where are you quoting from? (where do I get that version?)

Ahmad ElKomey <ahmad_elkomey>
Wed 17 Oct 2018 06:29:41 PM UTC, comment #1: 

Where are you reading that and in which version of find?

find.1 in GIT has a very verbose wording already.
-----------------
Like  -exec, but the specified command is run from the subdirectory containing the matched file,  which is not normally  the directory  in  which  you  started  find. [...]
-----------------

Andreas Metzler <ametzler>
Wed 17 Oct 2018 04:29:04 PM UTC, original submission:  

I am reading the part that says:


— Action: -execdir command ;

Execute command; true if zero status is returned. find takes all arguments after ‘-execdir’ to be part of the command until an argument consisting of ‘;’ is reached... *The command is executed in the directory in which find was run.*


I cut some of the text after is reached, and bolded the part I think needs enhancement.

I believe the part that say The command is executed in the directory in which find was run should be updated to something like:
The command is executed in the parent directory of every file matched the criteria. Meaning, the command is executed as if you have changed the current working directory to the one containing a matching file found by find command. Also, this means that {} is always basename.

Ahmad ElKomey <ahmad_elkomey>

 

(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 berny (Posted a comment)
  • -email is unavailable- added by ahmad_elkomey (Submitted the item)
  • -email is unavailable- added by ahmad_elkomey (Enhancing the wording of a confusing part in the documentation regarding execdir.)
  • -email is unavailable- added by ahmad_elkomey (Enhancing the wording of a confusing part in the documentation regarding execdir.)
  •  

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

    Date Changed by Updated Field Previous Value => Replaced by
    2021-01-09 berny Assigned toNone jay
        Open/ClosedOpen Closed
        Fixed ReleaseNone 4.7.0
    2019-05-05 jay StatusNone Fixed
    2018-10-17 ahmad_elkomey Carbon-Copy- Added -email is unavailable-
        Carbon-Copy- Added -email is unavailable-

    Back to the top

    Powered by Savane 3.13-f8d8.
    Corresponding source code