.\" -*- coding: UTF-8 -*-
.de  Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.\" Automatically generated by Pod::Man (Pod::Simple)
.\"
.\" Standard preamble:
.\" ========================================================================
.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.  \*(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-
.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" ''
.    ds C`
.    ds C'
'br\}
.ie  \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.de  IX
..
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.nr rF 0
.if  \n(.g .if rF .nr rF 1
.if  (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" fudge factors for nroff and troff
.    
.if  n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.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'\fI\(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 Titre "POD2TEXI 1"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH POD2TEXI 1 "9 janvier 2025" perl "Documentation de Perl fournie par les utilisateurs"
.if  n .ad l
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.nh
.SH NOM
pod2texi – Conversion de Pod en Texinfo
.SH SYNOPSIS
.IX En\-tête SYNOPSIS
.Vb 1
\&  \fBpod2texi\fP [\fIOPTION\fP]... \fIPOD\fP...
.Ve
.SH DESCRIPTION
.IX En\-tête DESCRIPTION
Traduction de fichier(s) Pod en Texinfo. Deux modes de base d’opération
existent. Premièrement, par défaut, chaque Pod est traduit en un manuel
Texinfo autonome.
.PP
Deuxièmement, si l’option \fB\-\-base\-level\fP est définie à une valeur
supérieure à zéro, chaque Pod est transformé en un fichier adapté à une
directive \fI@include\fP et un fichier supplémentaire est créé avec un sommaire
principal et tous les \fI@include\fP sont générées.
.SH OPTIONS
.IX En\-tête OPTIONS
.IP \fB\-\-appendix\-sections\fP 4
.IX Item \-\-appendix\-sections
Utilisation des commandes de sectionnement d’appendice (\fI@appendix\fP, ...)
au lieu des @\-commandes de sections numérotées de Texinfo (\fI@chapter\fP,
\fI@section\fP, ...).
.IP \fB\-\-base\-level\fP=\fINUM\fP|\fINOM\fP 4
.IX Item \-\-base\-level=NUM|NOM
Définir le niveau des commandes «\ head1\ ». Cela peut être un entier ou une
commande de sectionnement (sans le «\ @\ »)\ : 1 correspond au niveau
\fI@chapter\fP/\fI@unnumbered\fP, 2 au niveau \fI@section\fP,\ etc. La valeur par
défaut est\ 0, signifiant que les commandes «\ head1\ » produisent toujours
des chapitres, mais que la sortie est sous forme de manuel autonome.
.Sp
Si le niveau est différent de 0, le fichier Pod est rendu sous forme d’une
partie de manuel Texinfo adapté pour \fI@include\fP. Dans ce cas, le fichier
Pod possède une commande supplémentaire de sectionnement couvrant le fichier
en entier, un niveau au\-dessus de la valeur de l’option \fB\-\-base\-level\fP. Par
conséquent, pour faire de chaque fichier Pod un chapitre d’un grand manuel,
«\ section\ » doit être utilisée comme niveau de base.
.Sp
Pour un exemple de production en Texinfo à partir d’une documentation de
Perl lui\-même, consultez \fIcontrib/perldoc\-all\fP dans la distribution du
source de Texinfo.
.IP \fB\-\-debug\fP=\fI\s-1NUM\s0\fP 4
.IX Item \-\-debug=NUM
Définir le niveau de débogage à \fI\s-1NUM\s0\fP.
.IP \fB\-\-generate\-setfilename\fP 4
.IX Item \-\-generate\-setfilename
Générer une ligne \fI@setfilename\fP pour les manuels autonomes. Cela peut être
rejeté avec l’option \fB\-\-no\-generate\-setfilename\fP et est ignoré si
\fB\-\-base\-level\fP est différent de\ 0.
.IP \fB\-\-headings\-as\-sections\fP 4
.IX Item \-\-headings\-as\-sections
Utilisation des commandes de titres (\fI@heading\fP, ...) au lieu des
@\-commandes de sections numérotées de Texinfo (\fI@chapter\fP, \fI@section\fP,
\&...). Si l’option \fB\-\-base\-level\fP est différente de\ 0, la commande de
sectionnement couvrant la sortie totale de fichier pour chaque fichier est
une commande numérotée.
.IP \fB\-\-help\fP 4
.IX Item \-\-help
Afficher l'aide\-mémoire et quitter.
.IP \fB\-\-menus\fP 4
.IX Item \-\-menus
Afficher le sommaire sous forme de nœuds. S’il existe un manuel principal,
le sommaire \fITOP\fP sous forme de nœuds est toujours affiché puisqu’un
sommaire maitre est généré. Les autres sommaires sous forme de nœuds ne sont
pas affichés dans le comportement par défaut.
.IP \fB\-\-outdir\fP=\fI\s-1NOM\s0\fP 4
.IX Item \-\-outdir=NOM
S’il existe un manuel principal avec des fichiers \fIinclude\fP (chacun
correspondant à un fichier Pod d’entrée), alors les fichiers Texinfo générés
sont déposés dans le répertoire \fI\s-1NOM\s0\fP. Celui\-ci est basé par défaut
sur l’option \fB\-\-subdir\fP.
.IP \fB\-\-output\fP=\fI\s-1NOM\s0\fP 4
.IX Item \-\-output=NOM
Nom pour le premier manuel ou pour le manuel principal s’il existe. Le
comportement par défaut est d’écrire sur la sortie standard.
.IP \fB\-\-no\-section\-nodes\fP 4
.IX Item \-\-no\-section\-nodes
Utilisation d’ancres pour les sections au lieu de nœuds.
.IP \fB\-\-no\-fill\-section\-gaps\fP 4
.IX Item \-\-no\-fill\-section\-gaps
Ne pas combler les lacunes dans la structure des sections avec des fichiers
\fI@unnumbered\fP vides. En règle générale, il est préférable de conserver
intacte la hiérarchie des sections.
.IP \fB\-\-preamble\fP=\fI\s-1CHAINE\s0\fP 4
.IX Item \-\-preamble=CHAINE
Insérer \fI\s-1CHAINE\s0\fP comme entête standard avant le sommaire et les
\fIinclude\fP. Si \fI\s-1CHAINE\s0\fP est définie à «\ \-\ », lire cet entête sur
l’entrée standard. Cet entête est un point de départ minimal pour un
document Texinfo.
.IP \fB\-\-setfilename\fP=\fI\s-1CHAINE\s0\fP 4
.IX Item \-\-setfilename=CHAINE
Utiliser \fI\s-1CHAINE\s0\fP dans l’entête standard avant le sommaire et les
\fIinclude\fP pour \fI@setfilename\fP pour le manuel principal, si l’option
\fB\-\-base\-level\fP n’est pas définie à \ 0. Cette option est ignorée si
\fB\-\-base\-level\fP est définie à\ 0. Aucun \fI@setfilename\fP n’est produit dans
le comportement par défaut pour le manuel principal.
.IP \fB\-\-subdir\fP=\fI\s-1NOM\s0\fP 4
.IX Item \-\-subdir=NOM
S’il existe un manuel principal avec des fichiers \fIinclude\fP (chacun
correspondant à un fichier Pod d’entrée), alors ces fichiers \fIinclude\fP sont
inclus à partir de \fI\s-1NOM\s0\fP.
.Sp
Si l’option \fB\-\-outdir\fP est définie, \fI\s-1NOM\s0\fP doit en général être
défini au répertoire relatif selon le manuel principal et l’argument de
\fB\-\-outdir\fP.
.IP \fB\-\-unnumbered\-sections\fP 4
.IX Item \-\-unnumbered\-sections
Utiliser des commandes de sectionnement non numérotées (\fI@unnumbered\fP, ...)
au lieu des @\-commandes de Texinfo de sectionnement numéroté (\fI@chapter\fP,
\&\fI@section\fP, ...).
.IP \fB\-\-top\fP=\fI\s-1TOP\s0\fP 4
.IX Item \-\-top=TOP
Nom de l’élément \fI@top\fP pour le manuel principal. Il peut contenir du code
Texinfo.
.IP \fB\-\-version\fP 4
.IX Item \-\-version
Afficher le nom et la version du logiciel et quitter.
.SH "VOIR AUSSI"
.IX En\-tête "VOIR AUSSI"
Pod::Simple::Texinfo. \fBperlpod\fP(1). Manuel de Texinfo. Page d’accueil de
Texinfo\ : <https://www.gnu.org/software/texinfo/>
.SH "COPYRIGHT ET LICENCE"
.IX En\-tête "COPYRIGHT ET LICENCE"
Copyright 2012\-2026 Free Software Foundation, Inc.
.PP
Ce programme est libre, vous pouvez le redistribuer ou le modifier selon les
termes de la Licence Publique Générale \s-1GNU\s0 publiée par la Free
Software Foundation (version\ 3 ou bien toute autre version ultérieure à
votre convenance).
.PP
Il n'y a AUCUNE GARANTIE dans la mesure autorisée par la loi.
.SH AUTEUR
.IX En\-tête AUTEUR
Patrice Dumas <bug\-texinfo@gnu.org>.
.PP
.SH TRADUCTION
La traduction française de cette page de manuel a été créée par
Jean-Paul Guillonneau <guillonneau.jeanpaul@free.fr>
.
.PP
Cette traduction est une documentation libre ; veuillez vous reporter à la
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License version 3
.UE
concernant les conditions de copie et 
de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
.PP
Si vous découvrez un bogue dans la traduction de cette page de manuel, 
veuillez envoyer un message à
.MT debian-l10n-french@lists.debian.org
.ME .