Por que o rm manual diz que podemos executá-lo sem nenhum argumento, quando isso não é verdade?

A sinopse padrão para o rmutilitário é especificada no padrão POSIX ^1&2 como

rm [-iRr] file...
rm -f [-iRr] [file...]

Em sua primeira forma, requer pelo menos um operando de arquivo, mas em sua segunda forma não.

Fazer rm -fsem operandos de arquivo não é um erro:

$ rm -f
$ echo "$?"
0

... mas não faz muito.

O padrão diz que para a -fopção, o rmutilitário deve...

Não solicite confirmação. Não escreva mensagens de diagnóstico ou modifique o status de saída no caso de não haver operandos de arquivo ou no caso de operandos que não existem. Quaisquer ocorrências anteriores da -iopção serão ignoradas.

Isso confirma que deve ser possível executar rm -fsem nenhum operando de nome de caminho e que isso não é algo que faz rmsair com uma mensagem de diagnóstico nem com um status de saída diferente de zero.

Este fato é muito útil em um script que tenta deletar vários arquivos como

rm -f -- "$@"

onde "$@"é uma lista de nomes de caminhos que podem ou não estar vazios, ou que podem conter nomes de caminhos que não existem.

( rm -fainda gerará uma mensagem de diagnóstico e sairá com um status de saída diferente de zero se houver problemas de permissão impedindo que um arquivo nomeado seja removido.)

Executar o utilitário sem operandos de opção nem de nome de caminho é um erro:

$ rm
usage: rm [-dfiPRrv] file ...
$ echo "$?"
1

O mesmo vale para GNU rm(o acima mostra OpenBSD rm) e outras implementações do mesmo utilitário, mas a mensagem de diagnóstico exata e o status de saída diferente de zero podem ser diferentes (no Solaris o valor é 2 e no macOS é 64, por exemplo).

Em conclusão, o rmmanual GNU pode ser um pouco impreciso, pois é verdade que com alguma opção ( -f, que é uma opção opcional), o operando pathname é opcional.

¹ _{desde a edição de 2016, após a resolução deste bug , consulte a edição anterior para referência.}
² _{POSIX é o padrão que define o que é um sistema Unix e como ele se comporta. Este padrão é publicado pelo The Open Group . Veja também a pergunta " O que exatamente é POSIX? ".}

Tecnicamente, a sinopse está correta, mas é confusa. Há casos em que nenhum nome de arquivo é necessário:

rm --help
rm --version

(ao usar GNU rm). Todos os outros casos requerem um nome de arquivo.

Outras versões rmmostram o arquivo como não opcional, por exemplo , na página de manual do OpenBSD .

Uma sinopse mais precisa para GNU rmmostraria as três variantes:

rm[ opções ...] arquivo ...
rm --help
rm --version