Shell command projects/mkd

De Wiki EELL.

(Différences entre les versions)

Aller à : Navigation, rechercher

Version du 6 avril 2013 à 16:58

Ubuntu

Debian

Fedora

↑ 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

1 Captures d'écran / Screenshot
2 Téléchargements de paquets / Downloads local packages
3 Distributions Ubuntu / Update packages
4 Manuels / Manuals
5 Sources
6 Mise à jour des traduction / Update translations
7 Aide / Help
8 Bugs

Captures d'écran / Screenshot

Téléchargements de paquets / Downloads local packages

Index of mkd local package distribution

Distributions Ubuntu / Update packages

launchpad.net +archive/mkd

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

Manuels / Manuals

(man1) :

- Téléchargez la mise à jour des manuels:

- Download the latest manual multi-lang Installer:

~~mkd manuals 2012-11-06~~ (en) (de) (fr) (Obsolète)

Attention : Vérifiez les dates de publication de ces pages de manuels ci-dessous en bas de page.

Manual in english

Manual en (April 6, 2013)


MKD(1)                                                                 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  pro‐
              grams  sources  and  product  specific  documentation to target
              file. Usual target files are Organigrams, or Structure of  pro‐
              grams,  or  comments for Programmers, Warnings and Tests points
              .... Coded informations are respectively 'O', 'S', 'P',  'www',
              ant '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                   ( // → NL and  /*  →  */ )

       -F     Fortran style               ( c,C or * → end of line )

       -P     Pascal style                ( {  →  } and (*  →  *)  )

       -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). You can see these
              options compiled by the command mkd \?

       -n     numbering the lines (line number from source files)

       -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). You can see these options  compiled  by
              the command mkd \?

       -s     add to screen. (verbose)

       -t     text (copy only the comment).

       -w     overwrite the current target file.

