.\" Generated by scdoc 1.11.4
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "RPM-MACROFILE" "5" "2026-03-06" "RPM 6.0.1"
.PP
.SH "نام (NAME)"
\fBrpm-macrofile\fR \- قالب فایل ماکروی rpm
.PP
.SH "خلاصه دستور (SYNOPSIS)"
%\fINAME\fR[([\fIOPTS\fR]) \fIBODY\fR
.PP
.SH "توضیحات (DESCRIPTION)"
فایل‌های ماکروی Rpm برای تعریف \fBrpm-macros\fR(7) در بستر عمومی ماکروها (global macro context) به کار می‌روند.\&
دو کاربرد اصلی ماکروها، کمک به فرآیند بسته‌بندی و پیکربندی رفتار rpm است.\& مجموعه‌ای از پیش تعیین‌شده از فایل‌های ماکرو هنگام مقداردهی اولیه کتابخانه \fBrpm\fR همان‌طور که در \fBrpm-config\fR(5) شرح داده شده خوانده می‌شوند، اما می‌توان آن‌ها را به‌طور جداگانه از طریق ماکروی \fB%load\fR نیز بارگذاری کرد.\&
.PP
قالب یک فایل ماکرو بدین صورت است: نام ماکرو (\fINAME\fR) با پیشوند \fB%\fR، به دنبال آن فاصله خالی و سپس بدنه ماکرو؛ هر تعریف جدید با یک خط جدید جدا می‌شود.\& ساختار نگارش دقیقاً مانند استفاده از \fB%define\fR است.\& برای جزئیات نحو ماکرو، به \fBrpm-macros\fR(7) مراجعه کنید.\&
.PP
کاراکتر \fB\e\fR در انتهای خط نشان‌دهنده ادامه خط است، اما می‌توان آن را در داخل بدنه ماکروهایی که در یک بلوک \fB%{macro:.\&.\&.\&}\fR محصور شده‌اند حذف کرد.\&
.PP
خطوطی که با \fB#\fR آغاز می‌شوند یا صرفاً شامل فاصله‌های خالی هستند نادیده گرفته می‌شوند.\&
.PP
خواندن فایل ماکرو همیشه کاملاً اعلانی است: هنگام خواندن فایل ماکرو هیچ ماکرویی گسترش (expand) نمی‌یابد.\&
.PP
.SH "مثال‌ها (EXAMPLES)"
.SS "مثال ۱. ماکروی ساده"
.nf
.RS 4
%mytool	/usr/bin/mytool-with-annoying-name
.fi
.RE
.PP
.SS "مثال ۲. ماکروی چندخطی با توضیح پیشین"
.nf
.RS 4
# قرار دادن %{nil} در انتها برای اطمینان از درج خط جدید کاربردی است
%mycmd %{mytool} \\
    --one \\
    --with \\
    --too \\
    --many arguments \\
%{nil}
.fi
.RE
.PP
.SS "مثال ۳. ماکروی پارامتریک چندخطی Lua:"
.nf
.RS 4
%myhelper() %{lua:
    function dostuff(arg)
        return \&'do stuff to \&'\&.\&.arg
    end
    print(dostuff(arg[1]))
}
.fi
.RE
.PP
.SH "همچنین ببینید (SEE ALSO)"
\fBrpm-config\fR(5) \fBrpmbuild-config\fR(5)
\fBrpm-macros\fR(7)