« Mkd (Extracteur de documents)/Internationalisation des messages » : différence entre les versions
Contenu supprimé Contenu ajouté
m →Traduction des messages : Sauvegarde |
→Traduction des manuels : Sauvegarde |
||
Ligne 34 :
== Traduction des manuels ==
Les manuels pour UNIX sont écrits en standard au format [[w:Nroff|nroff]]
{{Boîte déroulante début|
titre='''mkd_en.1''' <small>Manuel de référence pour la version mkd-0~120508</small>|
fondtitre=|
alignT=center|
styleTitre=|
align=left|
clear=|
styleFrame=style CSS du cadre externe|
style=classe CSS|
noclose=absence d'enroulage par défaut
}}
<pre>
.TH MKD 1 "29 March 2012"
.SH NAME
mkd \- make documentation. Extract coded informations from programs sources and product specific documentation.
.SH SYNOPSIS
.I mkd
.RB [\-ABCFPSafjlpstw]
.IR char_codes
.IR path_source
.RB [path_target]
.SH DESCRIPTION
.TP
.I 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 comments for Programmers, Warnings and Tests points .... Coded informations are respectively 'O', 'S', 'P', 'www', ant 'T' just after the comment character.
.TP
.I char_codes
All ASCII. The comment are extracted if the comment begin with this character. With two star mkd extract all comments.
.TP
.I path_source
Path source file (or project file: option j ).
.TP
.I path_target
Path target file. Default, path target is idendical to source file with extension \'.doc\' .
.SH OPTIONS
.TP
.I Uppercase options:
.B restrict comments to one specific language:
.IP \fB\-A\fP
extract Assembler style comments ( ; to end of line )
.IP \fB\-B\fB
Basic style (REM or ' \-> end of line)
.IP \fB\-C\fB
C style ( / * \-> * / )
.IP \fB\-F\fB
Fortran style (c,C or * \-> end of line)
.IP \fB\-P\fB
Pascal style ( { \-> } )
.IP \fB\-S\fB
Shell or ratfor style ( # \-> end of line)
.TP
.I Lowercase options:
.B
.IP \fB\-a\fB
append to current target file.
.IP \fB\-f\fB
find source file language. (useful with project file)
.IP \fB\-j\fB
used if source file is a project file.
.IP \fB\-l\fB
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)
.IP \fB\-p\fB
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)
.IP \fB\-s\fB
add to screen. (verbose)
.IP \fB\-t\fB
text (copy only the comment).
.IP \fB\-w\fB
overwrite the current target file.
.SH EXAMPLES
.TP
.I with Cshell command:
.TP
mkd -Ct F manual mkd.1 | gzip -f mkd.1.gz
Product UNIX manual for french users.
.TP
mkd -Ct M manual mkd.1 | gzip -f mkd.1.gz
Product UNIX manual.
.TP
mkd -Csl '*Sied' mkd3.c '*.verif_struct'
Product documentation with structure of program, includes, defines, ifdef else and endif compile options, to verify structure of program.
(with compilable options CD1='#' or CD2='#' in version.h from mkd distribution).
.TP
mkd -jfsl '*OHie' mkd_docu.prj mkd.org
Product organigram. Comment begin with *,O,H, and sources files are itemize in project file.
(with compilable options CD1='#' or CD2='#').
.TP
mkd -l '*ide' mkd3.c '*.id_ei'
(with compilable options CD1='#' or CD2='#').
.TP
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=\'\\"\').
.TP
mkd (without argument)
Cause any error and syntax are transmit to terminal with caracters compiled to use options l and p.
.SH AUTHOR
.PP
JP LOUYOT, Clara JIMENEZ.
http://edeulo.free.fr/wiki/index.php/Projet_mkd/Compilations_UNIX-LINUX
.IP
.SH NOTES
.PP
No match, for read and decode include files from sources files in this Release 12.03.0
.SH BUGS
.PP
Bugs Report: http://edeulo.free.fr/phpBB3/index.php
Documents generator mkd
</pre>
{{Boîte déroulante fin}}
== Traduction des aides ==
| |||