PtoP |
Pascal à Pascal |
|---|---|
| Free Pascal | Outils |
Syntaxe
| ptop[-v] [-i indent] [-b bufsize ][-c optsfile] infile outfile |
Paramètres
| Nom | Description |
|---|---|
| -h | Ce paramètre permet d'afficher un message d'aide sur la commande. |
| -c | Ce paramètre permet d'effectuer la lecture des paramètres du fichier de configuration. Un fichier de configuration n'est pas nécessaire, ptop rétablira alors les valeurs internes par défaut. Voir aussi le paramètre -g. |
| -i ident | Ce paramètre permet de définir le nombre d'espaces de retrait utilisés pour BEGIN END; et d'autres blocs. |
| -b bufsize | Ce paramètre permet de définir la taille de la mémoire tampon à bufsize. La valeur par défaut est 255, et la valeur 0 est considéré comme non valide et ignoré. |
| -v | Ce paramètre permet de demander une sortie détaillé. Actuellement, seul le nombre de lignes lues et écrites et quelques messages d'erreur sont générés. |
| -g ptop.cfg | Ce paramètre permet d'écrire un fichier de configuration par défaut à éditer dans le fichier ptop.cfg. |
Description
Cette commande permet de plus ou moins embellir un source configurable pour les sources Pascal, et spécialement celles prises en charge par le FPC (plus ou moins compatibles avec Turbo Pascal ou Delphi 2.0).
Remarques
- La commande PtoP appartient au paquet FPC utils, contenant également les commandes PPDep, H2Pas, PPUDump et PPUMove.
- La commande ptop reformate fondamentalement la source indiqué par le paramètre infile" et sort le résultat dans la destination indiquer par le paramètre outfile.
- Vous devriez essayer de jouer avec les paramètres de ptop et son fichier de configuration jusqu'à ce que vous trouviez l'effet désiré. La configuration et les possibilités proposé de la commande ptop sont beaucoup plus élevé les autres logiciels du même type.
- Le fichier de configuration de la commande ptop ne s'appelle pas nécessairement ptop.cfg et n'est pas non plus chargé automatiquement. Par conséquent, le nom importe peu.
Structure du fichier de configuration (ptop.cfg)
La structure d'un fichier de configuration ptop est un bloc de construction simple répété plusieurs fois (de 20 à 30 fois), pour chaque mot réservé du langage de programmation Pascal connu du programme ptop.
Le bloc constitutif de base du fichier de configuration consiste en une ou deux lignes décrivant la réaction de ptop sur un mot réservé spécifié. D'abord une ligne sans crochets avec le format suivant :
| keyword=option1,option2,option3,... |
Si l'une des paramètres est "dindonkey", alors une deuxième ligne (avec des crochets) est nécessaire comme ceci :
| [keyword]=otherkeyword1,otherkeyword2,otherkeyword3,... |
Comme vous pouvez le constater, le bloc contient deux types d'identificateurs, les mots réservés (mot réservé et otherkeyword1..3 dans l'exemple ci-dessus) et les paramètres (option1..3 ci-dessus).
Les mots réservés sont les identificateurs de structure de Pascal valides intégrés tels que BEGIN, END, CASE, IF, THEN, ELSE et IMPLEMENTATION. Le fichier de configuration par défaut en répertorie la plupart.
Outre les mots réservés Pascal réels, d'autres mots de code sont utilisés pour les opérateurs et les expressions de commentaire. Ceux-ci sont répertoriés dans le tableau suivant :
| Nom du mot de code | Opérateur |
|---|---|
| casevar | L'opérateur «:» dans une étiquette de cas (<> 'deux-points') |
| becomes | L'opérateur «:=» |
| delphicomment | L'opérateur «//» |
| opencomment | Les opérateurs «{» ou «(*» |
| closecomment | Les opérateurs «}» ou «*)» |
| semicolon | L'opérateur «;» |
| colon | L'opérateur «:» |
| equals | L'opérateur «=» |
| openparen | L'opérateur «[» |
| closeparen | L'opérateur «]» |
| period | L'opérateur «.» |
Les mots de code Options définissent les actions à prendre lorsque le mot réservé précédant le signe égal est trouvé.
| Option | Signification |
|---|---|
| crsupp | Cette option permet de supprimer le CR avant le mot réservé. |
| crbefore | Cette option permet d'indiquer qu'il forcer le CR avant mot réservé (ne va pas avec crsupp). |
| blinbefore | Cette option permet d'indiquer une ligne blanche avant mot réservé. |
| dindonkey | Cette option permet d'indiquer un de-indent sur les mots réservés associés. |
| dindent | Cette option permet d'indiquer un deindent (toujours). |
| spbef | Cette option permet d'indiquer un espace avant. |
| spaft | Cette option permet d'indiquer un espace après. |
| gobsym | Cette option permet d'afficher les symboles suivant un mot réservé mais n'affectant pas la mise en page. Il affichera jusqu'à la fin des terminateurs. Les terminateurs sont codés en dur dans ptop, il faudra probablement les changer). |
| inbytab | Cette option permet d'indiquer retrait par tabulation. |
| crafter | Cette option permet de forcer un CR après le mot réservé. |
| upper | Cette option permet d'afficher le mot réservé en majuscule. |
| lower | Cette option permet d'afficher le mot réservé en minuscule. |
| capital | Cette option permet de transformer le premier caractère en majuscule et le reste en minuscule dans un mot réservé. |
L'option dindonkey nécessite quelques paramètres supplémentaires, étant définis par une seconde ligne pour ce mot réservé (celle avec les crochets), n'étant donc nécessaire que si les options contiennent dinkdonkey (contraction de l'indentation sur le mot réservé associé). La valeur dinkdonkey désindente si l'un des mots réservés spécifiés par les options supplémentaires de la ligne entre crochets est trouvé.