Apple fornisce un sito Web con contenuto di pagine "man" per i comandi della riga di comando in bundle con Mac OS X?


14

Voglio fornire collegamenti URL al contenuto della pagina man su apple.com come fonte autorevole di informazioni. Descrivere e citare la pagina man locale è imbarazzante.

Apple fornisce pagine man sul Web?


Ogni versione di OS X contiene già copie locali di pagine di manuale per i programmi della riga di comando, quindi non è necessario puntare altrove e perché Apple non mantiene più un set di pagine per ogni versione sul proprio sito web.
user3439894,

4
È utile averli su un sito Web per il collegamento a programmatori che utilizzano altri sistemi operativi. Anche un'azienda delle dimensioni di Apple potrebbe averli sul loro sito praticamente senza sforzo.
Lassi,

Ho bisogno di questi tutto il tempo. A volte sto provando a scrivere script di shell che supporteranno sia Linux che macOS (solo per esempio, se readlinkè disponibile su Mac o come ottenere la dimensione del file in byte da stat). Certo, potrei andare a cercare le pagine del manuale di BSD ma andiamo , Apple.
TheDudeAbides

Risposte:


4

Il vecchio indice online sembra essere svanito. Puoi comunque trovare il codice sorgente delle pagine di manuale su https://opensource.apple.com/ . Questo sito ospita anche versioni storiche.

Per esempio:

Sfortunatamente non esiste una panoramica di tutte le pagine del manuale, quindi è necessario controllare manualmente gli indici delle directory o utilizzare qualcosa come site:opensource.apple.com/source "ls.1"DuckDuckGo o Google.


Il site:opensource.apple.com/sourcetrucco è geniale. Per un elenco sfogliabile di tutte le pagine di manuale di tutte le sezioni del manuale (anche se risalenti al OS X 10.9 giorni) vedere la mia risposta di seguito.
TheDudeAbides

3

Sì, Apple fornisce queste pagine online, ad esempio: https://developer.apple.com/legacy/library/documentation/Darwin/Reference/ManPages/man1/ls.1.html per il comando ls .

Fonte: Dr Drang


7
Quel link contiene la parola "legacy" e indirizza la vecchia versione di Mac OS X. Non sono riuscito a trovare edizioni aggiornate di quel sito.
Basil Bourque,

3
Non so cosa potrebbe non essere aggiornato - questo è il problema. Le pagine dicono chiaramente in caratteri grandi in alto This manual page is for Mac OS X version 10.9. La barra in alto nella pagina dice "Libreria documenti ritirata". E "eredità" nel settore IT è sicuramente un eufemismo per "obsoleto, non più raccomandato o applicabile". Quindi, sebbene questo sito possa essere migliore di niente, non è certamente positivo per le discussioni in corso. Apprezzo molto il tuo post, vorrei solo che ci fossero edizioni aggiornate e in versione specifica delle pagine man sul web.
Basil Bourque,

9
@samh Ciao, questo URL è morto ora
SebMa,

10
Sembra che Apple abbia rimosso quella sezione del loro sito ... nuove posizioni?
0xF2,

1
@ 0xF2 Puoi accedere alle vecchie versioni su archive.org, ma Apple ha smesso di aggiornarle su OS X 10.9.
Zenexer,

3

Ciao dal futuro mondo del 2019!

Purtroppo, sembra che la ricerca sul web site:opensource.apple.com/source stat.1sia ancora lo stato fondamentale delle cose, se si desidera la documentazione "ufficiale" da apple.com.

Ecco alcune alternative:

  • Pagine man di Darwin sulla Wayback Machine
    • questa è un'acquisizione di maggio 2018, per OS X 10.9 (Mavericks), e ci sono ancora alcuni buchi, quindi potrebbe essere necessario tornare indietro nel tempo con la Wayback Machine per ottenere alcune pagine
  • Pagine man di Mojave (10.14) su unix.com
    • il design del sito qui utilizza un ex cru importo l'am- di spazi bianchi, e probabilmente necessario per diminuire fuori per vedere le pagine man nella loro interezza

Aggiornamento: A proposito, puoi formattare l'origine raw roff delle pagine man su opensource.apple.com in qualcosa di leggibile come questo:

  1. copia l'URL "testo normale":

    inserisci qui la descrizione dell'immagine

  2. recupera l'URL con curle formattalo per la visualizzazione sullo schermo con 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
    

    Alcune note a margine su quel groffcomando:

    • aggiungi -rLL=${COLUMNS}nper utilizzare l'intera larghezza del tuo terminale, se 80 colonne non lo fanno per te; il mancomando di solito fa un po 'di magia per rilevare automaticamente ciò dalla dimensione del terminale ( riferimento )
    • puoi sostituire groff -man -T ps > ~/Desktop/grep.1.psquest'ultima parte per ottenere una bellissima pagina di manuale PostScript che puoi aprire e stampare con Preview.app, se è il tuo genere

fondamentalmente "Ciao dal mondo futuro" è corretto per ogni data risposta che ci sia.
Max Ried il

Se il mondo futuro ha effettivamente risolto il tuo problema e si è preso la briga di riferire. Ma a volte il mondo futuro blocca invece il tuo thread, senza alcuna risoluzione per nessuno . :/
TheDudeAbides

2

Ci sono alcune pagine man di MacOS qui , anche se non so quanto sia completo l'elenco.


SS64 è davvero una buona risorsa per chiunque lavori in un ambiente a riga di comando, su qualsiasi sistema operativo. È ben strutturato, completo e ordinato. Se solo la documentazione ufficiale di Microsoft (o Apple) fosse conforme a questo standard .
TheDudeAbides
Utilizzando il nostro sito, riconosci di aver letto e compreso le nostre Informativa sui cookie e Informativa sulla privacy.
Licensed under cc by-sa 3.0 with attribution required.