autogen - آنلاین در ابر

برنامه:

نام

اتوژن - تولید کننده برنامه خودکار

خلاصه

اتوژن [پرچم ها] [-پرچم [ارزش]] [--option-name[[=| ]ارزش]] [ ]

AutoGen فایل های متنی را از قالب ها با استفاده از تعاریف خارجی ایجاد می کند.

شرح

AutoGen برای تولید فایل های برنامه حاوی متن های تکراری با متغیر طراحی شده است
تعویض ها هدف این است که نگهداری از برنامه هایی که حاوی حجم بالایی هستند، ساده شود
مقدار متن تکراری این به ویژه اگر چندین بلوک از آن وجود داشته باشد ارزشمند است
چنین متنی که باید همگام نگه داشته شود.

یک مثال رایج مشکل حفظ کد مورد نیاز برای پردازش برنامه است
گزینه ها. گزینه های پردازش به حداقل چهار ساختار مختلف نیاز دارد که در آن نگهداری شوند
نظم مناسب در مکان های مختلف برنامه شما. شما حداقل نیاز دارید: شخصیت پرچم
در رشته پرچم، کدی را برای پردازش پرچم در هنگام مواجه شدن با آن، یک حالت جهانی، کد کنید
متغیر یا دو، و یک خط در متن استفاده. شما به چیزهای بیشتری در کنار این نیاز خواهید داشت
شما انتخاب می کنید که نام گزینه های طولانی، پردازش فایل پیکربندی، محیط را پیاده سازی کنید
متغیرها و غیره

همه اینها را می توان به صورت مکانیکی انجام داد. با قالب های مناسب و این برنامه.

OPTIONS

La پیروی گزینه های را انتخاب کنید تعاریف، قالب و طرح توابع به استفاده کنید
-L دیر, --templ-dirs=دیر
جستجو برای الگوها در DIR. این گزینه ممکن است به تعداد نامحدود بارها ظاهر شود.

یک دایرکتوری به لیست دایرکتوری ها اضافه کنید اتوژن جستجو در هنگام باز کردن a
الگو، چه به عنوان الگوی اصلی یا یک الگوی همراه. آخرین ورودی دارد
بالاترین اولویت در لیست جستجو یعنی در آنها جستجو می شود
به صورت برعکس.

-T فایل tpl, -- override-tpl=فایل tpl
استفاده کنید TPL-FILE برای قالب این گزینه ممکن است با محیط از پیش تنظیم نشده باشد
متغیرها یا در فایل های اولیه (rc).

فایل های تعریف، الگوی استانداردی را مشخص می کنند که قرار است گسترش یابد. این گزینه
آن نام را لغو می کند و یک الگوی دیگر را گسترش می دهد.

-l فایل tpl, --lib-template=فایل tpl
بارگیری ماکروهای AutoGen از TPL-FILE. این گزینه ممکن است تعداد نامحدودی ظاهر شود
بار.

ماکروهای DEFINE از این فایل الگو برای استفاده در پردازش اصلی ذخیره می شوند
فایل ماکرو متن الگو به غیر از ماکروهای DEFINE نادیده گرفته می شود.

از این استفاده نکنید. در عوض، از ماکرو INCLUDE در قالب خود استفاده کنید.

توجه: این گزینه IS منسوخ

-- تعاریف=پرونده, Fl -بدون تعریف
تعاریف را بخوانید فایل. بدون تعاریف فرم گزینه را غیرفعال می کند. این
گزینه به طور پیش فرض فعال است. این گزینه ممکن است با محیط از پیش تنظیم نشده باشد
متغیرها یا در فایل های اولیه (rc).

از این آرگومان برای تعیین فایل تعاریف ورودی با گزینه خط فرمان استفاده کنید.
اگر این گزینه را مشخص نکنید، پس باید یک آرگومان خط فرمان وجود داشته باشد که
فایل را مشخص می کند، حتی اگر فقط stdin را با خط فاصله (-). مشخص كردن،
-- بدون تعاریف هنگامی که می خواهید یک الگو را بدون هیچ AutoGen فعال پردازش کنید
تعاریف

--پوسته=صدف
نام یا نام مسیر پوسته مورد استفاده.

