soelim(1) General Commands Manual soelim(1) Nom soelim - Interpolation recursive des requetes de source dans roff ou d'autres fichiers texte Synopsis soelim [-Crt] [-I repertoire] [fichier_entree ...] soelim --help soelim -v soelim --version Description GNU soelim est un preprocesseur pour le systeme de formatage de document groff(7). soelim fonctionne comme un filtre pour eliminer les requetes de source dans les fichiers d'entree de roff(7). Autrement dit, il remplace les lignes de la forme << .so fichier_inclus >> dans chaque fichier_entree au format texte avec le contenu du fichier_inclus de maniere recursive. Par defaut, il ecrit aussi les requetes lf pour enregistrer le nom et le numero de ligne de chaque fichier_entree et fichier_inclus, de facon que tout diagnostic produit par un traitement ulterieur soit precisement retrace jusqu'a l'entree d'origine. Des options permettent de supprimer ces informations (-r) ou de les fournir a la place dans les commentaires de TeX (-t). En l'absence d'argument fichier_entree, soelim lit le flux d'entree standard. La sortie est ecrite dans le flux de sortie standard. Si le nom d'un fichier_macro contient une controblique, utilisez \\ ou \e pour l'incorporer. Pour incorporer une espace, ecrivez << \ >> (controblique suivie d'une espace). Tout autre sequence d'echappement dans le fichier_macro, << \[rs] >> incluse, empeche soelim de remplacer la requete de source. Le point doit etre au debut d'une ligne et doit etre suivi de << so >> sans espace ou tabulation intermediaires pour que soelim puisse le gerer. Cette convention permet aux requetes de source d'etre << protegees >> d'un traitement par soelim, comme partie de definition de macro ou de requete << if >>, par exemple. Il doit y avoir aussi au moins une espace entre << so >> et son argument fichier_macro. L'option -C outrepasse cette requete. Ce qui precede est la limite de la comprehension par soelim du langage roff(7). Par exemple, il ne remplace pas la ligne d'entree .if 1 .so autre_fichier avec le contenu d'autre_fichier. Avec son option -r, soelim peut donc etre utilise pour traiter des fichiers texte en general, pour aplatir une arborescence de documents d'entree. soelim a ete concu pour gerer les situations ou la cible de requete de source roff necessite un preprocesseur tel que eqn(1), pic(1), refer(1) ou tbl(1). La sequence de traitement habituelle de groff(1) est la suivante. input sourced file file | | v v preprocessor --> troff --> postprocessor | v output file Autrement dit, les fichiers sources par << so >> ne sont normalement lus que par le formateur, troff(1). soelim n'est pas requis par troff pour sourcer les fichiers. Si un fichier devant etre source doit aussi etre pretraite, il doit deja etre lu avant que le fichier d'entree passe dans le preprocesseur. soelim, normalement invoque a travers l'option -s de groff, gere cela. input file | v soelim --> preprocessor --> troff --> postprocessor ^ | | v sourced output file file Options L'option --help affiche un message d'utilisation, tandis que les options -v et --version affichent une information de version ; apres quoi le programme se termine. -C Reconnaitre une ligne d'entree debutant par .so meme si un caractere autre qu'une espace ou nouvelle ligne suit. -I repertoire Rechercher dans le chemin repertoire pour les fichier_entree(s) et fichier_inclus. L'option -I peut etre specifiee plus d'une fois ; la recherche est faite dans chaque repertoire dans l'ordre indique. To search the current working directory before others, add "-I ." at the desired place; it is otherwise searched last. -r Ecrire les fichiers << bruts >> ; ne pas ajouter de requete lf. -t Produire des lignes de commentaire pour TeX debutant avec << % >> indiquant le fichier actuel et le numero de ligne plutot que d'emettre des requetes lf dans le meme but. Si les deux options -r et -t sont indiquees, la derniere indique le controle. Voir aussi groff(1) TRADUCTION La traduction francaise de cette page de manuel a ete creee par Jean- Paul Guillonneau Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . groff 1.23.0 15 fevrier 2025 soelim(1)