EXAMPLES
       with shell 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  listed  in project file.  (with compilable options CD1='#'
              or CD2='#'). f: find language, j: source file is a project file
              containing the list of sources files.

       mkd -l '*ide' mkd3.c '*.id_ei'
              (with  compilable  options  CD1='#'  or CD2='#', extract lines:
              #include, #define, #ifdef, #else, #endif, etc.)

       mkd -pj '**' mkd_docu.prj mkd.strings
              Extract strings from program. (messages are printed to stdout).
              (sources files are itemize in project file, and with compilable
              options CD4=CD5=´\"´).

       mkd (without argument)
              Cause any error and syntax are transmit to terminal with carac‐
              ters compiled to use options l and p.

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 - 2004 - mkdoc 3.22 to mkdoc 4 for Unix and Linux: SUN-SPARC, HP-
       UX, RedHat

       2004 - mkdoc 4 for Linux Ubuntu, 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'.

DOWNLOADS
       http://edeulo.free.fr/wiki/index.php/Projet_mkd/Compilations_UNIX-
       LINUX

AUTHORS
       man updated by Clara JIMENEZ, Cardabela, and JPL.

TRANSLATORS
       Catalan : Alizée

       English : JPL, Cardabela

       German : Clara, JPL, Martine

       Italian : Luca

       Spanish : Alizée, JPT, Sharo

       Email : http://edeulo.free.fr/contacts/formmail.php

NOTES
       It belong to the programmers to close comments, blocks and  lines,  by
       the appropriate closing codes in the source files.

       Warning:  The  closure of a comment line is a carriage-return (NL, LF,
       CR/LF) as the case.

       At the end of the file: this note implies a carriage-return at the end
       of  the  comment  line. In this case you must have a blank line at the
       end of the source file.

       Do es not allow to read and decode the files included by  #include  in
       the sources files.

BUGS
       Bugs Report: http://edeulo.free.fr/phpBB3/index.php

       Documents generator mkd




                                April 6, 2013                          MKD(1)

Manuel en français

Manuel fr (6 Avril 2013)

MKD(1)                                                                 MKD(1)



NOM
       mkd  -  make documentation.   Extrait des informations codées dans les
       programmes sources, et produit une documentation spécifique.

RÉSUMÉ
       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 car‐
              actè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)

       chemin_cible
              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++                  (  // → NL et  /*  →  */  )

       -F     style Fortran              ( c,C ou * → fin de ligne )

       -P     style Pascal               (  {   →   } et (*  →  *) )

       -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 suf‐
              fixe. (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 commen‐
              taire  se termine par la lecture du caractère ´Nouvelle Ligne´.
              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  distri‐
              bution  source  de mkd. On peut connaître ces options compilées
              par la commande mkd \?

       -n     (num) numérote les lignes (numéro de ligne du  fichier  d'orig‐
              ine).

       -p     (page)  Extrait  le  texte  débutant par le caractère CD4 suivi
              d´un des caractères codes, l'extraction du commentaire se  ter‐
              mine  avec  la  lecture  du  caractère CD5. CD4 et CD5 sont des
              options de compilation dans le fichier version.h de la  distri‐
              bution  source  de mkd. On peut connaître ces options compilées
              par la commande mkd \?

       -s     (screen verbose) Duplique les commentaires extraits sur la sor‐
              tie standard.

       -t     (text) Ne copie que le commentaire.

       -w     (overwrite) Réécrit le fichier documentaire.

EXEMPLES
       avec une commande shell :

       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 compila‐
              tions 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
              fichiers sources sont listés dans le fichier projet.) f:trouver
              le style de langage, j:le fichier source est un fichier  projet
              qui contient la liste des fichiers a 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 compi‐
              lation 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.


VOIR AUSSI
       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'univer‐
       sité  de Montpellier (France).

       1991 - mkdoc 3.12 pour PC et UNIX (Sun)

       1995 - 2004 - mkdoc 3.22 à mkdoc 4 pour Unix et Linux: SUN-SPARC,  HP-
       UX, RedHat

       2004 - mkdoc 4 pour Linux Ubuntu, 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  internationalisa‐
       tion. Dans la foulée mkdcppw est écrit pour les styles de langages C++
       (C,  c++,  c#, php, java, javscript, CSS, etc.) en mode graphique avec
       gcc et 'gtkmm' (fenêtres).

TELECHARGEMENTS
       http://edeulo.free.fr/wiki/index.php/Projet_mkd/Compilations_UNIX-
       LINUX

AUTEURS
       Manuel mis à jour par : Clara JIMENEZ

TRADUCTEURS
       Allemand : Clara, JPL, Martine

       Catalan : Alizée

       Espagnol : Alizée, JPT, Sharo

       Italien : Luca

       Email : http://edeulo.free.fr/contacts/formmail.php

NOTES
       Il appartient aux programmeurs de veiller à refermer les commentaires,
       blocs et lignes, par  les  codes  de  fermeture  appropriés  dans  les
       fichiers sources.

       Attention:  La fermeture d'un commentaire ligne est un  retour chariot
       ( NL, LF, CR/LF) selon les cas.

       En fin de fichier: cette note implique un retour  chariot  en  fin  de
       commentaire  ligne.  Dans  ce cas vous devez avoir une ligne vide à la
       fin du fichier source.

       Remarque: Cette version 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




                                 6 Avril 2013                          MKD(1)

Handbuch in German

mkd-Handbuch de (6. April 2013)

MKD(1)                                                                 MKD(1)



BEZEICHNUNG
       mkd - make documentation. Extrakte codierten Informationen aus Quellen
       Programm und Produkt spezifische Dokumentation.

ÜBERSICHT
       mkd [-ABCFPSafjlnpstw] Codes Quellpfad [Zieldatei]

BESCHREIBUNG
       mkd

       Selected comments (or  alle  comments)  are  extracted  from  programs
       sources  and product specific documentation to target file. Usual tar‐
       get files are Organigrams, or Structure of programs, or  comments  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, Kom‐
       mentare für Programmierer, Warnungen oder Testpunkte  Kommenttare  ...
       Codierte  Informationen  sind  jeweils  'O',  'S', 'P', 'www' und 'T',
       direkt hinter dem Kommentar.

       Codes  Alle  ASCII. Der Kommentar werden extrahiert, wenn der  Kommen‐
              tar beginnt mit diesem Zeichen.

       Quellpfad
              Pfad der Quelldatei. (Oder mit Projektdatei : Option j).

       Zieldatei
              Pfad  der  Zieldatei.  In  der  Standardeinstellung  Pfad  Ziel
              ist identisch mit der Quelldatei mit der Erweiterung '.doc'.

OPTIONEN
       Großbuchstaben Optionen:
              Wählen Sie eine bestimmte Programmierung Sprache:

       -A     Assembler Stil Kommentare zu extrahieren  (  ;   Zum  Ende  der
              Zeile)

       -B     Basic Stil               ( REM oder '  →  Zum Ende der Zeile  )

       -C     C++ Stil                 ( // → Ende der Zeile, und /*  →  */ )

       -F     Fortran Stil             ( c,C oder *  →   Zum Ende der Zeile )

       -P     Pascal Stil              ( {  Bis zu  }  und   (*  Bis zu  *) )

       -S     Shell oder Ratfor Stil   (   #  →  Bis  zu  Ende  der  Zeile  )

       Kleinbuchstaben Optionen:

       -a     (append) Hinzufügen am ende von Zieldatei.

       -f     (find)  Finden  Quelldatei Programmierung Sprache. (Mit Projekt
              Datei)

       -j     (project) Verwendet, wenn die Quelldatei ist eine Projektdatei.

       -l     (lines) 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').  Sie sehen die Optionen kompiliert
              mit dem Befehl mkd \?

       -n     (num) Zeilennummerierung (Die Nummer der Zeile der Quelldatei).

       -p     (page) Seite  (Extrakt Text beschränkt mit CD4 und CD5 - Begin‐
              nend mit CD4 und beendet mit CD5 - CD4, CD5, sind kompilierbare
              im Vertrieb und sind definiert in 'mkd distribution', in  'ver‐
              sion.h').  Sie sehen die Optionen kompiliert mit dem Befehl mkd
              \?

       -s     (screen verbose) Fügt auf dem Konsole Bildschirm  ('Verbose'  ;
              Ausführliche)

       -t     (text only) Text (Kopiert nur der Kommentar).

       -w     (overwrite) Überschrieben die aktuelle Zieldatei.

EXEMPLES
       Mit shell-Befehl:

       mkd -Cst F manual mkd.1 | gzip -f mkd.1.gz
              Produkt  französisch  UNIX Manual; Version 12.03. C: Sprache C,
              s:Auch  anzeigen   die   Konsole,   t:nur   text,   F:Code   zu
              entschlüsseln.

       mkd -Ct M manual mkd.1 | gzip -f mkd.1.gz
              Produkt  englisch  UNIX  Manual;  Version  12.03.   (Produit un
              manuel UNIX standard en anglais au format UTF-8 depuis la  ver‐
              sion 12.03)

       mkd -Csl '*Sied' mkd3.c  '*.verif_struct'
              (Mit  den  Kompilierung--optionen  CD1='#' oder CD2='#' in 'mkd
              distribution' version.h).Produkt  Dokumentation   mit  Struktur
              der  Programme,  '#includes', '#defines', '#ifdef', '#else' und
              '#endif' Kompilierte Optionen, für überprüfen die  Struktur  in
              Quelldatei in Programms

       mkd -jfsl '*OHie' mkd_docu.prj mkd.org
              (Mit  den  Kompilierung  Optionen  CD1='#' oder CD2='#' in 'mkd
              distribution' version.h)  Produkt  Organigramm.  Der  Kommentar
              beginnt  mit  *  oder O oder 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 Pro‐
              jektdatei.

       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  den Quelldateien. (Die Saiten werden auf die Standard-Aus‐
              gabe angezeigt.)

       mkd \? Zeigt die Syntax und den Charakter CD1 bis CD5 Kompiliert. (Mit
              den Optionen l und p verwendet)

       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, werden in ASCII geschrieben
       von Jean-Paul Louyot  für  CEM  loratory  in  Montpellier  Universität
       (Frankreich).

       1991 - 1991 - mkdoc 3.12 für PC und UNIX (Sun)

       1995 - 2004 - mkdoc 3.22 für Unix und Linux: SUN-SPARC, HP-UX, RedHat

       2004 - mkdoc 4 für Linux Ubuntu, Windows 98, Windows 2000

       2007  - 2012 -mkdoc R7.01 bis R12.01 sind auf ISO-8859-1-Format abges‐
       timmt.

       2012 - mkd 12.03 ist umgeschrieben in UTF-8 Format, und  mkdcppw  (für
       C, c++, php) ist geschrieben für Fenstern mit gcc und gtkmm.

DOWLOADS
       http://edeulo.free.fr/wiki/index.php/Projet_mkd/Compilations_UNIX-
       LINUX

AUTOREN
       Manuel mis à jour par : Clara JIMENEZ und JPL

ÜBERSETZER
       Deutsch : Clara, JPL, Martine

       Englisch : JPL, Cardabela

       Italienisch : Luca

       Katalanisch : Alizée

       Spanisch : Alizée, JPT, Sharo

       E-Mail : http://edeulo.free.fr/contacts/formmail.php

HINWEISE
       Es gehört zu Programmierer, um die Kommentare zu schließen, blöcke und
       Zeilen, mit entsprechenden Codes in Quelldateien.

       Warnung:  Die  Schließung  einer  Kommentarzeile ist ein Wagenrücklauf
       (NL, LF, CR/LF) als der Fall.

       Ende der Datei: Diese Beobachtung impliziert  einen  Wagenrücklauf  am
       ende  des  Kommentar Linie. In diesem Fall muss eine leerzeile am Ende
       der Quelldatei.

       Diese Version lesen, und Dekodiert nicht,  mit  '#include'  Richtlinie
       in der Quelldatei.

BUGS
       Bugs Report: http://edeulo.free.fr/phpBB3/index.php

       Documents generator mkd




                                6. April 2013                          MKD(1)

Sources

mkd-0~120508.tar.gz (langs: en, fr) Available on DEBIAN, UBUNTU, FEDORA

Mise à jour des traduction / Update translations

La mise à jour des traductions des messages est à distinguer de la mise à jour des manuels.

2012 :Les messages du code source étaient écrits en français ISO et ont été réécrit en anglais pour faciliter les traductions en UTF-8.

Depuis la version 12.03 les messages écrits en anglais font l'objet d'une traduction en français UTF-8

Décembre 2012 : les messages de la version 12.05 (120508) sont traduits en allemand (de).

Fichiers texte traduits, à traduire, ou à modifier (*.po)

Mise à jour des traductions (Update translations) *.mo avec installeur : (de) (en) (fr)

Aide / Help

Projet mkd/mkd/Aide

Projet mkd/mkd/Help

Bugs

Forum Rapports de bugs / Bugs report

Récupérée de « http://edeulo.free.fr/wiki/index.php/Shell_command_projects/mkd »