Date: Mon, 24 May 2021 08:56:13 GMT From: Ceri Davies <ceri@FreeBSD.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org Subject: git: ed1e8451a5 - main - books/handbook/basics: Use less confusing whatis(1) example. Message-ID: <202105240856.14O8uD8t080679@gitrepo.freebsd.org>
next in thread | raw e-mail | index | archive | help
The branch main has been updated by ceri: URL: https://cgit.FreeBSD.org/doc/commit/?id=ed1e8451a507305a18a5da67324708b9726e8e0c commit ed1e8451a507305a18a5da67324708b9726e8e0c Author: Ceri Davies <ceri@FreeBSD.org> AuthorDate: 2021-05-24 08:51:18 +0000 Commit: Ceri Davies <ceri@FreeBSD.org> CommitDate: 2021-05-24 08:54:27 +0000 books/handbook/basics: Use less confusing whatis(1) example. If, as suggested by the Basics chapter in the handbook, one does: % cd /usr/bin % man -f * | more the result is a number of warnings due to filenames like c++ and flex++ being treated as expressions. Two ways to handle this: 1) Explain that one should use "man -f -- *" and why; 2) Avoid the problem and use "cd /usr/sbin" instead. Option 1 is more appropriate for this stage of the handbook Approved by: blackend (mentor) --- documentation/content/en/books/handbook/basics/_index.adoc | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/documentation/content/en/books/handbook/basics/_index.adoc b/documentation/content/en/books/handbook/basics/_index.adoc index 3755b4a547..7c0c35a27c 100644 --- a/documentation/content/en/books/handbook/basics/_index.adoc +++ b/documentation/content/en/books/handbook/basics/_index.adoc @@ -1515,11 +1515,11 @@ If the name of the manual page is unknown, use `man -k` to search for keywords i This command displays a list of commands that have the keyword "mail" in their descriptions. This is equivalent to using man:apropos[1]. -To read the descriptions for all of the commands in [.filename]#/usr/bin#, type: +To read the descriptions for all of the commands in [.filename]#/usr/sbin#, type: [source,shell] .... -% cd /usr/bin +% cd /usr/sbin % man -f * | more .... @@ -1527,7 +1527,7 @@ or [source,shell] .... -% cd /usr/bin +% cd /usr/sbin % whatis * |more ....
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202105240856.14O8uD8t080679>