.TH "ZSHOPTIONS" "1" "July 12, 2026" "zsh 5\&.9\&.2"
.SH "نام (NAME)"
zshoptions \- گزینه‌های zsh
.\" Yodl file: Zsh/options.yo
.SH "تعیین گزینه‌ها (SPECIFYING OPTIONS)"
گزینه‌ها اساساً با نامشان شناخته می‌شوند\&.
این نام‌ها به بزرگی و کوچکی حروف حساس نیستند و زیرخط‌ها نادیده گرفته می‌شوند\&.
برای نمونه، `\fBallexport\fP\&' معادل `\fBA__lleXP_ort\fP' است\&.
.PP
مفهوم یک نام گزینه را می‌توان با افزودن پیشوند `\fBno\fP\&' به ابتدای آن معکوس کرد؛ بنابراین `\fBsetopt No_Beep\fP' معادل `\fBunsetopt beep\fP' است\&.
این معکوس‌سازی تنها یک‌بار قابل انجام است، در نتیجه `\fBnonobeep\fP\&' مترادفی برای `\fBbeep\fP\&' \fIنیست\fP\&. به‌همین ترتیب، `\fBtify\fP' مترادفی برای `\fBnonotify\fP\&' (معکوسِ `\fBnotify\fP') نیست\&.
.PP
برخی گزینه‌ها دارای یک یا چند نام تک‌حرفی نیز هستند\&.
دو مجموعه از گزینه‌های تک‌حرفی وجود دارد: یکی به‌طور پیش‌فرض استفاده می‌شود و دیگری برای شبیه‌سازی \fBsh\fP/\fBksh\fP به کار می‌رود (زمانی که گزینهٔ \fBSH_OPTION_LETTERS\fP تنظیم شده باشد)\&.
گزینه‌های تک‌حرفی را می‌توان در خط فرمان شل یا با دستورهای توکار \fBset\fP، \fBsetopt\fP و \fBunsetopt\fP به‌صورت گزینه‌های معمول یونیکس با پیشوند `\fB\-\fP\&' استفاده کرد\&.
.PP
مفهوم گزینه‌های تک‌حرفی را می‌توان با استفاده از `\fB+\fP\&' به‌جای `\fB\-\fP' معکوس کرد\&.
برخی از نام‌های گزینه‌های تک‌حرفی به غیرفعال بودن یک گزینه اشاره دارند که در این صورت، معکوسِ آن نام به فعال بودن آن گزینه اشاره می‌کند\&.
برای نمونه، `\fB+n\fP\&' نام کوتاه `\fBexec\fP' است و `\fB\-n\fP\&' نام کوتاه معکوس آن، یعنی `\fBnoexec\fP' است\&.
.PP
در رشته‌های گزینه‌های تک‌حرفی ارائه‌شده به شل در زمان راه‌اندازی، فاصله‌های خالی انتهایی نادیده گرفته می‌شوند؛ برای نمونه، رشتهٔ `\fB\-f    \fP\&' دقیقاً مانند `\fB\-f\fP\&' در نظر گرفته می‌شود، اما رشتهٔ `\fB\-f i\fP' یک خطا محسوب می‌شود\&.
دلیل این امر آن است که بسیاری از سیستم‌هایی که سازوکار `\fB#!\fP\&' را برای فراخوانی اسکریپت‌ها پیاده‌سازی می‌کنند، فاصله‌های خالی انتهایی را حذف نمی‌کنند\&.
.PP
تنظیم گزینه‌ها در دامنهٔ یک تابع نیز ممکن است\&. توضیحات گزینهٔ \fBLOCAL_OPTIONS\fP در زیر را ببینید\&.
.PP
.SH "شرح گزینه‌ها (DESCRIPTION OF OPTIONS)"
در فهرست زیر، گزینه‌هایی که به‌طور پیش‌فرض در تمام حالت‌های شبیه‌سازی فعال هستند با <D> مشخص شده‌اند؛ گزینه‌هایی که تنها در شبیه‌سازی‌های csh، ksh، sh یا zsh به‌طور پیش‌فرض فعال‌اند، به‌ترتیب با <C>، <K>، <S> و <Z> مشخص شده‌اند\&. هنگام فهرست کردن گزینه‌ها (توسط `\fBsetopt\fP\&'، `\fBunsetopt\fP\&'، `\fBset \-o\fP' یا `\fBset +o\fP')، مواردی که به‌طور پیش‌فرض فعال هستند با پیشوند `\fBno\fP\&' در فهرست ظاهر می‌شوند\&. از این رو (مگر اینکه \fBKSH_OPTION_PRINT\fP تنظیم شده باشد)، `\fBsetopt\fP\&' تمام گزینه‌هایی را نشان می‌دهد که وضعیت آن‌ها نسبت به مقدار پیش‌فرض تغییر یافته است\&.
.PP
.SS "تغییر دایرکتوری‌ها"
.PD 0
.TP
.PD
\fBAUTO_CD\fP (\fB\-J\fP)
اگر دستوری صادر شود که نتوان آن را به‌عنوان یک دستور معمولی اجرا کرد، و آن دستور نام یک دایرکتوری باشد، دستور \fBcd\fP را به مقصد آن دایرکتوری اجرا کن\&.
این گزینه تنها زمانی قابل اعمال است که گزینهٔ \fBSHIN_STDIN\fP تنظیم شده باشد، یعنی زمانی که دستورها از ورودی استاندارد خوانده می‌شوند\&. این گزینه برای استفادهٔ تعاملی طراحی شده است؛ توصیه می‌شود در اسکریپت‌ها برای جلوگیری از ابهام، \fBcd\fP به‌طور صریح استفاده شود\&.
.TP
\fBAUTO_PUSHD\fP (\fB\-N\fP)
باعث می‌شود \fBcd\fP دایرکتوری قبلی را به پشتهٔ دایرکتوری اضافه کند\&.
.TP
\fBCDABLE_VARS\fP (\fB\-T\fP)
اگر آرگومان دستور \fBcd\fP (یا یک \fBcd\fP ضمنی در صورت تنظیم بودن گزینهٔ \fBAUTO_CD\fP) یک دایرکتوری نباشد و با یک اسلش آغاز نشود، تلاش کن تا عبارت را طوری بسط دهی که گویی یک `\fB~\fP\&' در ابتدای آن قرار داشته است (بخش `Filename Expansion' را ببینید)\&.
.TP
\fBCD_SILENT\fP
هرگز پس از \fBcd\fP (خواه صریح باشد یا ضمنی با تنظیم گزینهٔ \fBAUTO_CD\fP) دایرکتوری کاری را چاپ نکن\&. دستور \fBcd\fP به‌طور معمول زمانی دایرکتوری کاری را چاپ می‌کند که آرگومان داده‌شده به آن \fB\-\fP، یک مدخل پشته، یا نام دایرکتوری یافت‌شده در \fBCDPATH\fP باشد\&. توجه داشته باشید که این رفتار با رفتار چاپ پشته در \fBpushd\fP که توسط \fBPUSHD_SILENT\fP کنترل می‌شود، متفاوت است\&. این گزینه بر تأثیرات مرتبط با چاپ در \fBPOSIX_CD\fP اولویت دارد\&.
.TP
\fBCHASE_DOTS\fP
هنگام تغییر به دایرکتوری حاوی بخش مسیر `\fB\&.\&.\fP\&' که در حالت عادی به‌معنای لغو بخش قبلی در مسیر در نظر گرفته می‌شود (به عبارت دیگر، `\fBfoo/\&.\&.\fP\&' از مسیر حذف می‌شود، یا اگر `\fB\&.\&.\fP' بخش نخست مسیر باشد، آخرین بخش از دایرکتوری کاری فعلی حذف می‌شود)، مسیر را به دایرکتوری فیزیکی تبدیل کن\&. این گزینه توسط \fBCHASE_LINKS\fP لغو می‌شود\&.
.RS
.PP
برای نمونه، فرض کنید \fB/foo/bar\fP پیوندی به دایرکتوری \fB/alt/rod\fP باشد\&. بدون فعال بودن این گزینه، `\fBcd /foo/bar/\&.\&.\fP\&' به \fB/foo\fP تغییر می‌یابد؛ با فعال بودن آن، به \fB/alt\fP تغییر می‌یابد\&. همین امر زمانی که دایرکتوری فعلی \fB/foo/bar\fP باشد و `\fBcd \&.\&.\fP\&' استفاده شود نیز صدق می‌کند\&. توجه داشته باشید که تمام پیوندهای نمادین دیگر در مسیر نیز حل خواهند شد\&.
.RE
.TP
\fBCHASE_LINKS\fP (\fB\-w\fP)
هنگام تغییر دایرکتوری، پیوندهای نمادین را به مقادیر واقعی آن‌ها حل کن\&. این گزینه اثر \fBCHASE_DOTS\fP را نیز به‌همراه دارد، یعنی بخش مسیر `\fB\&.\&.\fP\&' به عنوان ارجاع به والد فیزیکی در نظر گرفته می‌شود، حتی اگر بخش مسیر قبلی یک پیوند نمادین باشد\&.
.TP
\fBPOSIX_CD\fP <K> <S>
رفتار دستورهای \fBcd\fP، \fBchdir\fP و \fBpushd\fP را تغییر می‌دهد تا با استاندارد POSIX سازگارتر شوند\&. رفتار در صورت غیرفعال بودن این گزینه در مستندات دستور توکار \fBcd\fP در \fIzshbuiltins\fP(1) شرح داده شده است\&. اگر این گزینه تنظیم شود، شل دایرکتوری‌های زیر دایرکتوری محلی (`\fB\&.\fP\&') را تا پیش از بررسی تمام دایرکتوری‌های موجود در \fBcdpath\fP بررسی نمی‌کند، و دستورهای \fBcd\fP و \fBchdir\fP آرگومان‌هایی به فرم `{\fB+\fP|\fB\-\fP}\fIn\fP\&' را به‌عنوان مدخل‌های پشتهٔ دایرکتوری شناسایی نمی‌کنند\&.
.RS
.PP
همچنین در صورت تنظیم این گزینه، شرایطی که تحت آن شل دایرکتوری جدید را پس از تغییر به آن چاپ می‌کند، تغییر می‌یابد\&. این رفتار دیگر تنها به شل‌های تعاملی محدود نیست (گرچه چاپ پشتهٔ دایرکتوری با \fBpushd\fP همچنان محدود به شل‌های تعاملی است)؛ و هرگونه استفاده از مؤلفه‌ای از \fBCDPATH\fP، شامل `\fB\&.\fP\&' اما به‌جز مؤلفهٔ خالی که در غیر این صورت به‌عنوان `\fB\&.\fP\&' تلقی می‌شود، باعث چاپ شدن دایرکتوری خواهد شد\&.
.RE
.TP
\fBPUSHD_IGNORE_DUPS\fP
نسخه‌های تکراری از یک دایرکتوری یکسان را به پشتهٔ دایرکتوری اضافه نکن\&.
.TP
\fBPUSHD_MINUS\fP
هنگامی که همراه با یک عدد برای مشخص کردن دایرکتوری در پشته استفاده می‌شود، معانی `\fB+\fP\&' و `\fB\-\fP' را با یکدیگر جابه‌جا می‌کند\&.
.TP
\fBPUSHD_SILENT\fP (\fB\-E\fP)
پس از \fBpushd\fP یا \fBpopd\fP، پشتهٔ دایرکتوری را چاپ نکن\&.
.TP
\fBPUSHD_TO_HOME\fP (\fB\-D\fP)
دستور \fBpushd\fP بدون آرگومان را وادار می‌کند تا مانند `\fBpushd $HOME\fP\&' عمل کند\&.
.PP.SS "تکمیل (Completion)"
.PD 0
.TP
.PD
\fBALWAYS_LAST_PROMPT\fP <D>
اگر تنظیم نشده باشد، توابع کلیدی که تکمیل‌ها را فهرست می‌کنند در صورت دریافت یک آرگومان عددی، تلاش می‌کنند به آخرین اعلان (prompt) بازگردند\&. اگر تنظیم شده باشد، این توابع در صورتی که \fIهیچ\fP آرگومان عددی دریافت نکنند، تلاش می‌کنند به آخرین اعلان بازگردند\&.
.TP
\fBALWAYS_TO_END\fP
اگر تکمیلی در حالی که مکان‌نما درون یک کلمه قرار دارد انجام شود و یک تکمیل کامل درج گردد، مکان‌نما به انتهای کلمه منتقل می‌شود\&. به این معنی که اگر یک تطابق منفرد درج شود یا تکمیل منویی انجام گیرد، مکان‌نما به انتهای کلمه منتقل خواهد شد\&.
.TP
\fBAUTO_LIST\fP (\fB\-9\fP) <D>
در زمان تکمیل مبهم، گزینه‌ها را به صورت خودکار فهرست می‌کند\&.
.TP
\fBAUTO_MENU\fP <D>
پس از دومین درخواست متوالی برای تکمیل، مثلاً با فشردن مکرر کلید tab، به طور خودکار از تکمیل منویی استفاده می‌کند\&. این گزینه توسط \fBMENU_COMPLETE\fP لغو می‌شود\&.
.TP
\fBAUTO_NAME_DIRS\fP
هر پارامتری که روی نام مطلق یک دایرکتوری تنظیم شود، بلافاصله به نامی برای آن دایرکتوری تبدیل می‌شود که توسط توالی‌های اعلان `\fB%~\fP\&' و موارد مرتبط استفاده خواهد شد، و زمانی که تکمیل روی کلمه‌ای که با `\fB~\fP\&' شروع می‌شود انجام گیرد، در دسترس خواهد بود\&.
(در غیر این صورت، ابتدا باید از پارامتر در قالب `\fB~\fP\fIparam\fP\&' استفاده شود\&.)
.TP
\fBAUTO_PARAM_KEYS\fP <D>
اگر نام یک پارامتر تکمیل شد و یک نویسهٔ بعدی (معمولاً یک فاصله) به طور خودکار درج گردید، و نویسهٔ بعدی تایپ‌شده یکی از مواردی باشد که باید مستقیماً پس از نام بیایند (مانند `\fB}\fP\&'، `\fB:\fP' و غیره)، نویسهٔ اضافه‌شدهٔ خودکار حذف می‌شود تا نویسهٔ تایپ‌شده بلافاصله پس از نام پارامتر قرار گیرد\&.
تکمیل در یک بسط آکولاد نیز به طور مشابه تحت تأثیر قرار می‌گیرد: نویسهٔ اضافه‌شده یک `\fB,\fP\&' است که اگر بلافاصله `\fB}\fP' تایپ شود، حذف خواهد شد\&.
.TP
\fBAUTO_PARAM_SLASH\fP <D>
اگر پارامتری تکمیل شود که محتوای آن نام یک دایرکتوری است، به جای فاصله یک اسلش در انتها اضافه می‌کند\&.
.TP
\fBAUTO_REMOVE_SLASH\fP <D>
هنگامی که آخرین نویسهٔ حاصل از یک تکمیل یک اسلش باشد و نویسهٔ بعدی تایپ‌شده یک جداکنندهٔ کلمه، یک اسلش، یا نویسه‌ای باشد که به یک دستور پایان می‌دهد (مانند یک نقطه‌ویرگول یا یک امپرسند)، اسلش را حذف می‌کند\&.
.TP
\fBBASH_AUTO_LIST\fP
در زمان یک تکمیل مبهم، هنگامی که تابع تکمیل دو بار پیاپی فراخوانی شود، گزینه‌ها را به صورت خودکار فهرست می‌کند\&. این گزینه نسبت به \fBAUTO_LIST\fP اولویت دارد\&. تنظیمات \fBLIST_AMBIGUOUS\fP رعایت می‌شود\&. اگر \fBAUTO_MENU\fP تنظیم شده باشد، رفتار منویی با سومین فشردن کلید آغاز خواهد شد\&. توجه داشته باشید که این گزینه با \fBMENU_COMPLETE\fP کار نخواهد کرد، چرا که در آن صورت فراخوانی‌های مکرر تکمیل بلافاصله در میان فهرست می‌چرخند\&.
.TP
\fBCOMPLETE_ALIASES\fP
از جایگزینی درونی نام‌های مستعار در خط فرمان پیش از تلاش برای تکمیل جلوگیری می‌کند\&. تأثیر این گزینه آن است که نام مستعار را برای اهداف تکمیل به یک دستور متمایز تبدیل می‌کند\&.
.TP
\fBCOMPLETE_IN_WORD\fP
اگر تنظیم نشده باشد، در صورت شروع تکمیل، مکان‌نما به انتهای کلمه منتقل می‌شود\&. در غیر این صورت، در جای خود باقی می‌ماند و تکمیل از هر دو سر انجام می‌شود\&.
.TP
\fBGLOB_COMPLETE\fP
هنگامی که کلمهٔ فعلی دارای یک الگوی glob است، تمام کلمات حاصل از بسط را درج نکن، بلکه مانند تکمیل تطابق‌ها را تولید کن و مانند \fBMENU_COMPLETE\fP در میان آن‌ها بچرخ\&. تطابق‌ها به گونه‌ای تولید می‌شوند که گویی یک `\fB*\fP\&' به انتهای کلمه اضافه شده، یا در صورت تنظیم \fBCOMPLETE_IN_WORD\fP در محل مکان‌نما درج شده است\&. این در واقع از تطبیق الگو استفاده می‌کند، نه globbing، بنابراین نه تنها برای فایل‌ها بلکه برای هر تکمیلی مانند گزینه‌ها، نام‌های کاربری و غیره کار می‌کند\&.
.RS
.PP
توجه داشته باشید که هنگام استفاده از تطبیق‌دهندهٔ الگو، کنترل تطبیق (به عنوان مثال، تطبیق حساس نبودن به حروف کوچک و بزرگ یا تطبیق مهارشده) قابل استفاده نیست\&. این محدودیت تنها زمانی اعمال می‌شود که کلمهٔ فعلی حاوی یک الگو باشد؛ صرفاً فعال کردن گزینهٔ \fBGLOB_COMPLETE\fP این اثر را ندارد\&.
.RE
.TP
\fBHASH_LIST_ALL\fP <D>
هر زمان که یک تکمیل دستور یا تصحیح املا انجام شود، مطمئن می‌شود که ابتدا کل مسیر دستور هش شده است\&. این کار اولین تکمیل را کندتر می‌کند، اما از گزارش‌های نادرست خطاهای املایی جلوگیری می‌کند\&.
.TP
\fBLIST_AMBIGUOUS\fP <D>
این گزینه زمانی کار می‌کند که \fBAUTO_LIST\fP یا \fBBASH_AUTO_LIST\fP نیز تنظیم شده باشند\&. اگر پیشوند غیرمبهمی برای درج در خط فرمان وجود داشته باشد، این کار بدون نمایش فهرست تکمیل انجام می‌شود؛ به عبارت دیگر، رفتار فهرست‌بندی خودکار تنها زمانی اتفاق می‌افتد که هیچ چیزی درج نشود\&. در مورد \fBBASH_AUTO_LIST\fP، این بدان معنی است که نمایش فهرست تا سومین فراخوانی تابع به تعویق می‌افتد\&.
.TP
\fBLIST_BEEP\fP <D>
در زمان یک تکمیل مبهم بوق می‌زند\&. به طور دقیق‌تر، این گزینه ویجت‌های تکمیل را وادار می‌کند که در یک تکمیل مبهم وضعیت ۱ را برگردانند، که در صورت تنظیم بودن گزینهٔ \fBBEEP\fP، باعث بوق زدن پوسته می‌شود؛ اگر تکمیل از یک ویجت تعریف‌شده توسط کاربر فراخوانی شود، این رفتار ممکن است تغییر کند\&.
.TP
\fBLIST_PACKED\fP
با چاپ تطابق‌ها در ستون‌هایی با پهنای متفاوت، تلاش می‌کند فهرست تکمیل را کوچک‌تر (اشغال سطرهای کمتر) کند\&.
.TP
\fBLIST_ROWS_FIRST\fP
تطابق‌ها را در فهرست‌های تکمیل به صورت مرتب‌شدهٔ افقی می‌چیند، یعنی تطابق دوم در سمت راست تطابق اول قرار می‌گیرد، نه مانند حالت معمول در زیر آن\&.
.TP
\fBLIST_TYPES\fP (\fB\-X\fP) <D>
هنگام فهرست کردن فایل‌هایی که تکمیل‌های احتمالی هستند، نوع هر فایل را با یک علامت شناسایی در انتها نشان می‌دهد\&.
.TP
\fBMENU_COMPLETE\fP (\fB\-Y\fP)
در زمان یک تکمیل مبهم، به جای فهرست کردن احتمالات یا بوق زدن، بلافاصله اولین تطابق را درج می‌کند\&. سپس هنگامی که تکمیل دوباره درخواست شد، اولین تطابق را حذف کرده و تطابق دوم را درج می‌کند، و غیره\&. وقتی تطابق دیگری وجود نداشته باشد، دوباره به اولی بازمی‌گردد\&. از \fBreverse\-menu\-complete\fP می‌توان برای چرخش در فهرست در جهت معکوس استفاده کرد\&. این گزینه بر \fBAUTO_MENU\fP برتری دارد\&.
.TP
\fBREC_EXACT\fP (\fB\-S\fP)
اگر رشتهٔ موجود در خط فرمان دقیقاً با یکی از تکمیل‌های احتمالی مطابقت داشته باشد، پذیرفته می‌شود، حتی اگر تکمیل دیگری وجود داشته باشد (یعنی همان رشته به همراه چیز دیگری که اضافه شده است) که آن هم تطابق داشته باشد\&.
.PP.SS "بسط و تطبیق الگو (Expansion and Globbing)"
.PD 0
.TP
.PD
\fBBAD_PATTERN\fP (\fB+2\fP) <C> <Z>
اگر الگویی برای تولید نام فایل بدساخت باشد، یک پیام خطا چاپ می‌شود\&.
(اگر این گزینه غیرفعال باشد، الگو بدون تغییر باقی خواهد ماند\&.)
.TP
\fBBARE_GLOB_QUAL\fP <Z>
در یک الگوی glob، در صورتی که یک جفت پرانتز انتهایی شامل نویسه‌های `\fB|\fP\&'، `\fB(\fP' یا (در صورت خاص بودن) `\fB~\fP' نباشد، با آن به عنوان فهرست توصیف‌کننده (qualifier list) رفتار می‌شود\&. بخش `Filename Generation\&' را ببینید\&.
.TP
\fBBRACE_CCL\fP
عبارت‌های درون آکولاد را که در حالت عادی تحت بسط آکولاد قرار نمی‌گیرند، به فهرستی از تمام نویسه‌ها با ترتیب واژگانی بسط می‌دهد\&. بخش `Brace Expansion\&' را ببینید\&.
.TP
\fBCASE_GLOB\fP <D>
تطبیق الگو (تولید نام فایل) را به بزرگی و کوچکی حروف حساس می‌کند\&. توجه داشته باشید که سایر استفاده‌ها از الگوها همواره به بزرگی و کوچکی حروف حساس هستند\&. اگر این گزینه غیرفعال باشد، وجود هر نویسه‌ای که برای تولید نام فایل خاص است، باعث تطبیق غیرحساس به بزرگی و کوچکی حروف خواهد شد\&. برای مثال، \fBcvs(/)\fP به دلیل وجود پرچم تطبیق الگو می‌تواند با دایرکتوری \fBCVS\fP مطابقت یابد (مگر اینکه گزینهٔ \fBBARE_GLOB_QUAL\fP غیرفعال باشد)\&.
.TP
\fBCASE_MATCH\fP <D>
عبارت‌های باقاعده را که از پودمان \fBzsh/regex\fP استفاده می‌کنند (شامل تطبیق‌ها با \fB=~\fP) به بزرگی و کوچکی حروف حساس می‌کند\&.
.TP
\fBCASE_PATHS\fP
اگر \fBCASE_PATHS\fP تنظیم نشده باشد (پیش‌فرض)، هرگاه یک نویسهٔ خاص در \fIهر\fP بخشی از مسیر ظاهر شود، \fBCASE_GLOB\fP بر تفسیر \fIتمام\fP بخش‌های مسیر اثر می‌گذارد\&. هنگامی که \fBCASE_PATHS\fP تنظیم شود، بخش‌هایی از مسیر فایل که شامل نویسه‌های خاص تولید نام فایل \fIنیستند\fP، همواره به بزرگی و کوچکی حروف حساس خواهند بود؛ بدین ترتیب \fBNO_CASE_GLOB\fP تنها به بخش‌هایی که حاوی نویسه‌های تطبیق الگو هستند محدود می‌شود\&.
.RS
.PP
توجه داشته باشید که اگر خود سیستم‌فایل به بزرگی و کوچکی حروف حساس نباشد، آنگاه \fBCASE_PATHS\fP هیچ اثری نخواهد داشت\&.
.RE
.TP
\fBCSH_NULL_GLOB\fP <C>
اگر الگویی برای تولید نام فایل هیچ تطابقی نداشته باشد، الگو را از فهرست آرگومان‌ها حذف می‌کند؛ خطایی گزارش نمی‌شود مگر اینکه تمام الگوهای درون یک دستور هیچ تطابقی نداشته باشند\&. این گزینه بر \fBNOMATCH\fP اولویت دارد\&.
.TP
\fBEQUALS\fP <Z>
بسط نام فایل با \fB=\fP را انجام می‌دهد\&.
(بخش `Filename Expansion\&' را ببینید\&.)
.TP
\fBEXTENDED_GLOB\fP
با نویسه‌های `\fB#\fP\&'، `\fB~\fP' و `\fB^\fP' به عنوان بخشی از الگوها برای تولید نام فایل و غیره رفتار می‌کند\&. (یک `\fB~\fP\&' ابتدایی بدون نقل‌قول همواره بسط دایرکتوری نام‌گذاری‌شده را تولید می‌کند\&.)
.TP
\fBFORCE_FLOAT\fP
با ثابت‌ها در ارزیابی محاسباتی، حتی بدون استفاده از ممیز اعشاری، به عنوان ممیز شناور (floating point) رفتار خواهد شد؛ مقادیر متغیرهای عدد صحیح هنگام استفاده در عبارات محاسباتی به ممیز شناور تبدیل خواهند شد\&. اعداد صحیح در هر مبنایی تبدیل می‌شوند\&.
.TP
\fBGLOB\fP (\fB+F\fP, ksh: \fB+f\fP) <D>
تولید نام فایل (globbing) را انجام می‌دهد\&.
(بخش `Filename Generation\&' را ببینید\&.)
.TP
\fBGLOB_ASSIGN\fP <C>
اگر این گزینه تنظیم شود، تولید نام فایل (globbing) در سمت راست انتساب‌های پارامتر اسکالر به شکل `\fIname\fP\fB=\fP\fIpattern\fP (مانند `\fBfoo=*\fP\&') انجام می‌شود\&. اگر نتیجه بیش از یک کلمه داشته باشد، پارامتر به آرایه‌ای با آن کلمات به عنوان آرگومان تبدیل خواهد شد\&. این گزینه صرفاً برای سازگاری با گذشته ارائه شده است: تطبیق الگو همیشه در سمت راست انتساب‌های آرایه‌ای به شکل `\fIname\fP\fB=(\fP\fIvalue\fP\fB)\fP\&' (مانند `\fBfoo=(*)\fP\&') انجام می‌شود و این ساختار به دلیل وضوح بیشتر توصیه می‌گردد؛ با فعال بودن این گزینه، پیش‌بینی اینکه نتیجه یک آرایه خواهد بود یا یک اسکالر امکان‌پذیر نیست\&.
.TP
\fBGLOB_DOTS\fP (\fB\-4\fP)
نیازی نیست که یک `\fB\&.\fP\&' در ابتدای نام فایل به‌صورت صریح تطبیق داده شود\&.
.TP
\fBGLOB_STAR_SHORT\fP
هنگامی که این گزینه تنظیم شده باشد و تطبیق الگوی پیش‌فرض به سبک zsh در حال اجرا باشد، الگوی `\fB**/*\fP\&' می‌تواند به `\fB**\fP' و الگوی `\fB***/*\fP\&' می‌تواند به \fB***\fP خلاصه شود\&. از این رو `\fB**\&.c\fP' فایلی را که به \fB\&.c\fP ختم می‌شود در هر زیردایرکتوری پیدا می‌کند، و `\fB***\&.c\fP\&' همین کار را همراه با دنبال کردن پیوندهای نمادین انجام می‌دهد\&. قرار گرفتن یک \fB/\fP بلافاصله پس از `\fB**\fP\&' یا `\fB***\fP' الگو را مجبور می‌کند تا به عنوان شکل خلاصه‌نشده در نظر گرفته شود\&.
.TP
\fBGLOB_SUBST\fP <C> <K> <S>
با تمام نویسه‌های حاصل از بسط پارامتر به عنوان نویسه‌های واجد شرایط برای بسط نام فایل و تولید نام فایل رفتار می‌کند، و تمام نویسه‌های حاصل از جایگزینی دستور را واجد شرایط تولید نام فایل در نظر می‌گیرد\&. آکولادها (و ویرگول‌های میان آن‌ها) واجد شرایط بسط نمی‌شوند\&.
.TP
\fBHIST_SUBST_PATTERN\fP
جایگزینی‌ها با استفاده از اصلاح‌کننده‌های تاریخچهٔ \fB:s\fP و \fB:&\fP به جای تطبیق رشته‌ای با تطبیق الگو انجام می‌شوند\&. این امر در هر جایی که اصلاح‌کننده‌های تاریخچه معتبر باشند، از جمله توصیف‌کننده‌های glob و پارامترها رخ می‌دهد\&.
بخش `Modifiers\&' در \fIzshexpn\fP(1) را ببینید\&.
.TP
\fBIGNORE_BRACES\fP (\fB\-I\fP) <S>
بسط آکولاد را انجام نمی‌دهد\&. بنا به دلایل تاریخی، این گزینه شامل اثر گزینهٔ \fBIGNORE_CLOSE_BRACES\fP نیز می‌شود\&.
.TP
\fBIGNORE_CLOSE_BRACES\fP
هنگامی که نه این گزینه و نه \fBIGNORE_BRACES\fP تنظیم نشده باشند، یک نویسهٔ منفرد آکولاد بسته `\fB}\fP\&' در هر نقطه‌ای از خط فرمان از نظر نحوی معنادار است\&. این امر موجب می‌شود که پیش از آکولادی که یک تابع یا ساختار پوستهٔ جاری را خاتمه می‌دهد، به هیچ نقطه‌ویرگول یا خط جدیدی نیاز نباشد\&. هنگامی که هر یک از این گزینه‌ها تنظیم شده باشد، آکولاد بسته تنها در موقعیت دستور از نظر نحوی معنادار خواهد بود\&. برخلاف \fBIGNORE_BRACES\fP، این گزینه بسط آکولاد را غیرفعال نمی‌کند\&.
.RS
.PP
برای مثال، در صورت غیرفعال بودن هر دو گزینه، یک تابع می‌تواند به شیوهٔ زیر تعریف شود:
.PP
.RS
.nf
\fBargs() { echo $# }\fP
.fi
.RE
.PP
در حالی که اگر هر یک از گزینه‌ها تنظیم شده باشد، این شیوه کار نمی‌کند و چیزی معادل حالت زیر لازم است:
.PP
.RS
.nf
\fBargs() { echo $#; }\fP
.fi
.RE
.PP
.RE
.TP
\fBKSH_GLOB\fP <K>
در تطبیق الگو، تفسیر پرانتزها تحت تأثیر یک `\fB@\fP\&'، `\fB*\fP'، `\fB+\fP'، `\fB?\fP' یا `\fB!\fP' پیش از آن قرار می‌گیرد\&.
بخش `Filename Generation\&' را ببینید\&.
.TP
\fBMAGIC_EQUAL_SUBST\fP
تمام آرگومان‌های بدون نقل‌قول به شکل `\fIanything\fP\fB=\fP\fIexpression\fP\&' که پس از نام دستور ظاهر می‌شوند، بسط نام فایل بر روی \fIexpression\fP آن‌ها (یعنی جایی که \fIexpression\fP با یک `\fB~\fP\&' یا `\fB=\fP' شروع می‌شود) طوری انجام می‌گیرد که گویی یک انتساب پارامتر است\&. در غیر این صورت رفتار خاصی با آرگومان نمی‌شود؛ به عنوان یک تک‌آرگومان به دستور ارسال می‌شود و به عنوان انتساب پارامتر واقعی به کار نمی‌رود\&. برای مثال، در \fBecho foo=~/bar:~/rod\fP هر دو رخداد \fB~\fP جایگزین خواهند شد\&. توجه داشته باشید که این اتفاق در هر حالتی با \fBtypeset\fP و دستورات مشابه رخ می‌دهد\&.
.RS
.PP
این گزینه به تنظیمات گزینهٔ \fBKSH_TYPESET\fP احترام می‌گذارد\&. به عبارت دیگر، اگر هر دو گزینه فعال باشند، آرگومان‌هایی که شبیه انتساب هستند تحت تفکیک کلمات قرار نخواهند گرفت\&.
.RE
.TP
\fBMARK_DIRS\fP (\fB\-8\fP, ksh: \fB\-X\fP)
یک `\fB/\fP\&' انتهایی به تمام نام‌های دایرکتوری حاصل از تولید نام فایل (globbing) الحاق می‌کند\&.
.TP
\fBMULTIBYTE\fP <D>
نویسه‌های چندبایتی را در صورت یافت شدن در رشته‌ها به رسمیت می‌شناسد\&.
هنگامی که این گزینه تنظیم شده باشد، رشته‌ها با استفاده از کتابخانهٔ سیستم بررسی می‌شوند تا بسته به لوکال (locale) جاری مشخص شود چند بایت یک نویسه را تشکیل می‌دهند\&. این امر بر نحوهٔ شمارش نویسه‌ها در تطبیق الگو، مقادیر پارامترها و جداکننده‌های گوناگون اثر می‌گذارد\&.
.RS
.PP
اگر پوسته با \fBMULTIBYTE_SUPPORT\fP کامپایل شده باشد، این گزینه به‌طور پیش‌فرض فعال است؛ در غیر این صورت به‌طور پیش‌فرض غیرفعال است و فعال کردن آن اثری ندارد\&.
.PP
اگر این گزینه غیرفعال باشد، با یک تک‌بایت همواره به عنوان یک نویسهٔ منفرد رفتار می‌شود\&. این تنظیم صرفاً برای بررسی رشته‌هایی طراحی شده است که مشخص است حاوی بایت‌های خام یا مقادیر دیگری هستند که ممکن است در لوکال جاری نویسه نباشند\&. صرفاً به این دلیل که مجموعه نویسه‌های لوکال جاری شامل نویسه‌های چندبایتی نیست، نیازی به غیرفعال کردن این گزینه وجود ندارد\&.
.RE.PP
این گزینه بر ویرایشگر پوسته تأثیری نمی‌گذارد؛ ویرایشگری که همواره از لوکال (locale) برای تعیین نویسه‌های چندبایتی استفاده می‌کند\&. دلیل این امر آن است که مجموعه نویسه‌های نمایش‌یافته توسط شبیه‌ساز پایانه، مستقل از تنظیمات پوسته است\&.
.RE
.TP
\fBNOMATCH\fP (\fB+3\fP) <C> <Z>
اگر الگویی برای تولید نام فایل هیچ تطابقی نداشته باشد، به جای باقی گذاشتن بدون تغییر آن در فهرست آرگومان‌ها، یک خطا چاپ کند\&.
این مورد همچنین بر روی بسط فایل برای `\fB~\fP\&' یا `\fB=\fP' ابتدایی نیز اعمال می‌شود\&.
.TP
\fBNULL_GLOB\fP (\fB\-G\fP)
اگر الگویی برای تولید نام فایل هیچ تطابقی نداشته باشد، به جای گزارش خطا، الگو را از فهرست آرگومان‌ها حذف کند\&.  بر \fBNOMATCH\fP اولویت دارد\&.
.TP
\fBNUMERIC_GLOB_SORT\fP
اگر نام فایل‌های عددی با یک الگوی تولید نام فایل تطابق پیدا کنند، نام فایل‌ها را به جای ترتیب الفبایی، به صورت عددی مرتب کند\&.
.TP
\fBRC_EXPAND_PARAM\fP (\fB\-P\fP)
بسط‌های آرایه‌ای به فرم
`\fIfoo\fP\fB${\fP\fIxx\fP\fB}\fP\fIbar\fP\&'، که در آن پارامتر
\fIxx\fP با \fB(\fP\fIa b c\fP\fB)\fP مقداردهی شده است، به جای حالت پیش‌فرض
`\fIfooa b cbar\fP\&' با
`\fIfooabar foobbar foocbar\fP\&' جایگزین می‌شوند\&.  توجه داشته باشید که از این رو یک آرایه خالی باعث حذف تمام آرگومان‌ها خواهد شد\&.
.TP
\fBREMATCH_PCRE\fP
اگر تنظیم شود، تطبیق عبارات باقاعده با عملگر \fB=~\fP از عبارات باقاعده سازگار با پرل (PCRE) برگرفته از کتابخانه PCRE استفاده خواهد کرد\&.
(ماژول \fBzsh/pcre\fP باید در دسترس باشد\&.)
اگر تنظیم نشده باشد، عبارات باقاعده از ساختار نحو عبارت باقاعده گسترش‌یافته ارائه‌شده توسط کتابخانه‌های سیستم استفاده خواهند کرد\&.
.TP
\fBSH_GLOB\fP <K> <S>
معنای ویژه `\fB(\fP\&'، `\fB|\fP'، `\fB)\fP'
و \&'\fB<\fP' را برای تطبیق الگوی حاصل از بسط پارامتر و جایگزینی دستور،
و در برخی مکان‌های دیگری که
پوسته الگو می‌پذیرد، غیرفعال می‌کند\&.  اگر \fBSH_GLOB\fP تنظیم شده باشد اما \fBKSH_GLOB\fP
تنظیم نشده باشد، پوسته تفسیر عبارت‌های زیرپوسته (subshell) محصور در پرانتز را در مواردی که
پیش از پرانتز باز فاصله‌ای وجود ندارد امکان‌پذیر می‌سازد؛ برای نمونه \fB!(true)\fP
به گونه‌ای تفسیر می‌شود که گویی پس از \fB!\fP یک فاصله وجود داشته است\&.  این گزینه
در صورتی که zsh به عنوان \fBsh\fP یا \fBksh\fP فراخوانی شود، به صورت پیش‌فرض فعال است\&.
.TP
\fBUNSET\fP (\fB+u\fP, ksh: \fB+u\fP) <K> <S> <Z>
با پارامترهای تنظیم‌نشده هنگام جایگزینی به گونه‌ای رفتار می‌کند که گویی خالی هستند، و هنگام خواندن مقادیر آن‌ها در بسط حسابی و دستورهای محاسباتی، به گونه‌ای که گویی صفر هستند\&.
در غیر این صورت، با آن‌ها به عنوان خطا برخورد می‌شود\&.
.TP
\fBWARN_CREATE_GLOBAL\fP
هنگامی که یک پارامتر سراسری درون یک تابع توسط یک انتساب یا در بستر محاسباتی ایجاد می‌شود، پیام هشداری چاپ کند\&.
این مورد اغلب نشان‌دهنده آن است که پارامتری در حالی که باید به صورت محلی اعلان می‌شد، محلی اعلان نشده است\&.  پارامترهایی که به صراحت از درون یک تابع با استفاده از \fBtypeset \-g\fP سراسری اعلان شده‌اند، هشداری ایجاد نمی‌کنند\&.
توجه داشته باشید زمانی که به یک پارامتر محلی در یک تابع تودرتو مقداری انتساب داده می‌شود هشداری صادر نمی‌شود، که این مورد نیز ممکن است بیانگر یک خطا باشد\&.
.TP
\fBWARN_NESTED_VAR\fP
هنگامی که یک پارامتر موجود از دامنه تابع دربرگیرنده، یا سراسری، درون یک تابع توسط یک انتساب یا در بستر محاسباتی مقداردهی شود، پیام هشداری چاپ کند\&.  انتساب به پارامترهای ویژه پوسته هشداری ایجاد نمی‌کند\&.  این گزینه مکمل \fBWARN_CREATE_GLOBAL\fP است زیرا در این حالت، هشدار فقط زمانی چاپ می‌شود که پارامتری ایجاد \fIنشده\fP باشد\&.  در صورت امکان، استفاده از \fBtypeset \-g\fP برای مقداردهی پارامتر هشدار را فرومی‌نشاند، اما توجه داشته باشید که لازم است این کار هر بار که پارامتر مقداردهی می‌شود انجام گیرد\&.
برای محدود کردن اثر این گزینه به دامنه یک تابع خاص، از `\fBfunctions \-W\fP\&' استفاده کنید\&.
.RS
.PP
برای نمونه، کد زیر برای انتساب درون تابع \fBnested\fP هشدار تولید می‌کند، زیرا مقدار درون \fBtoplevel\fP را بازنویسی می‌کند:
.PP
.RS
.nf
\fBtoplevel() {
  local foo="in fn"
  nested
}
nested() {
     foo="in nested"
}
setopt warn_nested_var
toplevel\fP
.fi
.RE
.RE
.PP.SS "تاریخچه (History)"
.PD 0
.TP
.PD
\fBAPPEND_HISTORY\fP <D>
اگر این گزینه تنظیم شده باشد، نشست‌های zsh به‌جای جایگزین کردن فایل تاریخچه، فهرست تاریخچهٔ خود را به انتهای آن اضافه (append) می‌کنند\&. بنابراین، تمام مدخل‌های جدید از فهرست تاریخچهٔ چندین نشست موازی zsh، به ترتیبی که خارج می‌شوند، به فایل تاریخچه افزوده خواهند شد\&.
این فایل همچنان به‌صورت دوره‌ای زمانی که تعداد خطوط آن ۲۰٪ بیشتر از مقدار مشخص‌شده توسط \fB$SAVEHIST\fP شود، برای هرس شدن بازنویسی می‌شود (همچنین گزینهٔ \fBHIST_SAVE_BY_COPY\fP را ببینید)\&.
.TP
\fBBANG_HIST\fP (\fB+K\fP) <C> <Z>
گسترش متنی تاریخچه را به سبک \fBcsh\fP و با رفتار ویژه با نویسهٔ `\fB!\fP\&' انجام می‌دهد\&.
.TP
\fBEXTENDED_HISTORY\fP <C>
برچسب زمانیِ آغاز هر دستور (به ثانیه از مبدأ زمانی epoch) و مدت زمان اجرای آن (به ثانیه) را در فایل تاریخچه ذخیره می‌کند\&. قالب این داده‌های پیشوندی به این صورت است:
.RS
.PP
`\fB: \fP\fI<beginning time>\fP\fB:\fP\fI<elapsed seconds>\fP\fB;\fP\fI<command>\fP\&'\&.
.RE
.TP
\fBHIST_ALLOW_CLOBBER\fP
افزودن `\fB|\fP\&' به تغییرمسیرهای خروجی در تاریخچه\&. این کار اجازه می‌دهد ارجاعات به تاریخچه حتی زمانی که \fBCLOBBER\fP غیرفعال است، فایل‌ها را رونویسی (clobber) کنند\&.
.TP
\fBHIST_BEEP\fP <D>
پخش صدای بوق در ZLE هنگامی که یک ابزارک سعی می‌کند به مدخلی از تاریخچه که وجود ندارد دسترسی پیدا کند\&.
.TP
\fBHIST_EXPIRE_DUPS_FIRST\fP
اگر تاریخچهٔ درونی برای افزودن خط فرمان جاری نیاز به هرس شدن داشته باشد، تنظیم این گزینه باعث می‌شود که قدیمی‌ترین رویداد تاریخچه که نسخهٔ تکراری دارد، پیش از حذف یک رویداد یکتا از فهرست، از بین برود\&.
باید اطمینان حاصل کنید که مقدار \fBHISTSIZE\fP روی عددی بزرگ‌تر از \fBSAVEHIST\fP تنظیم شده باشد تا فضایی برای رویدادهای تکراری فراهم شود؛ در غیر این صورت، به محض پر شدن تاریخچه از رویدادهای یکتا، این گزینه رفتاری درست مانند \fBHIST_IGNORE_ALL_DUPS\fP خواهد داشت\&.
.TP
\fBHIST_FCNTL_LOCK\fP
هنگام نوشتن روی فایل تاریخچه، zsh به‌طور پیش‌فرض از قفل‌گذاری موقت (ad\-hoc) فایل استفاده می‌کند تا از مشکلات شناخته‌شدهٔ قفل‌گذاری روی برخی سیستم‌عامل‌ها جلوگیری کند\&. با فعال بودن این گزینه، قفل‌گذاری در صورت وجود این روش، از طریق فراخوانی سیستمی \fBfcntl\fP انجام می‌شود\&. در سیستم‌عامل‌های امروزی این کار ممکن است کارایی بهتری فراهم کند، به‌ویژه از خراب شدن تاریخچه در هنگام ذخیرهٔ فایل‌ها روی NFS جلوگیری می‌کند\&.
.TP
\fBHIST_FIND_NO_DUPS\fP
هنگام جست‌وجوی مدخل‌های تاریخچه در ویرایشگر خط، موارد تکراریِ خطی که پیش‌تر پیدا شده است را نمایش نده، حتی اگر موارد تکراری متوالی نباشند\&.
.TP
\fBHIST_IGNORE_ALL_DUPS\fP
اگر یک خط فرمان جدید که به فهرست تاریخچه اضافه می‌شود تکراریِ یک دستور قدیمی‌تر باشد، دستور قدیمی‌تر از فهرست حذف می‌شود (حتی اگر رویداد بلافاصله قبلی نباشد)\&.
.TP
\fBHIST_IGNORE_DUPS\fP (\fB\-h\fP)
اگر خطوط فرمان تکرار رویداد قبلی باشند، آن‌ها را وارد فهرست تاریخچه نکن\&.
.TP
\fBHIST_IGNORE_SPACE\fP (\fB\-g\fP)
خطوط فرمان را از فهرست تاریخچه حذف کن اگر نخستین نویسهٔ خط یک فاصله باشد، یا اگر یکی از نام‌های مستعار گسترش‌یافته حاوی فاصله در ابتدا باشد\&. تنها نام‌های مستعار معمولی (نه نام‌های مستعار سراسری یا پسوندی) این رفتار را دارند\&.
توجه داشته باشید که دستور تا زمان وارد شدن دستور بعدی در تاریخچهٔ درونی باقی می‌ماند و پس از آن ناپدید می‌شود؛ این به شما امکان می‌دهد خط را موقتاً مجدداً استفاده یا ویرایش کنید\&. اگر می‌خواهید فوراً و بدون وارد کردن دستور دیگری ناپدید شود، یک فاصله تایپ کرده و کلید بازگشت (return) را فشار دهید\&.
.TP
\fBHIST_LEX_WORDS\fP
به‌طور پیش‌فرض، تاریخچهٔ شل که از فایل‌ها خوانده می‌شود، روی تمام فاصله‌های سفید (whitespace) به کلمات تجزیه می‌شود\&. این بدان معناست که آرگومان‌های دارای فاصله‌های نقل‌قول‌شده به‌درستی پردازش نمی‌شوند، و در نتیجه، ارجاع به کلمات در خطوط تاریخچه‌ای که از فایل خوانده شده‌اند ممکن است نادرست باشد\&. وقتی این گزینه تنظیم شده باشد، کلمات خوانده‌شده از فایل تاریخچه به شیوه‌ای مشابه پردازش عادی خط فرمان شل تقسیم می‌شوند\&. اگرچه این کار کلماتی با مرزبندی دقیق‌تر تولید می‌کند، اما در صورت بزرگ بودن اندازهٔ فایل تاریخچه می‌تواند کُند باشد\&. برای تصمیم‌گیری نیاز به آزمون و خطا است\&.
.TP
\fBHIST_NO_FUNCTIONS\fP
تعاریف توابع را از فهرست تاریخچه حذف کن\&.
توجه داشته باشید که تابع تا زمان وارد شدن دستور بعدی در تاریخچهٔ درونی باقی می‌ماند و پس از آن ناپدید می‌شود؛ این به شما امکان می‌دهد تعریف آن را موقتاً دوباره استفاده یا ویرایش کنید\&.
.TP
\fBHIST_NO_STORE\fP
دستور \fBhistory\fP (\fBfc \-l\fP) را در هنگام فراخوانی از فهرست تاریخچه حذف کن\&.
توجه داشته باشید که دستور تا زمان وارد شدن دستور بعدی در تاریخچهٔ درونی باقی می‌ماند و پس از آن ناپدید می‌شود؛ این به شما امکان می‌دهد خط را موقتاً مجدداً استفاده یا ویرایش کنید\&.
.TP
\fBHIST_REDUCE_BLANKS\fP
فاصله‌های خالی اضافی را از هر خط فرمانی که به فهرست تاریخچه اضافه می‌شود حذف کن\&.
.TP
\fBHIST_SAVE_BY_COPY\fP <D>
هنگامی که فایل تاریخچه بازنویسی می‌شود، معمولاً رونوشتی از فایل به نام \fB$HISTFILE\&.new\fP نوشته می‌شود و سپس با تغییر نام، جایگزین فایل قدیمی می‌گردد\&. با این حال، اگر این گزینه غیرفعال باشد، به‌جای آن فایل قدیمی تاریخچه بریده (truncate) شده و نسخهٔ جدید در همان‌جا بازنویسی می‌شود\&. اگر یکی از گزینه‌های الحاق تاریخچه فعال باشد، این گزینه تنها زمانی اثرگذار خواهد بود که فایلِ بزرگ‌شدهٔ تاریخچه نیاز به بازنویسی جهت کاهش اندازه و هرس شدن داشته باشد\&. این گزینه را تنها در صورت داشتن نیازهای خاص غیرفعال کنید، زیرا در صورت قطع شدن فرایند zsh در حین ذخیره‌سازی، امکان از دست رفتن مدخل‌های تاریخچه وجود دارد\&.
.RS
.PP
هنگام نوشتن یک رونوشت از فایل تاریخچه، zsh دسترسی‌ها و اطلاعات گروهِ فایل قدیمی را حفظ می‌کند، اما اگر مالک فایل تاریخچه تغییر کند، از نوشتن فایل جدید خودداری خواهد کرد\&.
.RE
.TP
\fBHIST_SAVE_NO_DUPS\fP
هنگام نوشتن و ذخیرهٔ فایل تاریخچه، دستورات قدیمی‌تری که تکراریِ دستورات جدیدتر هستند، حذف می‌شوند\&.
.TP
\fBHIST_VERIFY\fP
هرگاه کاربر خطی را همراه با گسترش تاریخچه وارد کند، خط را مستقیماً اجرا نکن؛ در عوض، گسترش تاریخچه را انجام داده و خط را مجدداً درون بافر ویرایش بارگذاری کن\&.
.TP
\fBINC_APPEND_HISTORY\fP
این گزینه مانند \fBAPPEND_HISTORY\fP عمل می‌کند با این تفاوت که خطوط جدید تاریخچه به‌جای صبر کردن تا زمان خروج پوسته، به‌صورت افزایشی (به‌محض وارد شدن) به \fB$HISTFILE\fP اضافه می‌شوند\&.
این فایل همچنان به‌صورت دوره‌ای زمانی که تعداد خطوط آن ۲۰٪ بیشتر از مقدار مشخص‌شده توسط \fB$SAVEHIST\fP شود، برای هرس شدن بازنویسی خواهد شد (همچنین گزینهٔ \fBHIST_SAVE_BY_COPY\fP را ببینید)\&.
.TP
\fBINC_APPEND_HISTORY_TIME\fP
این گزینه شاخه‌ای از \fBINC_APPEND_HISTORY\fP است که در آن، در صورت امکان، مدخل تاریخچه پس از پایان اجرای دستور در فایل نوشته می‌شود تا مدت‌زمان مصرف‌شده توسط دستور به‌درستی با قالب \fBEXTENDED_HISTORY\fP در فایل تاریخچه ثبت شود\&. این بدان معناست که مدخل تاریخچه فوراً برای سایر نمونه‌های پوسته‌ای که از همان فایل تاریخچه استفاده می‌کنند در دسترس نخواهد بود\&.
.RS
.PP
این گزینه تنها زمانی مفید است که \fBINC_APPEND_HISTORY\fP و \fBSHARE_HISTORY\fP خاموش باشند\&. این سه گزینه باید ناسازگار با یکدیگر (مانعة‌الجمع) در نظر گرفته شوند\&.
.RE
.TP
\fBSHARE_HISTORY\fP <K>
.RS
.PP
این گزینه هم دستورات جدید را از فایل تاریخچه وارد (import) می‌کند و هم باعث می‌شود دستورات تایپ‌شدهٔ شما به انتهای فایل تاریخچه الحاق شوند (مورد دوم مشابه مشخص کردن \fBINC_APPEND_HISTORY\fP است که در صورت فعال بودن این گزینه باید غیرفعال شود)\&. خطوط تاریخچه همچنین همانند \fBEXTENDED_HISTORY\fP همراه با برچسب‌های زمانی خروجی داده می‌شوند (که یافتن نقطه‌ای را که خواندن فایل پس از بازنویسی متوقف شده بود، آسان‌تر می‌کند)\&.
.PP
به‌طور پیش‌فرض، دستورات پیمایش در تاریخچه علاوه بر خطوط محلی، خطوط واردشده را نیز بررسی می‌کنند، اما می‌توانید این حالت را با اتصال کلید zle با عنوان set\-local\-history فعال و غیرفعال کنید\&. همچنین امکان ساخت یک ابزارک zle وجود دارد که باعث شود برخی دستورات، دستورات واردشده را نادیده بگیرند و برخی دیگر آن‌ها را در بر گیرند\&.
.PP
اگر احساس می‌کنید کنترل بیشتری روی زمان وارد شدن دستورات نیاز دارید، ممکن است بخواهید \fBSHARE_HISTORY\fP را غیرفعال کرده و \fBINC_APPEND_HISTORY\fP یا \fBINC_APPEND_HISTORY_TIME\fP (به بالا نگاه کنید) را فعال نمایید و سپس هر زمان که نیاز داشتید با استفاده از `\fBfc \-RI\fP\&' دستورات را به‌صورت دستی وارد کنید\&.
.RE
.PP.SS "مقداردهی اولیه (Initialisation)"
.PD 0
.TP
.PD
\fBALL_EXPORT\fP (\fB\-a\fP, ksh: \fB\-a\fP)
تمام پارامترهایی که پس از این تعریف شوند، به‌طور خودکار صادر (export) می‌شوند\&.
.TP
\fBGLOBAL_EXPORT\fP <Z>
اگر این گزینه فعال باشد، دادن پرچم \fB\-x\fP به دستورهای توکار \fBdeclare\fP،
\fBfloat\fP، \fBinteger\fP، \fBreadonly\fP و \fBtypeset\fP (به‌جز \fBlocal\fP)
پرچم \fB\-g\fP را نیز تنظیم می‌کند؛ بنابراین پارامترهای صادرشده به
محیط، برای تابع دربرگیرنده به‌صورت محلی درنخواهند آمد، مگر اینکه
از قبل محلی بوده باشند یا پرچم \fB+g\fP به‌طور صریح داده شده باشد\&. اگر این گزینه
غیرفعال باشد، پارامترهای صادرشده درست مانند هر پارامتر دیگری
محلی خواهند شد\&.
.RS
.PP
این گزینه به‌طور پیش‌فرض برای سازگاری با نسخه‌های قبلی فعال است؛
توصیه نمی‌شود که به رفتار آن اتکا کنید\&. توجه داشته باشید که دستور توکار
\fBexport\fP همیشه هر دو پرچم \fB\-x\fP و \fB\-g\fP را تنظیم می‌کند و بنابراین
اثر آن به فراتر از دامنهٔ تابع دربرگیرنده گسترش می‌یابد؛ این
قابل‌حمل‌ترین روش برای دستیابی به این رفتار است\&.
.RE
.TP
\fBGLOBAL_RCS\fP (\fB+d\fP) <D>
اگر این گزینه غیرفعال باشد، فایل‌های راه‌اندازی \fB/etc/zsh/zprofile\fP،
\fB/etc/zsh/zshrc\fP، \fB/etc/zsh/zlogin\fP و \fB/etc/zsh/zlogout\fP اجرا نخواهند شد\&. این
گزینه را می‌توان در هر زمان، از جمله در داخل فایل‌های راه‌اندازی محلی
(\fB\&.zshrc\fP و غیره)، غیرفعال و دوباره فعال کرد\&.
.TP
\fBRCS\fP (\fB+f\fP) <D>
پس از بارگذاری \fB/etc/zsh/zshenv\fP در هنگام راه‌اندازی، فایل‌های
\fB\&.zshenv\fP، \fB/etc/zsh/zprofile\fP، \fB\&.zprofile\fP،
\fB/etc/zsh/zshrc\fP، \fB\&.zshrc\fP، \fB/etc/zsh/zlogin\fP، \fB\&.zlogin\fP و \fB\&.zlogout\fP
را همان‌طور که در بخش «Files» توضیح داده شده است، بارگذاری کن\&.
اگر این گزینه غیرفعال باشد، فایل \fB/etc/zsh/zshenv\fP همچنان بارگذاری می‌شود، اما
هیچ‌یک از فایل‌های دیگر بارگذاری نخواهند شد؛ می‌توان آن را در هر زمان تنظیم کرد تا از
بارگذاری فایل‌های راه‌اندازی باقی‌مانده پس از فایلی که هم‌اکنون در حال اجراست
جلوگیری شود\&.
.PP
.SS "ورودی/خروجی (Input/Output)"
.PD 0
.TP
.PD
\fBALIASES\fP <D>
بسط دادن نام‌های مستعار (aliases)\&.
.TP
\fBCLOBBER\fP (\fB+C\fP, ksh: \fB+C\fP) <D>
به تغییر مسیر `\fB>\fP\&' اجازه می‌دهد تا فایل‌های موجود را بازنویسی و کوتاه (truncate) کند\&.
در غیر این صورت، برای کوتاه کردن یک فایل باید از `\fB>!\fP\&' یا `\fB>|\fP' استفاده شود\&.
.RS
.PP
اگر این گزینه تنظیم نشده باشد، و گزینهٔ \fBAPPEND_CREATE\fP نیز
تنظیم نشده باشد، باید برای ایجاد یک فایل از `\fB>>!\fP\&' یا `\fB>>|\fP' استفاده شود\&.
اگر هر یک از این گزینه‌ها فعال باشد، می‌توان از `\fB>>\fP\&' استفاده کرد\&.
.RE
.TP
\fBCLOBBER_EMPTY\fP
این گزینه تنها در صورتی استفاده می‌شود که گزینهٔ \fBCLOBBER\fP فعال نباشد: توجه داشته باشید که
این گزینه به‌طور پیش‌فرض فعال است\&.
.RS
.PP
اگر این گزینه فعال باشد، فایل‌های عادی با طول صفر ممکن است
بازنویسی شوند (`clobbered\&')\&. توجه داشته باشید این امکان وجود دارد که پردازش دیگری
بین این بررسی و استفاده از فایل توسط پردازش فعلی، در فایل نوشته باشد\&.
بنابراین این گزینه نباید در مواردی استفاده شود که ممکن است در فایل‌های مورد
بازنویسی به‌صورت ناهمگام نوشته شود\&.
.RE
.TP
\fBCORRECT\fP (\fB\-0\fP)
تلاش برای تصحیح املای دستورها\&.
توجه داشته باشید که وقتی گزینهٔ \fBHASH_LIST_ALL\fP تنظیم نشده باشد یا وقتی برخی
از دایرکتوری‌های موجود در مسیر قابل خواندن نباشند، ممکن است در اولین باری که برخی
دستورها استفاده می‌شوند، خطاهای املایی به‌اشتباه گزارش شوند\&.
.RS
.PP
متغیر پوستهٔ \fBCORRECT_IGNORE\fP می‌تواند روی الگویی تنظیم شود تا
کلماتی را که هرگز نباید به‌عنوان تصحیح پیشنهاد شوند، مطابقت دهد\&.
.RE
.TP
\fBCORRECT_ALL\fP (\fB\-O\fP)
تلاش برای تصحیح املای تمام آرگومان‌ها در یک خط\&.
.RS
.PP
متغیر پوستهٔ \fBCORRECT_IGNORE_FILE\fP می‌تواند روی الگویی تنظیم شود تا
نام فایل‌هایی را که هرگز نباید به‌عنوان تصحیح پیشنهاد شوند، مطابقت دهد\&.
.RE
.TP
\fBDVORAK\fP
استفاده از صفحه‌کلید Dvorak به‌جای صفحه‌کلید استاندارد qwerty به‌عنوان مبنایی
برای بررسی خطاهای املایی در گزینه‌های \fBCORRECT\fP و \fBCORRECT_ALL\fP
و دستور ویرایشگر \fBspell\-word\fP\&.
.TP
\fBFLOW_CONTROL\fP <D>
اگر این گزینه غیرفعال باشد،
کنترل جریان خروجی از طریق نویسه‌های start/stop (که معمولاً به
^S/^Q اختصاص داده می‌شوند) در ویرایشگر پوسته غیرفعال می‌شود\&.
.TP
\fBIGNORE_EOF\fP (\fB\-7\fP)
با رسیدن به پایان فایل (end\-of\-file) خارج نشو\&. در عوض، استفاده
از \fBexit\fP یا \fBlogout\fP را الزامی کن\&.
با این حال، ده EOF متوالی در هر صورت باعث خروج پوسته خواهد شد
تا در صورت از دست رفتن tty، از معلق ماندن پوسته جلوگیری شود\&.
.RS
.PP
همچنین، اگر این گزینه فعال باشد و از Zsh Line Editor استفاده شود، ابزارک‌های (widgets)
پیاده‌سازی‌شده با توابع پوسته را می‌توان بدون چاپ پیام هشدار همیشگی
به EOF (معمولاً Control\-D) متصل (bind) کرد\&. این ویژگی
تنها برای ابزارک‌های عادی کار می‌کند، نه ابزارک‌های تکمیل (completion)\&.
.RE
.TP
\fBINTERACTIVE_COMMENTS\fP (\fB\-k\fP) <K> <S>
مجاز دانستن توضیحات (comments) حتی در پوسته‌های تعاملی\&.
.TP
\fBHASH_CMDS\fP <D>
مکان هر دستور را در اولین باری که اجرا می‌شود ثبت کن\&.
فراخوانی‌های بعدی همان دستور از مکان ذخیره‌شده استفاده خواهند کرد
که از جستجوی مسیر جلوگیری می‌کند\&.
اگر این گزینه غیرفعال باشد، هیچ هش‌گذاری مسیری انجام نمی‌شود\&.
با این حال، زمانی که \fBCORRECT\fP فعال است، دستورهایی که نام آن‌ها در
جدول‌های هش توابع یا نام‌های مستعار ظاهر نمی‌شود هش می‌شوند تا از
گزارش آن‌ها به‌عنوان خطای املایی جلوگیری شود\&.
.TP
\fBHASH_DIRS\fP <D>
هر زمان که نام دستوری هش شود، دایرکتوری حاوی آن
و همچنین تمام دایرکتوری‌هایی را که در مسیر قبل از آن قرار دارند هش کن\&.
اگر نه \fBHASH_CMDS\fP و نه \fBCORRECT\fP فعال نباشند، هیچ اثری ندارد\&.
.TP
\fBHASH_EXECUTABLES_ONLY\fP
هنگام هش کردن دستورها به‌دلیل \fBHASH_CMDS\fP، بررسی کن که آیا
فایل مورد نظر برای هش واقعاً یک فایل اجرایی است یا خیر\&. این گزینه
به‌طور پیش‌فرض غیرفعال است زیرا اگر مسیر شامل تعداد زیادی دستور باشد،
یا از فایل‌های ریموت متعددی تشکیل شده باشد، این بررسی‌های اضافی می‌تواند
زمان زیادی ببرد\&. برای مشخص شدن مفید بودن این گزینه به آزمون و خطا نیاز است\&.
.TP
\fBMAIL_WARNING\fP (\fB\-U\fP)
اگر از زمان آخرین بررسی پوسته به یک فایل ایمیل (mail) دسترسی پیدا
شده باشد، یک پیام هشدار چاپ کن\&.
.TP
\fBPATH_DIRS\fP (\fB\-Q\fP)
جستجوی مسیر را حتی برای نام‌های دستوری که حاوی اسلش هستند انجام بده\&.
بنابراین اگر `\fB/usr/local/bin\fP\&' در مسیر کاربر باشد و او عبارت
`\fBX11/xinit\fP\&' را تایپ کند، دستور `\fB/usr/local/bin/X11/xinit\fP' اجرا خواهد شد
(به فرض اینکه وجود داشته باشد)\&.
دستورهایی که به‌صراحت با `\fB/\fP\&'، `\fB\&./\fP' یا `\fB\&.\&./\fP' شروع می‌شوند،
مشمول جستجوی مسیر قرار نمی‌گیرند\&.
این قاعده برای دستورهای توکار `\fB\&.\fP\&' و \fBsource\fP نیز صدق می‌کند\&.
.RS
.PP
توجه داشته باشید که زیردایرکتوری‌های دایرکتوری فعلی همیشه برای یافتن
فایل‌های اجراییِ مشخص‌شده به این شکل جستجو می‌شوند\&. این کار پیش از هرگونه جستجوی
مشخص‌شده توسط این گزینه انجام می‌گیرد، و مستقل از این است که `\fB\&.\fP\&' یا دایرکتوری
فعلی در مسیر جستجوی دستور ظاهر شده باشد یا خیر\&.
.RE
.TP
\fBPATH_SCRIPT\fP <K> <S>
اگر این گزینه فعال نباشد، اسکریپتی که به‌عنوان اولین آرگومان غیرگزینه‌ای
به پوسته داده می‌شود باید شامل نام فایلی باشد که باید باز شود\&. اگر این
گزینه فعال باشد و اسکریپت مسیر دایرکتوری را مشخص نکند،
اسکریپت ابتدا در دایرکتوری فعلی، و سپس در
مسیر دستورها جستجو می‌شود\&. بخش INVOCATION در \fIzsh\fP(1) را
ببینید\&.
.TP
\fBPRINT_EIGHT_BIT\fP
چاپ نویسه‌های هشت‌بیتی به‌صورت تحت‌اللفظی در فهرست‌های تکمیل و غیره\&.
اگر سیستم شما قابلیت چاپ نویسه‌های هشت‌بیتی را به‌درستی برمی‌گرداند، این
گزینه لازم نیست (نگاه کنید به \fIctype\fP(3))\&.
.TP
\fBPRINT_EXIT_VALUE\fP (\fB\-1\fP)
چاپ مقدار وضعیت خروج برنامه‌هایی که وضعیت خروج غیرصفر دارند\&.
این ویژگی تنها در خط فرمان در پوسته‌های تعاملی در دسترس است\&.
.TP
\fBRC_QUOTES\fP
اجازه دادن به دنبالهٔ نویسه‌ای `\fB\&''\fP' برای نشان دادن یک نقل‌قول تکی (single quote)
در داخل رشته‌های محصور در نقل‌قول تکی\&. توجه داشته باشید که این قاعده برای رشته‌های
نقل‌قول‌شده با قالب \fB$\&'\fP\fI\&.\&.\&.\fP\fB'\fP اعمال نمی‌شود، جایی که می‌توان
از یک نقل‌قول تکی همراه با بک‌اسلش استفاده کرد\&.
.TP
\fBRM_STAR_SILENT\fP (\fB\-H\fP) <K> <S>
پیش از اجرای `\fBrm *\fP\&' یا `\fBrm path/*\fP' از کاربر تأییدیه نگیر\&..TP
\fBRM_STAR_WAIT\fP
اگر پیش از اجرای `\fBrm *\fP\&' یا `\fBrm path/*\fP' از کاربر سؤال پرسیده شود، ابتدا ده ثانیه درنگ می‌کند و هر آنچه در این مدت تایپ شود نادیده گرفته می‌شود\&. این کار از پاسخ غیرارادی «yes» به پرسش، زمانی که کاربر واقعاً چنین قصدی نداشته است، جلوگیری می‌کند\&. با بسط دادن `\fB*\fP\&' در ZLE (با کلید tab)، همواره می‌توان از این درنگ و پرسش جلوگیری کرد\&.
.TP
\fBSHORT_LOOPS\fP <C> <Z>
اجازه استفاده از اشکال کوتاه ساختارهای \fBfor\fP، \fBrepeat\fP، \fBselect\fP، \fBif\fP و \fBfunction\fP را می‌دهد\&.
.TP
\fBSHORT_REPEAT\fP
شکل کوتاه \fBrepeat\fP را همانند \fBSHORT_LOOPS\fP مجاز می‌داند، اما بدون اینکه آن را برای سایر ساختارها فعال کند\&.
.TP
\fBSUN_KEYBOARD_HACK\fP (\fB\-L\fP)
اگر خطی با یک بک‌تیک (backquote) خاتمه یابد و تعداد بک‌تیک‌های موجود در خط فرد باشد، بک‌تیک پایانی را نادیده می‌گیرد\&. این گزینه در برخی صفحه‌کلیدها که کلید return بیش از حد کوچک است و کلید بک‌تیک به شکلی آزاردهنده نزدیک آن قرار دارد مفید است\&. به‌عنوان یک جایگزین، متغیر \fBKEYBOARD_HACK\fP به شما امکان می‌دهد نویسه‌ای را که باید حذف شود تعیین کنید\&.
.PP
.SS "کنترل کارها (Job Control)"
.PD 0
.TP
.PD
\fBAUTO_CONTINUE\fP
با تنظیم این گزینه، به کارهای متوقف‌شده‌ای که با دستور توکار \fBdisown\fP از جدول کارها حذف می‌شوند، به طور خودکار سیگنال \fBCONT\fP ارسال می‌شود تا به حالت اجرا درآیند\&.
.TP
\fBAUTO_RESUME\fP (\fB\-W\fP)
دستورهای ساده تک‌کلمه‌ایِ بدون تغییرمسیر را به‌عنوان نامزدی برای از سرگیری یک کار موجود در نظر می‌گیرد\&.
.TP
\fBBG_NICE\fP (\fB\-6\fP) <C> <Z>
تمام کارهای پس‌زمینه را با اولویت پایین‌تری اجرا می‌کند\&. این گزینه به‌طور پیش‌فرض فعال است\&.
.TP
\fBCHECK_JOBS\fP <Z>
پیش از خروج از یک شل دارای کنترل کار، وضعیت کارهای پس‌زمینه و معلق‌شده را گزارش می‌دهد؛ تلاش دوم برای خروج از شل موفقیت‌آمیز خواهد بود\&. بهتر است \fBNO_CHECK_JOBS\fP تنها همراه با \fBNO_HUP\fP استفاده شود، در غیر این صورت چنین کارهایی به‌طور خودکار کشته خواهند شد\&.
.RS
.PP
اگر دستورهای اجراشده در خط فرمان قبلی شامل دستور `\fBjobs\fP\&' بوده باشد، این بررسی انجام نمی‌شود؛ چرا که فرض بر این است که کاربر از وجود کارهای پس‌زمینه یا معلق آگاه است\&. اجرای دستور `\fBjobs\fP\&' از طریق یکی از توابع قلاب تعریف‌شده در بخش SPECIAL FUNCTIONS در \fIzshmisc\fP(1) برای این منظور به شمار نمی‌آید\&.
.RE
.TP
\fBCHECK_RUNNING_JOBS\fP <Z>
هنگامی که \fBCHECK_JOBS\fP فعال است، هم کارهای در حال اجرا و هم کارهای معلق را بررسی می‌کند\&. هنگامی که این گزینه غیرفعال باشد، zsh تنها کارهای معلق را بررسی می‌کند که این رفتار با رفتار پیش‌فرض bash مطابقت دارد\&.
.RS
.PP
این گزینه هیچ تأثیری ندارد مگر اینکه \fBCHECK_JOBS\fP تنظیم شده باشد\&.
.RE
.TP
\fBHUP\fP <Z>
هنگام خروج شل، سیگنال \fBHUP\fP را به کارهای در حال اجرا ارسال می‌کند\&.
.TP
\fBLONG_LIST_JOBS\fP (\fB\-R\fP)
اعلان‌های کارها را به‌طور پیش‌فرض در قالب طولانی چاپ می‌کند\&.
.TP
\fBMONITOR\fP (\fB\-m\fP, ksh: \fB\-m\fP)
کنترل کارها را مجاز می‌سازد\&. به‌طور پیش‌فرض در شل‌های تعاملی فعال است\&.
.TP
\fBNOTIFY\fP (\fB\-5\fP, ksh: \fB\-b\fP) <Z>
وضعیت کارهای پس‌زمینه را فوراً گزارش می‌دهد، به جای اینکه تا درست پیش از نمایش اعلان اعلان شل منتظر بماند\&.
.TP
\fBPOSIX_JOBS\fP <K> <S>
این گزینه کنترل کار را با استاندارد POSIX سازگارتر می‌سازد\&.
.RS
.PP
هنگامی که این گزینه تنظیم نشده باشد، گزینه \fBMONITOR\fP هنگام ورود به زیرشل‌ها غیرفعال می‌شود تا کنترل کار دیگر فعال نباشد\&. هنگامی که گزینه تنظیم شده باشد، گزینه \fBMONITOR\fP و کنترل کار درون زیرشل فعال باقی می‌مانند، اما توجه داشته باشید که زیرشل هیچ دسترسی به کارهای موجود در شل والد ندارد\&.
.PP
هنگامی که این گزینه تنظیم نشده باشد، کارهایی که با \fBbg\fP یا \fBfg\fP به پس‌زمینه یا پیش‌زمینه منتقل می‌شوند با همان اطلاعاتی نمایش داده می‌شوند که توسط \fBjobs\fP گزارش می‌شد\&. هنگامی که گزینه تنظیم شده باشد، تنها متن چاپ می‌شود\&. خروجی خودِ \fBjobs\fP تحت تأثیر این گزینه قرار نمی‌گیرد\&.
.PP
هنگامی که این گزینه تنظیم نشده باشد، اطلاعات کارها از شل والد برای نمایش خروجی درون یک زیرشل (به عنوان مثال درون یک خط‌لوله) ذخیره می‌شود\&. هنگامی که گزینه تنظیم شده باشد، خروجی \fBjobs\fP خالی خواهد بود تا زمانی که کاری درون زیرشل آغاز شود\&.
.PP
در نسخه‌های پیشین این شل، فعال کردن \fBPOSIX_JOBS\fP برای این که دستور توکار \fBwait\fP وضعیت کارهای پس‌زمینه‌ای را که قبلاً خارج شده بودند بازگرداند ضروری بود\&. اکنون دیگر چنین نیست\&.
.RE
.PP.SS "اعلان‌ها (Prompting)"
.PD 0
.TP
.PD
\fBPROMPT_BANG\fP <K>
در صورت تنظیم، با «\fB!\fP\&» در بسط اعلان به گونه‌ای خاص رفتار می‌شود\&.
بخش
EXPANSION OF PROMPT SEQUENCES را در \fIzshmisc\fP(1) ببینید\&.
.TP
\fBPROMPT_CR\fP (\fB+V\fP) <D>
درست پیش از چاپ یک اعلان در ویرایشگر خط، یک بازگشت به ابتدای سطر (carriage return) چاپ می‌کند\&. این گزینه به‌طور پیش‌فرض فعال است چرا که ویرایش چندخطی تنها زمانی امکان‌پذیر است که ویرایشگر بداند ابتدای خط کجاست\&.
.TP
\fBPROMPT_SP\fP <D>
تلاش می‌کند تا یک خط ناقص (یعنی خطی که به یک خط جدید ختم نشده است) را که در غیر این صورت به دلیل گزینهٔ \fBPROMPT_CR\fP توسط اعلان خط فرمان پوشانده می‌شد، حفظ کند\&. این کار با خروجی دادن چند نویسهٔ کنترل مکان‌نما، از جمله مجموعه‌ای از فاصله‌ها، انجام می‌شود تا در صورت وجود یک خط ناقص، ترمینال به خط بعدی برود (توجه داشته باشید که این کار تنها در صورتی موفقیت‌آمیز است که ترمینال شما دارای حاشیه‌های خودکار (automatic margins) باشد، که معمولاً چنین است)\&.
.RS
.PP
هنگامی که یک خط ناقص حفظ می‌شود، به‌طور پیش‌فرض نویسه‌ای معکوس+پررنگ (inverse+bold) را در انتهای خط ناقص مشاهده خواهید کرد: یک «\fB%\fP\&» برای کاربر عادی یا یک «\fB#\fP\&» برای کاربر ریشه (root)\&. در صورت تنظیم، می‌توان از پارامتر شل \fBPROMPT_EOL_MARK\fP برای سفارشی‌سازی نحوهٔ نمایش انتهای خطوط ناقص استفاده کرد\&.
.PP
نکته: اگر گزینهٔ \fBPROMPT_CR\fP تنظیم نشده باشد، فعال کردن این گزینه هیچ اثری نخواهد داشت\&. این گزینه به‌طور پیش‌فرض فعال است\&.
.RE
.TP
\fBPROMPT_PERCENT\fP <C> <Z>
در صورت تنظیم، با «\fB%\fP\&» در بسط اعلان به گونه‌ای خاص رفتار می‌شود\&.
بخش
EXPANSION OF PROMPT SEQUENCES را در \fIzshmisc\fP(1) ببینید\&.
.TP
\fBPROMPT_SUBST\fP <K> <S>
در صورت تنظیم، \fIبسط پارامتر\fP، \fIجایگزینی دستور\fP و \fIبسط محاسباتی\fP در اعلان‌ها انجام می‌شوند\&. جایگزینی‌های درون اعلان‌ها بر وضعیت دستور تاثیری نمی‌گذارند\&.
.TP
\fBTRANSIENT_RPROMPT\fP
هنگام پذیرش یک خط فرمان، هرگونه اعلان سمت راست را از صفحه نمایش حذف می‌کند\&. این ممکن است در ترمینال‌هایی با روش‌های دیگر برش/چسباندن (cut/paste) مفید باشد\&.
.PP
.SS "اسکریپت‌ها و توابع (Scripts and Functions)"
.PD 0
.TP
.PD
\fBALIAS_FUNC_DEF\fP <S>
به‌طور پیش‌فرض، zsh اجازهٔ تعریف توابع با استفاده از نحو «\fIname\fP \fB()\fP\&» را در صورتی که \fIname\fP به عنوان یک نام مستعار (alias) بسط داده شده باشد، نمی‌دهد: این کار موجب بروز خطا می‌شود\&. این معمولاً رفتار مطلوب است، زیرا در غیر این صورت ترکیب یک نام مستعار و یک تابع بر اساس همان تعریف می‌تواند به راحتی مشکل‌ساز شود\&.
.RS
.PP
هنگامی که این گزینه تنظیم شود، می‌توان از نام‌های مستعار برای تعریف توابع استفاده کرد\&.
.PP
برای نمونه، تعاریف زیر را آن‌گونه که ممکن است در یک فایل راه‌اندازی رخ دهند در نظر بگیرید\&.
.PP
.RS
.nf
\fBalias foo=bar
foo() {
  print This probably does not do what you expect\&.
}\fP
.fi
.RE
.PP
در اینجا، \fBfoo\fP پیش از مواجهه با \fB()\fP به عنوان یک نام مستعار به \fBbar\fP بسط داده می‌شود، بنابراین تابع تعریف‌شده \fBbar\fP نام خواهد داشت\&. به‌طور پیش‌فرض، این کار در حالت بومی یک خطا محسوب می‌شود\&. توجه داشته باشید که قرار دادن هر بخش از نام تابع در نقل‌قول، یا استفاده از کلیدواژهٔ \fBfunction\fP، از این مشکل جلوگیری می‌کند، بنابراین زمانی که نام تابع می‌تواند یک نام مستعار نیز باشد، استفاده از آن توصیه می‌شود\&.
.RE
.TP
\fBC_BASES\fP
اعداد هگزادسیمال را در قالب استاندارد C خروجی می‌دهد، برای نمونه «\fB0xFF\fP\&» به جای حالت معمول «\fB16#FF\fP\&»\&. اگر گزینهٔ \fBOCTAL_ZEROES\fP نیز تنظیم شده باشد (که به‌طور پیش‌فرض نیست)، با اعداد هشت‌هشتی (اکتال) نیز به همین صورت برخورد می‌شود و از این رو به جای «\fB8#77\fP» به صورت «\fB077\fP\&» ظاهر می‌شوند\&. این گزینه بر انتخاب مبنای خروجی و همچنین بر خروجی مبناهایی غیر از هگزادسیمال و اکتال هیچ اثری ندارد\&. توجه داشته باشید که این قالب‌ها در ورودی، صرف‌نظر از تنظیم \fBC_BASES\fP، درک خواهند شد\&.
.TP
\fBC_PRECEDENCES\fP
اولویت عملگرهای محاسباتی را تغییر می‌دهد تا بیشتر شبیه به زبان C و سایر زبان‌های برنامه‌نویسی باشد؛
بخش ARITHMETIC EVALUATION در \fIzshmisc\fP(1)
فهرستی صریح از آن‌ها را در بر دارد\&.
.TP
\fBDEBUG_BEFORE_CMD\fP <D>
تلهٔ \fBDEBUG\fP را پیش از هر دستور اجرا می‌کند؛ در غیر این صورت پس از هر دستور اجرا می‌شود\&. تنظیم این گزینه رفتار ksh 93 را شبیه‌سازی می‌کند؛ با غیرفعال بودن این گزینه رفتار شبیه به ksh 88 خواهد بود\&.
.TP
\fBERR_EXIT\fP (\fB\-e\fP, ksh: \fB\-e\fP)
اگر دستوری وضعیت خروج غیرصفر داشته باشد، در صورت تنظیم، تلهٔ \fBZERR\fP را اجرا کرده و خارج می‌شود\&. این قابلیت در حین اجرای اسکریپت‌های مقداردهی اولیه غیرفعال است\&.
.RS
.PP
این رفتار در داخل تله‌های \fBDEBUG\fP نیز غیرفعال است\&. در این حالت با این گزینه به طور ویژه رفتار می‌شود: هنگام ورود به تله غیرفعال می‌شود\&. اگر گزینهٔ \fBDEBUG_BEFORE_CMD\fP تنظیم شده باشد (که به طور پیش‌فرض چنین است) و مشخص شود که گزینهٔ \fBERR_EXIT\fP هنگام خروج تنظیم شده است، آن‌گاه از دستوری که تلهٔ \fBDEBUG\fP برای آن اجرا می‌شود صرف‌نظر می‌گردد\&. این گزینه پس از خروج از تله به حالت اولیه بازگردانده می‌شود\&.
.PP
وضعیت غیرصفر در یک فهرست دستور شامل \fB&&\fP یا \fB||\fP برای دستوراتی که در انتهای فهرست نیستند نادیده گرفته می‌شود\&. از این رو
.PP
.RS
.nf
\fBfalse && true\fP
.fi
.RE
.PP
موجب خروج نمی‌شود\&.
.PP
خروج به دلیل \fBERR_EXIT\fP اثرات متقابل خاصی با کارهای ناهمگام (asynchronous jobs) دارد که در
بخش JOBS در \fIzshmisc\fP(1) قید شده است\&.
.RE
.TP
\fBERR_RETURN\fP
اگر دستوری وضعیت خروج غیرصفر داشته باشد، بی‌درنگ از تابع دربرگیرنده بازمی‌گردد\&. منطق آن مشابه \fBERR_EXIT\fP است، با این تفاوت که به جای \fBexit\fP، یک عبارت \fBreturn\fP ضمنی اجرا می‌شود\&. این در بیرونی‌ترین سطح یک اسکریپت غیرتعاملی، موجب خروج خواهد شد\&.
.RS
.PP
به‌طور معمول این گزینه رفتار \fBERR_EXIT\fP را به ارث می‌برد که در آن کدی که در ادامهٔ آن «\fB&&\fP\&» یا «\fB||\fP» بیاید، بازگشتی ایجاد نمی‌کند\&. بنابراین در عبارت زیر:
.PP
.RS
.nf
\fBsummit || true\fP
.fi
.RE
.PP
هیچ بازگشتی تحمیل نمی‌شود چرا که اثر ترکیبی همواره دارای وضعیت بازگشت صفر است\&.
.PP
با این حال، توجه داشته باشید که اگر \fBsummit\fP در مثال بالا خود یک تابع باشد، کد درون آن به طور جداگانه در نظر گرفته می‌شود: ممکن است باعث بازگشت از \fBsummit\fP شود (با فرض اینکه گزینه درون \fBsummit\fP فعال بماند)، اما نه از زمینهٔ دربرگیرنده\&. این رفتار با \fBERR_EXIT\fP که تحت تأثیر حوزهٔ توابع قرار نمی‌گیرد، تفاوت دارد\&.
.RE
.TP
\fBEVAL_LINENO\fP <Z>
در صورت تنظیم، شماره خطوط عبارت‌های ارزیابی‌شده با دستور توکار \fBeval\fP جدا از محیط دربرگیرنده پیگیری می‌شوند\&. این هم برای پارامتر \fBLINENO\fP و هم برای شماره خط خروجی توسط نویسهٔ گریز اعلان \fB%i\fP صدق می‌کند\&. اگر این گزینه تنظیم شده باشد، نویسهٔ گریز اعلان \fB%N\fP به عنوان نشانگر، رشتهٔ «\fB(eval)\fP\&» را به جای نام اسکریپت یا تابع خروجی می‌دهد\&. (این دو نویسهٔ گریز اعلان معمولاً در پارامتر \fBPS4\fP برای نمایش در خروجی هنگام فعال بودن گزینهٔ \fBXTRACE\fP استفاده می‌شوند\&.) اگر \fBEVAL_LINENO\fP غیرفعال باشد، شماره خط اسکریپت یا تابع پیرامون در حین ارزیابی حفظ می‌شود\&.
.TP
\fBEXEC\fP (\fB+n\fP, ksh: \fB+n\fP) <D>
دستورات را اجرا کن\&. بدون این گزینه، دستورات خوانده شده و از نظر خطاهای نحوی بررسی می‌شوند، اما اجرا نمی‌شوند\&. این گزینه را نمی‌توان در یک شل تعاملی خاموش کرد، مگر اینکه «\fB\-n\fP\&» هنگام راه‌اندازی به شل داده شده باشد\&.
.TP
\fBFUNCTION_ARGZERO\fP <C> <Z>
هنگام اجرای یک تابع شل یا سورس کردن یک اسکریپت، \fB$0\fP را موقتاً روی نام تابع/اسکریپت تنظیم می‌کند\&. توجه داشته باشید که تغییر وضعیت \fBFUNCTION_ARGZERO\fP از روشن به خاموش (یا از خاموش به روشن) مقدار فعلی \fB$0\fP را تغییر نمی‌دهد\&. تنها وضعیت موجود در زمان ورود به تابع یا اسکریپت تأثیرگذار است\&. مقایسه کنید با \fBPOSIX_ARGZERO\fP\&..TP
\fBLOCAL_LOOPS\fP
وقتی این گزینه تنظیم نشده باشد، اثر دستورهای \fBbreak\fP و \fBcontinue\fP ممکن است به خارج از حوزهٔ تابع سرایت کند و بر حلقه‌ها در توابع فراخواننده تأثیر بگذارد\&. هنگامی که این گزینه در یک تابع فراخواننده تنظیم شده باشد، دستور \fBbreak\fP یا \fBcontinue\fP که درون تابع فراخوانده‌شده مهار نشده باشد (صرف‌نظر از تنظیمات این گزینه در آن تابع)، هشداری تولید می‌کند و اثر آن لغو می‌شود\&.
.TP
\fBLOCAL_OPTIONS\fP <K>
اگر این گزینه در زمان بازگشت از یک تابع پوسته تنظیم شده باشد، بیشتر گزینه‌ها (از جمله خود این گزینه) که هنگام ورود به تابع فعال بودند، بازیابی می‌شوند؛ گزینه‌هایی که بازیابی نمی‌شوند \fBPRIVILEGED\fP و \fBRESTRICTED\fP هستند\&. در غیر این صورت، تنها این گزینه و گزینه‌های \fBLOCAL_LOOPS\fP، \fBXTRACE\fP و \fBPRINT_EXIT_VALUE\fP بازیابی می‌شوند\&. بنابراین اگر این گزینه به‌طور صریح توسط یک تابع پوسته غیرفعال شود، سایر گزینه‌های فعال در هنگام بازگشت به همان صورت باقی خواهند ماند\&.
یک تابع پوسته همچنین می‌تواند با ساختاری مانند `\fBemulate \-L zsh\fP\&'، یک پیکربندی مشخص از پوسته را برای خود تضمین کند؛ گزینهٔ \fB\-L\fP گزینهٔ \fBLOCAL_OPTIONS\fP را فعال می‌کند\&.
.TP
\fBLOCAL_PATTERNS\fP
اگر این گزینه در زمان بازگشت از یک تابع پوسته تنظیم شده باشد، وضعیت الگوهای غیرفعال‌شده، همان‌طور که با دستور داخلی `\fBdisable \-p\fP\&' تنظیم شده بود، به وضعیتی که هنگام ورود به تابع وجود داشت بازگردانده می‌شود\&. رفتار این گزینه مشابه اثر \fBLOCAL_OPTIONS\fP بر روی گزینه‌ها است؛ بنابراین `\fBemulate \-L sh\fP\&' (یا در واقع هر شبیه‌سازی دیگری همراه با گزینهٔ \fB\-L\fP) گزینهٔ \fBLOCAL_PATTERNS\fP را فعال می‌کند\&.
.TP
\fBLOCAL_TRAPS\fP <K>
اگر این گزینه هنگام تنظیم تلهٔ سیگنال (signal trap) درون یک تابع تنظیم شده باشد، وضعیت پیشین تله برای آن سیگنال هنگام خروج از تابع بازیابی خواهد شد\&. توجه داشته باشید که این گزینه باید \fIپیش\fP از تغییر رفتار تله در یک تابع تنظیم شود؛ برخلاف \fBLOCAL_OPTIONS\fP، مقدار آن هنگام خروج از تابع اهمیتی ندارد\&. با این حال، نیازی نیست که پیش از هر تلهٔ سراسری تنظیم شود تا آن تله به درستی توسط یک تابع بازیابی گردد\&.
برای مثال،
.RS
.PP
.RS
.nf
\fBunsetopt localtraps
trap \- INT
fn() { setopt localtraps; trap \&'' INT; sleep 3; }\fP
.fi
.RE
.PP
پس از خروج از تابع، مدیریت عادی \fBSIGINT\fP را بازیابی خواهد کرد\&.
.RE
.TP
\fBMULTI_FUNC_DEF\fP <Z>
امکان تعریف هم‌زمان چند تابع را در قالب `\fBfn1 fn2\fP\fI\&.\&.\&.\fP\fB()\fP\&' فراهم می‌کند؛ اگر این گزینه تنظیم نشده باشد، این عمل موجب خطای تجزیه (parse error) می‌شود\&. تعریف چند تابع با کلمهٔ کلیدی \fBfunction\fP همواره مجاز است\&. تعاریف چندگانهٔ توابع چندان رایج نیستند و می‌توانند باعث خطاهای مبهم شوند\&.
.TP
\fBMULTIOS\fP <Z>
هنگامی که چندین تغییر مسیر (redirection) اعمال می‌شود، دستورهای \fBtee\fP یا \fBcat\fP ضمنی را اجرا می‌کند (به بخش `Redirection\&' مراجعه کنید)\&.
.TP
\fBOCTAL_ZEROES\fP <S>
مطابق با استاندارد IEEE Std 1003\&.2\-1992 (ISO 9945\-2:1993)، هر ثابت عدد صحیحی که با 0 شروع می‌شود را به عنوان مبنای هشت (octal) تفسیر می‌کند\&. این گزینه به‌طور پیش‌فرض فعال نیست، چرا که برای مثال در تجزیهٔ رشته‌های تاریخ و زمان دارای صفرهای آغازین، مشکلاتی ایجاد می‌کند\&.
.RS
.PP
دنباله‌ای از ارقام که نشان‌دهندهٔ مبنای عددی هستند، مانند مؤلفهٔ `\fB08\fP\&' در `\fB08#77\fP\&'، صرف‌نظر از صفرهای آغازین همواره به صورت ده‌دهی تفسیر می‌شوند\&.
.RE
.TP
\fBPIPE_FAIL\fP
به‌طور پیش‌فرض، هنگامی که یک خط لوله خاتمه می‌یابد، وضعیت خروجی ثبت‌شده توسط پوسته و بازگردانده‌شده توسط متغیر پوستهٔ \fB$?\fP بازتاب‌دهندهٔ وضعیت راست‌ترین مؤلفهٔ خط لوله است\&. در صورت تنظیم این گزینه، وضعیت خروج در عوض نمایانگر وضعیت راست‌ترین مؤلفهٔ خط لوله است که غیرصفر بوده، یا اگر تمام مؤلفه‌ها با وضعیت صفر خارج شوند، صفر خواهد بود\&.
.TP
\fBSOURCE_TRACE\fP
در صورت تنظیم بودن، zsh با چاپ پیامی اطلاعاتی، نام هر فایلی را که بارگذاری می‌کند اعلام می‌نماید\&. قالب خروجی مشابه گزینهٔ \fBXTRACE\fP همراه با پیام \fB<sourcetrace>\fP است\&. یک فایل ممکن است توسط خود پوسته هنگام شروع به کار و خاموش شدن آن (\fBStartup/Shutdown Files\fP) یا با استفاده از دستورهای داخلی `\fBsource\fP\&' و `\fBdot\fP' بارگذاری شود\&.
.TP
\fBTYPESET_SILENT\fP
اگر این گزینه غیرفعال باشد، اجرای هر یک از دستورهای خانوادهٔ `\fBtypeset\fP\&' بدون هیچ گزینه‌ای و همراه با فهرستی از پارامترهایی که مقداری برای تخصیص ندارند اما از قبل وجود دارند، مقدار پارامتر را نمایش می‌دهد\&. اگر این گزینه تنظیم شده باشد، آن‌ها تنها زمانی نشان داده می‌شوند که پارامترها با گزینهٔ `\fB\-m\fP\&' انتخاب شده باشند\&. گزینهٔ `\fB\-p\fP' صرف‌نظر از تنظیم بودن یا نبودن این گزینه، در دسترس است\&.
.TP
\fBTYPESET_TO_UNSET\fP <K> <S>
هنگام اعلان یک پارامتر جدید با هر یک از دستورهای مرتبط با خانوادهٔ `\fBtypeset\fP\&'، پارامتر تنظیم‌نشده (unset) باقی می‌ماند مگر اینکه و تا زمانی که مقداری به‌طور صریح به آن اختصاص داده شود، چه در خود دستور `\fBtypeset\fP\&' و چه در عبارت‌های انتساب بعدی\&.
.TP
\fBVERBOSE\fP (\fB\-v\fP, ksh: \fB\-v\fP)
خطوط ورودی پوسته را به محض خوانده شدن چاپ می‌کند\&.
.TP
\fBXTRACE\fP (\fB\-x\fP, ksh: \fB\-x\fP)
دستورها و آرگومان‌های آن‌ها را هنگام اجرا چاپ می‌کند\&. در ابتدای خروجی، مقدار \fB$PS4\fP قرار می‌گیرد که طبق توضیحات بخش EXPANSION OF PROMPT SEQUENCES در \fIzshmisc\fP(1) قالب‌بندی شده است\&.
.PP.SS "شبیه‌سازی پوسته (Shell Emulation)"
.PD 0
.TP
.PD
\fBAPPEND_CREATE\fP <K> <S>
این گزینه تنها زمانی اعمال می‌شود که \fBNO_CLOBBER\fP (\-\fBC\fP) فعال باشد\&.
.RS
.PP
اگر این گزینه تنظیم نشده باشد، پوسته هنگام استفاده از تغییر مسیر الحاقی (\fB>>\fP) روی فایلی که از پیش وجود ندارد، خطا گزارش می‌کند (رفتار سنتی zsh برای \fBNO_CLOBBER\fP)\&. اگر گزینه تنظیم شده باشد، هیچ خطایی گزارش نمی‌شود (رفتار POSIX)\&.
.RE
.TP
\fBBASH_REMATCH\fP
هنگامی که فعال باشد، تطابق‌های انجام‌شده با عملگر \fB=~\fP به جای متغیرهای پیش‌فرض \fBMATCH\fP و \fBmatch\fP، متغیر آرایه‌ای \fBBASH_REMATCH\fP را مقداردهی می‌کنند\&. نخستین عنصر آرایهٔ \fBBASH_REMATCH\fP شامل کل متن منطبق‌شده خواهد بود و عنصرهای بعدی شامل زیررشته‌های استخراج‌شده خواهند بود\&. این گزینه زمانی مفهوم بیشتری پیدا می‌کند که \fBKSH_ARRAYS\fP نیز تنظیم شده باشد، به‌طوری که کل بخش منطبق‌شده در نمایهٔ 0 ذخیره شود و نخستین زیررشته در نمایهٔ 1 قرار گیرد\&. بدون این گزینه، متغیر \fBMATCH\fP شامل کل متن منطبق‌شده و متغیر آرایه‌ای \fBmatch\fP شامل زیررشته‌ها خواهد بود\&.
.TP
\fBBSD_ECHO\fP <S>
فرمان توکار \fBecho\fP را با فرمان \fIecho\fP(1) در BSD سازگار می‌کند\&. این کار دنباله‌های گریز با ممیز وارونه (backslash) را در رشته‌های echo غیرفعال می‌کند مگر اینکه گزینهٔ \fB\-e\fP مشخص شده باشد\&.
.TP
\fBCONTINUE_ON_ERROR\fP
اگر یک خطای مهلک رخ دهد (بخش ERRORS در \fIzshmisc\fP(1) را ببینید)، و کد در یک اسکریپت در حال اجرا باشد، پوسته اجرای خود را از دستور بعدی در بالاترین سطح اسکریپت از سر می‌گیرد؛ به عبارت دیگر بیرون از تمام توابع یا ساختارهای پوسته مانند حلقه‌ها و شرط‌ها\&. این ویژگی رفتار پوسته‌های تعاملی را شبیه‌سازی می‌کند، جایی که پوسته برای خواندن فرمانی جدید به ویرایشگر خط بازمی‌گردد؛ این رفتار عادی نسخه‌های zsh پیش از 5\&.0\&.1 بود\&.
.TP
\fBCSH_JUNKIE_HISTORY\fP <C>
یک ارجاع تاریخچه بدون مشخص‌کنندهٔ رویداد، همیشه به فرمان پیشین اشاره خواهد کرد\&. بدون این گزینه، چنین ارجاعی در تاریخچه به همان رویدادی اشاره می‌کند که ارجاع پیشین تاریخچه در خط فرمان جاری اشاره کرده است، و به‌طور پیش‌فرض به فرمان قبلی برمی‌گردد\&.
.TP
\fBCSH_JUNKIE_LOOPS\fP <C>
اجازه می‌دهد بدنهٔ حلقه‌ها به جای `\fBdo \fP\fIlist\fP\fB; done\fP\&' به شکل `\fIlist\fP\fB; end\fP\&' باشد\&.
.TP
\fBCSH_JUNKIE_QUOTES\fP <C>
قواعد مربوط به متن‌های نقل‌قول‌شدهٔ تکی و دوتایی (single- و double-quoted) را تغییر می‌دهد تا با \fBcsh\fP مطابقت داشته باشد\&. این قواعد ایجاب می‌کنند که خطوط جدید درج‌شده با یک ممیز وارونه (backslash) همراه باشند؛ خطوط جدید بدون گریز باعث ایجاد پیام خطا می‌شوند\&. در رشته‌های نقل‌قول دوگانه، فرار دادن (escape) `\fB$\fP\&'، `\fB`\fP' یا `\fB"\fP\&' غیرممکن می‌شود (و خود `\fB\e\fP' دیگر نیازی به گریز ندارد)\&. جایگزینی‌های فرمان فقط یک بار بسط داده می‌شوند و نمی‌توانند تودرتو باشند\&.
.TP
\fBCSH_NULLCMD\fP <C>
هنگام اجرای تغییر مسیرهای بدون فرمان، از مقادیر \fBNULLCMD\fP و \fBREADNULLCMD\fP استفاده نمی‌کند\&. این کار باعث شکست خوردن چنین تغییر مسیرهایی می‌شود (بخش `Redirection\&' را ببینید)\&.
.TP
\fBKSH_ARRAYS\fP <K> <S>
مدیریت آرایه در \fBksh\fP را تا حد امکان دقیق شبیه‌سازی می‌کند\&. اگر این گزینه تنظیم شود، شماره‌گذاری عنصرهای آرایه از صفر آغاز می‌شود، یک پارامتر آرایه‌ای بدون زیرنویس به جای کل آرایه به عنصر اول اشاره می‌کند، و برای تعیین زیرنویس (`\fB${path[2]}\fP\&' به جای `\fB$path[2]\fP\&') یا اعمال اصلاح‌کننده‌ها روی هر پارامتری (`\fB${PWD:h}\fP\&' به جای `\fB$PWD:h\fP') استفاده از آکولاد الزامی است\&.
.TP
\fBKSH_AUTOLOAD\fP <K> <S>
بارگذاری خودکار توابع را به سبک \fBksh\fP شبیه‌سازی می‌کند\&. بدین معنا که وقتی تابعی به‌طور خودکار بارگذاری می‌شود، فایل مربوطه صرفاً اجرا می‌شود و باید خود تابع را تعریف کند\&. (به‌طور پیش‌فرض، تابع به محتویات فایل تعریف می‌شود\&. با این حال، متداول‌ترین حالت سبک \fBksh\fP \- که فایل تنها شامل یک تعریف ساده از تابع است \- همیشه به شیوهٔ سازگار با \fBksh\fP مدیریت می‌شود\&.)
.TP
\fBKSH_OPTION_PRINT\fP <K>
شیوهٔ چاپ وضعیت گزینه‌ها را تغییر می‌دهد: به جای فهرست‌های جداگانه از گزینه‌های فعال و غیرفعال، تمام گزینه‌ها نشان داده می‌شوند؛ اگر در وضعیت غیرپیش‌فرض باشند با `on\&' و در غیر این صورت با `off\&' مشخص می‌گردند\&.
.TP
\fBKSH_TYPESET\fP
این گزینه اکنون منسوخ شده است: تقریب بهتری از رفتار دیگر پوسته‌ها با رابط کلمات رزروشده برای \fBdeclare\fP، \fBexport\fP، \fBfloat\fP، \fBinteger\fP، \fBlocal\fP، \fBreadonly\fP و \fBtypeset\fP حاصل می‌شود\&. توجه داشته باشید این گزینه تنها زمانی اعمال می‌شود که رابط کلمات رزروشده در حال استفاده \fIنباشد\fP\&.
.RS
.PP
شیوهٔ پردازش آرگومان‌های خانوادهٔ فرمان‌های \fBtypeset\fP، از جمله \fBdeclare\fP، \fBexport\fP، \fBfloat\fP، \fBinteger\fP، \fBlocal\fP و \fBreadonly\fP را تغییر می‌دهد\&. بدون این گزینه، zsh پس از بسط فرمان و پارامتر در آرگومان‌های یک انتساب، تفکیک کلمات عادی را انجام می‌دهد؛ با فعال بودن آن، تفکیک کلمات در این موارد رخ نمی‌دهد\&.
.RE
.TP
\fBKSH_ZERO_SUBSCRIPT\fP
استفاده از زیرنویس با مقدار صفر در عبارت‌های آرایه یا رشته را به عنوان ارجاع به نخستین عنصر در نظر می‌گیرد، یعنی عنصری که معمولاً زیرنویس 1 دارد\&. اگر \fBKSH_ARRAYS\fP نیز تنظیم شده باشد، نادیده گرفته می‌شود\&.
.RS
.PP
اگر نه این گزینه و نه \fBKSH_ARRAYS\fP تنظیم نشده باشند، دسترسی به یک عنصر از آرایه یا رشته با زیرنویس صفر یک عنصر یا رشتهٔ خالی برمی‌گرداند، در حالی که تلاش برای مقداردهی به عنصر صفر یک آرایه یا رشته به عنوان خطا در نظر گرفته می‌شود\&. با این حال، تلاش برای مقداردهی به یک بازهٔ معتبر از زیرنویس که شامل صفر باشد موفقیت‌آمیز خواهد بود\&. به عنوان مثال، اگر \fBKSH_ZERO_SUBSCRIPT\fP تنظیم نشده باشد،
.PP
.RS
.nf
\fBarray[0]=(element)\fP
.fi
.RE
.PP
یک خطا است، در حالی که
.PP
.RS
.nf
\fBarray[0,1]=(element)\fP
.fi
.RE
.PP
خطا نیست و نخستین عنصر آرایه را جایگزین خواهد کرد\&.
.PP
این گزینه برای سازگاری با نسخه‌های قدیمی‌تر پوسته است و استفاده از آن در کدهای جدید توصیه نمی‌شود\&.
.RE
.TP
\fBPOSIX_ALIASES\fP <K> <S>
هنگامی که این گزینه تنظیم شده باشد، کلمات رزروشده کاندیدای بسط نام مستعار نیستند: هنوز هم می‌توان هر یک از آن‌ها را به عنوان یک نام مستعار تعریف کرد، اما آن نام مستعار هرگز بسط داده نخواهد شد\&. کلمات رزروشده در بخش RESERVED WORDS در \fIzshmisc\fP(1) شرح داده شده‌اند\&.
.RS
.PP
بسط نام مستعار در حین خوانده شدن متن رخ می‌دهد؛ بنابراین هنگامی که این گزینه تنظیم می‌شود، اثر آن تا پایان هر تابع یا هر بخش دیگری از کد پوسته که به عنوان یک واحد تجزیه می‌شود اعمال نخواهد شد\&. توجه داشته باشید این موضوع ممکن است حتی در زمان فعال بودن گزینه باعث تفاوت‌هایی با سایر پوسته‌ها شود\&. برای مثال، هنگام اجرای یک فرمان با `\fBzsh \-c\fP\&'، یا حتی `\fBzsh \-o posixaliases \-c\fP\&'، کل آرگومان فرمان به عنوان یک واحد تجزیه می‌شود، بنابراین نام‌های مستعار تعریف‌شده در داخل این آرگومان حتی در خطوط بعدی نیز در دسترس نیستند\&. در صورت تردید، از به‌کارگیری نام‌های مستعار در کدهای غیرتعاملی خودداری کنید\&.
.RE
.TP
\fBPOSIX_ARGZERO\fP
این گزینه می‌تواند برای غیرفعال کردن موقت \fBFUNCTION_ARGZERO\fP و در نتیجه بازیابی مقدار \fB$0\fP به نام استفاده‌شده برای فراخوانی پوسته (یا آن‌طور که توسط گزینهٔ خط فرمان \fB\-c\fP تنظیم شده است) استفاده شود\&. برای سازگاری با نسخه‌های پیشین پوسته، شبیه‌سازها به جای \fBPOSIX_ARGZERO\fP از \fBNO_FUNCTION_ARGZERO\fP استفاده می‌کنند، که در صورت تغییر حالت شبیه‌سازی درون یک تابع یا اسکریپت، ممکن است به حوزهٔ دید (scoping) غیرمنتظره‌ای برای \fB$0\fP منجر شود\&. برای پیشگیری از این موضوع، \fBPOSIX_ARGZERO\fP را به‌طور صریح در فرمان \fBemulate\fP فعال کنید:
.RS
.PP
.RS
.nf
\fBemulate sh \-o POSIX_ARGZERO\fP
.fi
.RE
.PP
توجه داشته باشید که \fBNO_POSIX_ARGZERO\fP هیچ اثری ندارد مگر اینکه \fBFUNCTION_ARGZERO\fP از پیش در هنگام ورود به تابع یا اسکریپت فعال بوده باشد\&.
.RE
.TP
\fBPOSIX_BUILTINS\fP <K> <S>
هنگامی که این گزینه تنظیم شده باشد، فرمان توکار \fBcommand\fP می‌تواند برای اجرای فرمان‌های توکار پوسته استفاده شود\&. انتساب‌های پارامتر که پیش از توابع پوسته و توکارهای ویژه مشخص شده‌اند پس از پایان اجرای فرمان حفظ می‌شوند، مگر اینکه پیش از توکار ویژه فرمان توکار \fBcommand\fP درج شده باشد\&. توکارهای ویژه عبارتند از:
\fB\&.\fP،
\fB:\fP،
\fBbreak\fP،
\fBcontinue\fP،
\fBdeclare\fP،
\fBeval\fP،
\fBexit\fP،
\fBexport\fP،
\fBinteger\fP،
\fBlocal\fP،
\fBreadonly\fP،
\fBreturn\fP،
\fBset\fP،
\fBshift\fP،
\fBsource\fP،
\fBtimes\fP،
\fBtrap\fP و
\fBunset\fP\&.
.RS.PP
علاوه بر این، شرایط خطای گوناگون مرتبط با دستورهای داخلی فوق یا \fBexec\fP باعث خروج یک پوسته غیرتعاملی و بازگشت یک پوسته تعاملی به پردازش سطح بالای خود می‌شوند\&.
.PP
افزون بر این، توابع و دستورهای داخلی پوسته پس از پیشوند \fBexec\fP اجرا نمی‌شوند؛ دستور مورد نظر برای اجرا باید یک دستور خارجی باشد که در مسیر (path) یافت می‌شود\&.
.PP
همچنین، دستور داخلی \fBgetopts\fP به شیوه‌ای سازگار با POSIX عمل می‌کند، بدین صورت که متغیر مرتبط \fBOPTIND\fP برای توابع محلی نمی‌شود و مقدار آن به شکلی متفاوت محاسبه می‌گردد تا با سایر پوسته‌ها مطابقت داشته باشد\&.
.PP
علاوه بر این، هشدار و کد خروج ویژه از
\fB[[ \-o \fP\fInon_existent_option\fP\fB ]]\fP نادیده گرفته می‌شوند\&.
.RE
.TP
\fBPOSIX_IDENTIFIERS\fP <K> <S>
هنگامی که این گزینه تنظیم شده باشد، تنها کاراکترهای اسکی \fBa\fP تا \fBz\fP، \fBA\fP تا
\fBZ\fP، \fB0\fP تا \fB9\fP و \fB_\fP می‌توانند در شناسه‌ها (نام‌های
پارامترها و ماژول‌های پوسته) استفاده شوند\&.
.RS
.PP
علاوه بر این، تنظیم این گزینه اثر جایگزینی پارامتر بدون آکولاد را محدود می‌کند، به طوری که عبارت \fB$#\fP به عنوان
پارامتر \fB$#\fP در نظر گرفته می‌شود حتی اگر پس از آن یک نام پارامتر معتبر بیاید\&.
هنگامی که این گزینه غیرفعال باشد، zsh اجازه می‌دهد عباراتی به شکل \fB$#\fP\fIname\fP
به طول \fB$\fP\fIname\fP ارجاع دهند، حتی برای متغیرهای خاص،
برای نمونه در عباراتی مانند \fB$#\-\fP و \fB$#*\fP\&.
.PP
تفاوت دیگر این است که با تنظیم این گزینه، انتساب به یک
متغیر تنظیم‌نشده در بافت محاسباتی باعث می‌شود که متغیر به جای یک نوع عددی،
به صورت یک نوع اسکالر ایجاد شود\&. بنابراین پس از `\fBunset t; (( t = 3
))\fP\&'\&.، بدون تنظیم بودن \fBPOSIX_IDENTIFIERS\fP متغیر \fBt\fP دارای نوع عدد صحیح است، در حالی که با
تنظیم بودن آن دارای نوع اسکالر خواهد بود\&.
.PP
هنگامی که این گزینه غیرفعال است و پشتیبانی از کاراکترهای چندبایتی فعال باشد (یعنی در پوسته کامپایل شده باشد و گزینه \fBMULTIBYTE\fP تنظیم شده باشد)، علاوه بر این هر کاراکتر
حرفی-عددی در مجموعه کاراکترهای محلی می‌تواند در شناسه‌ها استفاده شود\&. توجه داشته باشید که اسکریپت‌ها و توابع نوشته‌شده با این ویژگی
سازگار و قابل حمل نیستند، و همچنین هر دو گزینه باید پیش از تجزیه شدن اسکریپت
یا تابع تنظیم شوند؛ تنظیم آن‌ها در طول اجرا کافی نیست
زیرا ساختار دستوری \fIvariable\fP\fB=\fP\fIvalue\fP از پیش به جای یک انتساب، به عنوان
یک دستور تجزیه شده است\&.
.PP
اگر پشتیبانی از کاراکترهای چندبایتی در پوسته کامپایل نشده باشد این گزینه نادیده گرفته می‌شود؛ تمام بایت‌هایی که بیت بالایی آن‌ها تنظیم شده است می‌توانند در شناسه‌ها استفاده شوند\&.
این رفتار غیراستاندارد است اما رفتار سنتی zsh محسوب می‌شود\&.
.RE
.TP
\fBPOSIX_STRINGS\fP <K> <S>
این گزینه بر پردازش رشته‌های داخل نقل‌قول تأثیر می‌گذارد\&. در حال حاضر تنها
بر رفتار کاراکترهای null، یعنی کاراکتر 0 در مجموعه کاراکترهای قابل‌حمل متناظر با US ASCII اثر می‌گذارد\&.
.RS
.PP
هنگامی که این گزینه تنظیم نشده باشد، کاراکترهای null جاسازی‌شده در رشته‌هایی
به شکل \fB$\&'\fP\fI\&.\&.\&.\fP\fB'\fP مانند کاراکترهای معمولی در نظر گرفته می‌شوند\&. تمام
رشته در داخل پوسته نگهداری شده و در صورت لزوم در فایل‌ها خروجی داده می‌شود، اگرچه به دلیل محدودیت‌های رابط کتابخانه‌ای،
رشته در نام فایل‌ها، متغیرهای محیطی یا آرگومان‌های برنامه‌های خارجی در محل کاراکتر null بریده می‌شود\&.
.PP
هنگامی که این گزینه تنظیم شده باشد، عبارت \fB$\&'\fP\fI\&.\&.\&.\fP\fB'\fP در کاراکتر
null بریده می‌شود\&. توجه داشته باشید که بخش‌های باقی‌مانده از همان رشته
فراتر از پایان نقل‌قول‌ها بریده نمی‌شوند\&.
.PP
برای نمونه، آرگومان خط فرمان \fBa$\&'b\e0c'd\fP در صورت غیرفعال بودن
این گزینه به صورت کاراکترهای \fBa\fP، \fBb\fP، null، \fBc\fP، \fBd\fP،
و در صورت فعال بودن این گزینه به صورت کاراکترهای \fBa\fP، \fBb\fP، \fBd\fP در نظر گرفته می‌شود\&.
.RE
.TP
\fBPOSIX_TRAPS\fP <K> <S>
هنگامی که این گزینه تنظیم شده باشد، رفتار معمول zsh مبنی بر اجرای
تله‌ها برای \fBEXIT\fP هنگام خروج از توابع پوسته نادیده گرفته می‌شود\&.
در این حالت، دستکاری تله‌های \fBEXIT\fP همواره تله سراسری
برای خروج از پوسته را تغییر می‌دهد؛ گزینه \fBLOCAL_TRAPS\fP برای
تله \fBEXIT\fP نادیده گرفته می‌شود\&.
.RS
.PP
همچنین، دستور \fBreturn\fP اجراشده در یک تله بدون هیچ آرگومانی، مقدار را
از بافت پیرامونی و نه از کدهای اجراشده در درون تله، از تابع بازمی‌گرداند\&.
.PP
علاوه بر این، اگر تله‌ای طوری تنظیم شده باشد که نادیده گرفته شود، این وضعیت هنگام
ورود به یک زیرپوسته پابرجا می‌ماند\&. بدون این گزینه، تله در این نقطه به حالت
پیش‌فرض خود بازنشانی می‌شود\&.
.RE
.TP
\fBSH_FILE_EXPANSION\fP <K> <S>
بسط نام فایل (مانند بسط \fB~\fP) را \fIپیش از\fP
بسط پارامتر، جایگزینی دستور، بسط محاسباتی
و بسط آکولاد انجام می‌دهد\&.
اگر این گزینه غیرفعال باشد، این کار \fIپس از\fP
بسط آکولاد انجام می‌شود، به طوری که مواردی مانند `\fB~$USERNAME\fP\&' و
`\fB~{pfalstad,rc}\fP\&' کار خواهند کرد\&.
.TP
\fBSH_NULLCMD\fP <K> <S>
هنگام انجام بازهدایت‌ها از مقادیر \fBNULLCMD\fP و \fBREADNULLCMD\fP
استفاده نکنید، به جای آن از `\fB:\fP\&' استفاده کنید (بخش «Redirection» را ببینید)\&.
.TP
\fBSH_OPTION_LETTERS\fP <K> <S>
اگر این گزینه تنظیم شود، پوسته تلاش می‌کند گزینه‌های تک‌حرفی را
(که با \fBset\fP و \fBsetopt\fP به کار می‌روند) همانند \fBksh\fP تفسیر کند\&.
این امر همچنین بر مقدار پارامتر ویژه \fB\-\fP تأثیر می‌گذارد\&.
.TP
\fBSH_WORD_SPLIT\fP (\fB\-y\fP) <K> <S>
باعث می‌شود تفکیک فیلد روی بسط‌های پارامتر بدون نقل‌قول انجام شود\&.
توجه داشته باشید که این گزینه ارتباطی با تفکیک کلمه ندارد\&.
(نگاه کنید به
\fIzshexpn\fP(1)\&.)
.TP
\fBTRAPS_ASYNC\fP
هنگام انتظار برای خروج یک برنامه، سیگنال‌ها را رسیدگی کرده و تله‌ها را
بی‌درنگ اجرا می‌کند\&. در غیر این صورت تله پس از خروج یک فرآیند فرزند اجرا می‌شود\&.
توجه داشته باشید که این گزینه نقطه اجرای تله‌ها را برای هر حالتی به جز
زمانی که پوسته در انتظار یک فرآیند فرزند است، تحت تأثیر قرار نمی‌دهد\&.
.PP.SS "وضعیت پوسته (Shell State)"
.PD 0
.TP
.PD
\fBINTERACTIVE\fP (\fB\-i\fP, ksh: \fB\-i\fP)
این یک پوستهٔ تعاملی است\&. این گزینه در هنگام راه‌اندازی اولیه در صورتی تنظیم می‌شود که ورودی استاندارد یک tty باشد و دستورها از ورودی استاندارد خوانده شوند\&.
(به بخش مربوط به \fBSHIN_STDIN\fP مراجعه کنید\&.)
این سازوکار تشخیصی را می‌توان با تعیین وضعیتی برای این گزینه در خط فرمان نادیده گرفت\&.
مقدار این گزینه تنها از طریق پرچم‌های ارائه‌شده هنگام فراخوانی پوسته قابل تغییر است\&.
پس از اجرای zsh، تغییر آن امکان‌پذیر نیست\&.
.TP
\fBLOGIN\fP (\fB\-l\fP, ksh: \fB\-l\fP)
این یک پوستهٔ ورود (login shell) است\&.
اگر این گزینه به طور صریح تنظیم نشده باشد، در صورتی که نخستین نویسهٔ \fBargv[0]\fP ارسال‌شده به پوسته یک «\fB\-\fP» باشد، پوسته به یک پوستهٔ ورود تبدیل می‌شود\&.
.TP
\fBPRIVILEGED\fP (\fB\-p\fP, ksh: \fB\-p\fP)
حالت ممتاز (privileged mode) را فعال می‌کند\&. این گزینه معمولاً زمانی استفاده می‌شود که قرار است اسکریپت با امتیازات ارتقایافته اجرا شود\&. این کار باید مستقیماً با گزینهٔ \fB\-p\fP برای zsh به صورت زیر انجام گیرد تا در طول راه‌اندازی اعمال شود\&.
.RS
.PP
.RS
.nf
\fB#!/bin/zsh \-p\fP
.fi
.RE
.PP
این گزینه در هنگام راه‌اندازی در صورتی که شناسه کاربری (گروهی) مؤثر با شناسه کاربری (گروهی) واقعی برابر نباشد، به طور خودکار فعال می‌شود\&. در این حالت، غیرفعال کردن گزینه باعث می‌شود شناسه‌های کاربری و گروهی مؤثر بر روی شناسه‌های کاربری و گروهی واقعی تنظیم شوند\&. توجه داشته باشید که در صورت شکست این عملیات، ممکن است پوسته با شناسه‌هایی متفاوت از آنچه مورد نظر بوده اجرا شود؛ بنابراین یک اسکریپت باید شکست را بررسی کرده و بر اساس آن عمل کند، برای مثال:
.PP
.RS
.nf
\fBunsetopt privileged || exit\fP
.fi
.RE
.PP
گزینهٔ \fBPRIVILEGED\fP بارگذاری (source کردن) فایل‌های راه‌اندازی کاربر را غیرفعال می‌کند\&.
اگر zsh به عنوان «\fBsh\fP» یا «\fBksh\fP» با این گزینهٔ تنظیم‌شده فراخوانی شود، فایل \fB/etc/suid_profile\fP بارگذاری خواهد شد (در پوسته‌های تعاملی پس از \fB/etc/profile\fP)\&. بارگذاری \fB~/\&.profile\fP غیرفعال شده و محتوای متغیر \fBENV\fP نادیده گرفته می‌شود\&. این گزینه را نمی‌توان با استفاده از گزینهٔ \fB\-m\fP در \fBsetopt\fP و \fBunsetopt\fP تغییر داد، و تغییر آن در داخل یک تابع، صرف‌نظر از گزینهٔ \fBLOCAL_OPTIONS\fP، همیشه آن را به صورت سراسری تغییر می‌دهد\&.
.RE
.TP
\fBRESTRICTED\fP (\fB\-r\fP)
حالت محدود (restricted mode) را فعال می‌کند\&. این گزینه را نمی‌توان با استفاده از \fBunsetopt\fP تغییر داد، و تنظیم آن در داخل یک تابع، صرف‌نظر از گزینهٔ \fBLOCAL_OPTIONS\fP، همیشه آن را به صورت سراسری تغییر می‌دهد\&. بخش «Restricted Shell» را ببینید\&.
.TP
\fBSHIN_STDIN\fP (\fB\-s\fP, ksh: \fB\-s\fP)
دستورها از ورودی استاندارد خوانده می‌شوند\&.
اگر هیچ دستوری با \fB\-c\fP مشخص نشده باشد و هیچ فایلی از دستورها تعیین نگردد، دستورها از ورودی استاندارد خوانده می‌شوند\&. اگر \fBSHIN_STDIN\fP به طور صریح در خط فرمان تنظیم شود، هر آرگومانی که در غیر این صورت به عنوان فایلی برای اجرا در نظر گرفته می‌شد، به عنوان یک پارامتر مکانی (positional parameter) معمولی رفتار خواهد شد\&.
توجه داشته باشید که تنظیم یا لغو تنظیم این گزینه در خط فرمان لزوماً بر وضعیتی که این گزینه هنگام اجرای پوسته خواهد داشت تأثیر نمی‌گذارد \- این صرفاً نشان‌دهندهٔ آن است که آیا دستورها \fIواقعاً\fP از ورودی استاندارد خوانده می‌شوند یا خیر\&.
مقدار این گزینه تنها از طریق پرچم‌های ارائه‌شده هنگام فراخوانی پوسته قابل تغییر است\&.
پس از اجرای zsh، تغییر آن امکان‌پذیر نیست\&.
.TP
\fBSINGLE_COMMAND\fP (\fB\-t\fP, ksh: \fB\-t\fP)
اگر پوسته در حال خواندن از ورودی استاندارد باشد، پس از اجرای یک دستور منفرد خارج می‌شود\&. این کار همچنین پوسته را غیرتعاملی می‌کند، مگر اینکه گزینهٔ \fBINTERACTIVE\fP به طور صریح در خط فرمان تنظیم شده باشد\&.
مقدار این گزینه تنها از طریق پرچم‌های ارائه‌شده هنگام فراخوانی پوسته قابل تغییر است\&.
پس از اجرای zsh، تغییر آن امکان‌پذیر نیست\&.
.PP.SS "Zle"
.PD 0
.TP
.PD
\fBBEEP\fP (\fB+B\fP) <D>
پخش بوق هشدار هنگام بروز خطا در ZLE\&.
.TP
\fBCOMBINING_CHARS\fP
فرض می‌کند که ترمینال نویسه‌های ترکیبی را به‌درستی نمایش می‌دهد\&.
به‌طور مشخص، اگر پس از یک نویسهٔ الفبایی\-عددی پایه، یک یا چند نویسهٔ
نشانه‌گذاری با عرض صفر (zero\-width) بیاید، فرض می‌شود که نویسه‌های
با عرض صفر به‌صورت اصلاحاتی بر روی نویسهٔ پایه و در همان عرض نمایش
داده خواهند شد\&. همهٔ ترمینال‌ها این مورد را پشتیبانی نمی‌کنند\&. اگر این
گزینه تنظیم نشود، نویسه‌های با عرض صفر به‌طور جداگانه با نشانه‌گذاری
ویژه نمایش داده می‌شوند\&.
.RS
.PP
اگر این گزینه تنظیم شود، آزمون الگوی \fB[[:WORD:]]\fP با این فرض که
نویسهٔ نشانه‌گذاری با عرض صفر در ترکیب با یک نویسهٔ کلمه، به‌صورت بخشی
از یک کلمه استفاده خواهد شد، با آن مطابقت می‌یابد\&. در غیر این صورت،
پوستهٔ پایه نویسه‌های ترکیبی را به‌طور ویژه‌ای مدیریت نمی‌کند\&.
.RE
.TP
\fBEMACS\fP
اگر ZLE بارگذاری شده باشد، فعال کردن این گزینه اثری معادل
«\fBbindkey \-e\fP» خواهد داشت\&. علاوه بر این، گزینهٔ VI غیرفعال می‌شود\&.
غیرفعال کردن آن هیچ اثری ندارد\&. تضمینی نیست که وضعیت این گزینه
نگاشت کلید فعلی را منعکس کند\&. این گزینه صرفاً برای سازگاری
ارائه شده است؛ رابط توصیه‌شده \fBbindkey\fP است\&.
.TP
\fBOVERSTRIKE\fP
راه‌اندازی ویرایشگر خط در حالت جایگزینی (overstrike)\&.
.TP
\fBSINGLE_LINE_ZLE\fP (\fB\-M\fP) <K>
استفاده از ویرایش تک‌خطیِ خط فرمان به جای چندخطی\&.
.RS
.PP
توجه داشته باشید اگرچه این گزینه در شبیه‌سازی ksh به‌طور پیش‌فرض
فعال است، اما تنها سازگاری ظاهری با ویرایشگر خط ksh فراهم می‌کند
و کارایی ویرایشگر خط zsh را کاهش می‌دهد\&. از آنجا که این گزینه تاثیری
بر نحو پوسته ندارد، بسیاری از کاربران ممکن است مایل باشند هنگام استفادهٔ
تعاملی از شبیه‌سازی ksh، این گزینه را غیرفعال کنند\&.
.RE
.TP
\fBVI\fP
اگر ZLE بارگذاری شده باشد، فعال کردن این گزینه اثری معادل
«\fBbindkey \-v\fP» خواهد داشت\&. علاوه بر این، گزینهٔ EMACS غیرفعال می‌شود\&.
غیرفعال کردن آن هیچ اثری ندارد\&. تضمینی نیست که وضعیت این گزینه
نگاشت کلید فعلی را منعکس کند\&. این گزینه صرفاً برای سازگاری
ارائه شده است؛ رابط توصیه‌شده \fBbindkey\fP است\&.
.TP
\fBZLE\fP (\fB\-Z\fP)
استفاده از ویرایشگر خط zsh\&. به‌طور پیش‌فرض در پوسته‌های تعاملی متصل
به یک ترمینال فعال است\&.
.PP
.SH "نام‌های مستعار گزینه‌ها (OPTION ALIASES)"
برخی گزینه‌ها نام‌های جایگزین دارند\&. این نام‌های مستعار هرگز در خروجی
استفاده نمی‌شوند، اما می‌توان از آن‌ها همانند نام‌های عادی گزینه‌ها هنگام
مشخص کردن گزینه‌ها برای پوسته استفاده کرد\&.
.PP
.PD 0
.TP
.PD
\fBBRACE_EXPAND\fP
\fINO_\fP\fBIGNORE_BRACES\fP
(سازگاری با ksh و bash)
.TP
\fBDOT_GLOB\fP
\fBGLOB_DOTS\fP
(سازگاری با bash)
.TP
\fBHASH_ALL\fP
\fBHASH_CMDS\fP
(سازگاری با bash)
.TP
\fBHIST_APPEND\fP
\fBAPPEND_HISTORY\fP
(سازگاری با bash)
.TP
\fBHIST_EXPAND\fP
\fBBANG_HIST\fP
(سازگاری با bash)
.TP
\fBLOG\fP
\fINO_\fP\fBHIST_NO_FUNCTIONS\fP
(سازگاری با ksh)
.TP
\fBMAIL_WARN\fP
\fBMAIL_WARNING\fP
(سازگاری با bash)
.TP
\fBONE_CMD\fP
\fBSINGLE_COMMAND\fP
(سازگاری با bash)
.TP
\fBPHYSICAL\fP
\fBCHASE_LINKS\fP
(سازگاری با ksh و bash)
.TP
\fBPROMPT_VARS\fP
\fBPROMPT_SUBST\fP
(سازگاری با bash)
.TP
\fBSTDIN\fP
\fBSHIN_STDIN\fP
(سازگاری با ksh)
.TP
\fBTRACK_ALL\fP
\fBHASH_CMDS\fP
(سازگاری با ksh).SH "گزینه‌های تک‌حرفی (SINGLE LETTER OPTIONS)"
.SS "مجموعه پیش‌فرض (Default set)"
.PD 0
.TP
\fB\-0\fP
CORRECT
.TP
\fB\-1\fP
PRINT_EXIT_VALUE
.TP
\fB\-2\fP
\fINO_\fPBAD_PATTERN
.TP
\fB\-3\fP
\fINO_\fPNOMATCH
.TP
\fB\-4\fP
GLOB_DOTS
.TP
\fB\-5\fP
NOTIFY
.TP
\fB\-6\fP
BG_NICE
.TP
\fB\-7\fP
IGNORE_EOF
.TP
\fB\-8\fP
MARK_DIRS
.TP
\fB\-9\fP
AUTO_LIST
.TP
\fB\-B\fP
\fINO_\fPBEEP
.TP
\fB\-C\fP
\fINO_\fPCLOBBER
.TP
\fB\-D\fP
PUSHD_TO_HOME
.TP
\fB\-E\fP
PUSHD_SILENT
.TP
\fB\-F\fP
\fINO_\fPGLOB
.TP
\fB\-G\fP
NULL_GLOB
.TP
\fB\-H\fP
RM_STAR_SILENT
.TP
\fB\-I\fP
IGNORE_BRACES
.TP
\fB\-J\fP
AUTO_CD
.TP
\fB\-K\fP
\fINO_\fPBANG_HIST
.TP
\fB\-L\fP
SUN_KEYBOARD_HACK
.TP
\fB\-M\fP
SINGLE_LINE_ZLE
.TP
\fB\-N\fP
AUTO_PUSHD
.TP
\fB\-O\fP
CORRECT_ALL
.TP
\fB\-P\fP
RC_EXPAND_PARAM
.TP
\fB\-Q\fP
PATH_DIRS
.TP
\fB\-R\fP
LONG_LIST_JOBS
.TP
\fB\-S\fP
REC_EXACT
.TP
\fB\-T\fP
CDABLE_VARS
.TP
\fB\-U\fP
MAIL_WARNING
.TP
\fB\-V\fP
\fINO_\fPPROMPT_CR
.TP
\fB\-W\fP
AUTO_RESUME
.TP
\fB\-X\fP
LIST_TYPES
.TP
\fB\-Y\fP
MENU_COMPLETE
.TP
\fB\-Z\fP
ZLE
.TP
\fB\-a\fP
ALL_EXPORT
.TP
\fB\-e\fP
ERR_EXIT
.TP
\fB\-f\fP
\fINO_\fPRCS
.TP
\fB\-g\fP
HIST_IGNORE_SPACE
.TP
\fB\-h\fP
HIST_IGNORE_DUPS
.TP
\fB\-i\fP
INTERACTIVE
.TP
\fB\-k\fP
INTERACTIVE_COMMENTS
.TP
\fB\-l\fP
LOGIN
.TP
\fB\-m\fP
MONITOR
.TP
\fB\-n\fP
\fINO_\fPEXEC
.TP
\fB\-p\fP
PRIVILEGED
.TP
\fB\-r\fP
RESTRICTED
.TP
\fB\-s\fP
SHIN_STDIN
.TP
\fB\-t\fP
SINGLE_COMMAND
.TP
\fB\-u\fP
\fINO_\fPUNSET
.TP
\fB\-v\fP
VERBOSE
.TP
\fB\-w\fP
CHASE_LINKS
.TP
\fB\-x\fP
XTRACE
.TP
\fB\-y\fP
SH_WORD_SPLIT
.PD.SS "مجموعه شبیه‌سازی sh/ksh"
.PD 0
.TP
\fB\-C\fP
\fINO_\fPCLOBBER
.TP
\fB\-T\fP
TRAPS_ASYNC
.TP
\fB\-X\fP
MARK_DIRS
.TP
\fB\-a\fP
ALL_EXPORT
.TP
\fB\-b\fP
NOTIFY
.TP
\fB\-e\fP
ERR_EXIT
.TP
\fB\-f\fP
\fINO_\fPGLOB
.TP
\fB\-i\fP
INTERACTIVE
.TP
\fB\-l\fP
LOGIN
.TP
\fB\-m\fP
MONITOR
.TP
\fB\-n\fP
\fINO_\fPEXEC
.TP
\fB\-p\fP
PRIVILEGED
.TP
\fB\-r\fP
RESTRICTED
.TP
\fB\-s\fP
SHIN_STDIN
.TP
\fB\-t\fP
SINGLE_COMMAND
.TP
\fB\-u\fP
\fINO_\fPUNSET
.TP
\fB\-v\fP
VERBOSE
.TP
\fB\-x\fP
XTRACE
.PD
.SS "همچنین توجه داشته باشید"
.PD 0
.TP
\fB\-A\fP
توسط \fBset\fP برای تنظیم آرایه‌ها به کار می‌رود
.TP
\fB\-b\fP
در خط فرمان برای مشخص کردن پایان پردازش گزینه‌ها استفاده می‌شود
.TP
\fB\-c\fP
در خط فرمان برای مشخص کردن یک دستور تکی استفاده می‌شود
.TP
\fB\-m\fP
توسط \fBsetopt\fP برای تنظیم گزینه‌ها با تطبیق الگو به کار می‌رود
.TP
\fB\-o\fP
در همه جا برای فراهم کردن امکان استفاده از نام‌های طولانی گزینه‌ها به کار می‌رود
.TP
\fB\-s\fP
توسط \fBset\fP برای مرتب‌سازی پارامترهای مکانی به کار می‌رود
.PD