Page-manuel (Unix)
Presque tout le substantiel UNIX et Unix-comme les logiciels d'exploitation de ont la documentation étendue connue sous le nom de pages d'homme de (abréviation le " ; pages" manuel ;). Unix commandent utilisé pour les montrer est man. Chaque page est un document d'un seul bloc.
Utilisation
Pour lire une page du manuel, on peut employer la commande à un message de sollicitation de la coquille , par exemple, " ; ftp" man ;. Des pages sont traditionnellement mentionnées using le " de notation ; " de nom (section) ; , par exemple. Le même nom de page peut apparaître dans plus d'une section du manuel. Ceci peut se produire quand les noms des commandes d'utilisateur des appels système ou du conflit des jeux de macros . Deux exemples sont et, ou et. La syntaxe pour accéder à la section manuelle non-default varie entre différentes réalisations d'homme. Sur le Linux et le *BSD, par exemple, la syntaxe pour la lecture est homme 3 printf Cependant, le format d'un d'une seule page pour chaque application, le manque de classification dans les sections et les équipements relativement peu sophistiqués de formatage ont motivé le développement des systèmes de documentation alternatifs, tels que le système précédemment mentionné de La plupart des applications de GUI d'Unix (en particulier ceux construites using le GNOME et des environnements de développement de KDE ) maintenant fournissent la documentation d'utilisateur dans HTML et incluent les visionneuses incorporées de HTML telles que Habituellement les pages d'homme sont écrites en anglais. Les traductions dans d'autres langues peuvent être également disponibles sur le système. Le format de défaut des pages d'homme est le Troff , avec l'homme du jeu de macros (aspect orienté) ou sur le Mdoc (sémantique de quelques systèmes orienté). Ceci permet pour composer une page d'homme au post-scriptum , pdf et divers autres formats pour le visionnement ou l'impression (bien que la plupart des utilisateurs préfèrent toujours l'interface terminale de défaut). .
Histoire
Le manuel du programmeur d'UNIX de a été édité la première fois le 3 novembre , le 1971 . Les premières pages d'homme réelles ont été écrites par le Dennis Ritchie et le Ken Thompson à l'insistance du Doug McIlroy en 1971. Les macros de Troff utilisés pour des pages de l'homme (- millimètre) étaient les d'usage universel écrits par Ted Dolotta (plus tard pour être le premier directeur d'USG et l'auteur principal du manuel de système III), avec des additions pour les manuels. Lorsque, la disponibilité de la documentation en ligne par le système de page-manuel a été considérée comme une grande avance. À ce jour, pratiquement chaque ligne de commande d'Unix application vient avec sa page d'homme, et beaucoup d'utilisateurs d'Unix perçoivent un manque de pages de l'homme comme signe de qualité ; en effet, quelques projets, tels que le Debian , sortent de leur manière d'écrire des pages d'homme pour des programmes manquant d'un. Peu de solutions de rechange à man ont apprécié beaucoup de popularité, à l'exception possible du " du projet de GNU ; information " de de ; système, un système tôt et simple de l'hypertexte . info. yelp pour lire l'aide dans l'application. Sections manuelles
Le manuel est généralement coupé en huit sections numérotées, organisées comme suit (sur schéma Unix de et Linux ) : Disposition
Toutes les pages d'homme suivent une disposition commune qui est optimisée pour la présentation sur un affichage simple des textes du ASCII , probablement sans n'importe quelle forme de mise en évidence ou de commande de police. Les titres suivants de section sont presque toujours présents et sont toujours en cette règle :
NOM - le nom de la commande ou de la fonction, suivi d'une un-ligne description de ce qu'il fait.
SYNTHÈSE - dans le cas d'une commande, vous obtenez une description formelle de la façon la courir et quelle ligne de commande options elle prend. Pour des fonctions de programme, une liste des paramètres que la fonction prend et que le dossier d'en-tête contient sa définition. Pour les utilisateurs expérimentés, ceci peut être toute la documentation qu'ils ont besoin.
DESCRIPTION - une description textuelle du fonctionnement de la commande ou de la fonction.
EXEMPLES - quelques exemples d'utilisation commune.
VOIR ÉGALEMENT - la liste de commandes ou de fonctions relatives. D'autres sections peuvent être présentes, mais ce ne sont pas bons normalisés à travers des pages de l'homme. Les exemples communs incluent : OPTIONS, ÉTAT DE SORTIE, ENVIRONNEMENT, BOGUES CONNUS, DOSSIERS, AUTEUR, RAPPORTANT DES BOGUES, l'HISTOIRE et le COPYRIGHT. Voir également
Liste de des programmes d'Unix
Liste de des applications du plan 9
Information de (Unix)
RTFM Random links: Manawydan | Histoire de grands nombres | Genre Balkan | Maître du ménage de l'Ecosse | LWS-3 Mewa | Página_manual_(Unix)