.de1 NOP
.  it 1 an-trap
.  if \\n[.$] \,\\$*\/
..
.ie t \
.ds B-Font [CB]
.ds I-Font [CI]
.ds R-Font [CR]
.el \
.ds B-Font B
.ds I-Font I
.ds R-Font R
.TH xml2ag 1 "23 Apr 2025" "GNU AutoGen (5.18.16)" "User Commands"
.\"
.\" DO NOT EDIT THIS FILE (in-mem file)
.\"
.\" It has been AutoGen-ed
.\" From the definitions ./xmlopts.def
.\" and the template file agman-cmd
.SH "نام (NAME)"
xml2ag \- تبدیل تعاریف XML به تعاریف و قالب‌های قابل استفاده در AutoGen
.SH "خلاصه دستور (SYNOPSIS)"
\f\*[B-Font]xml2ag\fP
.\" Mixture of short (flag) options and long options
[\f\*[B-Font]\-flags\f[]]
[\f\*[B-Font]\-flag\f[] [\f\*[I-Font]value\f[]]]
[\f\*[B-Font]\-\-option-name\f[][[=| ]\f\*[I-Font]value\f[]]]
[ <def-file> ]
.sp \n(Ppu
.ne 2

این برنامه هر فایل XML دلخواهی را به تعاریف معادل AutoGen تبدیل کرده و AutoGen را فراخوانی می‌کند.
.SH "توضیحات (DESCRIPTION)"
قالب (template) از یکی از موارد زیر مشتق خواهد شد:
.br
*  گزینه خط فرمان \fB--override-tpl\fP
.br
*  یک صفت سطح بالا در XML با نام "template"
.br
یکی از این دو \fBباید\fP ارائه شود، در غیر این صورت برنامه با پیام خطا خارج خواهد شد.
.sp 1
نام پایه (\(lqbase-name\(rq) برای خروجی نیز به‌طور مشابه از یکی از موارد زیر خواهد بود:
.br
*  گزینه خط فرمان \fB--base-name\fP
.br
*  نام پایه فایل ‎.xml
.SH "گزینه‌ها (OPTIONS)"
.SS "سایر گزینه‌ها از autogen مشتق شده‌اند"
.TP
.NOP \f\*[B-Font]\-O\f[] \f\*[I-Font]file\f[], \f\*[B-Font]\-\-output\f[]=\f\*[I-Font]file\f[]
فایل خروجی به جای پردازش توسط AutoGen.
.sp
به‌طور پیش‌فرض، خروجی برای پردازش به یک فرایند AutoGen تحویل داده می‌شود. با این حال، می‌توانید به جای آن، تعاریف را در یک فایل ذخیره کنید.
.SS "سایر گزینه‌ها"
این گزینه‌ها \fIعمدتاً\fP مستقیماً به \fBautogen\fP فرستاده می‌شوند (pass-through).
تنها استثنا \fB--override-tpl\fP است که قالب پیش‌فرض را در تعاریف خروجی جایگزین می‌کند. این گزینه از طریق خط فرمان منتقل نمی‌شود.
.TP
.NOP \f\*[B-Font]\-L\f[] \f\*[I-Font]dir\f[], \f\*[B-Font]\-\-templ\-dirs\f[]=\f\*[I-Font]dir\f[]
جستجو برای قالب‌ها در پوشه \fIDIR\fP.
این گزینه می‌تواند به تعداد نامحدود تکرار شود.
.sp
آرگومان عبوری (Pass-through) به AutoGen
.TP
.NOP \f\*[B-Font]\-T\f[] \f\*[I-Font]tpl\-file\f[], \f\*[B-Font]\-\-override\-tpl\f[]=\f\*[I-Font]tpl\-file\f[]
استفاده از \fITPL-FILE\fP به عنوان قالب.
.sp
آرگومان عبوری (Pass-through) به AutoGen
.TP
.NOP \f\*[B-Font]\-\-definitions\f[]=\f\*[I-Font]file\f[]
خواندن تعاریف از \fIFILE\fP.
.sp
آرگومان عبوری (Pass-through) به AutoGen
.TP
.NOP \f\*[B-Font]\-\-shell\f[]=\f\*[I-Font]shell\f[]
نام یا مسیر شل (shell) مورد استفاده.
.sp
آرگومان عبوری (Pass-through) به AutoGen
.TP
.NOP \f\*[B-Font]\-m\f[], \f\*[B-Font]\-\-no\-fmemopen\f[]
عدم استفاده از جریان‌های درون حافظه (in-mem streams).
.sp
آرگومان عبوری (Pass-through) به AutoGen
.TP
.NOP \f\*[B-Font]\-\-equate\f[]=\f\*[I-Font]char\-list\f[]
کاراکترهایی که معادل در نظر گرفته می‌شوند.
.sp
آرگومان عبوری (Pass-through) به AutoGen
.TP
.NOP \f\*[B-Font]\-b\f[] \f\*[I-Font]name\f[], \f\*[B-Font]\-\-base\-name\f[]=\f\*[I-Font]name\f[]
مشخص کردن \fBNAME\fP به عنوان نام پایه خروجی.
.sp
آرگومان عبوری (Pass-through) به AutoGen
.TP
.NOP \f\*[B-Font]\-\-source\-time\f[]
تنظیم زمان تغییر مطابق با آخرین فایل منبع.
.sp
آرگومان عبوری (Pass-through) به AutoGen
.TP
.NOP \f\*[B-Font]\-\-writable\f[], \f\*[B-Font]\-\-not\-writable\f[]
اجازه دادن به فایل‌های خروجی برای قابل نوشتن بودن (writable).
حالت \fInot\-writable\fP این گزینه را غیرفعال می‌کند.
.sp
آرگومان عبوری (Pass-through) به AutoGen
.TP
.NOP \f\*[B-Font]\-\-loop\-limit\f[]=\f\*[I-Font]lim\f[]
محدودیت روی حلقه‌های افزایشی (increment loops).
این گزینه یک عدد صحیح را به عنوان آرگومان دریافت می‌کند.
مقدار
\f\*[I-Font]lim\f[]
محدود به موارد زیر است:
.in +4
.nf
.na
دقیقاً \-1، یا
در محدوده 1 تا 0x1000000
.fi
.in -4
مقدار پیش‌فرض
\f\*[I-Font]lim\f[]
برای این گزینه برابر است با:
.ti +4
 256
.sp
آرگومان عبوری (Pass-through) به AutoGen
.TP
.NOP \f\*[B-Font]\-t\f[] \f\*[I-Font]seconds\f[], \f\*[B-Font]\-\-timeout\f[]=\f\*[I-Font]seconds\f[]
محدود کردن عملیات شل سرور به \fBSECONDS\fP ثانیه.
این گزینه یک عدد صحیح را به عنوان آرگومان دریافت می‌کند.
مقدار
\f\*[I-Font]seconds\f[]
محدود به موارد زیر است:
.in +4
.nf
.na
در محدوده 0 تا 3600
.fi
.in -4
.sp
آرگومان عبوری (Pass-through) به AutoGen
.TP
.NOP \f\*[B-Font]\-\-trace\f[]=\f\*[I-Font]level\f[]
سطح جزئیات ردگیری (tracing).
این گزینه یک کلمه کلیدی را به عنوان آرگومان دریافت می‌کند. این آرگومان یک مقدار شمارشی (enumeration) را تنظیم می‌کند که با مقایسه با ماکروی مقدار گزینه قابل بررسی است.
کلمات کلیدی در دسترس عبارتند از:
.in +4
.nf
.na
nothing       debug-message server-shell
templates     block-macros  expressions
everything
.fi
یا معادل عددی آن‌ها.
.in -4
.sp
مقدار پیش‌فرض
\f\*[I-Font]level\f[]
برای این گزینه برابر است با:
.ti +4
 nothing
.sp
آرگومان عبوری (Pass-through) به AutoGen
.TP
.NOP \f\*[B-Font]\-\-trace\-out\f[]=\f\*[I-Font]file\f[]
فایل یا فیلتر خروجی ردگیری (tracing).
.sp
آرگومان عبوری (Pass-through) به AutoGen
.TP
.NOP \f\*[B-Font]\-\-show\-defs\f[]
نمایش درخت تعاریف.
.sp
آرگومان عبوری (Pass-through) به AutoGen
.TP
.NOP \f\*[B-Font]\-\-used\-defines\f[]
نمایش تعاریف استفاده‌شده.
.sp
آرگومان عبوری (Pass-through) به AutoGen
.TP
.NOP \f\*[B-Font]\-C\f[], \f\*[B-Font]\-\-core\f[]
بر جای گذاشتن یک core dump هنگام خروج ناشی از خطا.
.sp
بسیاری از سیستم‌ها به‌طور پیش‌فرض محدودیت اندازه core را صفر در نظر می‌گیرند. اگر سیستم دارای هدر sys/resource.h باشد و این گزینه ارائه شود، در مسیر خروج ناشی از شکست، autogen تلاش خواهد کرد تا محدودیت soft core را به هر مقداری که محدودیت hard core است افزایش دهد. اگر این کار عمل نکرد، مدیر سیستم باید محدودیت اندازه hard core را افزایش دهد.
.TP
.NOP \f\*[B-Font]\-s\f[] \f\*[I-Font]suffix\f[], \f\*[B-Font]\-\-skip\-suffix\f[]=\f\*[I-Font]suffix\f[]
صرف‌نظر کردن از فایلی با این \fISUFFIX\fP (پسوند).
این گزینه می‌تواند به تعداد نامحدود تکرار شود.
این گزینه نباید در ترکیب با هیچ‌یک از گزینه‌های زیر استفاده شود:
select-suffix.
.sp
آرگومان عبوری (Pass-through) به AutoGen
.TP
.NOP \f\*[B-Font]\-o\f[] \f\*[I-Font]suffix\f[], \f\*[B-Font]\-\-select\-suffix\f[]=\f\*[I-Font]suffix\f[]
مشخص کردن این پسوند خروجی.
این گزینه می‌تواند به تعداد نامحدود تکرار شود.
.sp
آرگومان عبوری (Pass-through) به AutoGen
.TP
.NOP \f\*[B-Font]\-D\f[] \f\*[I-Font]value\f[], \f\*[B-Font]\-\-define\f[]=\f\*[I-Font]value\f[]
نامی برای افزودن به فهرست تعاریف.
این گزینه می‌تواند به تعداد نامحدود تکرار شود.
.sp
آرگومان عبوری (Pass-through) به AutoGen
.TP
.NOP \f\*[B-Font]\-U\f[] \f\*[I-Font]name\-pat\f[], \f\*[B-Font]\-\-undefine\f[]=\f\*[I-Font]name\-pat\f[]
الگوی حذف از فهرست تعاریف.
این گزینه می‌تواند به تعداد نامحدود تکرار شود.
.sp
آرگومان عبوری (Pass-through) به AutoGen
.TP
.NOP \f\*[B-Font]\-M\f[] \f\*[I-Font]type\f[], \f\*[B-Font]\-\-make\-dep\f[] [\f\*[I-Font]type\f[]]
ایجاد فایل وابستگی make.
این گزینه می‌تواند به تعداد نامحدود تکرار شود.
.sp
آرگومان عبوری (Pass-through) به AutoGen
.TP
.NOP \f\*[B-Font]\-\&?\f[], \f\*[B-Font]\-\-help\f[]
نمایش اطلاعات نحوه استفاده و خروج.
.TP
.NOP \f\*[B-Font]\-\&!\f[], \f\*[B-Font]\-\-more-help\f[]
ارسال اطلاعات مبسوط نحوه استفاده از طریق یک صفحه‌بند (pager).
.TP
.NOP \f\*[B-Font]\-v\f[] [{\f\*[I-Font]v|c|n\f[] \f\*[B-Font]\-\-version\f[] [{\f\*[I-Font]v|c|n\f[]}]}]
نمایش نسخه برنامه و خروج. حالت پیش‌فرض `v` است که نسخه ساده را نشان می‌دهد. حالت `c` اطلاعات کپی‌رایت را چاپ می‌کند و `n` اعلان کامل کپی‌رایت را چاپ خواهد کرد.
.PP
.SH "وضعیت خروج (EXIT STATUS)"
یکی از مقادیر خروج زیر بازگردانده خواهد شد:
.TP
.NOP 0 " (EXIT_SUCCESS)"
اجرای موفقیت‌آمیز برنامه.
.TP
.NOP 1 " (EXIT_FAILURE)"
عملیات ناموفق بود یا نحو دستور معتبر نبود.
.TP
.NOP 70 " (EX_SOFTWARE)"
کتابخانه libopts با یک خطای عملیاتی داخلی مواجه شد. لطفاً آن را به نشانی autogen-users@lists.sourceforge.net گزارش دهید. با تشکر.
.PP
.SH "نویسندگان (AUTHORS)"
Bruce Korb
.SH "کپی‌رایت (COPYRIGHT)"
حق نشر (C) 1992-2018 متعلق به Bruce Korb است؛ تمامی حقوق محفوظ است.
این برنامه تحت شرایط مجوز عمومی همگانی گنو (GNU GPL)، نسخه ۳ یا جدیدتر منتشر شده است.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
لطفاً گزارش‌های باگ را به نشانی autogen-users@lists.sourceforge.net ارسال کنید.
.SH "نکات (NOTES)"
این صفحه راهنما توسط \fIAutoGen\fP از روی تعاریف گزینه‌های \fBxml2ag\fP تولید شده است.