Apakah Apple menyediakan situs web dengan konten halaman `man` untuk perintah-perintah baris yang dibundel dengan Mac OS X?

14

Saya ingin memberikan tautan URL ke konten halaman manual di apple.com sebagai sumber informasi yang resmi. Menggambarkan dan mengutip halaman manual lokal adalah canggung.

Apakah Apple menyediakan halaman manual di web?

Basil Bourque
sumber
Setiap rilis OS X sudah berisi salinan lokal dari halaman manual untuk program command line, jadi tidak perlu menunjuk ke tempat lain dan mengapa Apple tidak lagi memelihara satu set halaman untuk setiap rilis di situs web mereka.
user3439894
4
Berguna untuk memilikinya di situs web untuk ditautkan dengan programmer yang menggunakan sistem operasi lain. Juga sebuah perusahaan seukuran Apple bisa memilikinya di situs mereka tanpa usaha.
Lassi
Saya membutuhkan ini sepanjang waktu. Terkadang saya mencoba menulis skrip shell yang akan mendukung Linux dan macOS (hanya misalnya, apakah readlinktersedia di Mac, atau bagaimana cara mendapatkan ukuran file dalam byte dari stat). Tentu, saya bisa mencari halaman manual BSD tapi ayolah , Apple.
TheDudeAbides

Jawaban:

4

Indeks online lama sepertinya harus lenyap. Namun Anda dapat menemukan kode sumber halaman manual di https://opensource.apple.com/ . Situs ini juga memiliki versi historis.

Sebagai contoh:

Sayangnya tidak ada ikhtisar semua halaman buku panduan, jadi Anda harus memeriksa indeks direktori secara manual atau menggunakan sesuatu seperti site:opensource.apple.com/source "ls.1"di DuckDuckGo atau Google.

Lekensteyn
sumber
The site:opensource.apple.com/sourcetrick brilian. Untuk daftar yang dapat ditelusuri dari semua halaman buku panduan dari semua bagian dari buku pedoman (meskipun kembali ke OS X 10.9 hari) lihat jawaban saya di bawah ini.
TheDudeAbides
3

Ya, Apple menyediakan halaman ini secara online, misalnya: https://developer.apple.com/legacy/library/documentation/Darwin/Reference/ManPages/man1/ls.1.html untuk perintah ls .

Sumber: Dr Drang

samh
sumber
7
Tautan itu berisi kata "legacy", dan membahas versi lama Mac OS X. Saya tidak dapat menemukan edisi terbaru dari situs itu.
Basil Bourque
3
Saya tidak tahu apa yang mungkin ketinggalan zaman - itulah masalahnya. Halaman-halamannya dengan jelas mengatakan dalam huruf besar di bagian atas This manual page is for Mac OS X version 10.9. Bilah paling atas pada halaman mengatakan "Perpustakaan Dokumen Pensiunan". Dan "warisan" dalam industri TI pasti adalah eufemisme untuk "ketinggalan zaman, tidak lagi direkomendasikan atau berlaku". Jadi sementara situs ini mungkin lebih baik daripada tidak sama sekali, tentu tidak baik untuk diskusi saat ini. Saya menghargai posting Anda, saya hanya berharap ada edisi terbaru dan versi manual dari halaman manual di web.
Basil Bourque
9
@samh Hai, URL ini sudah mati sekarang
SebMa
10
Tampaknya Apple mencatat bagian situs mereka ... ada lokasi baru?
0xF2
1
@ 0xF2 Anda dapat mengakses versi lama di archive.org, tetapi Apple berhenti memperbarui di sekitar OS X 10.9.
Zenexer
3

Halo dari dunia masa depan 2019!

Sayangnya, tampaknya pencarian web site:opensource.apple.com/source stat.1masih merupakan hal mendasar, jika Anda ingin dokumentasi "resmi" dari apple.com.

Berikut ini beberapa alternatif:

  • Halaman manual Darwin di Mesin Wayback
    • ini adalah tangkapan Mei 2018, untuk OS X 10.9 (Mavericks), dan masih ada beberapa lubang, jadi Anda mungkin perlu kembali lebih jauh dengan Mesin Wayback untuk mendapatkan beberapa halaman.
  • Halaman manual Mojave (10.14) di unix.com
    • desain situs di sini menggunakan mantan cru jumlah ciating spasi, dan Anda mungkin akan perlu tampilannya keluar untuk melihat halaman manual secara keseluruhan

Pembaruan: Omong-omong, Anda dapat memformat sumber roff mentah dari halaman manual di opensource.apple.com menjadi sesuatu yang dapat dibaca manusia seperti ini:

  1. salin URL "teks biasa":

    masukkan deskripsi gambar di sini

  2. ambil URL itu dengan curldan format untuk dilihat di layar dengan 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
    

    Beberapa catatan samping tentang groffperintah itu:

    • tambahkan -rLL=${COLUMNS}nuntuk menggunakan lebar penuh terminal Anda, jika 80 kolom tidak melakukannya untuk Anda; yang manperintah biasanya tidak sihir untuk autodetect ini dari ukuran terminal Anda ( referensi )
    • Anda dapat mengganti groff -man -T ps > ~/Desktop/grep.1.psbagian terakhir itu untuk mendapatkan halaman manual PostScript yang indah yang dapat Anda buka dan cetak dengan Preview.app, jika itu yang Anda inginkan
TheDudeAbides
sumber
pada dasarnya "Halo dari dunia masa depan" adalah benar untuk setiap jawaban yang diberikan.
Max Ried
Jika dunia masa depan benar-benar memperbaiki masalah Anda, dan repot - repot melaporkan kembali. Tapi terkadang dunia masa depan justru mengunci utas Anda, tanpa resolusi untuk siapa pun . :/
TheDudeAbides
2

Ada beberapa halaman manual MacOS di sini , meskipun saya tidak tahu seberapa lengkap daftar itu.

benwiggy
sumber
SS64 adalah sumber yang sangat bagus untuk siapa saja yang bekerja di lingkungan baris perintah, pada OS apa pun . Ini terstruktur dengan baik, komprehensif, dan tidak berantakan. Jika hanya dokumentasi resmi Microsoft (atau Apple) yang memenuhi standar ini .
TheDudeAbides