Apple fournit-il un site Web avec le contenu des pages de manuel pour les commandes de ligne de commande fournies avec Mac OS X?

14

Je souhaite fournir des liens URL vers le contenu des pages de manuel sur apple.com en tant que source d'informations faisant autorité. Décrire et citer la page de manuel locale est gênant.

Apple fournit-il des pages de manuel sur le Web?

command-line documentation Basil Bourque
la source
Chaque version d'OS X contient déjà des copies locales des pages de manuel pour les programmes en ligne de commande, il n'est donc pas nécessaire de pointer ailleurs et pourquoi Apple ne maintient plus un ensemble de pages pour chaque version sur leur site Web.
user3439894
4
Il est utile de les avoir sur un site Web pour les relier aux programmeurs qui utilisent d'autres systèmes d'exploitation. Une entreprise de la taille d'Apple pourrait également les avoir sur son site sans aucun effort.
Lassi
J'en ai besoin tout le temps. Parfois, j'essaie d'écrire des scripts shell qui prendront en charge Linux et macOS (juste par exemple, s'il readlinkest disponible sur Mac ou comment obtenir la taille du fichier en octets stat). Bien sûr, je pourrais aller consulter les pages de manuel BSD mais allez , Apple.
TheDudeAbides

Réponses:

4

L'ancien index en ligne semble avoir disparu. Vous pouvez cependant trouver le code source des pages de manuel sur https://opensource.apple.com/ . Ce site héberge également des versions historiques.

Par exemple:

Malheureusement, il n'y a pas d'aperçu de toutes les pages de manuel, vous devez donc vérifier manuellement les index des répertoires ou utiliser quelque chose comme site:opensource.apple.com/source "ls.1"dans DuckDuckGo ou Google.

Lekensteyn
la source
L' site:opensource.apple.com/sourceastuce est géniale. Pour une liste consultable de toutes les pages de manuel de toutes les sections du manuel (bien que remontant à OS X 10.9 jours), voir ma réponse ci-dessous.
TheDudeAbides
3

Oui, Apple fournit ces pages en ligne, par exemple: https://developer.apple.com/legacy/library/documentation/Darwin/Reference/ManPages/man1/ls.1.html pour la commande ls .

Source: Dr Drang

samh
la source
7
Ce lien contient le mot «hérité» et concerne l'ancienne version de Mac OS X. Je n'ai pas pu trouver les éditions à jour de ce site.
Basil Bourque
3
Je ne sais pas ce qui pourrait être périmé - c'est le problème. Les pages indiquent clairement en gros caractères en haut This manual page is for Mac OS X version 10.9. La barre tout en haut de la page indique «Bibliothèque de documents retirés». Et «l'héritage» dans l'industrie informatique est définitivement un euphémisme pour «obsolète, n'est plus recommandé ou applicable». Donc, bien que ce site soit mieux que rien, il n'est certainement pas bon pour les discussions en cours. J'apprécie votre publication, je souhaite juste qu'il y ait des éditions à jour et des versions spécifiques des pages de manuel sur le Web.
Basil Bourque
9
@samh Salut, cette URL est morte maintenant
SebMa
10
Il semble qu'Apple ait supprimé cette section de son site ... de nouveaux emplacements?
0xF2
1
@ 0xF2 Vous pouvez accéder aux anciennes versions sur archive.org, mais Apple a cessé de les mettre à jour autour d'OS X 10.9.
Zenexer
3

Bonjour du futur monde de 2019!

Malheureusement, il semble qu'une recherche sur le Web site:opensource.apple.com/source stat.1reste l'état fondamental des choses, si vous voulez une documentation "officielle" d'Apple.com.

Voici quelques alternatives:

  • Pages de manuel de Darwin sur la Wayback Machine
    • il s'agit d'une capture de mai 2018, pour OS X 10.9 (Mavericks), et il y a encore quelques trous, vous devrez donc peut-être remonter plus loin dans le temps avec la Wayback Machine pour obtenir certaines pages
  • Pages de manuel de Mojave (10.14) sur unix.com
    • la conception du site utilise ici un espace ex cru ciating, et vous aurez probablement besoin de faire un zoom arrière pour voir les pages de manuel dans leur intégralité

Mise à jour: Au fait, vous pouvez formater la source brute de roff des pages de manuel sur opensource.apple.com en quelque chose de lisible par l'homme comme ceci:

  1. copiez l'URL "texte brut":

    entrez la description de l'image ici

  2. récupérer cette URL curlet la formater pour la visualiser à l'écran avec 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

    Quelques notes secondaires sur cette groffcommande:

    • ajoutez -rLL=${COLUMNS}nà utiliser toute la largeur de votre terminal, si 80 colonnes ne le font pas pour vous; la mancommande fait généralement un peu de magie pour détecter automatiquement cela à partir de la taille de votre terminal ( référence )
    • vous pouvez remplacer groff -man -T ps > ~/Desktop/grep.1.pscette dernière partie pour obtenir une belle page de manuel PostScript que vous pouvez ouvrir et imprimer avec Preview.app, si c'est votre truc
TheDudeAbides
la source
Fondamentalement, "Bonjour du monde futur" est correct pour chaque réponse donnée.
Max Ried
Si le monde futur a réellement résolu votre problème et a pris la peine de faire rapport. Mais parfois, le monde futur verrouille simplement votre fil à la place, sans résolution pour personne . :/
TheDudeAbides
2

Il y a quelques pages de manuel MacOS ici , bien que je ne sache pas à quel point la liste est complète.

benwiggy
la source
SS64 est une très bonne ressource pour quiconque travaille dans un environnement de ligne de commande, sur n'importe quel système d' exploitation. Il est bien structuré, complet et épuré. Si seule la documentation officielle de Microsoft (ou Apple) était à la hauteur de cette norme .
TheDudeAbides