به‌طور پیش‌فرض، وقتی AutoGen ساخته می‌شود، پیکربندی برای یک معقول بررسی می‌شود
پوسته Bourne مانند برای استفاده برای پردازش اسکریپت پوسته. اگر یک قالب خاص
به یک پوسته جایگزین نیاز دارد، باید با این گزینه در دستور مشخص شود
خط، با متغیر محیطی (پوسته) یا در پیکربندی/آغاز اولیه
فایل.

-m, --no-fmemopen
از جریان های درون مم استفاده نکنید.

اگر کتابخانه محلی C از "فوپنکوکی(3GNU)"، یا "funopen(3BSD)" سپس
AutoGen ترجیح می دهد به جای فایل های ناشناس از بافر جریان در حافظه استفاده کند.
این ممکن است در صورت کمبود حافظه مجازی منجر به مشکلاتی شود. اگر، برای یک
برنامه خاصی، حافظه شما تمام می شود، سپس این گزینه را مشخص کنید. این هست
در یک محیط حافظه مجازی 64 بیتی مدرن بعید است.

در پلتفرم های بدون این توابع، این گزینه پذیرفته می شود اما نادیده گرفته می شود.
fmemopen (POSIX) کافی نیست زیرا بافر رشته آن قابل تخصیص مجدد نیست.
open_memstream (POSIX) is همچنین کافی نیست زیرا جریان فقط برای باز است
خروجی AutoGen به یک بافر قابل تخصیص مجدد نیاز دارد که هم برای خواندن و هم برای خواندن در دسترس باشد
نوشته.

-- برابر کردن=char-list
کاراکترها معادل در نظر گرفته می شوند. پیشفرض char-list برای این گزینه است:
_-^

این گزینه لیستی از کاراکترهای معادل در نظر گرفته شده را تغییر می دهد. پیشفرض
سه کاراکتر "_-^" هستند. (آخری در Tandem/HP-NonStop معمولی است،
و من قبلاً کارهای زیادی روی Tandems انجام می دادم.)

La پیروی گزینه های تغییر چگونه تولید is به کار گرفته
-b نام, ---نام=نام
مشخص کردن نام به عنوان نام پایه خروجی ممکن است این گزینه از پیش تنظیم نشده باشد
متغیرهای محیطی یا در فایل های اولیه (rc).

یک الگو ممکن است نام دقیق فایل خروجی را مشخص کند. به طور معمول، اینطور نیست.
در عوض، نام از نام پایه فایل تعاریف با تشکیل شده است
پسوندها اضافه شد این گزینه نام پایه مشتق شده از را لغو می کند
تعریف نام فایل در صورتی که فایل تعاریف وجود نداشته باشد این مورد ضروری است
توصیه می شود اگر تعاریف از stdin خوانده شوند. اگر تعاریف موجود باشد
خواندن از استاندارد در، نام پایه به طور پیش فرض به stdin. هر دایرکتوری پیشرو
اجزای نام به صورت بی صدا حذف خواهند شد. اگر می خواهید فایل خروجی به
در یک دایرکتوری خاص ظاهر می شود، توصیه می شود که در آن "cd" کنید
ابتدا دایرکتوری، یا از نام دایرکتوری ها در مشخصات قالب برای خروجی استفاده کنید
لیست های پسوندی، نگاه کنید به: شبه ماکرو.

---منبع-زمان, - Fl -بدون منبع-زمان
زمان‌های مد را روی آخرین منبع تنظیم کنید. را بدون منبع-زمان فرم گزینه را غیرفعال می کند.

اگر روی فایل های خروجی خود مهر بزنید شناسه خروجی ماکرو، سپس فایل های خروجی شما
همیشه متفاوت خواهد بود، حتی اگر محتوا واقعاً تغییر نکرده باشد. اگر استفاده می کنید
این گزینه، سپس زمان اصلاح فایل های خروجی تنها در صورتی تغییر می کند که
فایل های ورودی تغییر می کند این به کاهش ساخت های غیر ضروری کمک می کند.

--قابل نوشتن, - Fl -غیرقابل نوشتن
اجازه دهید فایل های خروجی قابل نوشتن باشند. در غیرقابل نوشتن فرم گزینه را غیرفعال می کند.

