doc(1)

NOM

doc - affichage des pages de manuel en html

SYNOPSIS

doc [section] nom

 

DESCRIPTION

doc est un script pour l'interpréteur de commandes. Il permet d'afficher des pages de manuel au format html à la place de la commande man(1). Les pages doivent se trouver dans le répertoire /usr/share/doc/man-html/fr/ pour pouvoir être retrouvées.

Si la page demandée est trouvée, lynx est appelé pour l'afficher. Si elle n'est pas trouvée dans le répertoire ci-dessus, c'est la commnde man(1) normale qui est lancée.

Le section correspond au thème habituel dans FreeBSD et est la même que celle utilisée par man(1).

 

SCRIPT

Voici le script utilisé :

#page a afficher :
if (test $# -eq 2 ); then
   lapage=$2
   lasection=$1
elif (test $# -eq 1 ); then
   lapage=$1
   lasection=""
else
   echo "Quelle page voulez-vous afficher ?."
   exit
fi
 
#chemin d'accès de la page en question.
#C'est "man" qui se charge de la chercher :
chemin=$(man -w -M /usr/share/doc/man-html/fr $lasection $lapage)
erreur=$? #La page est-elle trouvée ?
 
#C'est lynx qui affiche la page html ou man la page man
if (test $erreur -eq 0); then
   lynx $chemin
else
   /usr/bin/man $lasection $lapage
fi

VOIR AUSSI

man(1)

 

AUTEUR

le script doc a été écrit par Guillain SEUILLOT <guillain@lycosmail.com> le 8 novembre 2000.