Wo wird „die Ausgabe des Befehls 'ls' vertikal anzeigen“ dokumentiert?

30

Ich fand heraus, dass es möglich ist, die Ausgabe des lsBefehls mit dem -1Schalter vertikal anzuzeigen:

$ ls -1

Aber ich konnte es nicht im Handbuch von finden ls. Ist es eine geheime Option?

ls man documentation Meysam
quelle
1
man lsnicht sagen: -1 list one file per line. Infoseiten enthalten normalerweise mehr Informationen, versuchen Sie es info ls.
Devnull

Antworten:

33

Das Handbuch ist veraltet mit dem Programm. Versuchen Sie ls --help | grep -- ' -1':

  -1                         list one file per line

Dies ist eine der zuletzt beschriebenen Optionen ls --help.

Timo
quelle
/bin/lsGibt auch Ausgaben in Spalten aus, zumindest auf meinem System. Wofür sind Sie lsvoreingenommen?
Terdon
Neuzugang? OK, es ist nicht in V7. Aber 2BSD hatte es . Die älteste GNU-Version, die ich derzeit finden kann, war in Fileutils 3.12 enthalten , einschließlich der Dokumentation auf der Manpage, und das ChangeLog wurde 1990 auf Version 1.0 zurückgesetzt, ohne dass erwähnt wurde, dass es als neue Option hinzugefügt wurde. Ich denke, es war schon immer da.
@timo, Danke für die Antwort. Schöner Weg zur Erklärung. Funktioniert bei mir.
AMIC MING
6

Wie @Timo -1in der Hilfe anzeigt und @terdon darauf hinweist, -1ist dies für einige Versionen im Handbuch dokumentiert. coreutils8.13 hat diesen Fehler in der Manpage, Version 8.22 nicht mehr.

In den Hacking-Richtlinien für Coreutils. Es ist festgelegt, dass

Die Manpages werden aus der Ausgabe von --help generiert, sodass Sie unter man / nichts ändern müssen.

Es muss also ein Fehler in der Konvertierung vorliegen, der dazu führt, dass das Gleiche -mangezeigt wird, aber nicht das -1. Während lsich mit dem Patch baue , den ich als Antwort auf @ timos Frage vorgeschlagen habe , wird die Handbuchseite für lskorrekt neu generiert und der relevante Teil lautet:

  -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

Und ohne diesen Patch wird die -1 auch im Handbuch angezeigt. Das git logzeigt keine spezifische Aktion, um dies zu korrigieren. Erst im September 2013 help2manwurde das Handbuch aktualisiert. Der help2man ChangeLogzeigt auch keine bestimmte Aktion.

Anthon
quelle
3

Ich nehme an, dass dies von Ihrer lsImplementierung abhängt , aber von meinem LMDE (im Grunde genommen Debian-Test), den ich habe:

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

Sowie (ja, es ist die gleiche Ausgabe)

$ ls --help | grep -- '-1'
              across -x, commas -m, horizontal -x, long -l, single-column  -1,
       -1     list one file per line
terdon
quelle
Die OS X-Manpage für ls zeigt auch die Option -1.
Arne
Dies scheint behoben worden zu sein. coreutils 8.13 hat diesen Fehler in der Manpage, Version 8.22 nicht.
Anthon