این گزینه فایل های خروجی را قابل نوشتن می کند. به طور معمول، فایل های خروجی خوانده می شوند
تنها.

La پیروی گزینه های هستند غالبا مفید در حین اشکال زدایی جدید قالب
آنها محدودیت هایی را مشخص می کنند که از طولانی شدن بیش از حد الگو یا تولید بیشتر جلوگیری می کند
خروجی از حد انتظار

--loop-limit=لیمو
محدودیت در حلقه های افزایشی این گزینه یک عدد صحیح را به عنوان آرگومان خود می گیرد.
ارزش لیمو مقید به بودن است:
دقیقاً -1 یا
در محدوده 1 تا 0x1000000
به طور پیش فرض لیمو برای این گزینه است:
256

این گزینه از حلقه های فرار جلوگیری می کند. به عنوان مثال، اگر به طور تصادفی مشخص کنید، "FOR
x (for-from 1) (for-to -1) (for-by 1)"، زمان زیادی طول می کشد تا تمام شود.
اگر بیش از 256 ورودی در جداول دارید، باید یک محدودیت جدید با آن مشخص کنید
این گزینه

-t ثانیه, --تایم اوت=ثانیه
محدود کردن عملیات پوسته سرور به ثانیه ها. این گزینه یک عدد صحیح را به عنوان می گیرد
استدلال آن ارزش ثانیه مقید به بودن است:
در محدوده 0 تا 3600

AutoGen با فرآیند سرور پوسته کار می کند. اکثر دستورات معمولی تکمیل می شوند
کمتر از 10 ثانیه با این حال، اگر دستورات شما به زمان بیشتری از این نیاز دارند، استفاده کنید
این گزینه

محدوده معتبر 0 تا 3600 ثانیه (1 ساعت) است. Zero زمان سرور را غیرفعال می کند
حد.

--پی گیری=سطح
سطح ردیابی جزئیات این گزینه یک کلمه کلیدی را به عنوان آرگومان خود در نظر می گیرد. را
آرگومان یک مقدار شمارش را تنظیم می کند که می توان آن ها را با مقایسه آن ها با آن آزمایش کرد
ماکرو مقدار گزینه کلمات کلیدی موجود عبارتند از:
هیچ چیز اشکال زدایی پیام سرور پوسته
قالب عبارات بلوک ماکرو
همه چیز
یا معادل عددی آنها

به طور پیش فرض سطح برای این گزینه است:
هیچ چی

این گزینه باعث می شود AutoGen ردی از پردازش قالب خود را نمایش دهد.
شش سطح وجود دارد که هر سطح شامل پیام های سطوح قبلی است:

هیچ چی اصلا ردیابی نمی کند (پیش فرض)

پیام اشکال زدایی پیام ها را از ماکرو AutoGen "DEBUG" چاپ کنید (نگاه کنید به: DEBUG).

سرور-پوسته تمام ورودی ها و خروجی ها را به پوسته سرور ردیابی می کند. این شامل الف
اسکریپت مقداردهی اولیه پوسته "مستقل" حدود 30 خط طول دارد. خروجی آن است
دور انداخته شده و در هیچ قالبی درج نشده است.

قالب ردیابی فراخوانی از تعريف كردنd ماکروها و عبارتند ازs

بلوک ماکروها همه ماکروهای بلوک را ردیابی می کند. موارد فوق، به علاوه IF, برای, CASE و در حالی که.

اصطلاحات نتایج ارزیابی بیان را نمایش می دهد.

همه چیز فراخوانی هر ماکرو AutoGen را حتی یکسان نشان می دهد TEXT ماکروها (یعنی
متن خارج از نقل قول های کلان). به علاوه، اگر «expr.ini» را دوباره بسازید
فایل با اشکال زدایی فعال است، سپس همه فراخوانی ها به توابع طرح تعریف شده AutoGen
همچنین ثبت خواهد شد:
سی دی ${top_builddir}/agen5
DEBUG_ENABLED=باش واقعی bootstrap.dir expr.ini
ساختن CFLAGS='-g -DDEBUG_ENABLED=1'

