Shell command projects/mkd
De Wiki EELL.
JPL (discuter | contributions) m (→Manual in english : OK) |
JPL (discuter | contributions) m (→Handbuch in German : OK) |
||
| Ligne 439 : | Ligne 439 : | ||
{{Boîte déroulante/début|titre=mkd-Handbuch de (31. März 2013)}} | {{Boîte déroulante/début|titre=mkd-Handbuch de (31. März 2013)}} | ||
<pre> | <pre> | ||
| - | MKD(1) | + | MKD(1) MKD(1) |
BEZEICHNUNG | BEZEICHNUNG | ||
| - | mkd | + | mkd - make documentation. Extrakte codierten Informationen aus Quellen |
Programm und Produkt spezifische Dokumentation. | Programm und Produkt spezifische Dokumentation. | ||
| Ligne 453 : | Ligne 453 : | ||
mkd | mkd | ||
| - | Selected comments | + | Selected comments (or alle comments) are extracted from programs |
| - | sources and product specific documentation to target file. Usual | + | sources and product specific documentation to target file. Usual tar‐ |
| - | files are Organigrams, or Structure of programs, or comments for | + | 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, | + | Ausgewählte Kommentaren, (oder alle Kommentaren) werden von Prog‐ |
| - | Quelle extrahiert und Produkt spezifische | + | gramme Quelle extrahiert und Produkt spezifische Dokumentation. |
| - | Zieldateien sind Organigramme, Struktur der Programme, | + | Üblichen Zieldateien sind Organigramme, Struktur der Programme, Kom‐ |
| - | Programmierer, | + | mentare für Programmierer, Warnungen oder Testpunkte Kommenttare ... |
| - | Informationen sind jeweils 'O', 'S', 'P', 'www' und 'T', direkt | + | Codierte Informationen sind jeweils 'O', 'S', 'P', 'www' und 'T', |
| - | + | direkt hinter dem Kommentar. | |
| - | Codes Alle ASCII. Der Kommentar werden extrahiert, wenn der | + | Codes Alle ASCII. Der Kommentar werden extrahiert, wenn der Kommen‐ |
| - | beginnt mit diesem Zeichen. | + | tar beginnt mit diesem Zeichen. |
Quellpfad | Quellpfad | ||
| Ligne 473 : | Ligne 474 : | ||
Zieldatei | Zieldatei | ||
| - | Pfad der Zieldatei. In der Standardeinstellung Pfad Ziel | + | Pfad der Zieldatei. In der Standardeinstellung Pfad Ziel |
| - | identisch mit der Quelldatei mit der Erweiterung '.doc'. | + | ist identisch mit der Quelldatei mit der Erweiterung '.doc'. |
OPTIONEN | OPTIONEN | ||
| Ligne 480 : | Ligne 481 : | ||
Wählen Sie eine bestimmte Programmierung Sprache: | Wählen Sie eine bestimmte Programmierung Sprache: | ||
| - | -A Assembler | + | -A Assembler Stil Kommentare zu extrahieren ( ; Zum Ende der |
Zeile) | Zeile) | ||
| - | -B Basic Stil | + | -B Basic Stil ( REM oder ' → Zum Ende der Zeile |
| + | ) | ||
| - | -C C++ Stil ( // → Ende der Zeile, und /* → | + | -C C++ Stil ( // → Ende der Zeile, und /* → */ |
| + | ) | ||
| - | -F Fortran Stil | + | -F Fortran Stil ( c,C oder * → Zum Ende der Zeile |
| + | ) | ||
| - | -P Pascal Stil ( { Bis zu } und (* Bis zu | + | -P Pascal Stil ( { Bis zu } und (* Bis zu *) |
| + | ) | ||
| - | -S Shell oder Ratfor Stil ( # → Bis zu Ende der Zeile | + | -S Shell oder Ratfor Stil ( # → Bis zu Ende der Zeile |
| + | ) | ||
Kleinbuchstaben Optionen: | Kleinbuchstaben Optionen: | ||
| Ligne 497 : | Ligne 503 : | ||
-a (append) Hinzufügen am ende von Zieldatei. | -a (append) Hinzufügen am ende von Zieldatei. | ||
| - | -f (find) Finden Quelldatei Programmierung | + | -f (find) Finden Quelldatei Programmierung Sprache. (Mit Projekt |
Datei) | Datei) | ||
-j (project) Verwendet, wenn die Quelldatei ist eine Projektdatei. | -j (project) Verwendet, wenn die Quelldatei ist eine Projektdatei. | ||
| - | -l (lines) Linien (Extrakt | + | -l (lines) Linien (Extrakt Linien beginnend mit CD1 oder CD2 |
| - | in erste Spalte, oder CD3 in Linie bis nächste Ende | + | in erste Spalte, oder CD3 in Linie bis nächste Ende der Zeile. |
| - | CD1, CD2, CD3, sind kompilierbare im Vertrieb und sind | + | CD1, CD2, CD3, sind kompilierbare im Vertrieb und sind |
| - | in 'version.h') | + | definiert in 'version.h'). Sie sehen die Optionen kompiliert |
| + | mit dem Befehl mkd \? | ||
-n (num) Zeilennummerierung (Die Nummer der Zeile der Quelldatei). | -n (num) Zeilennummerierung (Die Nummer der Zeile der Quelldatei). | ||
| - | -p (page) Seite (Extrakt Text beschränkt mit CD4 und CD5 - | + | -p (page) Seite (Extrakt Text beschränkt mit CD4 und CD5 - Begin‐ |
| - | nend | + | nend mit CD4 und beendet mit CD5 - CD4, CD5, sind kompilierbare |
| - | im Vertrieb und sind definiert in 'mkd distribution', | + | im Vertrieb und sind definiert in 'mkd distribution', in 'ver‐ |
| - | sion.h') | + | sion.h'). Sie sehen die Optionen kompiliert mit dem Befehl mkd |
| + | \? | ||
| - | -s (screen verbose) Fügt | + | -s (screen verbose) Fügt auf dem Konsole Bildschirm ('Verbose' ; |
Ausführliche) | Ausführliche) | ||
| Ligne 522 : | Ligne 530 : | ||
EXEMPLES | EXEMPLES | ||
| - | Mit | + | Mit shell-Befehl: |
mkd -Cst F manual mkd.1 | gzip -f mkd.1.gz | mkd -Cst F manual mkd.1 | gzip -f mkd.1.gz | ||
| - | Produkt französisch UNIX Manual; Version 12.03. | + | Produkt französisch UNIX Manual; Version 12.03. C: Sprache C, |
| - | s:Auch anzeigen die Konsole, t:nur text, F:Code | + | s:Auch anzeigen die Konsole, t:nur text, F:Code zu |
entschlüsseln. | entschlüsseln. | ||
mkd -Ct M manual mkd.1 | gzip -f mkd.1.gz | mkd -Ct M manual mkd.1 | gzip -f mkd.1.gz | ||
| - | Produkt englisch UNIX Manual; Version 12.03. | + | Produkt englisch UNIX Manual; Version 12.03. (Produit un |
| - | UNIX | + | manuel UNIX standard en anglais au format UTF-8 depuis la ver‐ |
| - | 12.03) | + | sion 12.03) |
mkd -Csl '*Sied' mkd3.c '*.verif_struct' | mkd -Csl '*Sied' mkd3.c '*.verif_struct' | ||
| - | (Mit den Kompilierung--optionen CD1='#' | + | (Mit den Kompilierung--optionen CD1='#' oder CD2='#' in 'mkd |
| - | distribution' version.h).Produkt Dokumentation | + | distribution' version.h).Produkt Dokumentation mit Struktur |
| - | der Programme, '#includes', '#defines', | + | der Programme, '#includes', '#defines', '#ifdef', '#else' und |
| - | '#endif' Kompilierte Optionen, | + | '#endif' Kompilierte Optionen, für überprüfen die Struktur in |
Quelldatei in Programms | Quelldatei in Programms | ||
mkd -jfsl '*OHie' mkd_docu.prj mkd.org | mkd -jfsl '*OHie' mkd_docu.prj mkd.org | ||
| - | (Mit den Kompilierung Optionen CD1='#' oder CD2='#' in 'mkd | + | (Mit den Kompilierung Optionen CD1='#' oder CD2='#' in 'mkd |
| - | + | distribution' version.h) Produkt Organigramm. Der Kommentar | |
| - | mit * oder O oder H, und Pfad zu den Quelldatei | + | beginnt mit * oder O oder H, und Pfad zu den Quelldatei sind |
| - | + | die Komponenten der Projektdatei. Optionen : 'f' finden der | |
| - | Sprache, 'j' sagte dass die Quelldatei ist eine | + | Stil der Sprache, 'j' sagte dass die Quelldatei ist eine Pro‐ |
| + | jektdatei. | ||
mkd -l '*ide' mkd3.c '*.id_ei' | mkd -l '*ide' mkd3.c '*.id_ei' | ||
| - | ( Mit Kompilierung--optionen CD1='#' | + | ( Mit Kompilierung--optionen CD1='#' oder CD2='#' extrahiert |
| - | #include, | + | #include, #define, #ifdef, #else, #endif Kompilierung--optionen |
der C- Sprache. | der C- Sprache. | ||
mkd -pj '**' mkd_docu.prj mkd.strings | mkd -pj '**' mkd_docu.prj mkd.strings | ||
| - | (Mit Kompilierung--optionen | + | (Mit Kompilierung--optionen CD4=CD5='\"', extrahiert Saiten |
| - | den | + | aus den Quelldateien. (Die Saiten werden auf die Standard-Aus‐ |
| - | angezeigt.) | + | gabe angezeigt.) |
| - | mkd \? Zeigt die Syntax und den Charakter CD1 bis CD5 Kompiliert. | + | mkd \? Zeigt die Syntax und den Charakter CD1 bis CD5 Kompiliert. (Mit |
den Optionen l und p verwendet) | den Optionen l und p verwendet) | ||
| Ligne 568 : | Ligne 577 : | ||
GESCHICHTE | GESCHICHTE | ||
| - | 1986 - mkd für DOS, und mkdoc für UNIX, werden in ASCII geschrieben | + | 1986 - mkd für DOS, und mkdoc für UNIX, werden in ASCII geschrieben |
| - | Jean-Paul Louyot für CEM loratory in Montpellier Universität | + | von Jean-Paul Louyot für CEM loratory in Montpellier Universität |
| - | + | (Frankreich). | |
1991 - 1991 - mkdoc 3.12 für PC und UNIX (Sun) | 1991 - 1991 - mkdoc 3.12 für PC und UNIX (Sun) | ||
| - | 1995 - mkdoc 3.22 für Linux | + | 1995 - 2004 - mkdoc 3.22 für Unix und Linux: SUN-SPARC, HP-UX, RedHat |
| - | 2004 - mkdoc 4 für | + | 2004 - mkdoc 4 für Linux Ubuntu, Windows 98, Windows 2000 |
| - | 2007 | + | 2007 - 2012 -mkdoc R7.01 bis R12.01 sind auf ISO-8859-1-Format abges‐ |
timmt. | timmt. | ||
| - | 2012 - mkd 12.03 ist umgeschrieben in UTF-8 Format, und mkdcppw (für | + | 2012 - mkd 12.03 ist umgeschrieben in UTF-8 Format, und mkdcppw (für |
| - | c++, php) ist geschrieben für Fenstern mit gcc und gtkmm. | + | C, c++, php) ist geschrieben für Fenstern mit gcc und gtkmm. |
DOWLOADS | DOWLOADS | ||
| - | http://edeulo.free.fr/wiki/index.php/Projet_mkd/Compilations_UNIX-LINUX | + | http://edeulo.free.fr/wiki/index.php/Projet_mkd/Compilations_UNIX- |
| + | LINUX | ||
AUTOREN | AUTOREN | ||
| - | Manuel mis à jour par : Clara JIMENEZ | + | Manuel mis à jour par : Clara JIMENEZ und JPL |
ÜBERSETZER | ÜBERSETZER | ||
| Ligne 604 : | Ligne 614 : | ||
HINWEISE | HINWEISE | ||
| - | Diese Version lesen, und Dekodiert nicht, mit '#include' Richtlinie | + | 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. | in der Quelldatei. | ||
| Ligne 615 : | Ligne 635 : | ||
| - | + | 6. April 2013 MKD(1) | |
</pre> | </pre> | ||
{{Boîte déroulante/fin}} | {{Boîte déroulante/fin}} | ||
