.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH AUTOM4TE "1" "مارس 2026" "GNU Autoconf 2.73" "دستورات کاربر"
.SH "نام (NAME)"
autom4te \- تولید فایلها و اسکریپتها به کمک M4
.SH "خلاصه دستور (SYNOPSIS)"
.B autom4te
[\fI\,گزینه\/\fR]... [\fI\,فایل‌ها\/\fR]
.SH "توضیحات (DESCRIPTION)"
اجرای GNU M4 بر روی \fIFILES\fR، بدون اجراهای غیرضروری. در صورت ردیابی، ردپاها در خروجی قرار می‌گیرد؛ در صورت فریز کردن، فایل فریز‌شده؛ و در غیر این صورت خروجی گسترش‌یافتهٔ \fIFILES\fR خواهد بود.
.PP
اگر برخی از فایل‌های \fIFILES\fR با نام 'FILE.m4f' نام‌گذاری شده باشند، به‌عنوان فایل‌های فریز‌شدهٔ M4 برای تمامی فایل‌های قبلی در نظر گرفته می‌شوند (که در نتیجه، فایل‌های قبلی بارگذاری نخواهند شد). اگر 'FILE.m4f' یافت نشود، آنگاه 'FILE.m4' به همراه تمامی فایل‌های قبلی استفاده خواهد شد.
.PP
برخی از فایل‌ها ممکن است اختیاری باشند؛ یعنی تنها در صورت یافت شدن در مسیر include پردازش می‌شوند، اما در این صورت نام آن‌ها باید به '.m4?' ختم شود؛ علامت سؤال بخشی از نام واقعی فایل نیست.
.SS "حالتهای عملیاتی:"
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش این راهنما و خروج
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش شماره نسخه و خروج
.TP
\fB\-v\fR, \fB\-\-verbose\fR
گزارش مراحل پردازش با جزئیات کامل
.TP
\fB\-d\fR, \fB\-\-debug\fR
عدم حذف فایل‌های موقت
.TP
\fB\-o\fR, \fB\-\-output\fR=\fI\,FILE\/\fR
ذخیره خروجی در \fIFILE\fR (پیش‌فرض '\-'، خروجی استاندارد است)
.TP
\fB\-f\fR, \fB\-\-force\fR
عدم اتکا به مقادیر کش‌شده
.TP
\fB\-W\fR, \fB\-\-warnings\fR=\fI\,CATEGORY\/\fR
گزارش هشدارهای مربوط به دستهٔ \fICATEGORY\fR
(فهرست جداشده با ویرگول نیز پذیرفته می‌شود)
.TP
\fB\-l\fR, \fB\-\-language\fR=\fI\,LANG\/\fR
مشخص کردن مجموعه ماکروهای M4 مورد استفاده
.TP
\fB\-C\fR, \fB\-\-cache\fR=\fI\,DIRECTORY\/\fR
حفظ نتایج برای اجراهای آینده در \fIDIRECTORY\fR
.TP
\fB\-\-no\-cache\fR
غیرفعال‌سازی کش
.TP
\fB\-m\fR, \fB\-\-mode\fR=\fI\,OCTAL\/\fR
تغییر حالت دسترسی فایل خروجیِ غیر ردیابی (0666)
.TP
\fB\-M\fR, \fB\-\-melt\fR
عدم استفاده از فایل‌های فریز‌شدهٔ M4
.SS "زبانها شامل:"
.TP
\&'Autoconf'
تولید اسکریپت‌های پیکربندی Autoconf
.TP
\&'Autotest'
تولید مجموعه‌های آزمون Autotest
.TP
\&'M4sh'
تولید اسکریپت‌های شل M4sh
.TP
\&'M4sugar'
تولید خروجی M4sugar
.SS "دستهبندیهای هشدار عبارتند از:"
.TP
cross
مسائل مربوط به کامپایل متقابل (cross compilation)
.TP
gnu
استانداردهای کدنویسی گنو (پیش‌فرض در حالت‌های gnu و gnits)
.TP
obsolete
قابلیت‌ها یا ساختارهای منسوخ‌شده (پیش‌فرض)
.TP
override
بازتعریف قوانین یا متغیرهای Automake توسط کاربر
.TP
portability
مسائل مربوط به قابلیت حمل (پیش‌فرض در حالت‌های gnu و gnits)
.TP
portability\-recursive
متغیرهای تودرتوی Make (پیش‌فرض همراه‌با \fB\-Wportability\fR)
.TP
extra\-portability
مسائل جانبی قابلیت حمل مرتبط با ابزارهای کمتر شناخته‌شده
.TP
syntax
ساختارهای نحوی مشکوک (پیش‌فرض)
.TP
unsupported
قابلیت‌های پشتیبانی‌نشده یا ناقص (پیش‌فرض)
.SS "-W همچنین موارد زیر را درک میکند:"
.TP
all
فعال‌سازی تمام هشدارها
.TP
none
غیرفعال‌سازی تمام هشدارها
.TP
no\-CATEGORY
غیرفعال‌سازی هشدارهای موجود در \fICATEGORY\fR
.TP
error
تلقی کردن تمام هشدارهای فعال‌شده به‌عنوان خطا
.PP
متغیرهای محیطی 'M4' و 'WARNINGS' رعایت و اعمال می‌شوند.
.SS "دایرکتوریهای کتابخانه:"
.TP
\fB\-B\fR, \fB\-\-prepend\-include\fR=\fI\,DIR\/\fR
افزودن دایرکتوری \fIDIR\fR به ابتدای مسیر جستجو
.TP
\fB\-I\fR, \fB\-\-include\fR=\fI\,DIR\/\fR
افزودن دایرکتوری \fIDIR\fR به انتهای مسیر جستجو
.SS "ردیابی (Tracing):"
.TP
\fB\-t\fR, \fB\-\-trace\fR=\fI\,MACRO[\/\fR:FORMAT]
گزارش فراخوانی‌های \fIMACRO\fR
.TP
\fB\-p\fR, \fB\-\-preselect\fR=\fI\,MACRO\/\fR
آماده‌سازی برای ردیابی \fIMACRO\fR در اجرای آینده
.SS "فریز کردن (Freezing):"
.TP
\fB\-F\fR, \fB\-\-freeze\fR
تولید یک فایل وضعیت فریز‌شدهٔ M4 برای \fIFILES\fR
.SS "مقدار پیش‌فرض FORMAT برابر '$f:$l:$n:$%' است و می‌تواند از کدهای گریز زیر استفاده کند:"
.TP
$$
نویسهٔ واقعی $
.TP
$f
فایلی که ماکرو در آن فراخوانی شده است
.TP
$l
شماره خطی که ماکرو در آن فراخوانی شده است
.TP
$d
عمق تودرتویی فراخوانی ماکرو
.TP
$n
نام ماکرو
.TP
$NUM
آرگومان شمارهٔ \fINUM\fR، بدون نقل‌قول و همراه‌با خطوط جدید
.TP
$SEP@
تمام آرگومان‌ها، همراه‌با خطوط جدید، داخل نقل‌قول و جداشده با \fISEP\fR
.TP
$SEP*
تمام آرگومان‌ها، همراه‌با خطوط جدید، بدون نقل‌قول و جداشده با \fISEP\fR
.TP
$SEP%
تمام آرگومان‌ها، بدون خطوط جدید، بدون نقل‌قول و جداشده با \fISEP\fR
.PP
متغیر \fISEP\fR می‌تواند برای حالت پیش‌فرض خالی باشد (ویرگول برای @ و *، دونقطه برای %)، یک نویسه برای همان نویسه، یا {STRING} برای استفاده از یک رشته.
.SH "نویسنده (AUTHOR)"
نوشته‌شده توسط Akim Demaille.
.SH "گزارش باگها (REPORTING BUGS)"
گزارش باگ‌ها به
.MT bug-autoconf@gnu.org
.ME ،
یا از طریق ساوانا:
.UR https://savannah.gnu.org/support/?group=autoconf
.UE .
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2026 بنیاد نرم‌افزارهای آزاد (Free Software Foundation, Inc).
.br
مجوز GPLv3+/Autoconf: گنو GPL نسخه ۳ یا بالاتر
<https://gnu.org/licenses/gpl.html>, <https://gnu.org/licenses/exceptions.html>
.br
این نرم‌افزار آزاد است: شما در تغییر و بازتوزیع آن آزاد هستید.
هیچ ضمانتی برای آن وجود ندارد، تا حدی که قانون مجاز می‌داند.
.SH "همچنین ببینید (SEE ALSO)"
.BR autoconf (1),
.BR automake (1),
.BR autoreconf (1),
.BR autoupdate (1),
.BR autoheader (1),
.BR autoscan (1),
.BR config.guess (1),
.BR config.sub (1),
.BR ifnames (1),
.BR libtool (1).
.PP
مستندات کامل Autoconf به‌صورت کتابچه راهنمای Texinfo نگهداری می‌شود.
برای خواندن راهنما به‌صورت محلی، دستور زیر را اجرا کنید:
.IP
.B info autoconf
.PP
همچنین می‌توانید نسخهٔ وب این راهنما را در نشانی زیر مشاهده کنید:
.UR https://gnu.org/software/autoconf/manual
.UE .