توجه داشته باشید که نمی توانید این منبع را به این شکل بدون داشتن قبلی بازسازی کنید
را نصب کرد اتوژن قابل اجرا در مسیر جستجوی شما به همین دلیل، "expr.ini"
در فهرست منبع توزیع شده است و نه در وابستگی ها.

-- ردیابی=پرونده
فایل یا فیلتر خروجی ردیابی

خروجی مشخص شده ممکن است نام فایل، فایلی باشد که به آن ضمیمه شده است، یا اگر
آرگومان گزینه با عبارت شروع می شود لوله اپراتور (|) فرمانی را دریافت خواهد کرد
ردیابی خروجی به صورت استاندارد در. به عنوان مثال، --traceout='| کمتر" ردیابی را اجرا خواهد کرد
خروجی از طریق کمتر برنامه الحاق به یک فایل با قبل از علامت مشخص می شود
نام فایل با دو کاراکتر بزرگتر از (>>).

--نمایش دف
درخت تعریف را نشان دهید. این گزینه ممکن است با متغیرهای محیطی از پیش تنظیم نشده باشد
یا در فایل های مقداردهی اولیه (rc).

با این کار درخت تعریف کامل قبل از پردازش الگو چاپ می شود.

--استفاده-تعریف می کند
تعاریف استفاده شده را نشان دهید. این گزینه ممکن است با محیط از پیش تنظیم نشده باشد
متغیرها یا در فایل های اولیه (rc).

با این کار نام مقادیر تعریف جستجو شده در طول دوره چاپ می شود
پردازش الگو، چه واقعاً پیدا شود یا نه. ممکن است دیگری وجود داشته باشد
تعاریف ارجاع شده در یک الگو در بخش هایی از الگو ارزیابی نشده است.
برخی از نام‌های فهرست‌شده ممکن است نام‌های محاسبه‌شده و برخی دیگر آرگومان‌های ماکرو AutoGen باشند.
این وسیله ای برای تهیه فهرستی قطعی و فراگیر از همه و
فقط مقادیر استفاده شده از یک فایل تعریف. این به عنوان کمکی در نظر گرفته شده است
فقط مستندات الگو

-C, --هسته
در خروجی خرابی، یک تخلیه هسته ای باقی بگذارید.

بسیاری از سیستم‌ها به طور پیش‌فرض دارای محدودیت هسته صفر هستند. اگر سیستم دارای
هدر sys/resource.h و اگر این گزینه ارائه شده باشد، در حالت شکست خارج شوید
در مسیر، اتوژن تلاش خواهد کرد تا حد هسته نرم را به هر هسته سخت تنظیم کند
حد است. اگر این کار نمی کند، پس یک مدیر باید هسته سخت را بالا ببرد
محدودیت اندازه در فایل های تعاریف و فایل های قالب" مشخص می کنند که کدام
خروجی ها و بخش هایی از خروجی ها برای تولید.

-s پسوند, - پسوند پرش=پسوند
فایل را با این رد کنید پسوند. این گزینه ممکن است تعداد نامحدودی ظاهر شود
بار. این گزینه ممکن است با متغیرهای محیطی یا در از پیش تنظیم نشده باشد
فایل های اولیه (rc) این گزینه نباید در ترکیب با هیچ یک از آنها ظاهر شود
گزینه های زیر: select-fiffix.

گاهی اوقات، ممکن است تولید همه فایل های خروجی مشخص شده مطلوب نباشد
در قالب (مثلاً فقط .h فایل هدر، اما نه .c برنامه
text.) برای این کار مشخص کنید --skip-fiffix=c در خط فرمان

-o پسوند, --انتخاب-پسوند=پسوند
این پسوند خروجی را مشخص کنید. این گزینه ممکن است به تعداد نامحدود بارها ظاهر شود.
این گزینه ممکن است با متغیرهای محیطی یا در مقداردهی اولیه (rc) از پیش تنظیم نشده باشد.
فایل های.

اگر می خواهید مشخصات پسوند در قالب را لغو کنید، می توانید از یکی استفاده کنید
یا نسخه های بیشتری از این گزینه. مشخصات پسوند را در @ref{pseudo ببینید
بخش macro} سند اطلاعات.

