.\" Automatically generated by Pod::Man (Pod::Simple) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .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\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" 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'. .de IX .. .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 .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .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'\f2\(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 Title "POD2TEXI 1" .TH POD2TEXI 1 "2025-01-09" "perl" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "نام (NAME)" pod2texi \- تبدیل مستندات POD به قالب Texinfo .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" .Vb 1 \& pod2texi [OPTION]... POD... .Ve .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" تبدیل فایل(های) Pod به Texinfo. دو حالت کلی برای این عملیات وجود دارد. نخست، به‌طور پیش‌فرض، هر فایل Pod به یک راهنمای مستقل Texinfo تبدیل می‌شود. .PP دوم، اگر مقدار \f(CW\*(C`\-\-base\-level\*(C'\fR بزرگ‌تر از 0 تنظیم شود، هر فایل Pod به فایلی مناسب برای \f(CW@include\fR تبدیل می‌شود، و یک فایل دیگر شامل یک منوی اصلی و تمام دستورات \f(CW@include\fR تولید می‌گردد. .SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" .IP "\fB\-\-appendix\-sections\fR" 4 .IX Item "--appendix-sections" استفاده از دستورات بخش‌بندی پیوست (\f(CW@appendix\fR، ...) به‌جای دستورات پیش‌فرض شماره‌دار بخش‌بندی در Texinfo (\f(CW@chapter\fR، \&\f(CW@section\fR، ...). .IP "\fB\-\-base\-level\fR=\fINUM|NAME\fR" 4 .IX Item "--base-level=NUM|NAME" سطح دستورات \f(CW\*(C`head1\*(C'\fR را تنظیم می‌کند. این مقدار می‌تواند یک عدد صحیح یا یک دستور بخش‌بندی Texinfo (بدون \f(CW\*(C`@\*(C'\fR) باشد: 1 متناظر با سطح \&\f(CW@chapter\fR/\f(CW@unnumbered\fR است، 2 متناظر با سطح \f(CW@section\fR است، و به همین ترتیب. مقدار پیش‌فرض 0 است، به این معنی که دستورات \f(CW\*(C`head1\*(C'\fR همچنان به صورت فصل‌ها در خروجی قرار می‌گیرند، اما خروجی به شکل یک راهنمای مستقل سازمان‌دهی می‌شود. .Sp اگر سطح 0 نباشد، فایل Pod به صورت بخشی از یک راهنمای Texinfo رندر می‌شود که برای \f(CW@include\fR مناسب است. در این حالت، هر فایل Pod دارای یک دستور بخش‌بندی اضافی خواهد بود که کل فایل را در بر می‌گیرد و یک سطح بالاتر از مقدار \f(CW\*(C`\-\-base\-level\*(C'\fR قرار دارد. بنابراین، برای تبدیل هر فایل Pod به یک فصل در یک راهنمای بزرگ، باید از \f(CW\*(C`section\*(C'\fR به عنوان سطح پایه استفاده کنید. .Sp برای مشاهده نمونه‌ای از ساخت Texinfo از روی مستندات خود Perl، به \f(CW\*(C`contrib/perldoc\-all\*(C'\fR در توزیع سورس Texinfo مراجعه کنید. .IP "\fB\-\-debug\fR=\fI\s-1NUM\s0\fR" 4 .IX Item "--debug=NUM" تنظیم سطح اشکال‌زدایی روی \fI\s-1NUM\s0\fR. .IP "\fB\-\-generate\-setfilename\fR" 4 .IX Item "--generate-setfilename" تولید سطر \f(CW@setfilename\fR برای راهنماهای مستقل. می‌تواند با \f(CW\*(C`\-\-no\-generate\-setfilename\*(C'\fR نفی (غیرفعال) شود. در صورتی که مقدار \f(CW\*(C`\-\-base\-level\*(C'\fR برابر 0 نباشد نادیده گرفته می‌شود. .IP "\fB\-\-headings\-as\-sections\fR" 4 .IX Item "--headings-as-sections" استفاده از دستورات سرعنوان (\f(CW@heading\fR، ...) به‌جای دستورات پیش‌فرض شماره‌دار بخش‌بندی در Texinfo (\f(CW@chapter\fR، \&\f(CW@section\fR، ...). دستور بخش‌بندیِ پوشش‌دهنده کل فایل که برای هر فایل Pod در صورت غیرصفر بودن \fB\-\-base\-level\fR خروجی داده می‌شود، یک دستور شماره‌دار است. .IP "\fB\-\-help\fR" 4 .IX Item "--help" نمایش راهنما و خروج. .IP "\fB\-\-menus\fR" 4 .IX Item "--menus" خروجی دادن منوهای گره (node). در صورت وجود یک راهنمای اصلی، منوی گره Top آن همواره خروجی داده می‌شود، زیرا یک منوی اصلی (master menu) تولید می‌گردد. منوهای سایر گره‌ها در حالت پیش‌فرض در خروجی قرار نمی‌گیرند. .IP "\fB\-\-outdir\fR=\fI\s-1NAME\s0\fR" 4 .IX Item "--outdir=NAME" اگر یک راهنمای اصلی به همراه فایل‌های include (که هر کدام متناظر با یک فایل Pod ورودی است) وجود داشته باشد، فایل‌های Texinfo تولیدشده در دایرکتوری \fI\s-1NAME\s0\fR قرار می‌گیرند. مقدار پیش‌فرض بر اساس \f(CW\*(C`\-\-subdir\*(C'\fR تعیین می‌شود. .IP "\fB\-\-output\fR=\fI\s-1NAME\s0\fR" 4 .IX Item "--output=NAME" نام برای راهنمای اول، یا راهنمای اصلی در صورتی که راهنمای اصلی وجود داشته باشد. پیش‌فرض نوشتن در خروجی استاندارد است. .IP "\fB\-\-no\-section\-nodes\fR" 4 .IX Item "--no-section-nodes" استفاده از لنگرها (anchors) برای بخش‌ها به‌جای گره‌ها (nodes). .IP "\fB\-\-no\-fill\-section\-gaps\fR" 4 .IX Item "--no-fill-section-gaps" پر نکردن فاصله‌های بخش‌بندی با فایل‌های خالی \f(CW@unnumbered\fR. در حالت عادی، حفظ سلسله‌مراتب بخش‌بندی به همان شکل دست‌نخورده کار مناسبی است. .IP "\fB\-\-preamble\fR=\fI\s-1STR\s0\fR" 4 .IX Item "--preamble=STR" درج \fI\s-1STR\s0\fR به عنوان مقدمه اولیه (top boilerplate) پیش از منو و includeها. اگر مقدار \fI\s-1STR\s0\fR برابر \f(CW\*(C`\-\*(C'\fR تنظیم شود، مقدمه اولیه از ورودی استاندارد خوانده می‌شود. مقدمه اولیه پیش‌فرض، یک شروع حداقلی برای یک سند Texinfo است. .IP "\fB\-\-setfilename\fR=\fI\s-1STR\s0\fR" 4 .IX Item "--setfilename=STR" استفاده از \fI\s-1STR\s0\fR در مقدمه اولیه پیش از منو و includeها برای دستور \f(CW@setfilename\fR در راهنمای اصلی، در صورتی که مقدار \f(CW\*(C`\-\-base\-level\*(C'\fR برابر 0 تنظیم نشده باشد. اگر \&\f(CW\*(C`\-\-base\-level\*(C'\fR برابر 0 باشد نادیده گرفته می‌شود. در حالت پیش‌فرض، هیچ \f(CW@setfilename\fR در خروجی برای راهنمای اصلی نوشته نمی‌شود. .IP "\fB\-\-subdir\fR=\fI\s-1NAME\s0\fR" 4 .IX Item "--subdir=NAME" اگر یک راهنمای اصلی به همراه فایل‌های include (که هرکدام متناظر با یک فایل Pod ورودی است) وجود داشته باشد، آن فایل‌های include از دایرکتوری \fI\s-1NAME\s0\fR گنجانده می‌شوند. .Sp اگر \f(CW\*(C`\-\-outdir\*(C'\fR تنظیم شده باشد، \fI\s-1NAME\s0\fR باید به‌طور کلی روی مسیر دایرکتوری نسبی میان راهنمای اصلی و آرگومان \f(CW\*(C`\-\-outdir\*(C'\fR تنظیم شود. .IP "\fB\-\-unnumbered\-sections\fR" 4 .IX Item "--unnumbered-sections" استفاده از دستورات بخش‌بندی بدون شماره (\f(CW@unnumbered\fR، ...) به‌جای دستورات پیش‌فرض شماره‌دار بخش‌بندی در Texinfo (\f(CW@chapter\fR، \&\f(CW@section\fR، ...). .IP "\fB\-\-top\fR=\fI\s-1TOP\s0\fR" 4 .IX Item "--top=TOP" نام عنصر \f(CW@top\fR برای راهنمای اصلی. می‌تواند شامل کدهای Texinfo باشد. .IP "\fB\-\-version\fR" 4 .IX Item "--version" نمایش اطلاعات نسخه و خروج. .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" Pod::Simple::Texinfo. perlpod. راهنمای Texinfo. صفحه خانگی Texinfo: .SH "حق نشر و مجوز (COPYRIGHT AND LICENSE)" .IX Header "COPYRIGHT AND LICENSE" حق نشر 2012\-2026 Free Software Foundation, Inc. .PP این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (\s-1GNU\s0 General Public License) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، بازتوزیع کرده یا تغییر دهید؛ چه نسخه ۳ این مجوز و چه (به انتخاب خودتان) هر نسخه بعدی آن. .PP هیچ تضمینی وجود ندارد (\s-1NO WARRANTY\s0)، تا جایی که قانون اجازه می‌دهد. .SH "نویسنده (AUTHOR)" .IX Header "AUTHOR" Patrice Dumas .