.\"
.\" $Id: ispell.5X,v 1.36 2020-12-30 22:33:41-08 geoff Exp $
.\"
.\" Copyright 1992, 1993, 1999, 2001, Geoff Kuenning, Claremont, CA
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\"
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. All modifications to the source code must be clearly marked as
.\"    such.  Binary redistributions based on modified source code
.\"    must be clearly marked as modified versions in the documentation
.\"    and/or other materials provided with the distribution.
.\" 4. The code that causes the 'ispell -v' command to display a prominent
.\"    link to the official ispell Web site may not be removed.
.\" 5. The name of Geoff Kuenning may not be used to endorse or promote
.\"    products derived from this software without specific prior
.\"    written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY GEOFF KUENNING AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL GEOFF KUENNING OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.TH ISPELL 5 local
.SH "نام (NAME)"
ispell \- قالب فرهنگ لغت‌ها و فایل‌های وند در ispell
.SH "توضیحات (DESCRIPTION)"
.PP
برنامه
.IR Ispell (1)
برای تعریف زبانی که املای آن را بررسی می‌کند به دو فایل نیاز دارد.
نخستین فایل، یک فرهنگ لغت حاوی کلمات آن زبان است و دومی یک فایل «وند» (affix) است که معنای پرچم‌های ویژه در فرهنگ لغت را مشخص می‌کند.
این دو فایل توسط
.I buildhash
(ببینید
.IR ispell "(1))"
ترکیب شده و در یک فایل درهم‌سازی (hash) نوشته می‌شوند که ساختار آن در اینجا شرح داده نشده است.
.PP
یک فرهنگ لغت خام
.I ispell
(خواه فرهنگ لغت اصلی و خواه فرهنگ لغت شخصی شما) شامل فهرستی از کلمات است، هر کلمه در یک خط.
هر کلمه می‌تواند به صورت اختیاری با یک ممیز («/») و یک یا چند پرچم دنبال شود، که ریشه کلمه را طبق توضیحات زیر تغییر می‌دهند.
بسته به گزینه‌هایی که
.I ispell
با آن‌ها کامپایل شده است، حساسیت به بزرگی و کوچکی حروف ممکن است در ریشه کلمه یا در پرچم‌ها، به طور مستقل از یکدیگر، معنادار باشد یا نباشد.
به طور مشخص، اگر گزینه زمان کامپایل CAPITALIZATION تعریف شده باشد، بزرگی و کوچکی حروف در ریشه کلمه دارای اهمیت است؛ در غیر این صورت، از آن چشم‌پوشی می‌شود.
اگر گزینه زمان کامپایل MASKBITS بر روی مقدار 32 تنظیم شده باشد، بزرگی و کوچکی حروف در پرچم‌ها نادیده گرفته می‌شود؛ در غیر این صورت بزرگی و کوچکی حروف در پرچم‌ها معنادار است.
برای اطلاعات بیشتر با مدیر سیستم یا نگه‌دارنده
.I ispell
تماس بگیرید (یا از پرچم
.B \-vv
برای فهمیدن آن استفاده کنید).
فرهنگ لغت باید پیش از ساخته شدن فایل درهم‌سازی، با پرچم
.B \-f
از دستور
.IR sort (1)
مرتب‌سازی شود؛
این کار به صورت خودکار توسط
.IR munchlist (1)
که روش استاندارد ساخت فرهنگ لغت‌ها است، انجام می‌شود.
.PP
اگر فرهنگ لغت شامل کلماتی است که نویسه‌های رشته‌ای دارند (به مستندات فایل وند در ادامه نگاه کنید)، آنها باید در قالبی نوشته شوند که توسط دستور
.B defstringtype
در فایل وند تعیین شده است.
این امر برای بیشتر زبان‌های غیرانگلیسی صدق می‌کند.
هنگام افزودن کلمات به فرهنگ لغت، دقت کنید که به جای قالب قالب‌بند (formatter) دلخواه خود، از این قالب استفاده نمایید. (اگر در طول یک نشست
.I ispell
کلماتی را به فرهنگ لغت شخصی خود اضافه کنید، آنها به صورت خودکار به قالب صحیح تبدیل خواهند شد.
در صورت نیاز می‌توان از این ویژگی برای تبدیل ساختار کل یک فرهنگ لغت استفاده کرد:)
.PP
.RS
.nf
	echo qqqqq > dummy.dict
	buildhash dummy.dict \fIaffix-file\fP dummy.hash
	awk '{print "*"}END{print "#"}' \fIold-dict-file\fP \e
	| ispell -a -T \fIold-dict-string-type\fP \e
	  -d ./dummy.hash -p ./\fInew-dict-file\fP \e
	  > /dev/null
	rm dummy.*
.fi
.RE
.PP
بزرگی و کوچکی حروف ریشه کلمه، وضعیت حروف کلمات پذیرفته‌شده توسط
.IR ispell
را به صورت زیر کنترل می‌کند:
.IP (1)
اگر ریشه کلمه فقط با حروف کوچک باشد (مانند
.IR bob ")،"
با حروف کوچک، با حرف اول بزرگ (Capitalized)، یا تماماً حروف بزرگ پذیرفته می‌شود.
.IP (2)
اگر ریشه کلمه با حرف اول بزرگ ظاهر شود (مانند
.IR Robert ")،"
با تمام حروف کوچک پذیرفته نخواهد شد، اما با حرف اول بزرگ یا با تمام حروف بزرگ پذیرفته می‌شود.
.IP (3)
اگر ریشه کلمه با تمام حروف بزرگ ظاهر شود (مانند
.IR UNIX ")،"
تنها با تمام حروف بزرگ پذیرفته خواهد شد.
.IP (4)
اگر ریشه کلمه با ترکیب حروف خاصی (مانند
.IR ITCorp ")،"
آمده باشد، کلمه تنها در صورتی پذیرفته می‌شود که دقیقاً همان شکل نگارش را دنبال کند، یا تمام حروف آن بزرگ باشد.
.IP (5)
ممکن است بیش از یک شکل از وضعیت حروف یک ریشه در فرهنگ لغت وجود داشته باشد. پرچم‌های مربوط به حالت‌های مختلف حروف، با عملگر منطقی OR با یکدیگر ترکیب می‌شوند.
.PP
حالت‌های تکراری بزرگی و کوچکی حروف (مانند
.I bob
و
.IR Bob ")"
توسط
.I buildhash
و
.I ispell
(برای فرهنگ لغت‌های شخصی) ترکیب می‌شوند و می‌توان آنها را با استفاده از
.IR munchlist
از یک فرهنگ لغت خام حذف کرد.
.PP
برای نمونه، فرهنگ لغت:
.PP
.RS
.nf
bob
Robert
UNIX
ITcorp
ITCorp
.fi
.RE
.PP
کلمات
.IR bob ،
.IR Bob ،
.IR BOB ،
.IR Robert ،
.IR ROBERT ،
.IR UNIX ،
.IR ITcorp ،
.IR ITCorp
و
.IR ITCORP
را می‌پذیرد و تمام حالت‌های دیگر را رد می‌کند.
برخی از حالت‌های غیرقابل قبول عبارتند از:
.IR bOb ،
.IR robert ،
.IR Unix
و
.IR ItCorp .
.PP
همان‌طور که در بالا اشاره شد، ریشه‌های کلمات در هر فرهنگ لغتی می‌توانند با پرچم‌ها گسترش یابند.
هر پرچم یک نویسه الفبایی منفرد است که پیشوند یا پسوندی را نشان می‌دهد که می‌تواند به ریشه اضافه شود تا کلمه جدیدی را شکل دهد.
برای مثال در یک فرهنگ لغت انگلیسی، پرچم
.B D
می‌تواند به
.I bathe
اضافه شود تا
.IR bathed
ساخته شود.
از آنجا که پرچم‌ها در فرهنگ لغت درهم‌سازی‌شده به صورت یک تک‌بیت ذخیره می‌شوند، این امر منجر به صرفه‌جویی چشمگیری در فضای مصرفی می‌شود.
اسکریپت
.I munchlist
با اضافه کردن پرچم‌ها در صورت امکان، حجم یک فرهنگ لغت خام موجود را کاهش می‌دهد.
.PP
هنگامی که کلمه‌ای با یک وند گسترش می‌یابد، وند تنها در صورتی پذیرفته می‌شود که وضعیت بزرگی و کوچکی حروف آن با نویسه نخست (در پیشوند) یا نویسه پایانی (در پسوند) کلمه یکسان باشد.
بنابراین برای مثال، ورودی
.I UNIX/M
در فرهنگ لغت اصلی
.RB "(" M
به معنی افزودن آپاستروف و یک «s» برای ساختن حالت ملکی است) کلمه
.I "UNIX'S"
را می‌پذیرد اما
.I "UNIX's"
را رد می‌کند.
اگر
.I "UNIX's"
مجاز باشد، باید به صورت یک ورودی جداگانه در فرهنگ لغت ظاهر شود و توسط
.IR munchlist
ترکیب نخواهد شد.
(به طور کلی نیازی نیست نگران این موضوعات باشید؛
.I munchlist
تضمین می‌کند که فرهنگ لغت خروجی آن همان مجموعه کلماتی را بپذیرد که فرهنگ لغت ورودی پذیرفته بود، بنابراین تنها کاری که باید انجام دهید افزودن کلمات به فرهنگ لغت و اجرای گاه‌به‌گاه munchlist برای کاهش اندازه آن است).
.PP
همان‌طور که ذکر شد، فایل تعریف وند (affix)، وندهای مرتبط با پرچم‌های ویژه را شرح می‌دهد.
همچنین مجموعه نویسه‌های (character set) استفاده‌شده توسط زبان را تعریف می‌کند.
.PP
اگرچه گرامر تعریف وند برای ساختاری خط‌محور طراحی شده است، اما در حقیقت یک گرامر yacc با قالب آزاد (free-format) است و در صورت تمایل می‌توان آن را با چیدمان‌های گوناگون نوشت.
توضیحات با علامت هش (#) آغاز می‌شوند و تا انتهای خط ادامه می‌یابند.
بک‌اسلش‌ها به روش معمول پشتیبانی می‌شوند (\fB\e\fInnn\fR، به علاوه حالت‌های خاص
.BR \en ،
.BR \er ،
.BR \et ،
.BR \ev ،
.BR \ef ،
.BR \eb
و قالب جدید شانزده‌شانزدهی \fB\ex\fInn\fR).
هر نویسه‌ای که معنای خاصی برای تحلیل‌گر دارد را می‌توان با افزودن بک‌اسلش به یک نشانه تفسیرنشده تبدیل کرد؛
برای نمونه، می‌توانید پرچمی به نام 'asterisk' (ستاره) یا 'colon' (دو نقطه) را با
.I "flag \e*:"
یا
.IR "flag \e::"
تعریف کنید.
.PP
گرامر به صورت بالا به پایین ارائه شده و هر عنصر مورد بررسی قرار می‌گیرد.
یک فایل تعریف وند باید دقیقاً شامل یک جدول باشد:
.PP
.RS
.nf
\fItable\fR	:	[\fIheaders\fR] [\fIprefixes\fR] [\fIsuffixes\fR]
.fi
.RE
.PP
حداقل یکی از بخش‌های
.I prefixes
و
.I suffixes
الزامی است.
آن‌ها می‌توانند به هر ترتیبی ظاهر شوند.
.PP
.RS
.nf
\fIheaders\fR	:	[ \fIoptions\fR ] \fIchar-sets\fR
.fi
.RE
.PP
بخش سرآیندها (headers) گزینه‌های عمومی این فرهنگ لغت و زبان را توصیف می‌کند.
این موارد شامل مجموعه‌های نویسه مورد استفاده، قالب‌بند، و پیش‌فرض‌های مربوط به برخی پرچم‌های
.I ispell
است.
.PP
.RS
.nf
\fIoptions\fR	:	{ \fIfmtr-stmt\fR | \fIopt-stmt\fR | \fIflag-stmt\fR | \fInum-stmt\fR }
.fi
.RE
.PP
دستورهای گزینه‌ها پیش‌فرض‌های پرچم‌های خاص ispell و مجموعه‌های نویسه مورد استفاده توسط قالب‌بندها را تعیین می‌کنند.
.PP
.RS
.nf
\fIfmtr-stmt\fR	:	{ \fInroff-stmt\fR | \fItex-stmt\fR }
.fi
.RE
.PP
یک
.I fmtr-stmt
نویسه‌هایی را شرح می‌دهد که معنای ویژه‌ای برای یک قالب‌بند دارند.
به طور معمول، این دستور ضروری نیست، اما ممکن است برخی زبان‌ها از پیش‌فرض‌های معمول برای استفاده به عنوان نویسه‌های خاص زبان خود استفاده کرده باشند.
در این صورت، می‌توان از این دستورها برای تعریف مجدد نویسه‌های ویژه مورد انتظار قالب‌بند استفاده کرد.
.PP
.RS
.nf
\fInroff-stmt\fR :	{ \fBnroffchars\fR | \fBtroffchars\fR } \fIstring\fR
.fi
.RE
.PP
دستور
.B nroffchars
امکان تعریف مجدد برخی نویسه‌های کنترلی
.I nroff
را فراهم می‌کند.
رشته داده‌شده باید دقیقاً پنج نویسه باشد و باید جایگزین‌ها را برای پرانتزهای چپ و راست («()»)، نقطه («.»)، بک‌اسلش («\e») و ستاره («*») فهرست کند.
(پرانتز راست در حال حاضر استفاده نمی‌شود، اما برای کامل بودن گنجانده شده است.)
برای نمونه، دستور:
.PP
.RS
.nf
\fBnroffchars\fR {}.\e\e*
.fi
.RE
.PP
پرانتزهای چپ و راست را برای تحلیل رشته‌های
.IR nroff / troff
با آکولادهای چپ و راست جایگزین می‌کند، بدون اینکه بر بقیه تأثیری بگذارد (مسلماً یک مثال فرضی است).
توجه داشته باشید که بک‌اسلش با یک بک‌اسلش دیگر گریز داده شده است (escaped).
.PP
.RS
.nf
\fItex-stmt\fR	:	{ \fBTeXchars\fR | \fBtexchars\fR } \fIstring\fR
.fi
.RE
.PP
دستور
.B TeXchars
امکان تعریف مجدد برخی نویسه‌های کنترلی TeX/LaTeX را فراهم می‌کند.
رشته داده‌شده باید دقیقاً سیزده نویسه باشد و باید جایگزین‌ها را برای پرانتزهای چپ و راست («()»)، قلاب‌های چپ و راست («[]»)، آکولادهای چپ و راست («{}»)، براکت‌های زاویه‌دار چپ و راست («<>»)، بک‌اسلش («\e»)، علامت دلار («$»)، ستاره («*»)، نقطه («.») و علامت درصد («%») فهرست کند.
برای نمونه، دستور:
.PP
.RS
.nf
\fBtexchars\fR ()\e[\|]<\e><\e>\e\e$*.%
.fi
.RE
.PP
کارکرد آکولادهای چپ و راست را برای تحلیل ساختارهای TeX/LaTeX با براکت‌های زاویه‌دار جایگزین می‌کند، در حالی که کارکرد آن‌ها را برای پیش‌پردازنده کتاب‌شناختی
.I tib
حفظ می‌نماید.
توجه داشته باشید که بک‌اسلش، قلاب باز چپ و براکت زاویه‌دار راست باید با بک‌اسلش گریز داده شوند.
.PP
.RS
.nf
\fIopt-stmt\fR	:	{ \fIcmpnd-stmt\fR | \fIaff-stmt\fR }
.sp
\fIcmpnd-stmt\fR :	\fBcompoundwords\fR \fIcompound-opt\fR
.sp
\fIaff-stmt\fR	:	\fBallaffixes\fR \fIon-or-off\fR
.sp
\fIon-or-off\fR	:	{ \fBon\fR | \fBoff\fR }
.sp
\fIcompound-opt\fR :	{ \fIon-or-off\fR | \fBcontrolled\fR \fIcharacter\fR }
.fi
.RE
.PP
یک
.I opt-stmt
برخی پیش‌فرض‌های ispell را کنترل می‌کند که بهتر است وابسته به زبان تنظیم شوند.
دستور
.B allaffixes
پیش‌فرض مربوط به گزینه‌های
.B \-P
و
.B \-m
در
.I ispell
را کنترل می‌کند.
اگر
.B allaffixes
بر روی
.B off
تنظیم شود (حالت پیش‌فرض)،
.I ispell
رفتار پیش‌فرض پرچم
.I \-P
را در پیش خواهد گرفت:
پیشنهادات ریشه/وند تنها در صورتی ارائه می‌شوند که هیچ کلمه «تقریباً مشابه» (near miss) وجود نداشته باشد.
اگر
.B allaffixes
بر روی
.BR on
تنظیم شود،
.I ispell
رفتار پرچم
.I \-m
را در پیش می‌گیرد:
پیشنهادات ریشه/وند همیشه ارائه خواهند شد.
دستور
.B compoundwords
پیش‌فرض گزینه‌های
.B \-B
و
.B \-C
در
.I ispell
را کنترل می‌کند.
اگر
.B compoundwords
بر روی
.B off
تنظیم شود (پیش‌فرض)،
.I ispell
رفتار پرچم
.I \-B
را در پیش می‌گیرد:
کلمات به‌هم‌چسبیده به عنوان خطا گزارش می‌شوند.
اگر
.B compoundwords
بر روی
.BR on
تنظیم شود،
.I ispell
رفتار پرچم
.I \-C
را در پیش می‌گیرد:
کلمات به‌هم‌چسبیده در صورتی که هر دو بخش در فرهنگ لغت موجود باشند، به عنوان کلمه مرکب تلقی می‌شوند.
این ویژگی برای زبان‌هایی مانند آلمانی و نروژی که کلمات مرکب زیادی می‌سازند بسیار کاربردی است.
در نهایت، اگر
.B compoundwords
بر روی
.IR controlled
تنظیم شود، تنها کلماتی که با پرچم مشخص‌شده توسط
.I character
علامت‌گذاری شده‌اند (که نباید برای مقاصد دیگر استفاده شود) مجاز به شرکت در ساخت کلمات مرکب خواهند بود.
از آنجا که این گزینه نیازمند مشخص شدن پرچم‌ها در فرهنگ لغت است، از طریق خط فرمان در دسترس نیست.
.PP
.RS
.nf
\fIflag-stmt\fR	:	\fBflagmarker\fR \fIcharacter\fR
.fi
.RE
.PP
دستور
.B flagmarker
نویسه‌ای را مشخص می‌کند که برای جداسازی پرچم‌های وند از ریشه کلمه در فایل فرهنگ لغت خام به کار می‌رود.
این نویسه باید چیزی باشد که در هیچ کلمه‌ای (از جمله در نویسه‌های رشته‌ای؛ در ادامه ببینید) یافت نشود.
مقدار پیش‌فرض «/» است زیرا این نویسه معمولاً برای نشان دادن نویسه‌های ویژه در هیچ زبانی استفاده نمی‌شود.
.PP
.RS
.nf
\fInum-stmt\fR	:	\fBcompoundmin\fR \fIdigit\fR
.fi
.RE
.PP
دستور
.B compoundmin
طول دو بخش تشکیل‌دهنده یک کلمه مرکب را کنترل می‌کند.
این دستور تنها زمانی تأثیر دارد که
.B compoundwords
روی
.B on
تنظیم شده باشد یا پرچم
.B \-C
به
.IR ispell
داده شده باشد.
در این صورت، تنها کلماتی که حداقل به اندازه حداقل طول تعیین‌شده باشند به عنوان اجزای یک کلمه مرکب پذیرفته می‌شوند.
مقدار پیش‌فرض ۳ نویسه است.
.PP
.RS
.nf
\fIchar-sets\fR	:	\fInorm-sets\fR [ \fIalt-sets\fR ]
.fi
.RE
.PP
بخش مجموعه‌های نویسه، نویسه‌هایی را که می‌توانند بخشی از یک کلمه باشند شرح داده و ترتیب مرتب‌سازی (collating order) آن‌ها را تعریف می‌کند.
همیشه باید تعریفی از مجموعه‌های نویسه «عادی» (normal) وجود داشته باشد؛ علاوه بر این، ممکن است یک یا چند تعریف جزئی از مجموعه‌های «جایگزین» (alternate) که با قالب‌بندهای متنی گوناگون به کار می‌روند نیز وجود داشته باشد.
.PP
.RS
.nf
\fInorm-sets\fR :	[ \fIdeftype\fR ] [ \fIset-options\fR ] \fIcharset-group\fR
.fi
.RE
.PP
یک مجموعه نویسه «عادی» می‌تواند به صورت اختیاری با تعریفی از پسوندهای فایلی که از این مجموعه استفاده می‌کنند آغاز شود.
به دنبال آن یک یا چند اعلان مجموعه نویسه قرار می‌گیرد.
.PP
.RS
.nf
\fIdeftype\fR	:		\fBdefstringtype\fR \fIname\fR \fIdeformatter\fR \fIsuffix\fR*
.fi
.RE
.PP
اعلان
.B defstringtype
فهرستی از پسوندهای فایل را ارائه می‌دهد که باید از نویسه‌های رشته‌ای پیش‌فرضِ تعریف‌شده به عنوان بخشی از مجموعه نویسه پایه استفاده کنند؛
این مورد تنها در صورتی لازم است که نویسه‌های رشته‌ای تعریف شده باشند.
پارامتر
.I name
رشته‌ای است که نام یکتای مرتبط با این پسوندها را مشخص می‌کند؛ اغلب این نام، نام یک قالب‌بند است.
اگر قالب‌بند عضوی از خانواده troff باشد، باید از «nroff» برای نام مرتبط با پرکاربردترین بسته ماکرو استفاده شود؛
اعضای خانواده TeX باید از «tex» استفاده کنند.
نام‌های دیگر را می‌توان آزادانه انتخاب کرد، اما باید ساده نگه داشته شوند، زیرا در سوئیچ
.B \-T
برنامه
.I ispell
برای مشخص کردن نوع قالب‌بند استفاده می‌شوند.
پارامتر
.I deformatter
سبک قالب‌زدایی (deformatting) را برای پردازش فایل‌های دارای پسوندهای داده‌شده مشخص می‌کند.
در حال حاضر، این مقدار باید یکی از موارد
.BR plain ،
.BR tex ،
.BR nroff
یا
.BR html
باشد.
پارامترهای
.I suffix
فهرستی از رشته‌های جداشده با فاصله هستند که در صورت وجود در انتهای یک نام فایل، نشان می‌دهند که مجموعه نویسه‌های رشته‌ای مرتبط باید به طور پیش‌فرض برای این فایل استفاده شود. برای نمونه، فهرست پسوندهای خانواده troff معمولاً شامل پسوندهایی مانند «‎.ms»، «‎.me»، «‎.mm» و غیره است.
.PP
.RS
.nf
\fIset-options\fR :	\fBoptions\fR \fIcharset-options\fR*
.fi
.RE
.PP
اعلان
.B options
یک یا چند گزینه جداشده با فاصله را برای مجموعه نویسه داده‌شده (پیش‌فرض یا جایگزین) فعال می‌کند.
در حال حاضر، دو گزینه پشتیبانی می‌شوند:
گزینه
.B raw_display
نشان می‌دهد که نویسه‌های رشته‌ای باید همان‌طور که هستند نمایش داده شوند، حتی اگر به نظر برسد برخی از اجزای آن‌ها غیرقابل چاپ هستند؛ این گزینه برای مجموعه‌های نویسه‌ای مانند UTF-8 یا (اگر پایانه به درستی پیکربندی شده باشد) ISO Latin-1 مفید است.
گزینه
.B squeeze_string
نشان می‌دهد هنگامی که
.I ispell
با یک کلاینت خارجی مانند
.I emacs
(از طریق پرچم
.BR \-a )
تعامل دارد، نویسه‌های رشته‌ای باید به جای طول واقعی‌شان بر حسب بایت، دارای طول ۱ در نظر گرفته شوند.
این گزینه برای این لازم است که
.I ispell
بتواند هنگام پردازش فایل‌های حاوی نویسه‌های UTF-8 با
.I emacs
همگام‌سازی شود؛ این گزینه تنها باید برای مجموعه‌های نویسه UTF-8 تعیین گردد.
.PP
.RS
.nf
\fIcharset-group\fR :	{ \fIchar-stmt\fR | \fIstring-stmt\fR | \fIdup-stmt\fR}*
.fi
.RE
.PP
یک
.I char-stmt
نویسه‌های منفرد را توصیف می‌کند؛
یک
.I string-stmt
نویسه‌هایی را شرح می‌دهد که باید با هم به عنوان یک رشته ظاهر شوند و معمولاً نشان‌دهنده یک نویسه منفرد در زبان مقصد هستند.
هر دو دستور می‌توانند تبدیل بین حروف بزرگ و کوچک را نیز توصیف کنند.
یک
.I dup-stmt
برای توصیف اشکال جایگزین نویسه‌های رشته‌ای به کار می‌رود تا بتوان از یک فرهنگ لغت واحد به همراه چندین برنامه قالب‌بندی که از قراردادهای مختلفی برای نمایش نویسه‌های غیر ASCII استفاده می‌کنند، بهره برد.
.PP
.RS
.nf
\fIchar-stmt\fR	:	\fBwordchars\fR \fIcharacter-range\fR
		|	\fBwordchars\fR \fIlowercase-range\fR \fIuppercase-range\fR
		|	\fBboundarychars\fR \fIcharacter-range\fR
		|	\fBboundarychars\fR \fIlowercase-range\fR \fIuppercase-range\fR
\fIstring-stmt\fR :	\fBstringchar\fR \fIstring\fR
		|	\fBstringchar\fR \fIlowercase-string\fR \fIuppercase-string\fR
.fi
.RE
.PP
نویسه‌هایی که با دستور
.B boundarychars
تعریف می‌شوند، تنها در صورتی بخشی از یک کلمه در نظر گرفته می‌شوند که به صورت منفرد بین نویسه‌های اعلام‌شده با دستورهای
.B wordchars
یا
.B stringchar
قرار گرفته باشند.
برای مثال، اگر خط پیوند (hyphen) یک نویسه مرزی باشد (که در زبان فرانسوی کاربرد دارد)، رشته "foo-bar" یک کلمه منفرد خواهد بود، اما "-foo" مانند "foo" رفتار می‌کند و "foo--bar" به صورت دو کلمه جداشده با نویسه‌های غیرکلمه‌ای تلقی می‌شود.
.PP
اگر در یک
.I char-stmt
یا
.IR string-stmt
دو بازه یا رشته داده شود، اولی نویسه‌هایی را شرح می‌دهد که به عنوان حروف کوچک تفسیر می‌شوند و دومی حروف بزرگ را توصیف می‌کند.
در مورد دستور
.BR stringchar ،
دو رشته باید طول یکسانی داشته باشند.
همچنین در یک دستور
.BR stringchar ،
رشته‌های واقعی می‌توانند بدون مشکل شامل هر دو نوع نویسه بزرگ و کوچک باشند؛
برای نمونه، دستور
.PP
.RS
.nf
stringchar	"\e\e*(sS"	"\e\e*(Ss"
.fi
.RE
.PP
مجاز است و با سایر اعلان‌های "s" و "S" به عنوان حروف کوچک و بزرگ تداخلی ایجاد نخواهد کرد (و از آن‌ها تداخل نمی‌پذیرد).
.PP
نکته پایانی در مورد نویسه‌های رشته‌ای:
برخی زبان‌ها نویسه‌های ویژه معینی را طوری مرتب‌سازی می‌کنند که گویی رشته هستند.
برای مثال، در زبان آلمانی «a-umlaut» به طور سنتی طوری مرتب می‌شود که گویی «ae» است.
برنامه Ispell قادر به انجام این کار نیست؛
با هر نویسه باید به عنوان یک موجودیت مستقل رفتار شود.
بنابراین در موارد خاصی، ispell فهرستی از کلمات را به ترتیبی متفاوت از ترتیب استاندارد «فرهنگ لغت» برای زبان مقصد مرتب خواهد کرد.
.PP
.RS
.nf
\fIalt-sets\fR	:	\fIalttype\fR [ \fIset-options\fR ] [ \fIalt-stmt\fR* ]
.fi
.RE
.PP
از آنجا که قالب‌بندهای مختلف از نمادهای متفاوتی برای نمایش نویسه‌های غیر ASCII استفاده می‌کنند،
.I ispell
باید از نمایش‌های مورد استفاده توسط این قالب‌بندها آگاه باشد.
این موارد به عنوان مجموعه‌های جایگزینِ نویسه‌های رشته‌ای تعریف می‌شوند.
.PP
.RS
.nf
\fIalttype\fR	:	\fBaltstringtype\fR \fIname\fR \fIsuffix\fR*
.fi
.RE
.PP
دستور
.B altstringtype
هر مجموعه را با اعلان نام قالب‌بند مرتبط و فهرست پسوندهای فایل معرفی می‌کند.
این نام و فهرست دقیقاً مانند دستور
.B defstringtype
در بالا تفسیر می‌شوند.
به دنبال این سرآیند، یک یا چند \fIalt-stmt\fR قرار می‌گیرد که نویسه‌های رشته‌ای جایگزین مورد استفاده توسط این قالب‌بند را اعلام می‌کنند.
.PP
.RS
.nf
\fIalt-stmt\fR	:	\fBaltstringchar\fR \fIalt-string\fR \fIstd-string\fR
.fi
.RE
.PP
دستور
.I altstringchar
نمایش‌های جایگزین را برای نویسه‌های رشته‌ای توصیف می‌کند.
برای مثال، بسته ماکرو \-mm در
.I troff
نویسه «a-umlaut» آلمانی را به صورت
.IR a\e*:
نشان می‌دهد، در حالی که
.I TeX
از توالی \fI\e"a\fR استفاده می‌کند.
اگر نسخه‌های
.I troff
به عنوان نسخه‌های استاندارد با استفاده از
.B stringchar
اعلان شده باشند، می‌توان نسخه‌های
.I TeX
را به عنوان جایگزین با استفاده از دستور زیر تعریف کرد:
.PP
.RS
.nf
\fBaltstringchar\fR	\e\e\e"a	a\e\e*\:
.fi
.RE
.PP
هنگامی که دستور
.B altstringchar
برای تعیین اشکال جایگزین استفاده می‌شود، تمام اشکال برای یک قالب‌بند خاص باید با هم به عنوان یک گروه اعلام شوند.
همچنین هر قالب‌بند یا بسته ماکرو باید یک مجموعه کامل از نویسه‌ها (هم حروف بزرگ و هم کوچک) ارائه دهد، و توالی‌های نویسه‌ای استفاده‌شده برای هر قالب‌بند باید کاملاً مجزا و متمایز باشند.
توالی‌های نویسه‌ای که نسخه‌های بزرگ و کوچک یک نویسه قابل چاپ یکسان را توصیف می‌کنند نیز باید طول یکسانی داشته باشند.
ممکن است برای برآورده کردن این محدودیت‌ها لازم باشد ماکروهای جدیدی برای یک قالب‌بند معین تعریف شود.
(نسخه فعلی
.I buildhash
این محدودیت‌ها را اجبار نمی‌کند، اما رعایت نکردن آن‌ها ممکن است منجر به بروز خطا در فایل‌هایی شود که با
.I ispell
پردازش می‌شوند.)
.PP
یک نکته جانبی مهم این است که
.I ispell
فرض می‌کند تمام نویسه‌های اعلام‌شده به عنوان
.B wordchars
یا
.B boundarychars
دقیقاً یک موقعیت را در صفحه نمایش پایانه اشغال می‌کنند.
.PP
یک دستور مجموعه نویسه منفرد می‌تواند یک نویسه تکی یا یک بازه پیوسته از نویسه‌ها را اعلان کند.
یک بازه مانند egrep و پوسته مشخص می‌شود:
[a-z] به معنای حروف الفبای کوچک است؛
[^a-z] به معنای همه چیز به جز حروف کوچک، و غیره.
تمام دستورهای مجموعه نویسه با هم ترکیب (اجتماع) می‌شوند تا فهرست نهایی نویسه‌هایی را تشکیل دهند که می‌توانند بخشی از یک کلمه باشند.
ترتیب مرتب‌سازی نویسه‌ها بر اساس ترتیب اعلان آن‌ها تعیین می‌شود؛
اگر از یک بازه استفاده شود، فرض می‌شود که نویسه‌ها به ترتیب ASCII اعلان شده‌اند.
نویسه‌هایی که دارای حروف کوچک و بزرگ هستند در کنار یکدیگر مرتب می‌شوند، به طوری که نویسه بزرگ در ابتدا قرار می‌گیرد.
.PP
دستورهای اعلان نویسه به دلیل نیازی که به تطبیق هر نویسه کوچک با معادل بزرگ آن دارند، رفتار نسبتاً ویژه‌ای دارند.
در هر دستور
.B wordchars
یا
.B boundarychars
معین، نویسه‌ها در هر بازه ابتدا بر اساس مقادیر بایتی خود در یک توالی مرتب‌سازی قرار می‌گیرند، سپس یک‌به‌یک با بازه دیگر تطبیق داده می‌شوند.
(دو بازه باید تعداد نویسه‌های یکسانی داشته باشند).
بنابراین برای مثال، دو دستور:
.PP
.RS
.nf
\fBwordchars\fP [aeiou] [AEIOU]
\fBwordchars\fP [aeiou] [UOIEA]
.fi
.RE
.PP
دقیقاً همان اثر را ایجاد می‌کنند.
برای تطبیق «نامتعارف» حروف صدادار، باید از دستورهای جداگانه استفاده کنید:
.PP
.RS
.nf
\fBwordchars\fP a U
\fBwordchars\fP e O
\fBwordchars\fP i I
\fBwordchars\fP o E
\fBwordchars\fP u A
.fi
.RE
.PP
که باعث می‌شود حرف بزرگ 'e' برابر با 'O' و حرف کوچک 'O' برابر با 'e' شود.
این موضوع معمولاً فقط در زبان‌هایی مشکل‌ساز می‌شود که ناچار به استفاده از یک توالی مرتب‌سازی نامعمول شده‌اند.
اگر حروف بزرگ و کوچک شما هر دو به یک ترتیب مرتب می‌شوند، نباید نگران این ویژگی باشید.
.PP
بخش‌های پیشوندها (prefixes) و پسوندها (suffixes) نحو کاملاً یکسانی دارند، به جز کلیدواژه معرفی‌کننده.
.PP
.RS
.nf
\fIprefixes\fR	:	\fBprefixes\fI flagdef\fR*
\fIsuffixes\fR	:	\fBsuffixes\fI flagdef\fR*
\fIflagdef\fR	:	\fBflag\fR [\fB*\fR|\fB~\fR] \fIchar\fB : \fIrepl\fR*
.fi
.RE
.PP
یک جدول پیشوند یا پسوند شامل یک کلیدواژه آغازین و فهرستی از تعاریف پرچم است.
پرچم‌ها را می‌توان بیش از یک بار تعریف کرد، که در این حالت تعاریف با هم ترکیب می‌شوند.
هر پرچم یک یا چند
.IR repl
(جایگزینی) را کنترل می‌کند که به صورت شرطی بر ابتدا یا انتهای کلمات مختلف اعمال می‌شوند.
.PP
پرچم‌ها با یک نویسه منفرد
.I char
نام‌گذاری می‌شوند.
بسته به یک گزینه پیکربندی، این نویسه می‌تواند هر حرف بزرگ (پیکربندی پیش‌فرض) یا هر نویسه ۷-بیتی ASCII باشد.
بیشتر زبان‌ها باید بتوانند تنها با ۲۶ پرچم کار خود را پیش ببرند.
.PP
یک نویسه پرچم ممکن است با یک یا چند نویسه گزینه‌ای پیشوند شود.
(اگر می‌خواهید از یکی از نویسه‌های گزینه‌ای به عنوان نویسه پرچم استفاده کنید، کافی است آن را در گیومه دوتایی قرار دهید.)
.PP
گزینه ستاره (\fB*\fP) به این معنی است که این پرچم در ساخت «حاصل‌ضرب متقاطع» (cross-product) شرکت می‌کند.
این موضوع تنها در صورتی اهمیت دارد که فایل هم شامل جدول پیشوند و هم جدول پسوند باشد.
در این صورت، تمام پیشوندها و پسوندهای علامت‌گذاری‌شده با ستاره در تمام ترکیب‌های متقاطع ممکن بر ریشه کلمه اعمال خواهند شد.
برای مثال، ریشه
.I fix
را با پیشوندهای
.I pre
و
.IR in ،
و پسوندهای
.I es
و
.IR ed
در نظر بگیرید.
اگر تمام پرچم‌های کنترل‌کننده این پیشوندها و پسوندها با علامت ستاره مشخص شده باشند، ریشه منفرد
.I fix
کلمات
.IR prefix ،
.IR prefixes ،
.IR prefixed ،
.IR infix ،
.IR infixes ،
.IR infixed ،
.IR fix ،
.IR fixes
و
.IR fixed
را نیز تولید خواهد کرد.
ساخت حاصل‌ضرب متقاطع می‌تواند کلمات زیادی را به سرعت تولید کند که برخی از آن‌ها ممکن است نامعتبر باشند، بنابراین دقت کنید.
اگر حاصل‌ضرب متقاطع کلمات نامعتبر تولید کند،
.I munchlist
آن ترکیب‌های پرچم را تولید نخواهد کرد و پرچم کارآمد نخواهد بود.
.PP
.RS
.nf
\fIrepl\fR	:	\fIcondition\fR* \fB>\fR [ \fB- \fIstrip-string \fB,\fR ] \fIappend-string\fR
.fi
.RE
.PP
گزینه \fB~\fR مشخص می‌کند که پرچم مرتبط تنها زمانی فعال است که یک کلمه مرکب در حال ساخت باشد.
این ویژگی در زبانی مانند آلمانی که شکل یک کلمه گاهی در درون یک کلمه مرکب تغییر می‌کند، کاربرد دارد.
.PP
یک
.I repl
یک قاعده شرطی برای تغییر ریشه کلمه است.
تا ۸
.I condition
(شرط) را می‌توان مشخص کرد.
اگر
.I conditions
برقرار باشند، قواعد سمت راستِ
.I repl
به صورت زیر اعمال می‌شوند:
.IP (1)
اگر یک strip-string (رشته حذفی) داده شده باشد، ابتدا از ابتدا یا انتهای ریشه کلمه (بسته به پیشوند یا پسوند بودن) حذف می‌شود.
.IP (2)
سپس append-string (رشته الحاقی) در آن نقطه اضافه می‌شود.
.PP
برای نمونه، شرط
.B .
به معنای «هر کلمه‌ای» است و شرط
.B Y
به معنای «هر کلمه‌ای که به Y ختم می‌شود» است.
جایگزینی‌های (پسوند) زیر:
.PP
.RS
.nf
\&.	>	MENT
Y	>	-Y,IES
.fi
.RE
.PP
کلمه
.I induce
را به
.I inducement
و
.I fly
را به
.I flies
تبدیل می‌کنند.
(اگر هر دو توسط یک پرچم کنترل می‌شدند،
.I fly
را به
.IR flyment
نیز تبدیل می‌کردند، که شاید مورد نظر نبوده باشد.
برای جلوگیری از این نوع مشکلات می‌توان از
.I Munchlist
استفاده کرد؛ توالی دستوری ارائه‌شده در زیر را ببینید.)
.PP
رشته‌های سمت راست باید الزاماً رشته‌هایی از نویسه‌های مشخص باشند، نه بازه‌ها (ranges).
دلایل این امر عمیقاً در نحوه کارکرد
.I ispell
ریشه دارد و فراهم کردن انعطاف‌پذیری بیشتر در آن دشوار خواهد بود.
برای مثال، شاید بخواهید بنویسید:
.PP
.RS
.nf
[EY]	>	-[EY],IES
.fi
.RE
.PP
این شیوه کار نخواهد کرد.
در عوض، باید از دو قاعده جداگانه استفاده کنید:
.PP
.RS
.nf
E	>	-E,IES
Y	>	-Y,IES
.fi
.RE
.PP
اعمال
.IR repl
ها می‌تواند با
.IR condition
ها به کلمات خاصی محدود شود:
.PP
.RS
.nf
\fIcondition\fR	:	{ \fB.\fR | \fIcharacter\fR | \fIrange\fR }
.fi
.RE
.PP
یک
.I condition
محدودیتی بر روی نویسه‌هایی است که با سمت راستِ
.IR repl
هم‌جوار هستند و/یا توسط آن جایگزین می‌شوند.
تا ۸
.I condition
می‌توان تعیین کرد که زمینه (context) کافی را فراهم می‌کند.
سمت راست تنها در صورتی اعمال خواهد شد که
.I conditions
در
.I repl
برقرار باشند.
همچنین
.I conditions
به طور ضمنی یک طول را تعریف می‌کنند؛
ریشه‌هایی که کوتاه‌تر از تعداد
.I conditions
باشند در آزمون رد خواهند شد.
(به عنوان یک حالت خاص، یک
.I condition
شامل یک نقطه منفرد "." طولی برابر صفر را تعریف می‌کند، به طوری که قاعده بر روی تمام کلمات اعمال می‌شود).
این طول مستقل از آزمون جداگانه‌ای است که اصرار دارد تمام پرچم‌ها طول کلمه خروجی حداقل چهار نویسه تولید کنند.
.PP
شرط‌هایی (\fIConditions\fR) که نویسه‌های تکی هستند باید با فاصله از هم جدا شوند.
برای مثال، برای مشخص کردن کلماتی که به "ED" ختم می‌شوند، بنویسید:
.PP
.RS
.nf
E D	>	-ED,ING		# مانند covered > covering
.fi
.RE
.PP
اگر بنویسید:
.PP
.RS
.nf
ED	>	-ED,ING
.fi
.RE
.PP
اثر آن همانند زیر خواهد بود:
.PP
.RS
.nf
[ED]	>	-ED,ING
.fi
.RE
.PP
به عنوان یک نکته مهم، گاهی اوقات بازسازی یک فایل فرهنگ لغت با استفاده از یک فایل پسوند ناسازگار مفید است.
برای مثال، فرض کنید پرچم "R" را گسترش داده‌اید تا "er" و "ers" را تولید کند (و در نتیجه پرچم Z را تا حدودی منسوخ کرده‌اید).
برای ساخت یک فرهنگ لغت جدید
.I newdict
که با استفاده از
.IR newaffixes ،
دقیقاً همان فهرست کلماتی را بپذیرد که فهرست قدیمی
.I olddict
با استفاده از
.IR oldaffixes
می‌پذیرفت، سوئیچ
.B \-c
در
.I munchlist
مفید است، مانند مثال زیر:
.PP
.RS
.nf
$ munchlist -c oldaffixes -l newaffixes olddict > newdict
.fi
.RE
.PP
اگر از این روش استفاده کنید، فرهنگ لغت جدید شما همیشه همان فهرستی را خواهد پذیرفت که فرهنگ لغت اصلی می‌پذیرفت، حتی اگر فایل وند دارای اشکالات ساختاری باشد.
دلیل این امر این است که
.I munchlist
کلمات تولیدشده توسط یک پرچم را با فهرست کلمات اصلی مقایسه می‌کند و از به کار بردن هر پرچمی که کلمات غیرمجاز تولید کند خودداری می‌نماید.
.SH "مثال‌ها (EXAMPLES)"
.PP
به عنوان نمونه‌ای از پسوندهای شرطی، در اینجا مشخصات پرچم
.B S
از فایل وند انگلیسی آمده است:
.PP
.RS
.nf
flag *S:
    [^AEIOU]Y	>	-Y,IES	# مانند imply > implies
    [AEIOU]Y	>	S		# مانند convey > conveys
    [SXZH]	>	ES		# مانند fix > fixes
    [^SXZHY]	>	S		# مانند bat > bats
.fi
.RE
.PP
خط اول برای کلماتی اعمال می‌شود که به Y ختم می‌شوند، اما پیش از Y حرف صدادار ندارند.
خط دوم کلمات دارای حرف صدادار و سپس Y را مدیریت می‌کند.
خط سوم کلماتی را پردازش می‌کند که به یک صدای صفیری (sibilant) یا نزدیک به صفیری ختم می‌شوند، و خط آخر سایر موارد را در بر می‌گیرد.
.PP
توجه داشته باشید که
.I conditions
بسیار دقیق نوشته شده‌اند تا بر مجموعه‌های مجزایی از کلمات اعمال شوند.
به طور ویژه، دقت کنید که خط چهارم علاوه بر موارد مشخص SXZH، کلماتی را که به Y ختم می‌شوند نیز مستثنی می‌کند.
در غیر این صورت، "imply" را به "implys" تبدیل می‌کرد.
.PP
اگرچه فایل وند انگلیسی این کار را انجام نمی‌دهد، اما شما می‌توانید کاری کنید که یک پرچم بیش از یک شکل تغییریافته از ریشه کلمه را تولید کند.
برای مثال، می‌توانیم پرچم "R" انگلیسی را به صورت زیر گسترش دهیم:
.PP
.RS
.nf
flag *R:
   E			>	R		# مانند skate > skater
   E			>	RS		# مانند skate > skaters
   [^AEIOU]Y	>	-Y,IER	# مانند multiply > multiplier
   [^AEIOU]Y	>	-Y,IERS	# مانند multiply > multipliers
   [AEIOU]Y	>	ER		# مانند convey > conveyer
   [AEIOU]Y	>	ERS		# مانند convey > conveyers
   [^EY]		>	ER		# مانند build > builder
   [^EY]		>	ERS		# مانند build > builders
.fi
.RE
.PP
این پرچم هم "skater" و هم "skaters" را از "skate" تولید می‌کند.
این قابلیت می‌تواند در زبان‌هایی که از پسوندهای اسم، فعل و صفت استفاده می‌کنند بسیار مفید باشد؛
برای مثال، می‌توان یک پرچم واحد تعریف کرد که تمام پسوندهای افعال «ضعیف» آلمانی را تولید کند.
.SH "همچنین ببینید (SEE ALSO)"
.BR ispell (1),
.BR buildhash (1),
.BR munchlist (1),
.BR sort (1)