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

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