[PATCH v2] docs: find-unused-docs.sh: fixup directory usage

[PATCH v2] docs: find-unused-docs.sh: fixup directory usage

[Randy Dunlap]

The recent move of this script from scripts/ to tools/docs/
did not account for the 'cd' directory usage.
Update "cd .." to "cd ../.." to make the script self-correcting.

This also eliminates a shell warning:
./tools/docs/find-unused-docs.sh: line 33: cd: Documentation/: No such file or directory

Fixes: 184414c6a6ca ("docs: move find-unused-docs.sh to tools/docs")
Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
---
v2: correct subject line typos (2) (arg, kbd error!)

Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org

 tools/docs/find-unused-docs.sh |    2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

--- linux-next-20251219.orig/tools/docs/find-unused-docs.sh
+++ linux-next-20251219/tools/docs/find-unused-docs.sh
@@ -28,7 +28,7 @@ if ! [ -d "$1" ]; then
 fi
 
 cd "$( dirname "${BASH_SOURCE[0]}" )"
-cd ..
+cd ../..
 
 cd Documentation/
 

Re: [PATCH v2] docs: find-unused-docs.sh: fixup directory usage

[Matthew Wilcox]

On Fri, Jan 02, 2026 at 12:06:57PM -0800, Randy Dunlap wrote:
> The recent move of this script from scripts/ to tools/docs/
> did not account for the 'cd' directory usage.
> Update "cd .." to "cd ../.." to make the script self-correcting.
> 
> This also eliminates a shell warning:
> ./tools/docs/find-unused-docs.sh: line 33: cd: Documentation/: No such file or directory
> 
> Fixes: 184414c6a6ca ("docs: move find-unused-docs.sh to tools/docs")
> Signed-off-by: Randy Dunlap <rdunlap@infradead.org>

Hah.  I just committed this same patch.

    docs: Fix find-unused-docs.sh

    find-unused-docs.sh cares about which directory it lives in.
    After being moved from scripts/ to tools/docs/, it emits:

    ./tools/docs/find-unused-docs.sh: line 33: cd: Documentation/: No such file or directory

    and then claims that all files are omitted from the formatted
    documentation.  I opted for the simple fix here rather than trying to
    remove that dependency.

    Fixes: 184414c6a6ca (docs: move find-unused-docs.sh to tools/docs)
    Signed-off-by: Matthew Wilcox (Oracle) <willy@infradead.org>

You posted it first, so:

Reviewed-by: Matthew Wilcox (Oracle) <willy@infradead.org>

(feel free to use any parts of my commit message if you prefer them to
yours)

> v2: correct subject line typos (2) (arg, kbd error!)
> 
> Cc: Jonathan Corbet <corbet@lwn.net>
> Cc: linux-doc@vger.kernel.org
> 
>  tools/docs/find-unused-docs.sh |    2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
> 
> --- linux-next-20251219.orig/tools/docs/find-unused-docs.sh
> +++ linux-next-20251219/tools/docs/find-unused-docs.sh
> @@ -28,7 +28,7 @@ if ! [ -d "$1" ]; then
>  fi
>  
>  cd "$( dirname "${BASH_SOURCE[0]}" )"
> -cd ..
> +cd ../..
>  
>  cd Documentation/
>  
> 

Re: [PATCH v2] docs: find-unused-docs.sh: fixup directory usage

[Jonathan Corbet]

Randy Dunlap <rdunlap@infradead.org> writes:

> The recent move of this script from scripts/ to tools/docs/
> did not account for the 'cd' directory usage.
> Update "cd .." to "cd ../.." to make the script self-correcting.
>
> This also eliminates a shell warning:
> ./tools/docs/find-unused-docs.sh: line 33: cd: Documentation/: No such file or directory
>
> Fixes: 184414c6a6ca ("docs: move find-unused-docs.sh to tools/docs")
> Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
> ---
> v2: correct subject line typos (2) (arg, kbd error!)
>
> Cc: Jonathan Corbet <corbet@lwn.net>
> Cc: linux-doc@vger.kernel.org
>
>  tools/docs/find-unused-docs.sh |    2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
>
> --- linux-next-20251219.orig/tools/docs/find-unused-docs.sh
> +++ linux-next-20251219/tools/docs/find-unused-docs.sh
> @@ -28,7 +28,7 @@ if ! [ -d "$1" ]; then
>  fi
>  
>  cd "$( dirname "${BASH_SOURCE[0]}" )"
> -cd ..
> +cd ../..

Weird, I'm sure I tested that ... evidently not very well.  Applied,
thanks.

jon