-D ارزش, --تعريف كردن=ارزش
نام برای افزودن به لیست تعریف این گزینه ممکن است تعداد نامحدودی ظاهر شود
بار.

نام‌های تعریف AutoGen برای اهداف زیر استفاده می‌شوند:

بخش هایی از تعاریف AutoGen ممکن است با استفاده از C-style فعال یا غیرفعال شوند
دستورات #ifdef و #ifndef.

هنگام تعریف یک مقدار برای یک نام، می توانید شاخص را برای یک مقدار خاص مشخص کنید.
این شاخص ممکن است یک مقدار تحت اللفظی، یک گزینه تعریف یا مقدار #define-d در آن باشد
خود تعاریف

نام یک فایل ممکن است با پیشوند باشد $NAME/. $NAME بخشی از رشته نام
با مقدار define-d برای جایگزین خواهد شد نام.

هنگامی که AutoGen بارگیری تعاریف را به پایان رساند، مقادیر تعریف شده صادر می شوند
به محیط زیست با، putenv(3). سپس این مقادیر را می توان در اسکریپت های پوسته استفاده کرد
با ${NAME@} مراجع و در قالب ها با (getenv "نام").

هنگام پردازش یک الگو، ممکن است یک شاخص برای بازیابی یک مقدار خاص مشخص کنید.
آن شاخص همچنین ممکن است یک مقدار تعریف شده باشد.

قرار دادن این نام در محیط صادراتی کاملاً معادل است.
در داخل، این همان کاری است که AutoGen در واقع با این گزینه انجام می دهد.

-U نام پت, -- تعریف نکردن=نام پت
الگوی حذف لیست تعریف این گزینه ممکن است تعداد نامحدودی ظاهر شود
بار. این گزینه ممکن است با متغیرهای محیطی یا در از پیش تنظیم نشده باشد
فایل های اولیه (rc)

مشابه «C»، AutoGen استفاده می‌کند #ifdef/#ifndef دستورالعمل های پیش پردازش این گزینه
باعث می شود نام های منطبق از لیست مقادیر تعریف شده حذف شوند.

این انتخاب is استفاده به خودکار بودن وابستگی پیگردی
-M نوع, --make-dep [نوع]
فایل وابستگی را منتشر کنید. این گزینه ممکن است به تعداد نامحدود بارها ظاهر شود.
این گزینه ممکن است با متغیرهای محیطی یا در مقداردهی اولیه (rc) از پیش تنظیم نشده باشد.
فایل های.

این گزینه نسبتاً نزدیک به روش عمل می کند -M مجموعه ای از گزینه ها کار می کنند
کامپایلر gcc، با این تفاوت که به جای انتشار نسخه قبلی
وابستگی ها، این وابستگی های جانشین (فایل های هدف خروجی) را نیز منتشر می کند. توسط
به طور پیش فرض، اطلاعات وابستگی خروجی در آن قرار می گیرد .d، اما ممکن است
نیز با مشخص شود -MF. مهر زمانی روی این فایل دستکاری می شود
به طوری که یک ثانیه قدیمی تر از قدیمی ترین فایل خروجی اولیه خواهد بود.

هدف در این فایل وابستگی معمولاً نام فایل وابستگی خواهد بود، اما
همچنین ممکن است با -MT. AutoGen محتویات را تغییر نمی دهد
آن فایل، اما ممکن است آن را ایجاد کند و زمان اصلاح را برای مطابقت تنظیم می کند
زمان شروع

NB: این حروف دوم بخشی از آرگومان گزینه هستند، بنابراین -MF باید
کاراکتر فاصله نقل شده یا حذف شده و -M "F " قابل قبول است زیرا
F بخشی از آرگومان گزینه است.

-M ممکن است با هر یک از حروف M، F، P، T، Q، D یا G به دنبال آن باشد.
Q، T و P معنی دار هستند. همه به جز F معانی متفاوتی دارند. -MT
به معنا تعبیر می شود یک فایل نگهبان است که به همه ورودی ها بستگی دارد
(الگوها و فایل های تعریف) و تمام فایل های خروجی به این بستگی دارد
فایل نگهبان برای استفاده به عنوان هدف ساخت واقعی مناسب است. Q درمان می شود
به طور یکسان به T، به جز کاراکتر دلار ('$') دو برابر شده است. P باعث خاص می شود
قانون ساختگی تمیز (کلببر) که باید در قطعه فایل make درج شود. یک خالی
قانون همیشه برای ساخت لیست اهداف ایجاد می شود.

