نام (NAME)

ccmakedep - ایجاد وابستگی‌ها در Makefile با استفاده از کامپایلر C

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

ccmakedep [ cpp-flags ] [ -wwidth ] [ -smagic-string ] [ -fmakefile ] [ -oobject-suffix ] [ -v ] [ -a ] [ -cccompiler ] [ -- options -- ] sourcefile ...

توضیحات (DESCRIPTION)

برنامه ccmakedep یک کامپایلر C را برای پیش‌پردازش هر sourcefile فراخوانی می‌کند و از خروجی آن برای ساخت قواعد makefile جهت توصیف وابستگی‌های آن‌ها بهره می‌برد. این قواعد به make(1) اطلاع می‌دهند که هنگام تغییر یک وابستگی، کدام فایل‌های شیء باید مجدداً کامپایل شوند.

به‌طور پیش‌فرض، ccmakedep خروجی خود را در فایلی به نام makefile (در صورت وجود) یا در غیر این صورت در Makefile قرار می‌دهد. یک makefile جایگزین را می‌توان با گزینه -f مشخص کرد. این برنامه ابتدا در makefile به دنبال خطی می‌گردد که با

# DO NOT DELETE

یا رشته‌ای که با گزینه -s تعیین شده آغاز می‌شود تا به عنوان جداکننده خروجی وابستگی‌ها عمل کند. اگر آن را بیابد، تمام محتوای پس از آن را تا انتهای makefile حذف کرده و خروجی را پس از این خط قرار می‌دهد. اگر آن را نیابد، برنامه این رشته را به انتهای makefile اضافه کرده و خروجی را پس از آن درج می‌کند.

مثال (EXAMPLE)

معمولاً ccmakedep در یک هدف makefile استفاده می‌شود تا با اجرای دستور «make depend»، وابستگی‌های makefile به‌روزرسانی شوند. برای نمونه،

SRCS = file1.c file2.c ...
CFLAGS = -O -DHACK -I../foobar -xyz
depend:
        ccmakedep -- $(CFLAGS) -- $(SRCS)

گزینه‌ها (OPTIONS)

این برنامه هر گزینه‌ای را که تشخیص ندهد نادیده می‌گیرد، بنابراین می‌توانید از همان آرگومان‌هایی که برای cc(1) استفاده می‌کنید بهره ببرید؛ از جمله گزینه‌های -D و -U برای تعریف یا لغو تعریف نمادها و -I برای تعیین مسیر فایل‌های سرآیند (include).

-a

وابستگی‌ها را به جای جایگزین کردن با وابستگی‌های موجود، به انتهای فایل اضافه می‌کند.

-cccompiler

از این کامپایلر برای ایجاد وابستگی‌ها استفاده می‌کند.

-fmakefile

نام فایل. این گزینه امکان تعیین یک makefile جایگزین را فراهم می‌کند تا ccmakedep خروجی خود را در آن قرار دهد. مشخص کردن “-” به عنوان نام فایل (یعنی -f-) باعث ارسال خروجی به خروجی استاندارد به جای تغییر یک فایل موجود می‌شود.

-sstring

رشته جداکننده آغازین. این گزینه به شما امکان می‌دهد رشته متفاوتی را برای جستجوی ccmakedep در makefile تعیین کنید. مقدار پیش‌فرض “# DO NOT DELETE” است.

-v

حالت پرگو: دستور کامپایلر C را قبل از اجرا نمایش می‌دهد.

-- options --

اگر ccmakedep با دو خط تیره پیاپی (--) در فهرست آرگومان‌ها مواجه شود، هر آرگومان ناشناخته پس از آن بدون نمایش پیام نادیده گرفته می‌شود. دومین جفت خط تیره به این رفتار ویژه پایان می‌دهد. به این ترتیب، می‌توان کاری کرد که ccmakedep آرگومان‌های خاص کامپایلر را که ممکن است به‌طور معمول در ماکروی CFLAGS در make وجود داشته باشند با خیال راحت نادیده بگیرد (به بخش مثال (EXAMPLE) در بالا مراجعه کنید). گزینه‌های -D، -I و -U که بین دو جفت خط تیره قرار می‌گیرند همچنان به‌صورت عادی پردازش می‌شوند.

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

cc(1), make(1), makedepend(1), ccmakedep(1).

نویسندگان (AUTHORS)

برنامه ccmakedep توسط X Consortium نوشته شده است.

کالین واتسون (Colin Watson) این صفحه راهنما را در اصل برای پروژه دبیان (Debian Project) و تا حدی بر اساس صفحه راهنمای makedepend(1) نوشت.