Thu, 02 Sep 2021 14:28:54 -0700 Evan Silberman <[email protected]>
> Speaking of the first sentence of rm(1):

Where is that discussion happening, how is it concerning the rm(1) manual page?

> Remove extraneous word from command description

What is the rationale for this, is it entirely missing or undisclosed publicly?

> "non-directory files" reads more naturally and means the same thing as
> "non-directory type files".
> 
> diff --git a/bin/rm/rm.1 b/bin/rm/rm.1
> index a2526a36392..1be2bf31913 100644
> --- a/bin/rm/rm.1
> +++ b/bin/rm/rm.1
> @@ -46,7 +46,7 @@
>  .Sh DESCRIPTION
>  The
>  .Nm
> -utility attempts to remove the non-directory type files specified on the
> +utility attempts to remove the non-directory files specified on the
>  command line.
>  If the permissions of the file do not permit writing, and the standard
>  input device is a terminal, the user is prompted (on the standard error
> 

Hi Evan,

Read carefully these pages, they include file types sections that explain well:

https://man.openbsd.org/find.1#type
https://man.openbsd.org/stat.2

why directories are file types too, and the wording for that particular matter:

https://man.openbsd.org/rm.1
https://man.netbsd.org/rm.1
https://www.freebsd.org/cgi/man.cgi?rm
https://www.gnu.org/software/coreutils/manual/html_node/rm-invocation.html

https://pubs.opengroup.org/onlinepubs/9699919799/utilities/rm.html
https://pubs.opengroup.org/onlinepubs/9699919799.2018edition/utilities/rm.html
https://pubs.opengroup.org/onlinepubs/9699919799.2016edition/utilities/rm.html
https://pubs.opengroup.org/onlinepubs/9699919799.2013edition/utilities/rm.html
https://pubs.opengroup.org/onlinepubs/9699919799.2008edition/utilities/rm.html

Do all manual pages need to be free form texts to suit non-technical audiences?

--
Kind regards,
Anton Lazarov
MScEng EECSIT

Reply via email to