Де задокументовано "відображення результатів команди" ls по вертикалі "?

30

Я з’ясував, що можна показати результат lsкоманди вертикально за допомогою -1перемикача:

$ ls -1

Але не вдалося знайти його в керівництві користувача ls. Це секретний варіант?

ls man documentation

1

man lsдійсно говорить: -1 list one file per line. Інформаційні сторінки зазвичай містять більше інформації, спробуйте info ls.

— devnull

33

Посібник застарілий з програмою. Спробуйте ls --help | grep -- ' -1':

  -1                         list one file per line

Це один з останніх варіантів, описаних, якщо ви просто робите ls --help.

— Тімо
джерело

/bin/lsтакож дає вихід у стовпцях, принаймні, це робиться в моїй системі. Який твій lsпсевдонім?

— terdon

Нещодавнє додавання? Гаразд, це не у V7. Але у 2BSD це було . Найдавніша версія GNU, яку я зараз можу знайти, файлеві файли 3.12 мали її, включаючи документацію на сторінці man, а ChangeLog переходить до версії 1.0 у 1990 році, не згадуючи про те, що вона додається як нова опція. Я думаю, це завжди було.

@timo, дякую за відповідь. Хороший спосіб пояснення. Працює для мене.

— AMIC MING

6

Як вказує @Timo, -1він допомагає, і @terdon зазначає, що -1це документально підтверджено в посібнику для певної версії. coreutils8.13 ця помилка є на сторінці man, версія 8.22 вже не працює.

У керівництві щодо злому для coreutils. Вказано, що

Сторінки man генеруються з результатів --help, тому вам не потрібно нічого змінювати під man /.

Таким чином, у конверсії повинно бути щось порушено, що призведе до появи подібного -m, але не до -1. Під час створення lsпатча, який я запропонував у відповідь на питання @ timo , сторінка керівництва для lsрегенерується правильно, і відповідна частина зазначає:

  -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

І без цього виправлення -1 відображається в посібнику. Не git logпоказує конкретних дій, щоб виправити це. Нещодавно вересень 2013 року help2man, який використовується для створення довідкових сторінок, було оновлено. Також help2man ChangeLogне відображається конкретна дія.

— Антон
джерело

3

Я думаю, це буде залежати від вашої lsреалізації, але від мого LMDE (в основному тестування Debian) у мене є:

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

Як і (так, це той самий вихід)

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

— тердон
джерело

На сторінці користувача OS X для ls також відображається варіант -1.

— Арн

Це, здається, було виправлено. coreutils 8.13 має таку помилку на довідковій сторінці, версія 8.22 не має.

— Антон