Où «afficher la sortie de la commande« ls »verticalement» est-il documenté?

30

J'ai découvert qu'il était possible d'afficher la sortie de la lscommande verticalement en utilisant le -1commutateur:

$ ls -1

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

ls man documentation

— Meysam
source

1

man lsne dit: -1 list one file per line. Les pages d'informations contiennent généralement plus d'informations, essayez info ls.

— devnull

33

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

  -1                         list one file per line

C'est l'une des dernières options décrites si vous le faites ls --help.

— Timo
source

/bin/lsdonne également une sortie en colonnes, au moins sur mon système. À quoi vous lsalias?

— terdon

Ajout récent? OK, ce n'est pas en V7. Mais 2BSD l'avait . La plus ancienne version GNU que je puisse trouver en ce moment, fileutils 3.12 l' avait, y compris la documentation dans la page de manuel, et le ChangeLog revient à la version 1.0 en 1990 sans aucune mention de son ajout en tant que nouvelle option. Je pense que ça a toujours été là.

@timo, Merci pour la réponse. Belle façon d'expliquer. Travaille pour moi.

— AMIC MING

6

Comme @Timo l'indique -1dans l'aide, et @terdon souligne que cela -1est documenté dans le manuel pour une certaine version. coreutils8.13 a cette erreur dans la page de manuel, la version 8.22 n'en a plus.

Dans les directives de piratage pour coreutils. Il est précisé que

Les pages de manuel sont générées à partir de la sortie --help, vous ne devriez donc pas avoir besoin de changer quoi que ce soit sous man /.

Il doit donc y avoir quelque chose de cassé dans la conversion provoquant l'apparition du similaire -mmais pas du -1. Lors de la construction lsavec le patch que j'ai proposé en réponse à la question de @ timo , la page de manuel de lsest correctement régénérée 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 patch, le -1 apparaît également dans le manuel. Le git logne montre aucune action spécifique pour corriger cela. Pas plus tard que septembre 2013 help2man, qui est utilisé pour générer les pages de manuel, a été mis à jour. Le help2man ChangeLogne montre pas non plus d'action spécifique.

— Anthon
source

3

Je suppose que cela dépendra de votre lsimplémentation mais de mon LMDE (essentiellement des tests 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

— terdon
source

La page de manuel OS X pour ls affiche également l'option -1.

— Arne

Cela semble avoir été corrigé. coreutils 8.13 contient cette erreur dans la page de manuel, contrairement à la version 8.22.

— Anthon