Aller au contenu

Mkd (Extracteur de documents)/mkddocu-Manuel (fr)

Un livre de Wikilivres.
mkddocu(1)                            Linux User's Manual                           mkddocu(1)

NOM
       mkddocu  - Cette commande shell génère la documentation informatique de tout fichier de
       projet reconnu par le logiciel mkd.

SYNOPSIS
       mkddocu [projet] [-s]

DESCRIPTION
       La commande mkd associée à mkddocu,  extrait  les  commentaires  dotés  d'un  caractère
       repère.
       Exemple : //D ceci est un commentaire php repéré par le caractère 'D'
       Si  des  fichiers de langage C sont présents, mkddocu génère un fichier d'entête global
       (header) du projet informatique.

       Repère :
       D - Extrait la documentation générale.
       H - Crée le fichier d'entête global (header) si un fichier C est présent.
       P - Extrait un document utile aux mainteneurs, noms, dates, versions, etc.
       T - Extrait le document des directives de tests. (Unitaires, d'intégration, etc.)

OPTIONS
       projet Cette option permet de choisir un nom de projet différent de project par défaut.
              Si 'projet' est le caractère '?' la commande affiche la syntaxe.

       -s     Cette option précise qu'il faut générer le fichier des chaînes de caractères  et
              le fichier des chaînes utiles aux traductions avec gettext et poedit.

VALEURS RETOURNÉES
       0 : Fin normale à la fin de l'exécution de la commande ou de l'aide (syntaxe).
       -1 : La commande mkd n'est pas installée.
       -2 : Arrêt de la commande.  La sauvegarde de la série de documents dans Backups n'a pas
       été effectuée.

EXEMPLES
       L'auto-documentation de cette commande se crée avec le fichier d'origne mkddocu.sh
       Lancer la commande 'mkddocu.sh mkddocu -s'
       Le répertoire maintenance/mkddocu contiendra les documents.
       Les répertoires de projet sont générés par séries et peuvent avoir été sauvegardés dans
       un  répertoire Backups si le nombre de fichiers de projet de la série a atteind la lim‐
       ite BACKUPSMAX
       Pour les essais on peut se limiter à BACKUPSMAX=2 (3 'backups' par série.)

REMARQUES
       BACKUPSMAX est normalement fixé à 9 mais peut être modifié par  édition  du  fichier  :
       /usr/bin/mkddocu.

VOIR AUSSI
       mkd(1) xgettext(1) poedit(1)

TÉLÉCHARGEMENTS
       http://edeulo.free.fr

AUTEURS
       Clara, JPL, Luca
       Email : http://edeulo.free.fr/contacts/formmail.php

BUGS
       Rapports de bugs :  http://edeulo.free.fr/phpBB3/viewforum.php?f=14

                                          2014-02-24