POD2TEXI(1) Documentation de Perl fournie par les utilisateurs POD2TEXI(1) NOM pod2texi - Conversion de Pod en Texinfo SYNOPSIS pod2texi [OPTION]... POD... DESCRIPTION Traduction de fichier(s) Pod en Texinfo. Deux modes de base d'operation existent. Premierement, par defaut, chaque Pod est traduit en un manuel Texinfo autonome. Deuxiemement, si l'option --base-level est definie a une valeur superieure a zero, chaque Pod est transforme en un fichier adapte a une directive @include et un fichier supplementaire est cree avec un sommaire principal et tous les @include sont generees. OPTIONS --appendix-sections Utilisation des commandes de sectionnement d'appendice (@appendix, ...) au lieu des @-commandes de sections numerotees de Texinfo (@chapter, @section, ...). --base-level=NUM|NOM Definir le niveau des commandes << head1 >>. Cela peut etre un entier ou une commande de sectionnement (sans le << @ >>) : 1 correspond au niveau @chapter/@unnumbered, 2 au niveau @section, etc. La valeur par defaut est 0, signifiant que les commandes << head1 >> produisent toujours des chapitres, mais que la sortie est sous forme de manuel autonome. Si le niveau est different de 0, le fichier Pod est rendu sous forme d'une partie de manuel Texinfo adapte pour @include. Dans ce cas, le fichier Pod possede une commande supplementaire de sectionnement couvrant le fichier en entier, un niveau au-dessus de la valeur de l'option --base-level. Par consequent, pour faire de chaque fichier Pod un chapitre d'un grand manuel, << section >> doit etre utilisee comme niveau de base. Pour un exemple de production en Texinfo a partir d'une documentation de Perl lui-meme, consultez contrib/perldoc-all dans la distribution du source de Texinfo. --debug=NUM Definir le niveau de debogage a NUM. --generate-setfilename Generer une ligne @setfilename pour les manuels autonomes. Cela peut etre rejete avec l'option --no-generate-setfilename et est ignore si --base-level est different de 0. --headings-as-sections Utilisation des commandes de titres (@heading, ...) au lieu des @-commandes de sections numerotees de Texinfo (@chapter, @section, ...). Si l'option --base-level est differente de 0, la commande de sectionnement couvrant la sortie totale de fichier pour chaque fichier est une commande numerotee. --help Afficher l'aide-memoire et quitter. --menus Afficher le sommaire sous forme de noeuds. S'il existe un manuel principal, le sommaire TOP sous forme de noeuds est toujours affiche puisqu'un sommaire maitre est genere. Les autres sommaires sous forme de noeuds ne sont pas affiches dans le comportement par defaut. --outdir=NOM S'il existe un manuel principal avec des fichiers include (chacun correspondant a un fichier Pod d'entree), alors les fichiers Texinfo generes sont deposes dans le repertoire NOM. Celui-ci est base par defaut sur l'option --subdir. --output=NOM Nom pour le premier manuel ou pour le manuel principal s'il existe. Le comportement par defaut est d'ecrire sur la sortie standard. --no-section-nodes Utilisation d'ancres pour les sections au lieu de noeuds. --no-fill-section-gaps Ne pas combler les lacunes dans la structure des sections avec des fichiers @unnumbered vides. En regle generale, il est preferable de conserver intacte la hierarchie des sections. --preamble=CHAINE Inserer CHAINE comme entete standard avant le sommaire et les include. Si CHAINE est definie a << - >>, lire cet entete sur l'entree standard. Cet entete est un point de depart minimal pour un document Texinfo. --setfilename=CHAINE Utiliser CHAINE dans l'entete standard avant le sommaire et les include pour @setfilename pour le manuel principal, si l'option --base-level n'est pas definie a 0. Cette option est ignoree si --base-level est definie a 0. Aucun @setfilename n'est produit dans le comportement par defaut pour le manuel principal. --subdir=NOM S'il existe un manuel principal avec des fichiers include (chacun correspondant a un fichier Pod d'entree), alors ces fichiers include sont inclus a partir de NOM. Si l'option --outdir est definie, NOM doit en general etre defini au repertoire relatif selon le manuel principal et l'argument de --outdir. --unnumbered-sections Utiliser des commandes de sectionnement non numerotees (@unnumbered, ...) au lieu des @-commandes de Texinfo de sectionnement numerote (@chapter, @section, ...). --top=TOP Nom de l'element @top pour le manuel principal. Il peut contenir du code Texinfo. --version Afficher le nom et la version du logiciel et quitter. VOIR AUSSI Pod::Simple::Texinfo. perlpod(1). Manuel de Texinfo. Page d'accueil de Texinfo : COPYRIGHT ET LICENCE Copyright 2012-2026 Free Software Foundation, Inc. Ce programme est libre, vous pouvez le redistribuer ou le modifier selon les termes de la Licence Publique Generale GNU publiee par la Free Software Foundation (version 3 ou bien toute autre version ulterieure a votre convenance). Il n'y a AUCUNE GARANTIE dans la mesure autorisee par la loi. AUTEUR Patrice Dumas . 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 . perl 9 janvier 2025 POD2TEXI(1)