نام (NAME)

gccmakedep - ایجاد وابستگی‌ها در Makefile با استفاده از GCC

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

gccmakedep [ -sseparator ] [ -fmakefile ] [ -a ] [ -- options -- ] sourcefile ...

توضیحات (DESCRIPTION)

برنامه gccmakedep دستور 'gcc -M' را برای خروجی دادن قواعد makefile فراخوانی می‌کند که وابستگی‌های هر sourcefile را توصیف می‌کنند، تا make(1) بداند هنگام تغییر یک وابستگی، کدام فایل‌های شیء باید مجدداً کامپایل شوند.

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

# DO NOT DELETE

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

مثال‌ها (EXAMPLES)

به‌طور معمول، gccmakedep در یک هدف درون makefile استفاده می‌شود تا با اجرای 'make depend' وابستگی‌های makefile به‌روزرسانی شوند. به عنوان مثال:

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

گزینه‌ها (OPTIONS)

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

-a

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

-fmakefile

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

-sstring

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

-- options --

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

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

gcc(1), make(1), makedepend(1).

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

نسخه gccmakedep موجود در این انتشار بنیاد X.Org در ابتدا توسط پروژه XFree86 بر اساس کدهای ارائه‌شده توسط Hongjiu Lu نوشته شده است.

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