O manual está desatualizado com o programa. Experimente ls --help | grep -- ' -1'
:
-1 list one file per line
Esta é uma das últimas opções descritas se você acabou de fazer ls --help
.
Como @Timo indica que -1
está na ajuda, e @terdon indica que -1
está documentado no manual para alguma versão. coreutils
8.13 tem esse erro na página man, a versão 8.22 não tem mais.
Nas diretrizes de hacking para o coreutils. Está especificado que
The man pages are generated from --help output, so you shouldn't need to change anything under man/.
Portanto, deve haver algo quebrado na conversão, fazendo com que o -m
semelhante apareça, mas não o -1
. Ao criar ls
com o patch que propus em responda à pergunta do @timo , a página de manual de ls
é regenerado corretamente e a parte relevante diz:
-Z, --context print any security context of each file -1 list one file per line -0 list files separated with NUL --help display this help and exit --version output version information and exit
E sem esse patch, o -1 também aparece no manual. O git log
não mostra nenhuma ação específica para corrigir isso. Tão recente quanto setembro de 2013 help2man
, que é usado para gerar as páginas man, foi atualizado. O help2man
ChangeLog
também não mostra uma ação específica.
Suponho que isso vai depender da sua implementação ls
, mas no meu LMDE (basicamente teste Debian) eu tenho:
$ man ls | grep -- '-1'
across -x, commas -m, horizontal -x, long -l, single-column -1,
-1 list one file per line
Além de (sim, é o mesmo resultado)
$ ls --help | grep -- '-1'
across -x, commas -m, horizontal -x, long -l, single-column -1,
-1 list one file per line
Tags ls documentation man