.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH M4 "1" "March 2026" "GNU M4 1.4.21" "User Commands"
.SH "نام (NAME)"
m4 \- پردازشگر ماکرو
.SH "خلاصه دستور (SYNOPSIS)"
.B m4
[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]...
.SH "توضیحات (DESCRIPTION)"
پردازش ماکروها در FILEها. اگر هیچ FILEای مشخص نشود یا FILE برابر با `\-' باشد، ورودی
استاندارد خوانده می‌شود.
.PP
آرگومان‌های اجباری یا اختیاری برای گزینه‌های طولانی، برای گزینه‌های
کوتاه نیز اجباری یا اختیاری هستند.
.SS "حالت‌های عملکرد:"
.TP
\fB\-\-help\fR
نمایش این راهنما و خروج
.TP
\fB\-\-version\fR
نمایش اطلاعات نسخه و خروج
.TP
\fB\-E\fR, \fB\-\-fatal\-warnings\fR
یک‌بار: هشدارها به خطا تبدیل می‌شوند؛ دوبار: توقف
اجرا در اولین خطا
.TP
\fB\-i\fR, \fB\-\-interactive\fR
غیرفعال کردن بافر خروجی، نادیده گرفتن وقفه‌ها
.TP
\fB\-P\fR, \fB\-\-prefix\-builtins\fR
اجبار پیشوند `m4_' برای تمام دستورات توکار
.TP
\fB\-Q\fR, \fB\-\-quiet\fR, \fB\-\-silent\fR
فرونشاندن برخی هشدارها برای دستورات توکار
.TP
\fB\-\-warn\-macro\-sequence\fR[=\fI\,REGEXP\/\fR]
هشدار در صورت مطابقت تعریف ماکرو با REGEXP،
.IP
پیش‌فرض \e$\e({[^}]*}\e|[0\-9][0\-9]+\e)
.SS "ویژگی‌های پیش‌پردازنده:"
.TP
\fB\-D\fR, \fB\-\-define=NAME\fR[=\fI\,VALUE\/\fR]
تعریف NAME با مقدار VALUE، یا خالی
.TP
\fB\-I\fR, \fB\-\-include\fR=\fI\,DIRECTORY\/\fR
افزودن DIRECTORY به مسیر include
.TP
\fB\-s\fR, \fB\-\-synclines\fR
تولید خطوط `#line NUM "FILE"'
.TP
\fB\-U\fR, \fB\-\-undefine\fR=\fI\,NAME\/\fR
لغو تعریف NAME
.SS "کنترل محدودیت‌ها:"
.TP
\fB\-g\fR, \fB\-\-gnu\fR
لغو \fB\-G\fR برای فعال‌سازی مجدد افزونه‌های GNU
.TP
\fB\-G\fR, \fB\-\-traditional\fR
غیرفعال‌سازی تمام افزونه‌های GNU
.TP
\fB\-H\fR, \fB\-\-hashsize\fR=\fI\,PRIME\/\fR
تنظیم اندازه جدول درهم‌سازی جستجوی نماد [65537]
.TP
\fB\-L\fR, \fB\-\-nesting\-limit\fR=\fI\,NUMBER\/\fR
تغییر محدودیت تودرتویی، 0 برای نامحدود [0]
.SS "فایل‌های وضعیت منجمد:"
.TP
\fB\-F\fR, \fB\-\-freeze\-state\fR=\fI\,FILE\/\fR
ایجاد یک وضعیت منجمد در FILE در پایان
.TP
\fB\-R\fR, \fB\-\-reload\-state\fR=\fI\,FILE\/\fR
بارگذاری مجدد وضعیت منجمد از FILE در ابتدا
.SS "اشکال‌زدایی:"
.TP
\fB\-d\fR, \fB\-\-debug\fR[=\fI\,FLAGS\/\fR]
تنظیم سطح اشکال‌زدایی (نبود FLAGS به معنای `aeq' است)
.TP
\fB\-\-debugfile\fR[=\fI\,FILE\/\fR]
هدایت خروجی اشکال‌زدایی و ردگیری به FILE
(پیش‌فرض stderr، در صورت رشته خالی دور ریخته می‌شود)
.TP
\fB\-l\fR, \fB\-\-arglength\fR=\fI\,NUM\/\fR
محدود کردن اندازه ردگیری ماکرو
.TP
\fB\-t\fR, \fB\-\-trace\fR=\fI\,NAME\/\fR
ردگیری NAME هنگام تعریف شدن آن
.SS "FLAGS شامل هر یک از موارد زیر است:"
.TP
a
نمایش آرگومان‌های واقعی
.TP
c
نمایش پیش از جمع‌آوری، پس از جمع‌آوری و پس از فراخوانی
.TP
e
نمایش بسط
.TP
f
اعلام نام فایل ورودی جاری
.TP
i
نمایش تغییرات در فایل‌های ورودی
.TP
l
اعلام شماره خط ورودی جاری
.TP
p
نمایش نتایج جستجوهای مسیر
.TP
q
نقل‌قول کردن مقادیر در صورت نیاز، با پرچم a یا e
.TP
t
ردیابی برای تمام فراخوانی‌های ماکرو، نه فقط موارد traceon شده
.TP
x
افزودن شناسه فراخوانی ماکروی یکتا، مفید همراه با پرچم c
.TP
V
کوته‌نوشتی برای تمامی پرچم‌های بالا
.PP
در صورت تعریف شدن، متغیر محیطی `M4PATH' فهرستی از دایرکتوری‌ها است که با دونقطه (:) جدا شده‌اند و پس از هر مورد مشخص‌شده با `\-I' لحاظ می‌شوند.
.PP
وضعیت خروج برای موفقیت 0، برای شکست 1، برای عدم تطابق نسخه پرونده منجمد 63، یا هر مقداری است که به ماکروی m4exit ارسال شده است.
.SH "نویسندگان (AUTHORS)"
نوشته‌شده توسط Rene' Seindal.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش اشکالات به: bug\-m4@gnu.org
.br
صفحه خانگی GNU M4: <https://www.gnu.org/software/m4>
.br
راهنمای عمومی استفاده از نرم‌افزارهای گنو: <https://www.gnu.org/gethelp>
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2026 Free Software Foundation, Inc.
مجوز GPLv3+: گنو GPL نسخه 3 یا بالاتر <https://gnu.org/licenses/gpl.html>.
.br
این نرم‌افزار آزاد است: شما در تغییر و بازتوزیع آن آزاد هستید.
هیچ ضمانتی وجود ندارد، تا حدی که قانون اجازه می‌دهد.
.SH "همچنین ببینید (SEE ALSO)"
مستندات کامل برای
.B m4
به عنوان یک راهنمای Texinfo نگهداری می‌شود. اگر برنامه‌های
.B info
و
.B m4
به درستی در سیستم شما نصب شده باشند، دستور
.IP
.B info m4
.PP
باید دسترسی به راهنمای کامل را برای شما فراهم کند.