.\" Man page for zsoelim
.\"
.\" Copyright (C), 1994, 1995, Graeme W. Wilford. (Wilf.)
.\"
.\" You may distribute under the terms of the GNU General Public
.\" License as specified in the file docs/COPYING.GPLv2 that comes with the
.\" man-db distribution.
.\"
.\" Sat Dec 10 19:33:32 GMT 1994  Wilf. (G.Wilford@ee.surrey.ac.uk)
.\"
.pc
.TH ZSOELIM 1 "2025-05-02" "2.13.1" "Manual pager utils"
.SH "نام (NAME)"
zsoelim \- برآورده‌سازی و جایگزینی درخواست‌های .so در ورودی‌های roff
.SH "خلاصه دستور (SYNOPSIS)"
.B zsoelim
.RB [\| \-CVh \|]
.RI [\| file
\&.\|.\|.\|]
.SH "توضیحات (DESCRIPTION)"
دستور
.B zsoelim
آرگومان‌های
.I file
یا در صورت مشخص نشدن، ورودی استاندارد خود را برای یافتن خطوطی به شکل زیر پردازش و تجزیه می‌کند:

.B .so
.RI <\| filename \|>

این درخواست‌ها با محتوای
.I filename
مشخص‌شده جایگزین می‌شوند.
اگر درخواست نتواند برآورده شود،
.B zsoelim
به دنبال
.I filename.ext
می‌گردد که در آن
.I .ext
می‌تواند یکی از پسوندهای
.BR .gz ،
.B .Z
یا
.B .z
باشد.
بسته به گزینه‌های زمان کامپایل، ممکن است انواع پسوندهای دیگر نیز پشتیبانی شوند.
اگر درخواست بتواند با یک فایل فشرده برآورده شود، این فایل با استفاده از یک ابزار مناسب از حالت فشرده خارج شده و خروجی آن برای پاسخ به درخواست به کار می‌رود.

به‌طور سنتی، برنامه‌های
.B soelim
برای این استفاده می‌شدند که به پیش‌پردازنده‌های roff امکان دهند فایل‌های مورد ارجاع در درخواست‌ها را پیش‌پردازش کنند.
این نسخهٔ خاص برای برطرف کردن مشکلاتی نوشته شده است که به دلیل پشتیبانی از صفحات راهنمای فشرده‌شده به وجود آمده بودند.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BR \-C ", " \-\-compatible
این گزینه برای سازگاری با سایر برنامه‌های
.B soelim
در دسترس است.
کاربرد آن فعال‌سازی درخواست‌های .so است که پس از آن‌ها چیزی غیر از نویسه‌های فاصله (whitespace) آمده باشد.
از آنجا که این رفتار در حال حاضر رفتار پیش‌فرض است، نادیده گرفته می‌شود.
.TP
.BR \-h ", " \-\-help
چاپ پیام راهنما و خروج.
.TP
.BR \-V ", " \-\-version
نمایش اطلاعات نسخه.
.SH "همچنین ببینید (SEE ALSO)"
.BR groff (1),
.BR man (1),
.BR nroff (1),
.BR troff (1)
.SH "نویسندگان (AUTHORS)"
.nf
Wilf.\& (G.Wilford@ee.surrey.ac.uk).
Fabrizio Polacco (fpolacco@debian.org).
Colin Watson (cjwatson@debian.org).
.fi
.SH "گزارش اشکالات (BUGS)"
https://gitlab.com/man-db/man-db/\-/issues
.br
https://savannah.nongnu.org/bugs/?group=man\-db