.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.14
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  | will give a
.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
.\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
.\" expand to `' in nroff, nothing in troff, for use with C<>.
.tr \(*W-|\(bv\*(Tr
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.if \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.\"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "ACHECK-RULES.FR.5 5"
.TH ACHECK-RULES.FR.5 5 "2003-07-26" "perl v5.8.4" "User Contributed Perl Documentation"
.SH "NOM"
.IX Header "NOM"
jeu.rules \- Jeu de règles pour acheck
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
Les fichiers de jeu de règles contiennent les règles qu'acheck doit vérifier.
.PP
Les lignes commençant par un dièse («\ \fB#\fR\ ») et les lignes vides
sont ignorées. Les espaces au début et à la fin d'une ligne sont aussi ignorés
ainsi que les tabulations. Si vous avez besoin d'espaces à la fin ou au début
d'une valeur, vous pouvez utilisez des guillemets anglo-saxons
(«\ \fB"\fR\ »).
Un commentaire commence par un dièse, il peut y avoir des espaces ou des
tabulations devant le dièse.
Les lignes longues peuvent être coupées en plusieurs lignes se terminant par
une barre oblique inversée («\ \fB\e\fR\ »).
.PP
Quelques exemples\ :
.PP
.Vb 6
\& # cette ligne est ignorée
\& champ    valeur
\& champ    valeur                               # ceci est un commentaire
\& champ         "valeur avec espaces à la fin   "
\& champ    valeur\e
\&          se poursuivant sur la ligne suivante
.Ve
.PP
Vous devez protéger le caractère dièse avec une barre oblique inversée si vous
voulez l'utiliser dans une valeur et utiliser des apostrophes si une valeur
contient une barre oblique inversée.
.PP
Les jeux de règles sont constitués de listes de règles. Ces listes peuvent être
répétées un certain nombre de fois, jusqu'à ce que ou tant qu'une condition est
vérifiée.
.PP
Une règle détecte une erreur si le test correspondant est vrai et qu'aucun de
ses tests de validation ne l'est. Chaque règle peut produire des corrections,
un avertissement ou une erreur, et fournir des commentaires pour aider
l'opérateur à corriger l'erreur.
.PP
Des parties du texte peuvent être définies comme commentaires et ainsi aucune
règle ni vérification orthographique de sera faite dessus.
.SH "FICHIER DE RÈGLES"
.IX Header "FICHIER DE RÈGLES"
.SH "RÈGLES DE SYNTAXE"
.IX Header "RÈGLES DE SYNTAXE"
.Sh "list"
.IX Subsection "list"
Une liste débute à une indication «\ \fIlist\fR\ » et se termine au
premier «\ \fIend_list\fR\ » ou à la fin du fichier.
.PP
Champs obligatoires\ :
.IP "\fItype\fR type" 4
.IX Item "type type"
.RS 4
.PD 0
.IP "\fIuntil\fR, répète la liste jusqu'à ce que la ligne courante vérifie «\ \fItest\fR\ »\ ;" 4
.IX Item "until, répète la liste jusqu'à ce que la ligne courante vérifie «test»;"
.IP "\fIwhile\fR, répète la liste tant que la ligne courante vérifie «\ \fItest\fR\ »\ ;" 4
.IX Item "while, répète la liste tant que la ligne courante vérifie «test»;"
.IP "\fIloop\fR, répète la liste «\ \fItest\fR\ » fois." 4
.IX Item "loop, répète la liste «test» fois."
.RE
.RS 4
.RE
.IP "\fItest\fR regex / nombre" 4
.IX Item "test regex / nombre"
.PD
Une expression rationnelle pour les listes «\ \fIuntil\fR\ » et
«\ \fIwhile\fR\ ». Le nombre de fois que la liste doit être répétée pour
«\ \fIloop\fR\ », ou «\ 0\ » pour une boucle infinie.
.PP
Champs optionnels\ :
.IP "\fIname\fR nom" 4
.IX Item "name nom"
Utilisez ceci pour nommer la liste.
.IP "\fIspell\fR yes / no" 4
.IX Item "spell yes / no"
Positionner à «\ \fIyes\fR\ » (oui, valeur par défaut) ou
«\ no\ » (non), selon que vous voulez ou pas que l'orthographe soit
vérifiée pour les lignes de cette liste. Cette valeur est héritée par les
sous\-listes.
.PP
Sous\-règles\ :
.IP "\fIlist\fR [nom]" 4
.IX Item "list [nom]"
.PD 0
.IP "\fIrule\fR [nom]" 4
.IX Item "rule [nom]"
.IP "\fIcomment\fR [nom]" 4
.IX Item "comment [nom]"
.PD
Suivi par le nom de la sous\-règle ou sa définition pour une sous\-règle anonyme.
.Sh "rule"
.IX Subsection "rule"
Une règle débute à une indication «\ \fIrule\fR\ » et se termine au
premier «\ \fIend_rule\fR\ » ou au début d'un commentaire ou d'une
liste.
.PP
Champs obligatoires\ :
.IP "\fItype\fR type" 4
.IX Item "type type"
.RS 4
.PD 0
.IP "\fIfix\fR, règle fournissant dans corrections et des commentaires dans un menu\ ;" 4
.IX Item "fix, règle fournissant dans corrections et des commentaires dans un menu;"
.IP "\fIautofix\fR, règle corrigeant une erreur sans intéraction\ ;" 4
.IX Item "autofix, règle corrigeant une erreur sans intéraction;"
.IP "\fIwarning\fR, règle produisant un avertissement\ ;" 4
.IX Item "warning, règle produisant un avertissement;"
.IP "\fIerror\fR, règle produisant une erreur\ ;" 4
.IX Item "error, règle produisant une erreur;"
.IP "\fInop\fR, règle spéciale ne faisant rien, les autres champs ne sont pas obligatoires." 4
.IX Item "nop, règle spéciale ne faisant rien, les autres champs ne sont pas obligatoires."
.RE
.RS 4
.RE
.IP "\fIregex\fR regex" 4
.IX Item "regex regex"
.PD
L'expression rationnelle qui doit être vérifiée pour trouver cette erreur. Des
motifs peuvent être capturés pour être utilisés ensuite dans les expressions
«\ \fIfix\fR\ ».
.IP "\fIfix\fR expression" 4
.IX Item "fix expression"
Fournit une correction pour la règle, ce champ peut être répété pour fournir
plusieurs choix. Seule la première est utilisée pour les règles
«\ \fIautofix\fR\ ». Les règles «\ \fIwarning\fR\ » et
«\ \fIerror\fR\ » ne fournissent pas de correction. Les motifs capturés
sont utilisables ici avec les variables «\ \fI$1\fR\ »,
«\ \fI$2\fR\ », etc.
.IP "\fIhint\fR texte" 4
.IX Item "hint texte"
Fournit des explications, elles sont utilisées comme commentaire de relecture
en mode relecture.
.PP
Champs optionnels\ :
.IP "\fIname\fR nom" 4
.IX Item "name nom"
Utilisez ceci pour nommer la règle.
.IP "\fIvalid\fR [name]" 4
.IX Item "valid [name]"
Fournit un test de validation, il peut être nommé ou anonyme. Pour les
validations anonymes, la définition du test doit suivre. Ce champ peut être
répété plusieurs fois, il suffit que l'un des tests de validation soit réussi
pour que la règle ne soit pas appliquée.
.Sh "valid"
.IX Subsection "valid"
Un test de validation débute à une indication «\ \fIvalid\fR\ » et se
termine au premier «\ \fIend_valid\fR\ » ou au début d'une règle, d'un
commentaire, d'une liste, ou d'un autre test de validation.
.PP
Champs obligatoires\ :
.IP "\fIpre\fR regex" 4
.IX Item "pre regex"
.PD 0
.IP "\fIin\fR regex" 4
.IX Item "in regex"
.IP "\fIpost\fR regex" 4
.IX Item "post regex"
.PD
Teste les expressions rationnelles, avant, dans et après le motif trouvé par
l'expression rationnelle de la règle. Au moins l'un de ces test doit être
fourni. Si tous les tests réussissent, la règle n'est pas appliquée.
.PP
Champ optionnel\ :
.IP "\fIname\fR nom" 4
.IX Item "name nom"
Utilisez ceci pour nommer le test.
.Sh "comment"
.IX Subsection "comment"
Un commentaire débute à une indication «\ \fIcomment\fR\ » et se termine
au premier «\ \fIend_comment\fR\ » ou au début d'une règle, d'un
commentaire ou d'une liste.
.PP
Champs obligatoires\ :
.IP "\fIskip\fR regex" 4
.IX Item "skip regex"
Une expression rationnelle correspondant au texte du commentaire. Ne pas
utiliser «\ \fIstart\fR\ » ou «\ \fIstop\fR\ » avec ceci.
.IP "\fIstart\fR regex" 4
.IX Item "start regex"
.PD 0
.IP "\fIstop\fR regex" 4
.IX Item "stop regex"
.PD
Expressions rationnelles définissant le début et la fin d'un commentaire, tout
le texte contenu entre est considéré comme commentaire. Ne pas utiliser
«\ \fIskip\fR\ » avec ceci.
.PP
Champs optionnels\ :
.IP "\fIname\fR nom" 4
.IX Item "name nom"
Utilisez ceci pour nommer le commentaire.
.IP "\fIstart_offset\fR" 4
.IX Item "start_offset"
.PD 0
.IP "\fIstop_offset\fR" 4
.IX Item "stop_offset"
.PD
Définit où le commentaire commence et s'arrête réellement. Les valeurs
possibles sont «\ \fIs\fR\ » pour le début du motif trouvé,
«\ \fIs+<n>\fR\ » pour \fIn\fR caractères après le début du motif,
«\ \fIe\fR\ » pour la fin du motif, ou «\ \fIe\-<n>\fR\ »
pour \fIn\fR caractères avant la fin du motif. Par défaut, «\ \fIs\fR\ »
est utilisé pour les motifs de début de commentaire, et «\ \fIe\fR\ »
pour ceux de fin.
.SH "VOYEZ AUSSI"
.IX Header "VOYEZ AUSSI"
\&\fIacheck\fR\|(1), \fIacheck\fR\|(5)
.SH "AUTEUR"
.IX Header "AUTEUR"
Nicolas Bertolissio <nico.bertol@free.fr>