web-dev-qa-db-fra.com

Où est "montrant la sortie de la commande" LS "verticalement" documentée?

I découvert Il est possible d'afficher la sortie de la commande ls verticalement à l'aide de -1 changer:

$ ls -1

Mais ne pouvait pas le trouver dans le manuel de ls. Est-ce une option secrète?

lsmandocumentation
33
Meysam

Le manuel est obsolète avec le programme. Essayer ls --help | grep -- ' -1':

  -1                         list one file per line

C'est l'une des dernières options décrites si vous venez de faire ls --help.

37
Timo

Comme @timo indique -1 est dans l'aide et @terdon souligne le -1 est documenté dans le manuel pour une version. coreutils 8.13 a cette erreur dans la page de l'homme, la version 8.22 ne peut plus.

Dans les Directives de piratage pour Coreutils. Il est spécifié que

Les pages de l'homme sont générées à partir de la sortie --Help, de sorte que vous n'auriez pas besoin de changer quoi que ce soit sous l'homme /.

Donc, il doit y avoir quelque chose de brisé dans la conversion causant le similaire -m montrer mais pas le -1. Tandis que le bâtiment ls avec le patch, j'ai proposé dans Répondre à la question de @ timo , la page manuelle de ls est régénérée correctement et la partie pertinente se lit comme suit:

  -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

Et sans ce correctif, le -1 apparaît également dans le manuel. Les git log ne montre aucune action spécifique pour corriger cela. Aussi récent que sept. 2013 help2man, qui est utilisé pour générer les pages de l'homme, a été mise à jour. Les help2man _ ChangeLog _ ne montre pas non plus une action spécifique.

6
Anthon

Je suppose que cela dépendra de votre mise en œuvre ls, mais sur mon LMDE (essais essentiellement de Debian), j'ai:

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

Ainsi que (oui, c'est la même sortie)

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