« Mkd (Extracteur de documents)/Introduction aux exercices » : différence entre les versions

Contenu supprimé Contenu ajouté
m →‎Exercices : WL:RD : ! mise en page
Ligne 96 :
* Quelle meilleure solution proposez-vous pour créer cpp-documentation_logicielle_codage.html ?<br />
[[Mkd_(Extracteur_de_documents)/Exercices/Corrigés|<u>''Solution 1.6''</u>]]
 
 
== Exercices pour se familiariser avec les fichiers de projets ==
* Dans votre répertoire des fichiers sources. (''ci-dessousaprès: ''fichier'' est un nom quelconque sensé représenter votre projet) dans le répertoire des fichiers sources.''
 
* Pour utiliser l'option -f [[Mkd_(Extracteur_de_documents)/Exercices#Notes_sur_le_finder|(finder)]] il pourra être utile d'ajouter un fichier d'un autre langage de programmation à votre convenance ''(Trouvez sur wikibooks ou wikipedia)''. A défaut recopiez et collez le texte ci-dessous dans un fichier nommé putchar.asm <small>''sous Windows''</small> ou putchar.s <small>''sous Linux''</small>, à placer dans le répertoire du projet, avec cpp.c et asm.c
<u>Utiliser l'option -f [[Mkd_(Extracteur_de_documents)/Exercices#Notes_sur_le_finder|'''(finder)''']]:</u><br />
C'est un exemple<ref>[[wikipedia:Assembleur#Macro-assembleur]]</ref> (en assembleur Microsoft [[w:MASM|MASM]]):
* Pour utiliservaloriser cette l'option -f [[Mkd_(Extracteur_de_documents)/Exercices#Notes_sur_le_finder|(finder)]] il pourra êtreserait utile d'ajouter un fichier d'un autre langage de programmation à votre convenance ''(Trouvez sur wikibooks ou wikipedia)''. A défaut recopiez et collez le texte ci-dessous dans un fichier nommé putchar.asm <small>''sous Windows''</small> ou putchar.s <small>''sous Linux''</small>, à placer dans le répertoire du projet, avec cpp.c et asm.c<br />
Trouvez l'exemple en assembleur Microsoft ([[w:MASM|MASM]]) sur wikipédia<ref>[[wikipedia:Assembleur#Macro-assembleur]]</ref>:
{{Boîte déroulante début|
titre='''putchar.asm'''|
}}
''Ce court fichier est utilisé à titre d'exemple pour donner une solution réaliste aux exercices et peut être remplacé par tout autre fichier en assembleur.''
<source lang="asm">
;P Fichier puchar, macro en assembleur pour MS-DOS
Ligne 139 ⟶ 143 :
{{Boîte déroulante fin}}
 
# Créer un '''fichier de projet''' ''fichier''.prj manuellement avec les fichiers disponibles. [[Mkd_(Extracteur_de_documents)/Exercices/Corrigés#Fichiers_de_projet|
==== Créer des fichiers de projets ====
''Aperçus et solutions des exercices pour comprendre les "Fichiers de projets"'']]
# Créer un '''fichier de projet''' ''fichier''.prj manuellement avec les fichiers disponibles. [[Mkd_(Extracteur_de_documents)/Exercices/Corrigés#Fichiers_de_projet|
 
''Aperçus et solutions des "Fichiers de projets"'']]
#=== Créer un '''fichier de projet''' ''fichier''.prj avec les commandes disponibles dans votre système d'exploitation; ls,manuellement dir.===
Projet exercice.prj ; à créer manuellement avec les fichiers disponibles asm.c cpp.c putchar.s<br />
[[Mkd_(Extracteur_de_documents)/Comprendre_les_fichiers_de_projets#Créer_un_fichier_de_projet_manuellement|Aperçu]]
 
=== Créer un fichier de projet avec les commandes système ===
Projet exercice.prj ; à créer avec les commandes de votre système d'exploitation; ls, dir.
[[Mkd_(Extracteur_de_documents)/Comprendre_les_fichiers_de_projets#Céer_un_fichier_de_projet_avec_les_commandes_système|Solution]]
 
==== Créer desun fichiersfichier de projetscommandes pour : ====
''Vous aurez copié les fichiers à éprouver dans le répertoire des essais . exécutez la commande '''mkd \?''' pour visualiser les extensions reconnues par <u>votre</u> mkd. Ces extensions dépendent des options de compilation.''
 
Les fichiers sont écrits dans des langages de programmation différents, le but est de créer des documentations globales avec ou sans le ''finder'' (option -f).<br />
# Créer un '''fichier de commandes '''pour : [[Mkd_(Extracteur_de_documents)/Exercices/CorrigésComprendre_les_fichiers_de_projets#Cr.C3.A9er_un_fichier_de_commandes_pour_Céer_un_fichier_de_commandes_pour_:|''Aperçus et solutions dedes "Fichiers de commandes"'']]
 
##==== mettreMettre à jour le '''fichier d'entête'''. header global, ''fichier''.h====
(header global, exercice.h)<br />
[[Mkd_(Extracteur_de_documents)/Comprendre_les_fichiers_de_projets#Mettre_à_jour_le_fichier_d'entête._header_globa|Solutionl]]
 
==== Mettre à jour l'organigramme de chaque fichier de programme ====
Pseudo-code; Code de repérage 'O',
asm.org, cpp.org, putchar.org<br />
[[Mkd_(Extracteur_de_documents)/Comprendre_les_fichiers_de_projets#Mettre_à_jour_l'organigramme_de_chaque_fichier_de_programme|Solution et aperçu avec commentaires]]
 
 
==== Créer des fichiers de commandes pour les projets ====
# Créer un '''fichier de commandes '''pour : [[Mkd_(Extracteur_de_documents)/Exercices/Corrigés#Cr.C3.A9er_un_fichier_de_commandes_pour_:|''Aperçus et solutions de "Fichiers de commandes"'']]
## mettre à jour le '''fichier d'entête'''. header global, ''fichier''.h
## mettre à jour '''l'organigramme'''; ''le pseudo-code''. Code de repérage 'O', ''fichier''.organigramme
## mettre à jour la '''structure des fichiers''' avec le pseudo code. Code 'S' et 'O' et 'w', ''fichier''.structure
## mettre à jour la '''documentation des programmeurs''', dates de mise à jour etc. Code 'P' ''fichier''.info_programmeurs
Ligne 153 ⟶ 175 :
## vous aurez copié '''les fichiers à éprouver''' dans le répertoire des essais . Voir les extensions reconnues par mkd avec la commande mkd \? ; ''Ces extensions dépendent des options de compilation.''
:::: Les fichiers sont écrits dans des langages de programmation différents, le but est de créer une documentation globale. Créez un fichier de commandes qui met '''mkd à l'épreuve''' avec ou sans le ''finder'' (option -f)
==== Notes sur le ''finder'' ====
::'''Le ''finder''''' (trouveur) cherche le style du langage par examen de l'extension du nom de fichier, l'option -f '''est rarement utilisée'''.
:Extensions:
Ligne 166 ⟶ 188 :
::Les commentaires en ADA commencent par deux tirets et ne sont pas reconnus en standard par le ''finder'' (trouveur) de mkd, cependant si il est facile de l'implémenter dans le fichier "find.inc.c" il faudra aussi créer un fichier spécifique à ADA (ada.inc.c)
 
=== Fichiers de tests unitaires ===
* Inspirez-vous de la documentation pour créer un fichier de commandes qui met la fonction à l'épreuve.
* '''Conditions des tests:''' tous les tests se feront avec l'option impérative -C