Предоставляет ли Apple веб-сайт с содержимым страниц man для команд командной строки, связанных с Mac OS X?

14

Я хочу предоставить URL-ссылки на материалы справочной страницы на apple.com в качестве авторитетного источника информации. Описывать и цитировать местную справочную страницу неудобно.

Предоставляет ли Apple справочные страницы в Интернете?

command-line documentation Базилик Бурк
источник
Каждый выпуск OS X уже содержит локальные копии страниц руководства для программ командной строки, поэтому нет необходимости указывать в другом месте и почему Apple больше не поддерживает набор страниц для каждого выпуска на своем веб-сайте.
user3439894
4
Полезно иметь их на веб-сайте для связи с программистами, которые используют другие операционные системы. Также компания размером с Apple может разместить их на своем сайте без особых усилий.
Ласси
Мне нужно это все время. Иногда я пытаюсь написать сценарии оболочки, которые будут поддерживать как Linux, так и macOS (например, readlinkдоступен ли он на Mac или как получить размер файла в байтах stat). Конечно, я могу пойти посмотреть справочные страницы BSD, но давай , Apple.
TheDudeAbides

Ответы:

4

Старый онлайн-индекс, похоже, исчез. Однако вы можете найти исходный код справочных страниц на https://opensource.apple.com/ . Этот сайт также содержит исторические версии.

Например:

К сожалению, нет обзора всех страниц справочника, поэтому вы должны вручную проверить индексы каталогов или использовать что-то вроде site:opensource.apple.com/source "ls.1"DuckDuckGo или Google.

Lekensteyn
источник
site:opensource.apple.com/sourceТрюк является блестящим. Для просмотра списка всех страниц руководства из всех разделов руководства (хотя и начиная с OS X 10,9 дней) см. Мой ответ ниже.
TheDudeAbides
3

Да, Apple предоставляет эти страницы в Интернете, например: https://developer.apple.com/legacy/library/documentation/Darwin/Reference/ManPages/man1/ls.1.html для команды ls .

Источник: Доктор Дранг

samh
источник
7
Эта ссылка содержит слово «legacy» и относится к старой версии Mac OS X. Я не смог найти последние версии этого сайта.
Василий Бурк
3
Я не знаю, что может быть устаревшим - вот в чем проблема. Страницы четко написаны крупным шрифтом вверху This manual page is for Mac OS X version 10.9. Самая верхняя полоса на странице гласит «Библиотека документов на пенсию». И «наследие» в ИТ-индустрии определенно является эвфемизмом для «устаревшего, более не рекомендуемого или не применимого». Таким образом, хотя этот сайт может быть лучше, чем ничего, он, конечно, не подходит для текущих обсуждений. Я очень ценю ваши сообщения, я просто хочу, чтобы в Интернете были свежие и специальные версии справочных страниц.
Василий Бурк
9
@samh Привет, этот URL уже мертв
SebMa
10
Похоже, Apple снял этот раздел своего сайта ... какие-нибудь новые места?
0xF2
1
@ 0xF2 Вы можете получить доступ к старым версиям на archive.org, но Apple перестала обновлять их в OS X 10.9.
Zenexer
3

Привет из будущего мира 2019 года!

К сожалению, кажется, что поиск в Интернете site:opensource.apple.com/source stat.1все еще является фундаментальным положением вещей, если вам нужна «официальная» документация от apple.com.

Вот несколько альтернатив:

  • Справочные страницы Дарвина на Wayback Machine
    • это снимок мая 2018 года для OS X 10.9 (Mavericks), и все еще есть некоторые дыры, поэтому вам может понадобиться вернуться назад во времени с Wayback Machine, чтобы получить некоторые страницы
  • Справочные страницы Мохаве (10.14) на unix.com
    • дизайн сайта здесь используется бывшим крит количество ciating символов пустого пространства, и вы , вероятно , придется увеличить выход , чтобы увидеть страницы человека во всех их полноте

Обновление: Кстати, вы можете форматировать сырой ROFF источник искусственных страниц opensource.apple.com в нечто Читабельно , как это:

  1. скопируйте "обычный текст" URL:

    введите описание изображения здесь

  2. получить этот URL-адрес curlи отформатировать его для просмотра на экране с помощью groff:

    # use 'wget -qO -' if you don't have 'curl'
curl -s https://opensource.apple.com/source/grep/grep-28/grep/doc/grep.1 \
  | groff -man -T utf8 \
  | less

    Некоторые примечания об этой groffкоманде:

    • добавьте, -rLL=${COLUMNS}nчтобы использовать всю ширину вашего терминала, если 80 столбцов не делают это для вас; команда , как правило , какая - то магия автоопределения это от вашего терминала размера ( эталонного )man
    • Вы можете заменить groff -man -T ps > ~/Desktop/grep.1.psэту последнюю часть, чтобы получить красивую справочную страницу PostScript, которую можно открыть и распечатать с помощью Preview.app, если это ваша вещь
Чувак пребывает
источник
в основном «Привет из будущего мира» правильно для каждого данного ответа.
bot47
Если будущий мир на самом деле исправил вашу проблему, и надоело отчитываться. Но иногда мир будущего просто блокирует вашу нить, без разрешения для кого-либо . :/
TheDudeAbides
2

Есть некоторая MacOS страницы человека здесь , хотя я не знаю , как полный список.

benwiggy
источник
SS64 - это действительно хороший ресурс для всех, кто работает в среде командной строки, на любой ОС. Он хорошо структурирован, всеобъемлющ и не перегружен. Если бы только официальная документация Microsoft (или Apple) соответствовала этому стандарту .
TheDudeAbides