¿Dónde se documenta "mostrar la salida del comando 'ls' verticalmente"?

Me di cuenta de que es posible mostrar la salida del lscomando verticalmente mediante el -1interruptor:

$ ls -1

Pero no pude encontrarlo en el manual de ls. ¿Es una opción secreta?

El manual no está actualizado con el programa. Prueba ls --help | grep -- ' -1':

  -1                         list one file per line

Es una de las últimas opciones descritas si solo lo hace ls --help.

Como @Timo indica -1está en la ayuda, y @terdon señala que -1está documentado en el manual para alguna versión. coreutils8.13 tiene ese error en la página de manual, la versión 8.22 ya no.

En las pautas de piratería para coreutils. Se especifica que

Las páginas man se generan a partir de la salida --help, por lo que no debería necesitar cambiar nada en man /.

Por lo tanto, debe haber algo roto en la conversión que haga -mque aparezca lo similar , pero no el -1. Mientras construía lscon el parche que propuse en respuesta a la pregunta de @ timo , la página del manual para lsse regenera correctamente y la parte relevante dice:

  -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

Y sin ese parche, el -1 también aparece en el manual. El git logno muestra ninguna acción específica para corregir esto. En septiembre de 2013 help2man, que se utiliza para generar las páginas de manual, se actualizó. El help2man ChangeLogtampoco muestra una acción específica.

Supongo que esto dependerá de su lsimplementación, pero en mi LMDE (básicamente pruebas de Debian) tengo:

$ man ls | grep -- '-1'
              across -x, commas -m, horizontal -x, long -l, single-column  -1,
       -1     list one file per line

Además de (sí, es la misma salida)

$ ls --help | grep -- '-1'
              across -x, commas -m, horizontal -x, long -l, single-column  -1,
       -1     list one file per line