Где документировано «показывать вывод команды« ls »по вертикали»?

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

$ ls -1

Но не смог найти его в руководстве ls. Это секретный вариант?

Руководство устарело с программой. Попробуй ls --help | grep -- ' -1':

  -1                         list one file per line

Это один из последних вариантов, описанных, если вы просто делаете ls --help.

Как указывает @Timo, -1в справке, а @terdon указывает на то, -1что задокументировано в руководстве для некоторой версии. coreutils8.13 имеет эту ошибку в справочной странице, версия 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не отображается конкретное действие.

Я полагаю, это будет зависеть от вашей 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