نام (NAME)

autom4te - تولید فایلها و اسکریپتها به کمک M4

خلاصه دستور (SYNOPSIS)

autom4te [گزینه]... [فایل‌ها]

توضیحات (DESCRIPTION)

اجرای GNU M4 بر روی FILES، بدون اجراهای غیرضروری. در صورت ردیابی، ردپاها در خروجی قرار می‌گیرد؛ در صورت فریز کردن، فایل فریز‌شده؛ و در غیر این صورت خروجی گسترش‌یافتهٔ FILES خواهد بود.

اگر برخی از فایل‌های FILES با نام 'FILE.m4f' نام‌گذاری شده باشند، به‌عنوان فایل‌های فریز‌شدهٔ M4 برای تمامی فایل‌های قبلی در نظر گرفته می‌شوند (که در نتیجه، فایل‌های قبلی بارگذاری نخواهند شد). اگر 'FILE.m4f' یافت نشود، آنگاه 'FILE.m4' به همراه تمامی فایل‌های قبلی استفاده خواهد شد.

برخی از فایل‌ها ممکن است اختیاری باشند؛ یعنی تنها در صورت یافت شدن در مسیر include پردازش می‌شوند، اما در این صورت نام آن‌ها باید به '.m4?' ختم شود؛ علامت سؤال بخشی از نام واقعی فایل نیست.

حالتهای عملیاتی:

-h, --help: نمایش این راهنما و خروج
-V, --version: نمایش شماره نسخه و خروج
-v, --verbose: گزارش مراحل پردازش با جزئیات کامل
-d, --debug: عدم حذف فایل‌های موقت
-o, --output=FILE: ذخیره خروجی در FILE (پیش‌فرض '-'، خروجی استاندارد است)
-f, --force: عدم اتکا به مقادیر کش‌شده
-W, --warnings=CATEGORY: گزارش هشدارهای مربوط به دستهٔ CATEGORY (فهرست جداشده با ویرگول نیز پذیرفته می‌شود)
-l, --language=LANG: مشخص کردن مجموعه ماکروهای M4 مورد استفاده
-C, --cache=DIRECTORY: حفظ نتایج برای اجراهای آینده در DIRECTORY
--no-cache: غیرفعال‌سازی کش
-m, --mode=OCTAL: تغییر حالت دسترسی فایل خروجیِ غیر ردیابی (0666)
-M, --melt: عدم استفاده از فایل‌های فریز‌شدهٔ M4

زبانها شامل:

'Autoconf': تولید اسکریپت‌های پیکربندی Autoconf
'Autotest': تولید مجموعه‌های آزمون Autotest
'M4sh': تولید اسکریپت‌های شل M4sh
'M4sugar': تولید خروجی M4sugar

دستهبندیهای هشدار عبارتند از:

cross: مسائل مربوط به کامپایل متقابل (cross compilation)
gnu: استانداردهای کدنویسی گنو (پیش‌فرض در حالت‌های gnu و gnits)
obsolete: قابلیت‌ها یا ساختارهای منسوخ‌شده (پیش‌فرض)
override: بازتعریف قوانین یا متغیرهای Automake توسط کاربر
portability: مسائل مربوط به قابلیت حمل (پیش‌فرض در حالت‌های gnu و gnits)
portability-recursive: متغیرهای تودرتوی Make (پیش‌فرض همراه‌با -Wportability)
extra-portability: مسائل جانبی قابلیت حمل مرتبط با ابزارهای کمتر شناخته‌شده
syntax: ساختارهای نحوی مشکوک (پیش‌فرض)
unsupported: قابلیت‌های پشتیبانی‌نشده یا ناقص (پیش‌فرض)

-W همچنین موارد زیر را درک میکند:

all: فعال‌سازی تمام هشدارها
none: غیرفعال‌سازی تمام هشدارها
no-CATEGORY: غیرفعال‌سازی هشدارهای موجود در CATEGORY
error: تلقی کردن تمام هشدارهای فعال‌شده به‌عنوان خطا

متغیرهای محیطی 'M4' و 'WARNINGS' رعایت و اعمال می‌شوند.

دایرکتوریهای کتابخانه:

-B, --prepend-include=DIR: افزودن دایرکتوری DIR به ابتدای مسیر جستجو
-I, --include=DIR: افزودن دایرکتوری DIR به انتهای مسیر جستجو

ردیابی (Tracing):

-t, --trace=MACRO[:FORMAT]: گزارش فراخوانی‌های MACRO
-p, --preselect=MACRO: آماده‌سازی برای ردیابی MACRO در اجرای آینده

فریز کردن (Freezing):

-F, --freeze: تولید یک فایل وضعیت فریز‌شدهٔ M4 برای FILES

مقدار پیش‌فرض FORMAT برابر '$f:$l:$n:$%' است و می‌تواند از کدهای گریز زیر استفاده کند:

$$: نویسهٔ واقعی $
$f: فایلی که ماکرو در آن فراخوانی شده است
$l: شماره خطی که ماکرو در آن فراخوانی شده است
$d: عمق تودرتویی فراخوانی ماکرو
$n: نام ماکرو
$NUM: آرگومان شمارهٔ NUM، بدون نقل‌قول و همراه‌با خطوط جدید
$SEP@: تمام آرگومان‌ها، همراه‌با خطوط جدید، داخل نقل‌قول و جداشده با SEP
$SEP*: تمام آرگومان‌ها، همراه‌با خطوط جدید، بدون نقل‌قول و جداشده با SEP
$SEP%: تمام آرگومان‌ها، بدون خطوط جدید، بدون نقل‌قول و جداشده با SEP

متغیر SEP می‌تواند برای حالت پیش‌فرض خالی باشد (ویرگول برای @ و *، دونقطه برای %)، یک نویسه برای همان نویسه، یا {STRING} برای استفاده از یک رشته.

نویسنده (AUTHOR)

نوشته‌شده توسط Akim Demaille.

گزارش باگها (REPORTING BUGS)

گزارش باگ‌ها به bug-autoconf@gnu.org، یا از طریق ساوانا: https://savannah.gnu.org/support/?group=autoconf.

حق نشر (COPYRIGHT)

حق نشر © 2026 بنیاد نرم‌افزارهای آزاد (Free Software Foundation, Inc).
مجوز GPLv3+/Autoconf: گنو GPL نسخه ۳ یا بالاتر https://gnu.org/licenses/gpl.html, https://gnu.org/licenses/exceptions.html
این نرم‌افزار آزاد است: شما در تغییر و بازتوزیع آن آزاد هستید. هیچ ضمانتی برای آن وجود ندارد، تا حدی که قانون مجاز می‌داند.

همچنین ببینید (SEE ALSO)

autoconf(1), automake(1), autoreconf(1), autoupdate(1), autoheader(1), autoscan(1), config.guess(1), config.sub(1), ifnames(1), libtool(1).

مستندات کامل Autoconf به‌صورت کتابچه راهنمای Texinfo نگهداری می‌شود. برای خواندن راهنما به‌صورت محلی، دستور زیر را اجرا کنید:

: info autoconf

همچنین می‌توانید نسخهٔ وب این راهنما را در نشانی زیر مشاهده کنید: https://gnu.org/software/autoconf/manual.

مارس 2026

GNU Autoconf 2.73