\documentclass{report}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{textcomp}
\usepackage{geometry}
\geometry{top=15mm, bottom=15mm, left=1cm, right=1cm}
\usepackage[french]{babel}
\usepackage{pslatex}
\usepackage[colorlinks=true,urlcolor=black]{hyperref}
\usepackage{graphicx}
\usepackage{fancyhdr}
\pagestyle{fancy}
\renewcommand{\footrulewidth}{0.4pt}
\fancyfoot[L]{Uubu.fr}
\fancyfoot[R]{jeu. janv. 30 22:36:04 CET 2014}
\lfoot{\Large \textit{Uubu.fr}}
\hypersetup{pdfinfo={
Title={man},
Author={Sylvain Girod},
Creator={Bash script from uubu.fr's format version 1},
Producer={Bash script and PDFLaTeX},
Subject={Man est le pager de manuel système. Chaque page donné en argument est normalement le nom du programme, utilitaire ou fonction.},
CreationDate={D:20140130223604},
ModDate={D:20140130223604},
Keywords={man;pager}
}}
\begin{document}
 
\begin{center}
{\Huge man }
\end{center}
\vspace{1cm}
 
\begin{flushleft}
 
{\large Man est le pager de manuel système. Chaque page donné en argument est normalement le nom du programme, utilitaire ou fonction.}
 
\vspace{10mm}
 
\vspace{1cm}{\huge Liste des sections }
 
\
 
\begin{description} \normalsize
\item[\hspace{1mm} 1]{Programmes exécutables ou commandes shell}
\item[\hspace{1mm} 2]{appels système (fonctions fournies par le kernel)}
\item[\hspace{1mm} 3]{Appel de librarie}
\item[\hspace{1mm} 4]{Fichiers spéciaux généralement trouvés dans /dev}
\item[\hspace{1mm} 5]{Formats de fichier et conventions}
\item[\hspace{1mm} 6]{Jeux}
\item[\hspace{1mm} 7]{Divers}
\item[\hspace{1mm} 8]{Commandes d'administration système}
\item[\hspace{1mm} 9]{Routine kernel non standard}
\end{description}
 
\hspace{1mm}  Les sections conventionnels incluent:
\vspace{5mm} \\
\hspace{1mm}  NAME, SYNOPSIS, CONFIGURATION, DESCRIPTION, OPTIONS, EXIT STATUS, RETURN VALUE, ERRORS, ENVIRONNEMENT, FILES, VERSIONS, CONFORMING TO, NOTES, BUGS, EXAMPLE, AUTHORS et SEE ALSO.
\vspace{5mm} \\
\hspace{1mm}  Les conventions suivantes s'appliquent à la section synopsis et peuvent être utilisées comme guide dans les autres sections:
\vspace{5mm} \\
 
 
\begin{description} \normalsize
\item[\hspace{1mm} Texte en gras]{taper exactement comme affiché}
\item[\hspace{1mm} texte italique]{Remplace avec l'argument approprié}
\item[\hspace{1mm} \texttt{[}-abc\texttt{]}]{ces arguments sont optionnels}
\item[\hspace{1mm} -a|-b]{Ne peuvent pas être utilisés ensemble}
\item[\hspace{1mm} argument ...]{L'argument est répétable}
\item[\hspace{1mm} \texttt{[}expressions\texttt{]} ...]{Toutes l'expression est répétable}
\item[\hspace{1mm} ]{}
\end{description}
 
\vspace{1cm}{\huge OPTIONS Générales }
 
\
 
\begin{description} \normalsize
\item[\hspace{1mm} -C file, --config-file=file]{Spécifie le fichier de configuration à utiliser au lieu de \textasciitilde/.manpath}
\item[\hspace{1mm} -d, --debug]{Mode debug}
\item[\hspace{1mm} -D, --default]{Réinitialise les paramètres à leur valeurs par défaut}
\item[\hspace{1mm} --warnings\texttt{[}=warnings\texttt{]}]{Active les alertes de groff.}
\end{description}
 
\vspace{1cm}{\huge Opérations du mode principal }
 
\
 
\begin{description} \normalsize
\item[\hspace{1mm} -f, --whatis]{Equivalent à whatis}
\item[\hspace{1mm} -k, --apropos]{Equivalent à apropos}
\item[\hspace{1mm} -K, --global-apropos]{Recherche du texte dans toutes les pages de manuel.}
\item[\hspace{1mm} -l, --local-file]{Active le mode local. Recherche dans les fichiers locaux au lieu des manuels système.}
\item[\hspace{1mm} -w, --where, --location]{N'affiche pas le man, mais affiche l'emplacement des fichiers source nroff}
\item[\hspace{1mm} -W, --where-cat, --location-cat]{N'affiche pas le man, mais affiche l'emplacement des fichiers cat}
\item[\hspace{1mm} -c, --catman]{Utilisé par le programme catman}
\item[\hspace{1mm} -R encoding, --recode=encoding]{Spécifie l'encodage pour l'affichage des manuels}
\end{description}
 
\vspace{1cm}{\huge Recherche de pages de manuel }
 
\
 
\begin{description} \normalsize
\item[\hspace{1mm} -L locale, --locale=locale]{Remplace l'appel setlocale(3)}
\item[\hspace{1mm} -m system\texttt{[},...\texttt{]}, --systems=system\texttt{[},...\texttt{]}]{Permet d'accéder à des page de manuel d'autres OS.}
\item[\hspace{1mm} -M path, --manpath=path]{Spécifie un manpath alternatif à utiliser.}
\item[\hspace{1mm} -S list, -s list, --sections=list]{Liste de sections de manuel à rechercher.}
\item[\hspace{1mm} -e sub-extension, --extension=sub-extension]{sur les systèmes qui incorporent beaucoup de pages de manuel, il peut y avoir plusieurs manuels ayant le même nom. exemple tcl peut avoir exit(3), on peut l'appeler avec exit(3tcl). *tcl permet de restreindre les recherches.}
\item[\hspace{1mm} -i, --ignore-case]{Insensible à la casse lors de la recherche de pages de man}
\item[\hspace{1mm} -I, --match-case]{Recherche sensible à la casse}
\item[\hspace{1mm} --regex]{Permet de spécifier que la recherche est un regex. implique a}
\item[\hspace{1mm} --wildcard]{Affiche toutes les pages avec n'importe quelle partie dans le nom ou le contenu matchent chaque argument page. implique -a}
\item[\hspace{1mm} --names-only]{si --regex ou --wildcard, match uniquement les nom des pages, pas la description, comme avec whatis}
\item[\hspace{1mm} -a, --all]{Par défaut, man va quitter après avoir affiché les pages de man qu'il a trouvé}
\item[\hspace{1mm} -u, --update]{effectue une vérification de consistance 'inode level' sur son cache.}
\item[\hspace{1mm} --no-subpages]{Support pour les page de manuel qui ont des sous commandes. ex:}
\end{description}
 
\hspace{6mm} man -aw git diff \\
\hspace{6mm} \textbf{/usr/share/man/man1/git-diff.1.gz} \\
\hspace{6mm} man -aw --no-subpages git diff \\
\hspace{6mm} \textbf{/usr/share/man/man1/git.1.gz} \\
\hspace{6mm} \textbf{/usr/share/man/man3/Git.3pm.gz} \\
\hspace{6mm} \textbf{/usr/share/man/man1/diff.1.gz} \\
 
\vspace{1cm}{\huge Contrôler la sortie formatée }
 
\
 
\begin{description} \normalsize
\item[\hspace{1mm} -p pager, --pager=pager]{Spécifie le pager à utiliser. ne peut pas être utilisé avec -f ou -k}
\item[\hspace{1mm} -r prompt, --prompt=prompt]{si une version récente de less est utilisé comme pager, tente de définir son prompt et certaines options sensibles.}
\item[\hspace{1mm} -7, --ascii]{Affiche en pure ascii(7)}
\item[\hspace{1mm} -E encoding, --encoding=encoding]{Génère la sortie pour un jeu de caractères tel que UTF-8}
\item[\hspace{1mm} --no-hyphenation, --nh]{Désactive la césure automatique}
\item[\hspace{1mm} --no-justification, --nj]{Désactive la justification automatique}
\item[\hspace{1mm} -p string, --preprocessor=string]{Spécifie la séquence de pré-processeurs à lancer avant nroff ou groff. ex: eqn (e), grap (g), pic (p), tbl (p), tbl (t), vgrind (v), refer (r). zsoelim est toujours lancé au tout début.}
\item[\hspace{1mm} -t, --troff]{Utilise groff -mandoc pour formater la page de manuel.}
\item[\hspace{1mm} -T\texttt{[}device\texttt{]}, --troff-device\texttt{[}=device\texttt{]}]{Change la sortie de groff. implique -t. ex: dvi, latin1, ps, utf8, X75 et X100}
\item[\hspace{1mm} -H\texttt{[}browser\texttt{]}, --html\texttt{[}=browser\texttt{]}]{Force groff à produire une sortie HTML.}
\item[\hspace{1mm} -X\texttt{[}dpi\texttt{]}, --gxditview\texttt{[}=dpi\texttt{]}]{Affiche la sortie de groff en utilisant gxditview. dpi peut être 75, 75-12, 100 ou 100-12.}
\item[\hspace{1mm} -Z, --ditroff]{Groff utilise un post-processeur pour produire une sortie utilisable pour le périphérique choisi.}
\end{description}
 
\vspace{1cm}{\huge Exemples }
 
\
 
\hspace{1mm} Affiche la page de manuel de ls \\
\hspace{1mm} \textbf{man ls} \\
\hspace{1mm} Affiche successivement, toutes les pages de manuel intro disponibles. \\
\hspace{1mm} \textbf{man -a intro} \\
\hspace{1mm} Formatte le manuel référencé par l'alias en format troff par défaut et le pipe dans une imprimante nommée ps \\
\hspace{1mm} \textbf{man -t alias | lpr -Pps} \\
\hspace{1mm} Décompress et formatte en dvi \\
\hspace{1mm} \textbf{man -l -Tdvi ./foo.1x.gz > ./foo.1x.dvi} \\
\hspace{1mm} Recherche la description courte et les noms de page de manuel pour le regex donné. (idem à apropos -r printf) \\
\hspace{1mm} \textbf{man -k printf} \\
\hspace{1mm} Recherche les pages de manuel référencés par smail et affiche les descriptions courtes. (idem à whatis -r smail) \\
\hspace{1mm} \textbf{man -f smail} \\
 
\vspace{1cm}{\huge Variables d'environnement }
 
\
 
\begin{description} \normalsize
\item[\hspace{1mm} MANPATH]{Chemin de recherche pour les pages de manuel}
\item[\hspace{1mm} MANROFFSEQ]{Détermine le jeu de préprocesseurs à utiliser}
\item[\hspace{1mm} MANSECT]{Liste de sections dans lesquels rechercher et dans quel ordre.}
\item[\hspace{1mm} MANPAGER]{Pager à utiliser (défaut: pager -s)}
\item[\hspace{1mm} PAGER]{Pager à utiliser (défaut: pager -s)}
\item[\hspace{1mm} MANLESS]{Avec less comme pager, copie cette valeur telle quelle dans \$LESS}
\item[\hspace{1mm} BROWSER]{Liste de commandes utilisées pour lancer un navigateur web.}
\item[\hspace{1mm} SYSTEM]{Si le système a accès à des pages de manuel d'autres OS, permet de les inclure}
\item[\hspace{1mm} MANOPT]{Parsé avant la ligne de commande pour des options spécifiques}
\item[\hspace{1mm} MANWIDTH]{Longueur de ligne (défaut: 80)}
\item[\hspace{1mm} MAN\_KEEP\_FORMATTING]{les caractères de formattage définis sont affichés.}
\item[\hspace{1mm} MAN\_KEEP\_STDERR]{non vide, permet d'afficher les erreurs dans la sortie}
\item[\hspace{1mm} LANG]{Utilisé pour rechercher les locales}
\item[\hspace{1mm} LC\_MESSAGES]{Utilisé pour rechercher les locales.}
\end{description}
 
\vspace{1cm}{\huge Fichiers }
 
\
 
\begin{description} \normalsize
\item[\hspace{1mm} /etc/manpath.config]{Fichier de configuration de man-db}
\item[\hspace{1mm} /usr/share/man]{Contient les manuels}
\item[\hspace{1mm} /usr/share/man/index.(bt|db|dir|pag)]{DB cache pour l'index global.}
\item[\hspace{1mm} /var/cache/man/index.(bt|db|dir|pag)]{DB cache pour l'index global. FHS compliant}
\end{description}
\end{flushleft}
\end{document}
