Onde está “mostrando a saída do comando 'ls' verticalmente” documentado?

23

Eu descobri que é possível mostrar a saída do ls comanda verticalmente usando a opção -1 :

$ ls -1

Mas não foi possível encontrá-lo no manual de ls . É uma opção secreta?

    
por Meysam 01.02.2014 / 09:55

3 respostas

30

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 .

    
por 01.02.2014 / 10:25
6

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.

    
por 03.02.2014 / 05:46
3

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
    
por 01.02.2014 / 20:20