Re: typo fix in symbolic link docs

Bernhard Voelker <[email protected]> Mon, 18 Aug 2025 15:27:27 +0200
Newsgroups gmane.comp.gnu.findutils.bugs
Message-ID <[email protected]>
On 8/16/25 06:13, danny mcClanahan wrote:
> Hello findutils, I noticed a small typo in the docs for symbolic link handling [...]

Good spot.

> [...] (which also showed up in a comment) [...]

Well done for the other match, thanks!

I've rolled the change into a proper Git commit and would push it like
that in your name (unless you don't want that, or want another change).
Good to go?

 > As a side note, I have been working on a library to perform directory traversal and really wished
 > I'd looked at `find` more closely earlier. In particular the discussion of symbolic link handling,
 > stat optimization with -noleaf, and the clever error behavior from -ignore_readdir_race all help
 > to resolve some questions I'd been having difficulty with.

Other implementations using the gnulib FTS module are e.g. in coreutils: du(1), rm(1), cp(1) and
chmod(1).  There might be interesting cases for you as well.

 > The docs section on security implications
 > is also just incredibly well-done and I have mentioned the HTML rendered documentation to others
 > as an example of really effective discussion of safety/security.

The kudos go probably mostly to James. :-)

Have a nice day,
Berny
0001-doc-fix-typo-in-symbolics-links-node.patch (text/x-patch, 1.6 KB)
From 2977df530c15ff2431d6adb2a348faf532068af8 Mon Sep 17 00:00:00 2001
From: Danny McClanahan <[email protected]>
Date: Mon, 18 Aug 2025 15:16:29 +0200
Subject: [PATCH] doc: fix typo in symbolics links node

* doc/find.texi (node Symbolic Links): s/directoires/directories/
* find/testsuite/find.gnu/execdir-hier.exp: Likewise here in a comment.
---
 doc/find.texi                            | 2 +-
 find/testsuite/find.gnu/execdir-hier.exp | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/find.texi b/doc/find.texi
index c84d8a4a..3d7c63a1 100644
--- a/doc/find.texi
+++ b/doc/find.texi
@@ -819,7 +819,7 @@ Actions that can cause symbolic links to become broken while
 confusing behaviour.  Take for example the command line
 @samp{find -L . -type d -delete}.   This will delete empty
 directories.  If a subtree includes only directories and symbolic
-links to directoires, this command may still not successfully delete
+links to directories, this command may still not successfully delete
 it, since deletion of the target of the symbolic link will cause the
 symbolic link to become broken and @samp{-type d} is false for broken
 symbolic links.
diff --git a/find/testsuite/find.gnu/execdir-hier.exp b/find/testsuite/find.gnu/execdir-hier.exp
index 59d877bb..4529919e 100644
--- a/find/testsuite/find.gnu/execdir-hier.exp
+++ b/find/testsuite/find.gnu/execdir-hier.exp
@@ -1,5 +1,5 @@
 # tests for -execdir ... \+
-# Specifically, ensure that output for separate directoires is not mixed.
+# Specifically, ensure that output for separate directories is not mixed.
 if { [ safe_path ] } {
     exec rm -rf tmp
     exec mkdir tmp tmp/two
-- 
2.50.1