Чи надає Apple веб-сайт із вмістом сторінок `man` для командних рядків команд, в комплекті з Mac OS X?


14

Я хочу надати URL-посилання на вміст чоловічої сторінки на apple.com як авторитетне джерело інформації. Опис і цитування сторінки місцевого чоловіка незручно.

Чи надає Apple веб-сторінки в Інтернеті?


Кожен випуск OS X вже містить локальні копії сторінок вручну для програм командного рядка, тому немає потреби вказувати в іншому місці і чому Apple більше не підтримує набір сторінок для кожного випуску на своєму веб-сайті.
користувач3439894

4
Корисно розмістити їх на веб-сайті для посилання на програмістів, які використовують інші операційні системи. Також компанія розміром Apple могла б розмістити їх на своєму сайті в основному не докладаючи зусиль.
Лассі

Мені це потрібно постійно. Іноді я намагаюся написати сценарії оболонки, які підтримуватимуть Linux та macOS (лише наприклад, readlinkдоступні вони на Mac чи як отримати розмір файлу в байтах stat). Звичайно, я міг би переглянути сторінки керівництва BSD, але, звичайно , Apple.
TheDudeAbides

Відповіді:


4

Старий інтернет-індекс, схоже, зник. Однак ви можете знайти вихідний код сторінок з посібниками на https://opensource.apple.com/ . На цьому сайті також розміщені історичні версії.

Наприклад:

На жаль, немає огляду всіх сторінок вручну, тому вам доведеться вручну перевіряти індекси каталогів або використовувати щось на кшталт site:opensource.apple.com/source "ls.1"DuckDuckGo або Google.


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 .

Джерело: Д-р Дранг


7
Це посилання містить слово "спадщина" і стосується старої версії Mac OS X. Я не зміг знайти оновлені видання цього сайту.
Василь Бурк

3
Я не знаю, що може бути застарілим - це питання. Сторінки чітко написані великим шрифтом вгорі This manual page is for Mac OS X version 10.9. На самій верхній панелі сторінки написано "Бібліотека документів у відставці". І "спадщина" в ІТ-галузі, безумовно, є евфемізмом "застарілого, більше не рекомендованого або застосовного". Тому, хоча цей сайт може бути кращим, ніж нічого, це, звичайно, не добре для поточних дискусій. Я дуже ціную вашу публікацію, я просто хочу, щоб в Інтернеті були актуальні та конкретні версії видання сторінок man.
Василь Бурк

9
@samh Привіт, ця URL-адреса тепер мертва
SebMa

10
Здається, Apple зняла цей розділ свого сайту ... якісь нові місця?
0xF2

1
@ 0xF2 Ви можете отримати доступ до старих версій на archive.org, але Apple перестала оновлювати їх навколо OS X 10.9.
Зенексер

3

Привіт з майбутнього світу 2019 року!

На жаль, здається, що пошук в Інтернеті site:opensource.apple.com/source stat.1все ще є основним станом речей, якщо ви хочете "офіційну" документацію з apple.com.

Ось кілька альтернатив:

  • Сторінки людини Дарвіна на машині Wayback
    • це захоплення в травні 2018 року для ОС X 10.9 (Mavericks), і все ще є деякі дірки, тому вам, можливо, доведеться повернутися далі за часом із машиною Wayback, щоб отримати деякі сторінки
  • Сторінки чоловіків Mojave (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 сторінки людини тут , хоча я не знаю , як повний список.


SS64 - це дійсно хороший ресурс для всіх, хто працює в середовищі командного рядка, на будь-якій ОС. Це добре структуроване, всеосяжне та безладне. Якби тільки офіційна документація Microsoft (або Apple) відповідала цьому стандарту .
TheDudeAbides
Використовуючи наш веб-сайт, ви визнаєте, що прочитали та зрозуміли наші Політику щодо файлів cookie та Політику конфіденційності.
Licensed under cc by-sa 3.0 with attribution required.