| GUILE(1) | GNU Guile 2.2 | GUILE(1) |
نام (NAME)
guile - زبان گسترش پروژه گنو
خلاصه دستور (SYNOPSIS)
guile [-L DIRECTORY] [-l FILE] [-e FUNCTION] [\] [-c EXPR] [-s SCRIPT] [--] [SCRIPT [ARGs for SCRIPT]]
تنها کاربردی‌ترین گزینه‌ها در اینجا فهرست شده‌اند؛ برای مشاهده باقی موارد به ادامه متن مراجعه کنید.
توضیحات (DESCRIPTION)
پروژه GNU Guile یک پیاده‌سازی از زبان برنامه‌نویسی Scheme است. این نرم‌افزار استانداردهای زبانی R5RS و R6RS را گسترش داده و قابلیت‌های اضافی لازم برای استفاده‌های کاربردی و واقعی را فراهم می‌کند.
نرم‌افزار Guile برای استفاده تعاملی، اسکریپت‌نویسی پایه، و گسترش برنامه‌های کاربردی بزرگتر، و همچنین برای توسعه برنامه‌های مستقل به زبان Scheme بسیار مناسب است.
خود فایل اجرایی guile یک کامپایلر تعاملی مستقل و یک محیط زمان‌اجرا (runtime) برای برنامه‌های Scheme فراهم می‌کند؛ هم برای استفاده تعاملی و هم برای اجرای اسکریپت‌ها یا برنامه‌های Scheme.
این صفحه راهنما صرفاً راهنمایی کوتاهی درباره نحوه فراخوانی guile از طریق خط فرمان ارائه می‌دهد. لطفاً برای اطلاعات بیشتر به مستندات info نرم‌افزار Guile مراجعه کنید (دستور info "(guile)Invoking Guile" را در خط فرمان وارد کنید).
گزینه‌ها (OPTIONS)
- -L DIRECTORY
- افزودن DIRECTORY به ابتدای مسیر بارگذاری ماژول‌های Guile.
- -l FILE
- بارگذاری کد منبع Scheme از FILE.
- -e FUNCTION
- پس از خواندن SCRIPT، تابع FUNCTION را روی آرگومان‌های خط فرمان اعمال می‌کند. توجه داشته باشید که FUNCTION ارزیابی می‌شود، بنابراین، برای مثال، (@ (my-module) my-proc) در اینجا معتبر است.
- \
- «سوئیچ متا» (meta switch)، برای دور زدن محدودیت‌های اسکریپت‌های #! استفاده می‌شود. برای جزئیات بیشتر به بخش «The Meta Switch» در مستندات texinfo مراجعه کنید.
- --
- پایان دادن به پردازش آرگومان‌ها و آغاز به کار guile در حالت تعاملی (interactive).
- -c EXPR
- پایان دادن به پردازش آرگومان‌ها، و ارزیابی EXPR به عنوان یک عبارت Scheme.
- -s SCRIPT-FILE
- بارگذاری کد منبع Scheme از SCRIPT-FILE و اجرای آن به عنوان یک اسکریپت. توجه داشته باشید که در بسیاری از موارد استفاده از -s ضروری نیست؛ می‌توان guile را به سادگی به صورت زیر فراخوانی کرد: guile SCRIPT-FILE ARG...
- -ds
- اجرای -s SCRIPT در این نقطه از توالی گزینه‌ها. توجه داشته باشید که این آرگومان باید در کنار -s استفاده شود.
- --debug
- راه‌اندازی guile با ماشین مجازی اشکال‌زدایی (debugging VM). به طور پیش‌فرض، اشکال‌زدایی زمانی که guile به صورت تعاملی فراخوانی شود روشن است؛ در غیر این صورت خاموش است.
- --no-debug
- راه‌اندازی guile بدون ماشین مجازی اشکال‌زدایی، حتی اگر guile به صورت تعاملی اجرا شود.
- --auto-compile
- کامپایل خودکار فایل‌های منبع (رفتار پیش‌فرض).
- --no-auto-compile
- غیرفعال‌سازی کامپایل خودکار فایل‌های منبع.
- --listen[=P]
- شنود روی یک پورت یا سوکت برای اتصالات دوردست REPL. برای جزئیات بیشتر به دفترچه راهنما مراجعه کنید.
- --use-srfi=N,M...
- بارگذاری افزونه‌های SRFI شامل N، M و غیره. برای مثال: --use-srfi=8,13.
- -x EXTENSION
- افزودن EXTENSION به فهرست پسوندهای بارگذاری guile.
- -h, --help
- نمایش شرح گزینه‌های خط فرمان و خروج.
- -v, --version
- نمایش نسخه guile و خروج.
- -q
- در حالت تعاملی، از بارگذاری فایل پیکربندی اولیه کاربر، ~/.guile جلوگیری می‌کند.
محیط (ENVIRONMENT)
- GUILE_LOAD_PATH
- اگر $GUILE_LOAD_PATH پیش از راه‌اندازی guile مقداردهی شده باشد، مقدار آن برای گسترش مسیر جستجوی فایل‌های Scheme هنگام بارگذاری استفاده می‌شود. این متغیر باید فهرستی از دایرکتوری‌ها باشد که با دونقطه (:) از هم جدا شده‌اند، و به ابتدای مسیر پیش‌فرض %load-path افزوده خواهد شد.
- GUILE_LOAD_COMPILED_PATH
- اگر $GUILE_LOAD_COMPILED_PATH پیش از راه‌اندازی guile مقداردهی شده باشد، مقدار آن برای گسترش مسیر جستجوی فایل‌های کامپایل‌شده Scheme (فایل‌های .go) هنگام بارگذاری استفاده می‌شود. این متغیر باید فهرستی از دایرکتوری‌ها باشد که با دونقطه (:) از هم جدا شده‌اند، و به ابتدای مسیر پیش‌فرض %load-compiled-path افزوده خواهد شد.
فایل‌ها (FILES)
- ~/.guile
- اسکریپت Guile که پیش از هر پردازش دیگری اجرا می‌شود. برای مثال، قطعه کد .guile زیر، رابط readline نرم‌افزار guile را فعال می‌کند:
همچنین ببینید (SEE ALSO)
مستندات کامل Guile به صورت یک کتابچه راهنمای Texinfo نگهداری می‌شود. اگر برنامه‌های info و guile به درستی روی سیستم شما نصب شده باشند، دستور
- info guile
باید دسترسی به مستندات کامل را فراهم کند.
نشانی http://www.schemers.org مقدمه‌ای کلی برای زبان Scheme ارائه می‌دهد.
گزارش باگ‌ها (BUGS)
یک فهرست پستی، bug-guile@gnu.org، برای گزارش باگ‌ها و اصلاحیه‌های Guile وجود دارد. اما پیش از گزارش یک مورد به عنوان باگ، لطفاً مطمئن شوید که واقعاً یک باگ است، نه یک سوءتفاهم یا یک قابلیت تعمدی. از شما تقاضا می‌شود بخش «Reporting Bugs» را در مستندات مرجع Guile (یا سامانه Info) برای کسب راهنمایی در مورد چگونگی و زمان گزارش باگ‌ها مطالعه کنید. همچنین، شماره نسخه Guile مورد استفاده خود را در هر گزارش باگی که ارسال می‌کنید درج نمایید. باگ‌ها در صورتی که بتوان آن‌ها را تفکیک و جداسازی کرد، شانس بالایی برای رفع شدن دارند، بنابراین به نفع شماست که آن‌ها را به گونه‌ای گزارش کنید که به سادگی قابل بازتولید باشند.
کپی‌رایت و تکثیر (COPYRIGHT)
حق نشر (C) 2010, 2011 بنیاد نرم‌افزارهای آزاد (Free Software Foundation, Inc.)
اجازه تکثیر و توزیع نسخه‌های بدون تغییر این سند داده می‌شود، مشروط بر اینکه اعلان حق نشر و این اعلان مجوز در تمامی نسخه‌ها حفظ شوند.
اجازه تکثیر و توزیع نسخه‌های تغییریافته این سند تحت شرایط تکثیر بدون تغییر داده می‌شود، مشروط بر اینکه تمام اثر اشتقاقی حاصل تحت شرایط اعلانی همسان با این اعلان مجوز توزیع شود.
اجازه تکثیر و توزیع ترجمه‌های این سند به زبانی دیگر، تحت شرایط فوق برای نسخه‌های تغییریافته داده می‌شود، به استثنای اینکه این اعلان مجوز ممکن است در ترجمه‌ای بیان شود که توسط بنیاد نرم‌افزارهای آزاد تأیید شده باشد.
نویسندگان (AUTHORS)
Robert Merkel <rgmerk@mira.net> این صفحه راهنما را نوشت. Rob Browning <rlb@cs.utexas.edu> مواردی را به آن اضافه کرد.
guile یک نرم‌افزار گنو (GNU) است. Guile در ابتدا بر اساس مفسر SCM اثر Aubrey Jaffer ساخته شده است، و حاصل کار افراد بسیاری است.
| 2011-03-04 | GNU |