.TH CCMAKEDEP 1 2002-10-12 "imake 1.0.11"
.SH "نام (NAME)"
ccmakedep \- ایجاد وابستگی‌ها در Makefile با استفاده از کامپایلر C
.SH "خلاصه دستور (SYNOPSIS)"
.B ccmakedep
[
.I cpp-flags
] [
.BI \-w width
] [
.BI \-s magic-string
] [
.BI \-f makefile
] [
.BI \-o object-suffix
] [
.B \-v
] [
.B \-a
] [
.BI \-cc compiler
] [
\-\^\-
.I options
\-\^\-
]
.I sourcefile
\^.\|.\|.
.SH "توضیحات (DESCRIPTION)"
برنامه
.B ccmakedep
یک کامپایلر C را برای پیش‌پردازش هر
.IR sourcefile
فراخوانی می‌کند و از خروجی آن برای ساخت قواعد
.I makefile
جهت توصیف وابستگی‌های آن‌ها بهره می‌برد.
این قواعد به
.BR make (1)
اطلاع می‌دهند که هنگام تغییر یک وابستگی، کدام فایل‌های شیء باید مجدداً کامپایل شوند.
.PP
به‌طور پیش‌فرض،
.B ccmakedep
خروجی خود را در فایلی به نام
.I makefile
(در صورت وجود) یا در غیر این صورت در
.I Makefile
قرار می‌دهد.
یک makefile جایگزین را می‌توان با گزینه
.B \-f
مشخص کرد.
این برنامه ابتدا در makefile به دنبال خطی می‌گردد که با
.sp
\&    # DO NOT DELETE
.sp
یا رشته‌ای که با گزینه
.B \-s
تعیین شده آغاز می‌شود تا به عنوان جداکننده خروجی وابستگی‌ها عمل کند.
اگر آن را بیابد، تمام محتوای پس از آن را تا انتهای makefile حذف کرده و خروجی را پس از این خط قرار می‌دهد.
اگر آن را نیابد، برنامه این رشته را به انتهای makefile اضافه کرده و خروجی را پس از آن درج می‌کند.
.SH "مثال (EXAMPLE)"
معمولاً
.B ccmakedep
در یک هدف makefile استفاده می‌شود تا با اجرای دستور «make depend»، وابستگی‌های makefile به‌روزرسانی شوند.
برای نمونه،
.nf
    SRCS\0=\0file1.c\0file2.c\0.\|.\|.
    CFLAGS\0=\0\-O\0\-DHACK\0\-I\^.\^.\^/foobar\0\-xyz
    depend:
            ccmakedep\0\-\^\-\0$(CFLAGS)\0\-\^\-\0$(SRCS)
.fi
.SH "گزینه‌ها (OPTIONS)"
این برنامه هر گزینه‌ای را که تشخیص ندهد نادیده می‌گیرد، بنابراین می‌توانید از همان آرگومان‌هایی که برای
.BR cc (1)
استفاده می‌کنید بهره ببرید؛ از جمله گزینه‌های
.B \-D
و
.B \-U
برای تعریف یا لغو تعریف نمادها و
.B \-I
برای تعیین مسیر فایل‌های سرآیند (include).
.TP
.B \-a
وابستگی‌ها را به جای جایگزین کردن با وابستگی‌های موجود، به انتهای فایل اضافه می‌کند.
.TP
.BI \-cc compiler
از این کامپایلر برای ایجاد وابستگی‌ها استفاده می‌کند.
.TP
.BI \-f makefile
نام فایل.
این گزینه امکان تعیین یک makefile جایگزین را فراهم می‌کند تا
.B ccmakedep
خروجی خود را در آن قرار دهد.
مشخص کردن \(lq\-\(rq به عنوان نام فایل (یعنی
.BR \-f\- )
باعث ارسال خروجی به خروجی استاندارد به جای تغییر یک فایل موجود می‌شود.
.TP
.BI \-s string
رشته جداکننده آغازین.
این گزینه به شما امکان می‌دهد رشته متفاوتی را برای جستجوی
.B ccmakedep
در makefile تعیین کنید.
مقدار پیش‌فرض \(lq# DO NOT DELETE\(rq است.
.TP
.B \-v
حالت پرگو: دستور کامپایلر C را قبل از اجرا نمایش می‌دهد.
.TP
.BI \-\^\- " options " \-\^\-
اگر
.B ccmakedep
با دو خط تیره پیاپی (\-\^\-) در فهرست آرگومان‌ها مواجه شود، هر آرگومان ناشناخته پس از آن بدون نمایش پیام نادیده گرفته می‌شود.
دومین جفت خط تیره به این رفتار ویژه پایان می‌دهد.
به این ترتیب، می‌توان کاری کرد که
.B ccmakedep
آرگومان‌های خاص کامپایلر را که ممکن است به‌طور معمول در ماکروی CFLAGS در
.B make
وجود داشته باشند با خیال راحت نادیده بگیرد (به بخش
.B "مثال (EXAMPLE)"
در بالا مراجعه کنید).
گزینه‌های
.BR \-D ،
.BR \-I
و
.B \-U
که بین دو جفت خط تیره قرار می‌گیرند همچنان به‌صورت عادی پردازش می‌شوند.
.SH "همچنین ببینید (SEE ALSO)"
.BR cc (1),
.BR make (1),
.BR makedepend (1),
.BR ccmakedep (1).
.SH "نویسندگان (AUTHORS)"
برنامه
.B ccmakedep
توسط X Consortium نوشته شده است.
.PP
کالین واتسون (Colin Watson) این صفحه راهنما را در اصل برای پروژه دبیان (Debian Project) و تا حدی بر اساس صفحه راهنمای
.BR makedepend (1)
نوشت.