diff --git a/documentation/content/en/books/porters-handbook/special/_index.adoc b/documentation/content/en/books/porters-handbook/special/_index.adoc
--- a/documentation/content/en/books/porters-handbook/special/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/special/_index.adoc
@@ -4990,17 +4990,20 @@
 If an option is used, though, always enable it in `OPTIONS_DEFAULT`.
 
 [[shell-completion-paths]]
-.Shell completion file paths
-[cols="1,1", frame="none"]
+.Full shell completion file names
+[cols="1,1,1", frame="none"]
 |===
 |`bash`
-|[.filename]#${PREFIX}/etc/bash_completion.d#
+|[.filename]#${PREFIX}/etc/bash_completion.d# or [.filename]#${PREFIX}/share/bash-completion/completions#
+|(any unique file names in one of these folders)
 
 |`fish`
-|[.filename]#${PREFIX}/share/fish/vendor_completions.d#
+|[.filename]#${PREFIX}/share/fish/completions/${PORTNAME}.fish#
+|
 
 |`zsh`
-|[.filename]#${PREFIX}/share/zsh/site-functions#
+|[.filename]#${PREFIX}/share/zsh/site-functions/_${PORTNAME}#
+|
 |===
 
 Do not register any dependencies on the shells themselves.