#!/usr/bin/perl -w

=encoding ISO8859-1

=head1 NOM

acheck - Correction des erreurs courantes de traduction

=head1 SYNOPSIS

acheck [OPTIONS] [FICHIER_D'ENTRÉE]

=head1 DESCRIPTION

Ce programme analyse un fichier en vérifiant des règles de syntaxe et
éventuellement en demandant à Aspell de vérifier l'orthographe des mots. Il
suggère des corrections et génère un fichier corrigé en fonction, ajoutant des
commentaires de relecture si vous le désirez.

Il essaye de trouver le type de fichier en fonction de son extension ou de ses
premières lignes et charge les règles correspondantes.

Il affiche les lignes au fur et à mesure de l'analyse.

Quand une erreur est trouvée, un menu est affiché. Pressez simplement Entrée si
vous ne voulez rien modifier. Si un choix vous convient, entrez la lettre
correspondante. Si vous voulez corriger mais qu'aucun choix n'est correct,
entrez un espace, il vous demandera alors un texte pour remplacer celui qui est
surligné. Il remplacera le texte surligné par votre choix et reprendra
l'analyse.

Voici toutes les commandes disponiblesE<nbsp>:

=over 4

=item I<Enter>, ignorer.

Ignore l'erreur.

=item I<Ctrl+L>, rafficher.

Raffiche la dernière ligne, les suggestions et commentaires.

=item I<Espace>, éditer.

Édite le texte surligné.

=item I<E>, éditer la ligne.

Édite la ligne entière.

=item I<H>, ajouter le commentaire.

Ajouter le commentaire affiché en tant que commentaire de relecture. Ceci peut
être utilisé si vous voulez que le traducteur voit l'avertissement ou l'erreur
mais que vous n'avez pas de correction à apporter.

=item I<N>, ligne suivante.

Continuer à la ligne suivante en sautant le reste de la ligne courante.

=item I<X>, quitter sans changement.

Quitter sans sauvegarder les modifications, le script vous demande alors
confirmation, vous devez tapez «E<nbsp>B<yes>E<nbsp>» (oui) pour sortir sinon
l'analyse reprend sur l'erreur actuelle.

=item I<a>, ajouter au dictionnaire.

Ajoute le mot surligné à votre dictionnaire personnel, avec les majuscules
telles qu'elles sont.

=item I<l>, ajouter en minuscules au dictionnaire.

Ajoute le mot surligné à votre dictionnaire personnel, en minuscules.

=item I<i>, ignorer le mot.

Ignore le mot surligné, comme I<Entrée>.

=item I<I>, ignorer toujours.

Ignore le mot surligné et l'ajoute à votre dictionnaire de session.

=back

=head1 OPTIONS

Niveau de bavardageE<nbsp>:

=over 4

=item I<-q>, I<--quiet>

silencieuxE<nbsp>;

=item I<-v>

verbeux, commence au niveau I<$Debug + 1>, plus il y en a, plus il est bavard
(voir plus bas)E<nbsp>;

=item I<--verbose n>

utiliser le niveau I<n> (voir plus bas).

=back

FichiersE<nbsp>:

=over 4

=item I<-i>, I<--input>

nom du fichier d'entrée, utiliser «E<nbsp>I<->E<nbsp>» pour lire depuis
l'entrée standardE<nbsp>;

=item I<-o>, I<--output>

nom du fichier de sortie, utiliser «E<nbsp>I<->E<nbsp>» pour écrire sur la
sortie standard. Si aucun nom de fichier de sortie n'est fourni, le fichier
d'entrée est sauvegardé avec l'extension «E<nbsp>I<bak_ext>E<nbsp>» et son nom
est utilisé.

=back

Vérification de l'orthographeE<nbsp>:

=over 4

=item I<-s>, I<--spell>

vérifier l'orthographe avec AspellE<nbsp>;

=item I<-d langue>, I<--dict langue>

utiliser Aspell avec le dictionnaire I<langue>E<nbsp>;

=item I<-n>, I<--nospell>

ne pas vérifier l'orthographe.

=back

ModeE<nbsp>:

=over 4

=item I<-r>, I<--review>

mode relecture, ajoute des commentaires sur des lignes commençant par
I<$Comment> après les lignes analyséesE<nbsp>;

=item I<-t>, I<--trans>

mode traduction, ne pas ajouter de commentaire, ne faire que les corrections.

=back

AutreE<nbsp>:

=over 4

=item I<--rules jeu_de_règles>

utiliser I<jeu_de_règles> comme jeu de règlesE<nbsp>;

=item I<--type type_de_fichier>

utiliser I<type_de_fichier> quelque soit le type de fichierE<nbsp>;

=item I<--dump>

affiche le jeu de règles, pour le débogageE<nbsp>;

=item I<-V>, I<--version>

afficher le numéro de version.

=item I<-h>, I<--help>

afficher un court message d'utilisationE<nbsp>;

=back

=head2 Niveaux de bavardage

=over 4

=item I<0> silencieux, normal

seulement les avertissements et les erreursE<nbsp>;

=item I<1> débogage

noms des procéduresE<nbsp>;

=item I<2> débogage bavard

noms et arguments des procéduresE<nbsp>;

=item I<3> .. I<5> débogage très bavard

détails des analyses et des vérifications.

=back

=head1 VOIR AUSSI

acheck(5), acheck-rules(5)

=head1 AUTEUR

Nicolas Bertolissio <bertol@debian.org>
  
=cut
