\chapter{À l'aide !}
\label{chap-aide}
\begin{epigraphe}{\TeX{} Version 3.14159}
? h\\
Sorry, I already gave what help I could...\\
Maybe you should try asking a human?
\end{epigraphe}

\begin{introchap}{L'austérité}
  d'un terminal laisse pantois nombre
  d'utilisateurs affrontant pour la première fois un système Unix.
  Combien de fois l'Unixien n'a-t-il pas entendu un utilisateur se
  plaindre du manque de convivialité du système par rapport à ses «
  concurrents » intégrant aide en ligne, lignes chaudes et autres
  systèmes d'assistance à l'utilisateur ? Ce chapitre a donc pour
  principal objectif de tordre le cou à cette idée d'indisponibilité
  d'information.
\end{introchap}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%% commande shell

\section{Quoi fait quoi ?}
\label{sec-aide-commande}

\unix{} fournit une pléthore de commandes. En shell \soft{bash}, par
exemple, le fait d'appuyer par deux fois sur la touche tabulation dans
un terminal provoque l'apparition du message :
\begin{verbatim}
There are 2727 possibilities.  Do you really
wish to see them all? (y or n)
\end{verbatim}
L'interpréteur de commande signifie par là qu'il nous donne la
possibilité de choisir parmi 2727 commandes différentes et ayant
\emph{a priori} toutes une action différente. Dans cette section, nous
ne donnerons pas la signification et l'action de chacune de ces 2727
commandes mais plutôt le moyen de vous permettre d'accéder à
l'information concernant chacune d'entre elle. En effet, l'un des
principaux avantages d'\unix{} est de permettre l'accès à ce genre
d'informations.

%% apropos
\subsection{À propos}
\label{sec-apropos}
\index{aide!apropos@\texttt{apropos}}

La première question est probablement de savoir ce que vous désirez
faire. Supposons que vous cherchiez à visualiser le contenu de votre
répertoire de travail. Malheureusement, vous ne connaissez pas
\emph{la} commande qui permet de le faire. Un outil permet de faire
une recherche parmi les commandes disponibles : \com{apropos}.

Son utilisation est des plus simples. Tapez simplement
\com{apropos} suivi d'un mot-clé (en anglais) définissant au mieux
votre requête. Pour notre exemple, nous cherchons à visualiser le
contenu de notre répertoire de travail (en anglais : \emph{to display
  working directory content}). Essayons :
\begin{shellcom}
  ¢usercom«apropos display»
\end{shellcom}
Cette commande devrait faire apparaître un grand nombre (155 sur mon
système) de lignes ressemblant probablement à\footnote{Nous vous
  faisons grâce de 71 lignes.} :
\begin{verbatim}
bell (n)             - Ring a display's bell
bitmap (n)           - Images that display two colors
cal (1)              - displays a calendar
ckalloc, memory, ckfree, Tcl_DisplayMemory, 
  Tcl_InitMemory, Tcl_ValidateAllMemory (n)
                     - Validated memory allocation interface.
\end{verbatim}
Si vous aussi, vous prétendez être un informaticien plein de
qualités\footnote{Voir à ce sujet \citet{perl-programming} et sa
  définition de la paresse.} vous ne lirez pas (sauf peut-être en
dernier recours) ces 75 lignes.  Le mot-clé display n'était
probablement pas suffisamment significatif.  Essayons autre chose :
\begin{shellcom}
  ¢usercom«apropos working»
  cd (n)               - Change working directory
  chdir, fchdir (2)    - change working directory
  getcwd (3)           - Get current working directory
  pwd (1)              - print name of current/working directory
  pwd (n)              - Return the current working directory
  rcsclean (1)         - clean up working files
\end{shellcom}
Nous obtenons moins d'informations mais malheureusement pas celle qui
nous intéresse\footnote{Il n'empêche que vous savez maintenant changer de
  répertoire...}.
Essayons encore :
\begin{shellcom}
  ¢usercom«apropos content»
  dir (1)              - list directory contents
  gl_copyscreen (3)    - copy the screen contents of contexts
  ls (1)               - list directory contents
  perltoc (1)          - perl documentation table of contents
  pick (1)             - search for messages by content
  pair_content (3x)    - curses color manipulation routines
  stat (1)             - print inode contents
  vdir (1)             - list directory contents
  vga_dumpregs (3)     - dump the contents of the SVGA registers
  xev (1x)             - print contents of X events
\end{shellcom}
Il semble que la commande recherchée soit \com{dir} ou \com{ls}
ou \com{vdir}. Essayons l'une d'entre elles :
\begin{shellcom}
  ¢usercom«ls»
  2Hypergraphes  Impression  Microsoft  Sarah      games
  Admin          LaTeX       Mygale     Transfert  local
  Archives       Logo        NT         Web        nsmail
  Arkeia         Mac         Netscape   archive    test
  ConfigNT       Mail        Oueb       bin        tmp
\end{shellcom}
... et nous avons donc bien obtenu le contenu du répertoire courant.
En conclusion, \com{apropos} peut être considéré comme un « moteur
de recherche » sur le rôle des commandes disponibles.

%% whatis
\subsection{Mais c'est quoi donc ?}
\label{sec-whatis}
\index{aide!whatis@\com{whatis}}

Il arrive parfois d'oublier ce que peut faire une commande. Supposons
que l'on vous ait parlé de la commande \com{find} en vous disant
qu'elle était fabuleuse. La commande \com{whatis} devrait vous
éclairer.
\begin{shellcom}
  ¢usercom«whatis find»
  find (1)        - search for files in a directory hierarchy
\end{shellcom}
Notez que \com{whatis} ne sait pas nécessairement de quoi vous lui
causez :
\begin{shellcom}
  ¢usercom«whatis trouver»
  trouver: nothing appropriate
\end{shellcom}
\com{whatis} permet donc d'obtenir une information succincte sur le
rôle d'une commande shell.

%% man

\section{Les pages de manuel}
\label{sec-man}
\index{aide!man@\com{man}}

Le paragraphe précédent nous a permis de constater que \com{find}
permettait de rechercher des fichiers dans une arborescence.
Supposons que vous vouliez rechercher un fichier dénommé \com{toto}
perdu quelque part sur votre \emph{home}. Un \texttt{find toto} lancé
en ligne de commande produit un navrant \texttt{find: toto: No such
  file or directory}. Vous vous douterez alors que \com{find}
attend peut-être autre chose pour lui permettre de trouver ce fameux
\com{toto}. Une commande va nous aider grandement : \com{man}.
Osons un \texttt{man find}. Devant vos yeux ébahis devrait apparaître
une page de manuel (raccourci en anglais en \emph{manpage})
concernant \com{find}.

\subsection{Une page de manuel}
Les pages de manuel ont cette propriété d'avoir une structure assez
fixe. Détaillons quelques-unes de ses principales entrées :
\begin{description}
\item[Name] qui définit en une ligne ce que fait la commande. C'est
  d'ailleurs cette ligne qui est affichée par \com{whatis}. Il s'agit de la
  seule partie requise pour faire d'une page de documentation
  quelconque une \emph{manpage} ;
\item[Synopsis] qui précise la forme d'appel de la commande. Le
  synopsis précise de plus toutes les options qu'il est possible de
  passer à la commande et ses arguments éventuels ;
\item[Description] qui décrit effectivement l'action de la commande,
  précise le rôle de chaque argument ;
\item[Options] précise le rôle de chaque option (vous vous en doutiez,
  non ?);
\item[See Also] vous donne quelques commandes qui ont une action
  similaire à la commande dont vous avez la page de manuel sous les
  yeux et parfois les commandes utilisées par la commande.
\end{description}
Parfois on trouve également en fin de page, des exemples et les bugs
connus du programme documenté.

% Peut-être qu'à la fin de la page de manuel de \texttt{find} vous
% constaterez qu'il existe une référence à une commande dénommée
% \com{locate} (dans la partie SEE ALSO). Il est possible (cela
% dépend fortement de votre système Unix) que vous constatiez qu'un
% \texttt{man locate} fait apparaître la page de manuel non pas de
% \com{locate} mais de \com{slocate}. Il est donc possible qu'une
% commande soit documentée par la page de manuel d'une autre commande.
% Ceci reste tout de même assez marginal. Il est aussi possible qu'une
% même page de manuel contienne la documentation pour plusieurs
% commandes (c'est le cas pour la commande \com{hostname} sous Linux
% par exemple).

\subsection{Hiérarchie des pages de manuel}
Vous aurez constaté que la page de manuel de \com{find} commence en
fait non pas par NAME, mais en fait par un nébuleux FIND(1). Les pages
de manuel sont souvent hiérarchisées en douze sections numérotées de 1
à 9, \emph{n}, \emph{o} et \emph{l}. Décrivons succinctement cette
hiérarchie.
\begin{description}
\item[1] commandes de l'utilisateur pouvant être lancées par n'importe
  qui ;
\item[2] appels système (fonctions fournies par le noyau) ;
\item[3] fonctions propres à certaines bibliothèques (C, X  windows, etc.) ;
\item[4] ports et périphériques (c'est-à-dire les fichiers de /dev) ;
\item[5] descriptions de formats de fichier de configuration ;
\item[6] jeux ;
\item[7] divers (essentiellement des conventions) ;
\item[8] outils d'administration système ;
\item[9] routines des noyaux (propre à \linux).
\end{description}
Les sections suivantes ont vraisemblablement été abondonnées mais
peuvent être toutefois présentes sur de « vieux » systèmes :
\begin{description}
\item[n] ce qu'il y a de nouveau. Les documentations résidant dans
  cette partie se doivent d'être déplacées au bout d'un certain temps
  dans la section appropriée ;
\item[o] vieilles documentations condamnées à la disparition ;
\item[l] documentation locale propre à un système, un site.
\end{description}
Notons qu'il n'est pas conseillé d'utiliser les trois
dernières sections et que ces dernières ont de plus en plus tendance à
disparaître (sur le système où ces lignes sont écrites, seule subsiste
la section \emph{n}\footnote{Et elle ne contient que 210 pages de
  documentation alors que la section 1 en contient environ 1300.}).

Il peut arriver qu'un mot donné corresponde à des pages de
manuel de différentes sections. Par exemple, vous cherchez une
information sur la fonction~C \com{printf} :
\begin{shellcom}
  ¢usercom«apropos printf»
  format (n)           - Format a string in the style of sprintf
  gl_printf (3)        - write formatted output in graphic mode
  printf (1)           - format and print data
  sprintf, printf,(3)  - formatted output conversion
  printftest (6)       - tests the vgagl gl_printf function
  snprintf, vsnprintf (3) - formatted output conversion
\end{shellcom}
Si vous vous contentez d'un \texttt{man printf}, à votre grand
désarroi, vous ne pourrez visualiser que la page de documentation
correspondant à la section~1. Comment spécifier à \com{man} d'aller
regarder dans la section~3 ? Facile : essayez un \texttt{man 3 printf}
et réjouissez-vous :
\begin{shellcom}
  ¢usercom«man 3 printf»
  PRINTF(3)        Linux Programmer's Manual         PRINTF(3)
  
  NAME
      printf, fprintf, sprintf, snprintf, vprintf, vfprintf,
      vsprintf, vsnprintf - formatted output conversion
  
  SYNOPSIS
      #include <stdio.h>
  ...
\end{shellcom}
Bien entendu, il est nécessaire d'interroger une section dans laquelle
existe la page de documentation. Il y a fort à parier qu'un
\texttt{man 2 printf} vous rétorque narquoisement qu'il n'y a pas
d'entrée pour \texttt{printf} dans la section 2 du manuel.

\subsection{La variable d'environnement \envvar{MANPATH}}

Le plus rageant avec l'utilisation de \com{man} est d'obtenir un
insoutenable \emph{No manual entry for (le nom de la commande)}. Par
exemple, un \texttt{man xv} produit \emph{No manual entry for xv}. La
première idée qui peut vous venir à l'esprit est qu'il n'existe pas de
documentation pour cet outil qu'est \com{xv}. C'est possible mais
regardons de plus près une certaine variable d'environnement dénommée
\envvar{MANPATH}. 
\begin{shellcom}
  ¢usercom«echo $MANPATH»
  /usr/share/man:/usr/local/man
\end{shellcom}
%$
Cette variable a le même format que \voir{sec-conf-env}{\texttt{PATH}}
et indique à la commande \com{man} les endroits où rechercher les
pages de manuel. Dans l'exemple précédent, \com{man} ira donc dans
\texttt{/usr/share/man} puis (en cas d'échec) dans
\texttt{/usr/local/man} pour tenter de trouver l'information qui vous
intéresse. Aucune page n'étant associée à \com{xv}, \com{man} vous le
signifie poliment.  Il suffit de rajouter un nouveau répertoire de
recherche (\texttt{/usr/X11R6/man} sous Linux) à la variable
\envvar{MANPATH} pour voir apparaître la page de documentation.
\begin{shellcom}
  ¢usercom«export MANPATH=$MANPATH:/usr/X11R6/man»
  ¢shellprompt man xv
  XV(1)                                               XV(1)

  NAME
  xv - interactive image display for the X Window System
  «¢normalfont ... etc ... »
\end{shellcom}
%$
Cette variable devrait être \emph{a priori} « correctement »
configurée pour aller visiter les points de chute classiques des pages
de manuel, c'est-à-dire (cette liste ne se veut en aucun cas
exhaustive) \texttt{/usr/share/man}, \texttt{/usr/local/man} et
\texttt{/usr/X11R6/man}. 

Dans le cas où vous souhaiteriez installer certaines pages de manuel à
certains endroits précis de votre compte utilisateur, vous pouvez
utiliser la même démarche et ajouter dans vos
\voir{sec-shell-demarrage}{fichiers} de démarrage :
\begin{verbatim}
  export MANPATH=$HOME/man:$MANPATH
\end{verbatim}
%$
de manière à ajouter vos pages de manuels aux pages traitées par la
commande \com{man}.

\subsection{Recherche exhaustive}

Il peut arriver qu'en désespoir de cause, vous désiriez effectuer une
recherche exhaustive d'un mot donné dans l'ensemble des pages de
manuel. Si vous choisissez de prendre ce risque, sachez que c'est
possible mais qu'il y a de grandes chances que cela prenne un certain
temps\footnote{Par exemple, à la toute fin du siècle dernier, un
  \texttt{man -K yaourt} a pris environ une minute sur notre beau
  bi-Xeon (500 MHz - 512 Mo de RAM) et plus de cinq minutes sur notre
  bon vieux 486 (33 MHz - 24 Mo).}.

\subsection{La commande ultime}

Pour toutes les subtilités concernant votre version locale de \com{man},
vous n'avez finalement qu'une seule commande à connaître : \texttt{man
  man}. La boucle est donc bouclée.

% \subsubsection{En français ?}

% Les systèmes Unix entrent peu à peu dans une vague
% d'internationalisation assez massive et petit à petit les documents de
% référence que constituent les pages de manuel sont réécrites en des
% langages aussi variés que le swahili, le slovaque ou même le français.
% Concernant la traduction française justement, si vous vous sentez
% l'âme d'un \textsc{Artaud} \emph{vs} \textsc{Lewis}, votre
% participation sera la bienvenue

% %% info

\section{Le format info}
\label{sec-info} 
\index{aide!info@\com{info}}

Il existe un système de documentation répandu sur les systèmes \unix{}
basé sur les outils \gnu{} : le système Texinfo. L'idée de ce système
est de pouvoir produire à partir d'un source, à la fois une
information de type hypertexte et un document imprimable. D'un point
de vue technique, ce même source est passé à la moulinette de \TeX{}
pour produire la version papier, et par l'utilitaire \com{makeinfo}
pour produire la version hypertexte. On manipule la version imprimable
comme un document au format dvi traditionnel\footnote{Voir à ce sujet,
  le merveilleux ouvrage de \citet{lozano-latex}.}, et la version
hypertexte avec la commande \com{info} :
\begin{shellcom}
  ¢usercom«info whoami»
\end{shellcom}
vous permet de vous esbaudir avec quelque chose devant ressembler à
\begin{verbatim}
File: sh-utils.info,  Node: whoami invocation,  Next: groups 
invocation,  Prev:  logname invocation,  Up: User information

`whoami': Print effective user id
=================================

   `whoami' prints the user name associated with the current 
effective user id.  It is equivalent to the command `id -un'.

   The only options are `--help' and `--version'.  
   *Note Common options::.
\end{verbatim}
Les commandes à connaître pour manipuler \com{info} dans un terminal
sont :
\begin{itemize}
\item \texttt{SPC}/\texttt{-} : pour défiler vers la page
  suivante/précédente ;
\item \texttt{u} : pour le lien père (\emph{up}) ;
\item \texttt{n}/\texttt{p} pour le lien suivant/précédent
  (\emph{next}/\emph{previous}) dans la hiérarchie
\item \texttt{l} pour le lien précédent dans l'historique
  (\emph{last}) ;
\item \texttt{RET} pour pénétrer dans un lien
\item \texttt{q} pour quitter \soft{info}.
\end{itemize}
Si vous disposez d'\emacs, il existe une interface « cliquable »
permettant d'éviter de s'encombrer l'esprit avec les commandes
précédentes tout en vous donnant la possibilité de manipuler
joyeusement le bouton du milieu de votre souris préférée.

Notez enfin que s'il n'y a pas de page info associée à une commande,
l'exécution de \texttt{info <nom\_de\_commande>} vous affichera
simplement la page de manuel de la commande en question. Si la page de
manuel n'existe pas non plus, \com{info} vous affichera le sommaire
de l'ensemble des pages d'info existant sur votre site. Pour boucler
la boucle de manière analogue à la commande \com{man}, essayez :
\begin{shellcom}
  ¢usercom«info info»
\end{shellcom}

\section{Le logiciel}
\label{sec-aide-logiciel}

Tout bon logiciel devrait être fourni avec une documentation
présentant l'ensemble de ses fonctionnalités. Sous \linux, cette
documentation se trouve généralement installée dans le répertoire
\texttt{/usr/doc} ou \texttt{/usr/share/doc}. Un \com{ls} devrait
peut-être assouvir votre curiosité. Ces documentations sont
généralement rédigées en pur texte ASCII et \com{more} ou \com{less}
devrait vous permettre de les découvrir.  Si vous ne savez vraiment
pas à quoi peut servir une commande ou un logiciel donnés, vous pouvez
toujours tenter de l'exécuter avec l'option~\texttt{-h} ou
\texttt{-{}-help}, c'est parfois suffisant.

\section{Les HOWTO}
\label{sec-aide-howto}
\index{aide!HOWTOS}
\index{HOWTOS}

Il existe autour de \gnu/\linux, un système de documentation dénommé la
documentation HOWTO (en engliche, « comment faire » )\footnote{Pour
  les allergiques à Shakespeare (et les autres), certaines
  documentations ont été traduites dans notre belle langue.}.  Cet
ensemble de documents fait lui-même partie d'un vaste projet de
documentation nommé le \emph{linux documentation project} sur lequel
on peut obtenir des infos sur le site \url{http://www.linuxdoc.org}.
Sur la plupart des distributions de \linux{}, les Howto's sont
installés dans le répertoire recevant la documentation sur votre
système\footnote{Le répertoire \texttt{/usr/share/doc/HOWTO} sur la
  distribution Debian.}. Initialement formatées au format sgml, ces
docs sont disponibles aux formats texte, PostScript, html et dvi. On
trouve en vrac (plus de 400 thèmes sur une Debian Sarge), des
informations destinées à la fois à l'utilisateur, l'administrateur ou
au programmeur, sur les modems, l'impression, le son, l'interaction
avec le Palm Pilot, la programmation du port série, la configuration
des cartes SCSI, le jeu Quake, l'utilisation de \linux{} en Thaïlande
ou en Slovénie, bref tout sujet sur lequel un utilisateur de \linux{}
s'interroge un jour ou l'autre. Toutes ces documentations sont pour la
plupart très claires, prenant l'utilisateur novice « par la main » de
manière très progressive, avec moult exemples ; elles portent des
noms significatifs qui peuvent être utilisés comme argument aux moteurs
de recherche : \texttt{Printing-Howto},
\texttt{Serial-Programming-Howto}, etc. Lisez donc le
\texttt{Howto-Howto} !




\section{La documentation en ligne}
\index{aide!en ligne|(}

Si malgré les lectures des pages de manuels et de howtos, vous
n'arrivez toujours pas à comprendre comment peut fonctionner telle ou
telle commande, ou comment faire faire ceci ou cela à un logiciel
particulier, rien n'est encore perdu ! Il vous reste le monde
extérieur, des personnes qui ont les mêmes problèmes que vous ou qui
les ont déjà résolus.

\subsection{Les newsgroups}
\label{sec-news}
\index{aide!newgroups}
\index{newsgroups}

La première source d'informations du point de vue de sa richesse
mais aussi de son « bruit » est sans doute les groupes ou forums de
discussion (\emph{newsgroups}). Apprenez en effet que si vous vous
posez une question donnée, la probabilité pour que quelqu'un se la
soit déjà posée et surtout ait la réponse, est extrêmement grande.


Les \emph{news} constituent un vaste panneau d'affichage que tout le
monde peut consulter, sur lequel on peut poser des messages à
certaines conditions ; ce vaste panneau est séparé en thèmes
(\emph{group}) hiérarchisés. Parmi les milliers de thématiques
abordées, on trouve quelques groupes autour d'\unix{}. Ces groupes
font partie de la hiérarchie \texttt{comp.os} pour les groupes traitant
de l'informatique (\texttt{comp}\emph{uter}) et plus précisément des
systèmes d'exploitation (\texttt{o}\emph{perating}
\texttt{s}\emph{system}), ou de son pendant francophone
\texttt{fr.comp.os}. On trouvera parmi ces groupes :
\begin{itemize}
\item \texttt{fr.comp.os.unix} : discussion autour d'\unix ;
\item \texttt{fr.comp.os.linux.annonces} : les annonces concernant les
  nouvelles versions ou les rencontres entre utilisateurs ;
\item \texttt{fr.comp.os.linux.moderated} : groupe modéré sur
  l'utilisation de \linux{} ;
\item ...
\end{itemize}
On pourra également lire les groupes \texttt{comp.os.linux.*} de la
hiérarchie anglophone.  Il est important de comprendre que ces groupes suivent
quelques règles d'usage dont l'ignorance peut vous faire envoyer
plus ou moins poliment sur les roses :
\begin{itemize}
\item on veillera à respecter la nétiquette\footnote{voir par exemple
    une traduction en français à
    \url{http://www.sri.ucl.ac.be/SRI/rfc1855.fr.html}} dans le cadre
  de la communication « de un à plusieurs » ;
\item on testera son logiciel de news sur un groupe comme
  \texttt{fr.test} et non sur le groupe sur lequel on a l'intention de
  poster ;
\item on veillera à lire attentivement « toutes » les documentations
  disponibles (notamment les \voir{sec-faq}{faqs}) avant de
  poser une question dont la réponse se trouve dans une dizaine de
  manuels, au risque d'obtenir une réponse du genre : \com{man}
  \comarg{softquejarrivepasàfairemarcher} ou RTFM (qui signifie dans
  sa version polie : \emph{read the fantastic manual}) ;
\item il faudra lire les archives des mois précédents pour éviter de
  poser une question posée la veille ; une bonne source d'information
  pour rechercher dans les archives est le site
  \url{groups.google.com} qui fonctionne comme un moteur de
  recherche ;
\item on tentera de trouver la charte du groupe si elle existe et la
  lire ;
\item certains groupes sont modérés, c'est-à-dire qu'un groupe de
  personnes filtre votre message avant de le poster sur le groupe. Le
  filtrage a pour but de vérifier l'adéquation du contenu avec le
  thème du groupe. Par conséquent votre message n'apparaîtra pas
  immédiatement sur le groupe, inutile donc de le reposter !
\end{itemize}
Le mieux est sans doute de se renseigner précisément sur l'usage des
news en consultant des documents destinés aux nouveaux utilisateurs,
comme  par exemple \url{http://UsenetFR.free.fr/BU.htm}.

\subsection{Les mailing lists}
\index{mailing lists}
\index{aide!mailing lists}

Les listes de diffusion (ou \emph{mailing lists}) ont un caractère
plus confidentiel puisqu'il faut explicitement s'abonner auprès
d'un serveur pour recevoir les messages traitant d'un thème
donné. Lorsqu'on envoie un message à la liste, tous les adhérents le
reçoivent également ; le principe est donc différent du fonctionnement
des news. On pourra trouver des listes de discussions traitant de
points particuliers de \linux{} comme par exemple :
\begin{itemize}
\item \texttt{linux-8086} - for the 8086 systems 
\item \texttt{linux-admin} 
\item \texttt{linux-kernel} - General kernel discussion 
\item \texttt{linux-kernel}-announce 
\item \texttt{linux-sound}
\item ....
\end{itemize}
plus de soixante listes référencées sur
\url{http://www.linux.org/docs/lists.html}. Pour s'abonner, il faut
envoyer un mail poli au gentil robot qui manage tout ça à :
\texttt{majordomo@vger.kernel.org}. Le \emph{corps} du message doit
contenir le mot \texttt{subscribe} (s'abonner) suivi du nom de la
liste. Sans s'abonner on pourra consulter les archives des messages,
par exemple sur :
\begin{itemize}
\item \url{http://www.tux.org/hypermail}
\item \url{http://news.gmane.org}
\end{itemize}

\subsection{Le ouèbe}
\label{sec-ouebe}
\index{aide!sur le ouèbe}

La majorité des logiciels suivant le modèle open source dispose d'une
page web dite \emph{home page}. Sur cette page se trouve une
description du logiciel, des documentations pour l'utiliser et/ou
l'installer, et la dernière version à télécharger. Outre les moteurs
de recherche généraux, on pourra consulter :
\begin{itemize}
\item \url{freshmeat.net} : donnant des infos quotidiennes sur les
  nouveaux projets et disposant d'un moteur de recherche ;
\item \url{sourceforge.net} : hébergeant plusieurs projets de
  logiciels libres, dispose également d'un outil de recherche.
\end{itemize}

\subsection{Les foires aux questions}
\label{sec-faq}
\index{FAQs}
\index{aide!FAQs}

Le terme faq pour \emph{frequently asked question} est parfois traduit
par « foire\footnote{Traduction qui a le léger inconvénient de faire
  perdre la notion de questions \emph{fréquemment} posées.} aux
questions ».  Certaines personnes collectent donc les questions
fréquemment posées par les « p'tits nouveaux » et les « Grands Anciens
» et, de ce fait, les réponses fréquemment données pour écrire des
compendiums extrêmement riches en informations, astuces et autres
indices pour le débutant (et le confirmé aussi parfois). Une recherche
sur le Ouèbe avec votre moteur de recherche préféré avec votre question
et le mot-clé FAQ pourrait vous permettre d'atteindre le nirvana assez
rapidement. Vous trouverez sur les sites :
\begin{itemize}
\item \url{http://www.linuxdoc.org/FAQ/Linux-FAQ/index.html}
\item \url{http://www.linuxdoc.org/FAQ/}
\end{itemize}
la FAQ officielle de \linux{} et celles de quelques-uns des logiciels
connexes.

\subsection{Les Request for comments}
\label{sec-rfc}
\index{Rfc}
\index{aide!Rfc}

Même s'il s'agit de documents très techniques, il peut être utile de
connaître l'existence des RFCs (\anglais{request for comments}). Ces
documents maintenus par l'IETF (\anglais{Internet Engineering Task
  Force\footnote{\url{http://www.ietf.org}}}) décrivent les
standards utilisés sur le réseau Internet. Chacun de ces documents est
identifé par un numéro et passe de l'état de brouillon
(\anglais{draft}) à l'état de standard après un processus de
correction. On retrouvera parmi les RFCs la description des protocoles
réseau que nous utilisons quotidiennement (http, smtp pour le mail,
etc.).


\index{aide!en ligne|)}


\bigskip
\pagebreak[1]
\begin{center}
  $*$\\
  $*\quad *$\\[2\baselineskip]\nopagebreak[4]
  \textbf{Bon courage !}
\end{center}

% \section{Comment aider les autres ?}
% \begin{itemize}
% \item en rédigeant des docs après avoir collecté le maximum
%   d'informations sur un sujet que vous trouvez mal documenté ;
% \item en traduisant en sumérien des docs écrites en araméen ;
% \item en apprenant aux jeunots à trouver par eux-même l'information ;
% \item en diffusant ce manuel \texttt{8o)}
% \end{itemize}



%%% Local Variables: 
%%% mode: latex
%%% TeX-master: "../framabook"
%%% End: 
