Wikilivres

« Mkd (Extracteur de documents)/Comprendre les options » : différence entre les versions

Navigation interactive dans l’historique
← Modification précédenteModification suivante →
Contenu supprimé Contenu ajouté
VisuelWikicode
Ligne 485 :
Fonction asm_(); Fichier asm.c
Documentation simplifi�esimplifiée.
-------------------------
La fonction asm_() doit d�coderdécoder des commentaires, pr�pré-cod�scodés avec un caract�recarac-
tère ASCII qui suit le d�butdébut de commentaire. exemple
Exemple ;A en 'd�butdébut' ou 'dans' la ligne.
... et bla bla bla ...(raccourci pour les exercices)
Tests unitaires:
----------------
La fonction doit �treêtre �prouv�eéprouvée de telle sorte qu'un commentaire qui se
termine par le caract�recaractère de fin de fichier soit enti�remententièrement copi�copié dans
le fichier cible.
Le caract�recaractère de fin de fichier d�cod�décodé avant le caract�recaractère de fin de ligne
doit �treêtre remplac�remplacé par un caract�recaractère de fin de ligne.
Le caract�recaractère de fin de fichier (EOF) ne doit jamais appara�treapparaître dans texte
du fichier cible.
Ligne 500 ⟶ 507 :
 
ACTION:
La fonction asm_ lit le fichier �critécrit en assembleur et extrait les
renseignements de structure, l'organigramme, la documentation destin�edestinée
aux programmeurs, au fichier d'ent�teentête (.h) ou �à la documentation
destin�edestinée �à l'utilisateur etc.
On utilise ici les codes d'identficationidentification des commentaires suivants :
D: pour la documentation g�n�ralegénérale sur les fonctions (listing)
H: pour g�n�rergénérer le fichier d'ent�teentête (header, .h ou .hpp)
O: pour l'organigramme
S: pour le contr�lecontrôle de la structure du programme
T: pour les points de tests
U: pour la documentation utilisateur
Options :
n : num�ronuméro de ligne (ajoute dule num�ronuméro de ligne)
s : �cranécran (ajoute le commentaire �à l'�cranécran)
t : texte seul (ne copie pas les caract�rescaractères de rep�ragerepérage)
 
SYNTAXE:
Ligne 532 ⟶ 539 :
 
DROIT DE COPIE:
� mkd, EUPL 2007, pr�cis�eprécisée dans version.h
 
 
Ligne 538 ⟶ 545 :
Fonction cpp_(); Fichier cpp.c
Documentation simplifi�esimplifiée.
-------------------------
La fonction doit d�coderdécoder des commentaires, pr�pré-cod�scodés avec un caract�recaractère
ASCII qui suit //D le d�butdébut de commentaire. exemple //A ou /*A
... et bla bla bla ...(raccourci pour les exercices)
Tests unitaires:
----------------
V�rifiezVérifiez les options n, s et t s�par�mentsépar�ment:
V�rifiezVérifiez que la num�rotationnumérotation des lignes est correcte dans tous les cas de d�codage
décodage (lignes et blocs). n, ns. nt, nst.
V�rifiezVérifiez que le texte reste �à la bonne place dans tous les cas de d�codagedécodage:
toute la ligne (dans la cas de la directive de compilation FULL_LINE), ou
texte seul.
-- V�rifiezVérifiez que les tabulations sont bien prises en charge dans tous les
cas,; d�codagedécodage des lignes et des blocs.
-- V�rifiezVérifiez de m�memême pour les espaces.
La fonction doit �treêtre �prouv�eéprouvée de telle sorte qu'un commentaire qui se
termine par le caract�recaractère de fin de fichier soit enti�remententièrement copi�copié dans le
fichier cible.
Le caract�recaractère de fin de fichier d�cod�décodé avant le(les) caract�recaractère(s) de fin de
commentaire doit �treêtre remplac�remplacé par un caract�recaractère de fin de ligne.
Le caract�recaractère de fin de fichier (EOF) NE DOIT JAMAIS APPARA�TREAPPARAÎTRE DANS LE
TEXTE DU FICHIER CIBLE.
Ceci provoquait un bug dans la version Alpha de l'application fen�tr�efenêtrée
mkdcppw �à l'�tapeétape du test d'int�grationintégration.
Ligne 571 ⟶ 588 :
The 'Codes': table of 5 characters:
extern char codes[];
They must be d�fineddefined in the calling function:
char codes[5] = {0,0,0,0,0};
The 'Options': n,s,t,v.
extern unsigned char n,s,t;
They must be dEfineddefined in the calling function:
unsigned char n=0,s=0,t=0;
With the options:
Ligne 630 ⟶ 647 :
On l'utilisera par exemple ainsi
putchar "X"
Et cela g�n�reragénèrera :
mov dl,"X"
mov ah,2
Récupérée de « https://fr.wikibooks.org/wiki/Mkd_(Extracteur_de_documents)/Comprendre_les_options »