Gdzie jest udokumentowane „pokazywanie wyniku polecenia ls” w pionie?

30

Odkryłem , że można wyświetlić wyjście lspolecenia pionowo za pomocą -1przełącznika:

$ ls -1

Ale nie mogłem tego znaleźć w instrukcji obsługi ls. Czy to tajna opcja?

ls man documentation Meysam
źródło
1
man lsnie mówi: -1 list one file per line. Strony informacyjne zwykle zawierają więcej informacji, spróbuj info ls.
devnull

Odpowiedzi:

33

Instrukcja jest nieaktualna w programie. Spróbuj ls --help | grep -- ' -1':

  -1                         list one file per line

Jest to jedna z ostatnich opisanych opcji, jeśli po prostu to zrobisz ls --help.

Timo
źródło
/bin/lsdaje również dane wyjściowe w kolumnach, przynajmniej w moim systemie. Do czego masz lsalias?
terdon
Ostatnio dodane? OK, nie ma go w V7. Ale 2BSD miało to . Fileutils 3.12 miała najstarszą wersję GNU, jaką mogę teraz znaleźć , w tym dokumentację na stronie podręcznika , a dziennik zmian powraca do wersji 1.0 w 1990 r., Nie wspominając o dodaniu go jako nowej opcji. Myślę, że zawsze tam był.
@timo, dziękuję za odpowiedź. Niezły sposób na wyjaśnienie. Pracuje dla mnie.
AMIC MING
6

Jak wskazuje @Timo, -1jest w pomocy, a @terdon wskazuje, że -1jest to udokumentowane w instrukcji obsługi niektórych wersji. coreutils8.13 ma ten błąd na stronie podręcznika, wersja 8.22 już nie.

W wytycznych dotyczących hakowania Coreutils. Jest to określone

Strony podręcznika są generowane z wyjścia --help, więc nie powinieneś zmieniać niczego w man /.

Więc musi być coś przerwanego w konwersji, co powoduje pojawienie się podobnego -m, ale nie -1. Podczas budowania lsza pomocą łatki, którą zaproponowałem w odpowiedzi na pytanie @ timo , strona podręcznika dla została lspoprawnie zregenerowana, a odpowiednia część brzmi:

  -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

Bez tej łatki -1 pojawia się również w instrukcji. Te git logpokazy żadnych szczególnych działań w celu skorygowania tego. Od września 2013 r. help2man, Który jest używany do generowania stron podręcznika, został zaktualizowany. help2man ChangeLogNie wykazuje działania konkretnego albo.

Anthon
źródło
3

Przypuszczam, że będzie to zależeć od twojej lsimplementacji, ale od mojego LMDE (w zasadzie testowanie Debiana) Mam:

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

Jak również (tak, to ta sama wydajność)

$ ls --help | grep -- '-1'
              across -x, commas -m, horizontal -x, long -l, single-column  -1,
       -1     list one file per line
terdon
źródło
Strona podręcznika OS X dla ls pokazuje również opcję -1.
Arne
Wydaje się, że zostało to naprawione. coreutils 8.13 ma ten błąd na stronie man, wersja 8.22 nie.
Anthon