نام (NAME)

sgmlpre - مدیریت شرطی‌سازی SGML برای ابزارهای SGML-tools

خلاصه دستور (SYNOPSIS)

sgmlpre [options] ...

توضیحات (DESCRIPTION)

این صفحه راهنما به‌طور خلاصه دستور sgmlpre را شرح می‌دهد. این صفحه راهنما برای توزیع گنو/لینوکس دبیان نوشته شده است زیرا برنامه اصلی فاقد صفحه راهنما برای sgmlpre بود.

sgmlpre برنامه‌ای است که شرطی‌سازی SGML را برای SGML-tools مدیریت می‌کند.

این ابزار توسط سایر برنامه‌های موجود در sgml-tools (v1) استفاده می‌شود و معمولاً یک کاربر عادی نیازی به استفاده مستقیم از آن ندارد.

متن زیر برگرفته از سربرگ موجود در کد منبع است:

(شروع نقل‌قول)

sgmlpre -- مدیریت شرطی‌سازی SGML برای ابزارهای SGML-tools توسط Eric S. Raymond <esr@thyrsus.com>، ۳ نوامبر ۱۹۹۷

فیلتر کردن SGML بر اساس نشانه‌گذاری‌های شرطی‌ساز. جفت‌های آرگومان/مقدار در خط فرمان با مشخصه‌های تگ‌های <#if> و <#unless> تطبیق داده می‌شوند. محدوده‌های میان <#if>/</#if> در صورتی که هیچ عدم‌تطابقی در مشخصه‌ها نباشد، بدون تغییر عبور داده می‌شوند؛ محدوده‌های میان <#unless></#unless> در صورتی عبور داده می‌شوند که حداقل یک عدم‌تطابق در مشخصه‌ها وجود داشته باشد. عدم‌تطابق مشخصه زمانی رخ می‌دهد که مشخصه‌ای هم در آرگومان‌های خط فرمان و هم در تگ وجود داشته باشد اما مقادیر آن‌ها یکسان نباشد. تطبیق مقادیر بر اساس برابری رشته‌ای انجام می‌پذیرد، جز اینکه نویسه "|" به عنوان تفکیک‌کننده گزینه‌های انتخابی (یا) در نظر گرفته می‌شود. حتی اگر بخشی از متن حذف شود و عبور نکند، نویسه‌های خط جدید آن عبور داده می‌شوند (تا شماره خطوط در پیام‌های خطا دچار اختلال نشوند).

این تحلیل‌گر لغوی (lexer) به flex نیاز دارد. محدودیت‌ها: نام مشخصه‌ها حداکثر می‌تواند ۲۵۶ نویسه و مقادیر حداکثر می‌توانند ۱۶۳۸۴ (YY_BUF_SIZE) نویسه باشند. این ابزار بررسی نمی‌کند که حتماً </if> فقط با <if> و </unless> فقط با <unless> متناظر باشد (زیرا چنین بررسی نیازمند ساختار داده پشته بوده و محدودیت مضاعفی ایجاد می‌کرد).

(پایان نقل‌قول)

گزینه‌ها (OPTIONS)

این برنامه از گزینه‌های استاندارد خط فرمان پشتیبانی نمی‌کند.

همچنین ببینید (SEE ALSO)

برای توضیحات کامل، به سربرگ موجود در آرشیو کد منبع مراجعه کنید.

نویسندگان (AUTHORS)

sgmlpre توسط Eric S. Raymond <esr@thyrsus.com> در ۳ نوامبر ۱۹۹۷ نوشته شد.

این صفحه راهنما توسط Taketoshi Sano <sano@debian.org> برای سیستم گنو/لینوکس دبیان نوشته شده است (اما ممکن است توسط دیگران نیز استفاده شود). در حال حاضر توسط Agustin Martin <agustin6martin AT gmail com> نگهداری می‌شود.