این استفاده توصیه شده است:
-MFwhatever-you-like.dep -MTyour-sentinel-file -MP
و سپس در شما makefile، ساخت اتوژن قانون:
-شامل هر چیزی که دوست دارید.dep
clean_targets += clean-your-sentinel-file
.sp
your-sentinel-file:
autogen -MT$@@ -MF$*.d .....
.sp
تمیز محلی:
rm -f $(clean_targets)

زمان اصلاح روی فایل وابستگی یک ثانیه قبل تنظیم شده است
اولین مهر زمانی از هر فایل خروجی دیگری. در نتیجه برای
به عنوان فایل نگهبان استفاده کنید که گواهی بر این واقعیت است که برنامه با موفقیت اجرا شده است.
(-عبارتند از راه گنو برای تعیین "در صورت وجود آن شامل شود". ساخت شما
باید از آن ویژگی پشتیبانی کند یا فرآیند بوت استرپ شما باید فایل را ایجاد کند.)

همه اینها همچنین ممکن است با استفاده از DEPENDENCIES_OUTPUT or AUTOGEN_MAKE_DEP
متغیرهای محیطی. در صورت تعریف، اطلاعات وابستگی خروجی خواهد شد. اگر
با متن آزاد فضای سفید که چیزی غیر از درست, غلط, بله,
نه, 0 or 1، سپس رشته به عنوان یک نام فایل خروجی در نظر گرفته می شود. اگر حاوی الف باشد
رشته ای از کاراکترهای فضای سفید، نشانه اول مانند بالا و نشانه دوم است
به عنوان فایل هدف (سنتینل) در نظر گرفته می شود -MT در پاراگراف های بالا
DEPENDENCIES_OUTPUT در صورت وجود چندین توالی از فضای سفید نادیده گرفته می شود
کاراکترها یا اگر محتوای آن، به طور خاص، غلط, نه or 0.

کمک، نسخه و انتخاب اداره
-?, --کمک
نمایش اطلاعات استفاده و خروج.

-!, --کمک بیشتر
اطلاعات استفاده گسترده را از طریق پیجر منتقل کنید.

-> [فایل cfg], --save-opts [=فایل cfg]
وضعیت گزینه را ذخیره کنید فایل cfg. پیش فرض است آخرین فایل پیکربندی
ذکر شده در گزینه پیشنهادها بخش، زیر دستور پس از به روز رسانی خارج می شود
فایل کانفیگ

-< فایل cfg, --load-opts=فایل cfg, --بدون بار-انتخاب
بارگذاری گزینه ها از فایل cfg. انتخاب بدون بار فرم بارگیری را غیرفعال می کند
فایل های قبلی config/rc/ini. --بدون بار-انتخاب زودتر رسیدگی می شود، بدون نظم.

-v [{v|c|n - نسخه [{v|c|n}]}]
نسخه خروجی برنامه و خروج. حالت پیش فرض 'v' است، یک نسخه ساده.
حالت "c" اطلاعات حق چاپ را چاپ می کند و "n" حق چاپ کامل را چاپ می کند
اطلاع.

گزینه پیشنهادها

هر گزینه ای که به عنوان علامت گذاری نشده باشد نه قابل پیش تنظیم ممکن است با بارگذاری مقادیر از پیش تنظیم شود
پیکربندی ("RC" یا ".INI") فایل(های) و مقادیر از متغیرهای محیطی به نام:
AUTOGEN_ or AUTOGEN
تنظیمات از پیش تعیین شده محیطی اولویت دارند (دیرتر از پیکربندی پردازش می شوند).
فایل ها. هومرک فایل ها هستند "$ HOME"، و".اگر هر یک از اینها دایرکتوری هستند، پس
پرونده autogenrc در آن دایرکتوری ها جستجو می شود.

محیط زیست

دیدن گزینه پیشنهادها برای متغیرهای محیط پیکربندی

با استفاده از خدمات onworks.net از autogen به صورت آنلاین استفاده کنید