Shell command projects/mkd
De Wiki EELL.
(Différences entre les versions)
JPL (discuter | contributions) m (→Manuel en français : Ajouté numéroter les lignes) |
JPL (discuter | contributions) m (→Manuel en anglais : !!) |
||
| Ligne 98 : | Ligne 98 : | ||
CD3 in line, and next New-Line. CD1, CD2, CD3 are compilable | CD3 in line, and next New-Line. CD1, CD2, CD3 are compilable | ||
options in version.h from mkd distribution) | options in version.h from mkd distribution) | ||
| + | |||
| + | -n add the line number | ||
-p page (extract text delimited by CD4 and CD5 -begin with CD4 and | -p page (extract text delimited by CD4 and CD5 -begin with CD4 and | ||
| Ligne 181 : | Ligne 183 : | ||
</pre> | </pre> | ||
{{Boîte déroulante/fin}} | {{Boîte déroulante/fin}} | ||
| + | |||
=== Manuel en français === | === Manuel en français === | ||
{{Boîte déroulante/début|titre=Manuel fr}} | {{Boîte déroulante/début|titre=Manuel fr}} | ||
Version du 5 décembre 2012 à 17:13
↑ Retour au portail mkd
Cette page n'est pas encore opérationnelle. L'empaquetage n'est pas prévue avant juillet 2012.
La version console (terminal) non empaquetée est disponible: Projet_mkd/téléchargements/UNIX_LINUX
Sommaire |
Documentation visuelle
Téléchargement de paquets
Download local packages
Index of mkd local package distribution
Distribution Ubuntu
dist bin deb https://launchpad.net/~jean-paul-louyot/+archive/mkd/+packages ubuntu 12.04 (precise)
Mettre votre liste des paquets à jour (systèmes d'expoitation plus anciens) :
deb http://ppa.launchpad.net/jean-paul-louyot/mkd/ubuntu precise main
deb-src http://ppa.launchpad.net/jean-paul-louyot/mkd/ubuntu precise main
Pour les nouveaux systèmes ubuntu 12.04 (precise) l'utilitaire deb n'existe plus.
Pour mettre votre liste à jour, utilisez : sudo add-apt-repository ppa:jean-paul-louyot/mkd
Pour récupérer les fichiers source : apt-get source mkd
Traductions
Les messages du code source étaient écrits en français ISO et a été réécrit en anglais pour faciliter les traductions en UTF-8.
Depuis la version 120508 les messages sont traduits en français UTF-8
Docs
- Attention : Ces manuels sont au format UTF-8 pour lecture. Téléchargez les applications qui contiennent les manuels 'man1' (Manual pages)
Manuel en anglais
Manual en
MKD(1)
NAME
mkd - make documentation. Extract coded informations from programs
sources and product specific documentation.
SYNOPSIS
mkd [-ABCFPSafjlpstw] char_codes path_source [path_target]
DESCRIPTION
mkd
Selected comments (or all comments) are extracted from programs
sources and product specific documentation to target file. Usual
target files are Organigrams, or Structure of programs, or com‐
ments for Programmers, Warnings and Tests points .... Coded
informations are respectively 'O', 'S', 'P', 'www', and 'T' just
after the comment character.
char_codes
All ASCII. The comment are extracted if the comment begin with
this character. With two star mkd extract all comments.
path_source
Path source file (or project file: option j ).
path_target
Path target file. Default, path target is idendical to source
file with extension ´.doc´ .
OPTIONS
Uppercase options:
restrict comments to one specific language:
-A extract Assembler style comments ( ; to end of line )
-B Basic style (REM or ' -> end of line)
-C C style ( / * -> * / )
-F Fortran style (c,C or * -> end of line)
-P Pascal style ( { -> } )
-S Shell or ratfor style ( # -> end of line)
Lowercase options:
-a append to current target file.
-f find source file language. (useful with project file)
-j used if source file is a project file.
-l lines (extract lines delimited by CD1 or CD2 in first colomn or
CD3 in line, and next New-Line. CD1, CD2, CD3 are compilable
options in version.h from mkd distribution)
-n add the line number
-p page (extract text delimited by CD4 and CD5 -begin with CD4 and
end with CD5-. CD4, CD5 are compilable options in version.h from
mkd distribution)
-s add to screen. (verbose)
-t text (copy only the comment).
-w overwrite the current target file.
EXAMPLES
with Cshell command:
mkd -Ct F manual mkd.1 | gzip -f mkd.1.gz
Product UNIX manual for french users.
mkd -Ct M manual mkd.1 | gzip -f mkd.1.gz
Product UNIX manual.
mkd -Csl '*Sied' mkd3.c '*.verif_struct'
Product documentation with structure of program, includes,
defines, ifdef else and endif compile options, to verify struc‐
ture of program. (with compilable options CD1='#' or CD2='#' in
version.h from mkd distribution).
mkd -jfsl '*OHie' mkd_docu.prj mkd.org
Product organigram. Comment begin with *,O,H, and sources files
are itemized in project file. Options: 'f' find languages, 'j'
Source file is a project file. (with compilable options CD1='#'
or CD2='#').
mkd -l '*ide' mkd3.c '*.id_ei'
(with compilable options CD1='#' or CD2='#').
mkd -pj '**' mkd_docu.prj mkd.strings
Extract strings from program. (messages are printed to stdout).
(sources files are itemized in project file, and with compilable
options CD4=CD5=´\"´).
mkd (without argument)
Cause any error and syntax are transmited to terminal.
SEE ALSO
mkdcppw(1)
HISTORY
1986 - mkd for DOS, and mkdoc for UNIX, are writen in ASCII format by
Jean-Paul Louyot for the Montpellier Universidad 'CEM' laboratory
(France).
1991 - mkdoc 3.12 for PC and UNIX (Sun)
1995 - mkdoc 3.22 for Linux Red-Hat
2004 - mkdoc 4 for SUN-SPARC, HP-UX, RedHat, Windows 98, Windows 2000
2007-2012 - mkdoc release 7.01 to mkd R12.01 are in format ISO-8859-1.
The name 'mkdoc' is abandoned with the release 10.01 compiled with
Visual C++ 2010
2012 - mkd 12.03 is adapted to UTF-8 format for translations and
internationalization. In the wake mkdcppw is writen to decode computer
C, c++ and php languages in graphical mode with 'gcc' and 'gtkmm'.
AUTHORS
JP LOUYOT, Clara JIMENEZ.
Translations : Alizée (Catalan, Spanish), Luca (Italian).
http://edeulo.free.fr/wiki/index.php/Projet_mkd/Compilations_UNIX-LINUX
NOTES
No match to read and decode the files included in the sources files in
this Release 12.05.0
BUGS
Bugs Report: http://edeulo.free.fr/phpBB3/index.php
Documents generator mkd 2 December 2012 MKD(1)
Manuel en français
Manuel fr
MKD(1)
NOM
mkd - make documentation. Extrait des informations codées dans les
programmes sources, et produit une documentation spécifique.
SYNOPSIS
mkd [-ABCFPSafjlpstw] codes chemin_source [chemin_cible]
DESCRIPTION
mkd Des commentaires sélectionnés (ou tous les commentaires) sont
extraits des programmes sources: 'chemin_source', et sont copiés
dans un fichier documentaire: 'chemin_cible', afin de produire
une documentation spécifique . Habituellement les fichiers
documentaires sont des Organigrammes, des Structures de
programme, des commentaires pour Programmeurs, des points de
Test et 'warnings' .... Les codes de sélection peuvent être
respectivement 'O', 'S', 'P', 'T' et 'www' juste après le
caractère début de commentaire.
codes Les commentaires commençant par ces caractères sont extraits du
programme source et sont ajoutés au fichier documentaire. Tous
les caractères ASCII peuvent servir a coder les commentaires,
toutefois on utilise habituellement des caractères majuscules,
sauf w pour 'warning'. Avec deux étoiles en paramètre codes, mkd
extrait tous les commentaires. (Voir aussi option t et les
exemples).
chemin_source
Chemin du fichier source (ou fichier projet: option j)
path_target
Chemin du fichier documentaire. Par défaut chemin_cible est une
copie de chemin_source auquel on remplace le suffixe par le
suffixe Ž.docŽ.
OPTIONS
Options en majuscules:
Restreind l'extraction des commentaires a un style de langage:
-A extrait le style Assembleur ( ; -> fin de ligne)
-B style Basic (REM ou ' -> fin de ligne)
-C style C ( / * -> * / )
-F style Fortran (c,C ou * -> fin de ligne)
-P style Pascal ( { -> } )
-S style Shell ou ratfor ( # -> fin de ligne)
options en minuscules:
-a (append) Ajoute a la suite du fichier documentaire
Žchemin_cibleŽ.
-f (find) Trouve le langage du fichier source par analyse du
suffixe. (sŽutilise généralement avec un fichier projet)
-j (project) SŽutilise avec un fichier projet composé de sources en
langages différents.
-l (lignes) Extrait les lignes commençant par les caractères CD1 ou
CD2 ou CD3 et suivis par un des caractères codes, le commentaire
se termine par la lecture du caractère ŽNew LineŽ. CD1 et CD2
doivent être placés en 1ère colonne, alors que CD3 peut être
placé en milieu de ligne. CD1, CD2, CD3, sont des options de
compilation dans le fichier version.h de la distribution source
de mkd.
-n numéroter les lignes.
-p (page) Extrait le texte débutant par le caractère CD4 suivi dŽun
des caractères codes, l'extraction du commentaire se termine
avec la lecture du caractère CD5. CD4 et CD5 sont des options de
compilation dans le fichier version.h de la distribution source
de mkd.
-s (screen verbose) Duplique les commentaires extraits sur la
sortie standard.
-t (text) Ne copie que le commentaire.
-w (overwrite) Réécrit le fichier documentaire.
EXEMPLES
avec une commande Cshell :
mkd -Ct F manual mkd.1 | gzip -f mkd.1.gz
(Produit un manuel UNIX en francais. au format UTF-8 depuis la
version 12.03) C: pour décoder le fichier en langage C, s:avec
visualisation à lŽ écran, t:ne copier que le commentaire,
F:sélectionner les commentaires debutants par F.
mkd -Ct M manual mkd.1 | gzip -f mkd.1.gz
(Produit un manuel UNIX standard en anglais au format UTF-8
depuis la version 12.03)
mkd -Csl '*Sied' mkd3.c '*.verif_struct'
(avec les options de compilation CD1 ou CD2 = '#', produit une
documentation avec la structure du programme, avec les: include,
define, ifdef, else, et endif, des options de compilations afin
de vérifier la structure du programme.) C:décoder les
commentaires style C, s:vérifier à l'écran, l:décoder egalement
des lignes commencant par les caractères CD1 ou CD2 ou CD3 et
suivis des char_codes:*Sied.
mkd -jfsl '*OHie' mkd_docu.prj mkd.org
(avec les options de compilation CD1 ou CD2 = '#', produit un
organigramme. Les commentaires commencent par *,O,H, et les
chemins d'accès aux fichiers source sont les constituants du
fichier projet. Les options : 'f' trouve le style du langage,
'j' dit que le fichier source est un fichier projet (liste des
fichiers à documenter).
mkd -l '*ide' mkd3.c '*.id_ei'
(avec les options de compilation CD1='#' ou CD2='#', décode les
#includes, #define, #ifdef, #else, #endif des options de
compilation en C ).
mkd -pj '**' mkd_docu.prj mkd.strings
(avec les options de compilation CD4=CD5=Ž\"Ž, extrait les
chaînes de caractères du programme. (les commentaires sont
transmis a la sortie standard).
mkd (sans argument)
Génère une erreur et envoie la syntaxe au terminal avec les
caractères compilés pour les options l et p.
SIEHE AUCH
mkdcppw(1)
HISTOIRE
1986 - mkd pour DOS, et mkdoc pour UNIX, sont écrits au format ASCII
par Jean-Paul Louyot pour le laboratoire 'CEM' de l'université de
Montpellier (France).
1991 - mkdoc 3.12 pour PC et UNIX (Sun)
1995 - mkdoc 3.22 pour Linux Red-Hat
2004 - mkdoc 4 pour SUN-SPARC, HP-UX, RedHat, Windows 98, Windows 2000
2007 - 2012 - de mkdoc R7.01 à mkd R12.01 sont au format ISO-8859-1.
Le nom 'mkdoc' est abandonné avec la version 10.01 compilée avec
Visual C++ 2010
2012 - mkd 12.03 adapté au format UTF-8 pour son internationalisation.
Dans la foulée mkdcppw est écrit pour langages C, c++ et php en mode
graphique avec gcc et 'gtkmm' (fenêtres).
AUTEURS
JP LOUYOT, Clara JIMENEZ
Traductions : Alizée (Catalan, Espagnol), Luca (Italien).
http://edeulo.free.fr/wiki/index.php/Projet_mkd/Compilations_UNIX-LINUX
NOTES
Cette version 12.03.0 ne lit et ne décode pas les fichier inclus par
'#include' dans les sources.
BUGS
Bugs Report: http://edeulo.free.fr/phpBB3/index.php
Générateur de documents mkd 2 Décembre 2012 MKD(1)
Manuel en allemand
mkd-Handbuch de
MKD(1)
BEZEICHNUNG
mkd - make documentation. Extrakte codierten Informationen aus Quellen
Programm und Produkt spezifische Dokumentation.
ÜBERSICHT
mkd [-ABCFPSafjlpstw] char_codes path_source [path_target]
BESCHREIBUNG
mkd
Selected comments (or alle comments) are extracted from programs
sources and product specific documentation to target file. Usual
target files are Organigrams, or Structure of programs, or com‐
ments for Programmers, Warnings and Tests points .... Coded
informations are respectively 'O', 'S', 'P', 'www', ant 'T' just
after the comment character.
Ausgewählte Kommentaren, (oder alle Kommentaren) werden von Prog-
gramme Quelle extrahiert und Produkt spezifische Dokumentation.
Üblichen Zieldateien sind Organigramme, Struktur der Programme,
Kommentare für Programmierer, Warnungen oder Testpunkte Komment-
tare ... Codierte Informationen sind jeweils 'O', 'S', 'P',
'www' und 'T', direkt hinter dem Kommentar.
char_codes
Alle ASCII. Der Kommentar werden extrahiert, wenn der Kommentar
beginnt mit diesem Zeichen.
path_source
Pfad der Quelldatei. (Oder Projektdatei : Option j).
path_target
Pfad der Zieldatei. In der Standardeinstellung Pfad Ziel ist
identisch mit der Quelldatei mit der Erweiterung '.doc'.
OPTIONEN
Großbuchstaben Optionen:
; Restrict comments to one specific language:
Wählen Sie eine bestimmte Programmierung Sprache:
-A Assembler Stil Kommentare zu extraktieren ( ; Zum Ende der Zeile )
-B Basic Stil (REM or ' -> Ende der Zeile)
-C C Stil ( / * -> * / )
-F Fortran Stil (c,C or * -> Ende der Zeile)
-P Pascal Stil ( { -> } )
-S Shell or ratfor Stil ( # -> Ende der Zeile)
Kleinbuchstaben Optionen:
-a Hinzufügen am ende von Zieldatei.
-f Finden Quelldatei Programmierung Sprache. (Mit Projekt Datei)
-j Verwendet, wenn die Quelldatei ist eine Projektdatei.
-l Linien (Extrakt Linien beginnend mit CD1 oder CD2 in erste
Spalte, oder CD3 in Linie bis nächste ende der Zeile. CD1, CD2, CD3, sind
kompilierbare im Vertrieb und sind definiert in 'version.h')
-p Seite (Extrakt Text beschränkt mit CD4 und CD5 - Beginnend mit
CD4 und beendet mit CD5 - CD4, CD5, sind kompilierbare im Vertrieb
und sind definiert in 'mkd distribution', in 'version.h')
-s Fügt auf dem Konsole Bildschirm ('Verbose' ; Ausführliche)
-t Text (Kopiert nur der Kommentar).
-w Überschrieben die aktuelle Zieldatei.
BEISPIELE
Mit Cshell-Befehl:
mkd -Ct F manual mkd.1 | gzip -f mkd.1.gz
Produkt französisch UNIX Manual.
mkd -Ct M manual mkd.1 | gzip -f mkd.1.gz
Produkt englisch UNIX Manual.
mkd -Csl '*Sied' mkd3.c '*.verif_struct'
Produkt Dokumentation mit Struktur der Programme, '#includes',
'#defines', '#ifdef', '#else' und '#endif' Kompilierte Optionen,
für überprüfen die Struktur in Quelldatei in Programms (Mit den
Kompilierung--optionen CD1='#' oder CD2='#' in 'mkd distribution'
version.h).
mkd -jfsl '*OHie' mkd_docu.prj mkd.org
Produkt Organigramm. Der Kommentar beginnt mit *,O,H, und Pfad
zu den Quelldatei sind die Komponenten der Projektdatei.
Optionen : 'f' finden der Stil der Sprache, 'j' sagte dass die
Quelldatei ist eine Projektdatei. (Mit den Kompilierung Optionen
CD1='#' oder CD2='#' in 'mkd distribution' version.h)
mkd -l '*ide' mkd3.c '*.id_ei'
( Mit Kompilierung--optionen CD1='#' oder CD2='#' extrahiert
#include, #define, #ifdef, #else, #endif Kompilierung--optionen
der C- Sprache.
mkd -pj '**' mkd_docu.prj mkd.strings
(Mit Kompilierung--optionen CD4=CD5='\"', extrahiert Saiten aus
aus den Quelldateien. (Die Saiten werden auf die Standard-
Ausgabe angezeigt.)
mkd (mit ohne Argumente)
Generiert einen Syntaxfehler und zeigt die Syntax zum Konsole.
SIEHE AUCH
mkdcppw(1)
GESCHICHTE
1986 - mkd für DOS, und mkdoc für UNIX, sind im ASCII-Format geschrieben
von Jean-Paul Louyot für dem CEM Laboratory der Montpellier Universität.
(Frankreich).
1991 - mkdoc 3.12 für PC und UNIX (Sun)
1995 - mkdoc 3.22 für Linux Red-Hat
2004 - mkdoc 4 für SUN-SPARC, HP-UX, RedHat, Windows 98, Windows 2000
2007 - 2012 -mkdoc R7.01 bis R12.01 sind auf ISO-Format abgestimmt.
2012 - mkd 12.03 ist umgeschrieben in UTF-8 Format und mkdcppw für C,
c++, und php, ist geschrieben für Fenstern.
AUTOREN
Aktualisiert von : Clara JIMENEZ
Übersetzungen : Alizée (Katalanisch, Spanisch), Luca (Italienisch),
Deutsch (JPL geholfen von Martine)
http://edeulo.free.fr/wiki/index.php/Projet_mkd/Compilations_UNIX-LINUX
HINWEISE
Diese Version lesen, und Dekodiert nicht, mit '#include' Richtlinie
in der Quelldatei.
Dokuments--generator mkd 5 Dezember 2012 MKD(1)
