.TH "yodlverbinsert" "1" "1996\-2025" "yodl_4\&.05\&.01" "Your Own Document Language"

.PP 
.SH "نام (NAME)"
yodlverbinsert \- ایجاد بخش‌های verb از قسمت‌هایی از یک فایل
.PP 
.SH "خلاصه دستور (SYNOPSIS)"
\fByodlverbinsert\fP [OPTIONS] \fI[marker] file\fP
.PP 
.SH "توضیحات (DESCRIPTION)"

.PP 
برنامهٔ \fBVerbinsert\fP یک ابزار پشتیبان ساده بر پایهٔ \fBC++\fP است که برای ایجاد
بخش‌های \fIverb()\fP در فایل‌های \fBYodl\fP با استفاده از بخش‌هایی از فایل‌های
موجود به کار می‌رود\&. فایل‌هایی که بخش‌ها از آن‌ها درج می‌شوند معمولاً فایل‌های منبع \fBC\fP
یا \fBCpp\fP هستند که از توضیحات با سبک \fI//\fP یا \fI/*\fP پشتیبانی می‌کنند\&. برای
مشاهدهٔ نمونه‌ها، بخش \fBمثال‌ها (EXAMPLES)\fP را ببینید\&.
.PP 
دستور \fBVerbinsert\fP امکان دندانه‌دار کردن (indent) هم عبارت آغازین \fIverb\fP
و هم محتویات درج‌شدهٔ فایل را فراهم می‌کند\&. علاوه بر این، می‌توان یک خط خالی
اضافی پیش از اولین خطی که در عمل درج می‌شود وارد کرد\&.
.PP 
خطوط خالی در ابتدا و انتهای فایل‌ها نادیده گرفته می‌شوند\&.
.PP 
.IP o 
\fImarker\fP
.br 
آرگومان \fImarker\fP باید از ستون اول \fIfile\fP آغاز شود و باید به‌صورت یک توضیح
استاندارد \fBC\fP یا \fBC++\fP شروع شود: باید از \fI//\fP یا \fI/*\fP استفاده شود\&.
پس از آن، باقی‌ماندهٔ آرگومان به‌عنوان یک برچسب استفاده می‌شود، مانند
\fI//label\fP یا \fI/*label*/\fP\&. به‌جز دو نویسهٔ نخست و مکان آن‌ها، و دو نویسهٔ
پایانی یک نشانگر به سبک \fBC\fP، هیچ محدودیت خاصی بر نام‌های برچسب اعمال نمی‌شود\&.
یک بخش برچسب‌دار در اولین \fI//=\fP بعدی (برای برچسب‌هایی که با \fI//\fP آغاز می‌شوند)
یا در اولین \fI/**/\fP بعدی (برای برچسب‌هایی که با \fI/*\fP آغاز می‌شوند) به پایان می‌رسد\&.
همانند نشانگرها، نشانگرهای پایانی نیز باید در ستون اول خطوط آغاز شوند\&.
.IP 
همچنین می‌توان از جفت‌های \fI//+label\fP یا \fI/*+label*/\fP استفاده کرد\&. برای
چنین نشانگرهایی، رونوشت‌برداری از اولین خطِ پس از نخستین رخداد برچسب آغاز شده،
و هنگامی که برچسب دوباره مشاهده شود پایان می‌یابد\&. هنگامی که از این نشانگرها
استفاده می‌شود، هر خط نشانگر دیگری که متعاقباً دیده شود به‌سادگی نادیده گرفته شده
و در جریان خروجی نوشته نمی‌شود\&. این ویژگی اجازه می‌دهد که بخش‌های برچسب‌دار
به‌صورت تودرتو باشند\&.
.IP 
.IP o 
\fIfile\fP
.br 
آرگومان \fIfile\fP باید یک فایل موجود باشد\&.

.PP 
دستور \fBVerbinsert\fP بخش انتخاب‌شدهٔ خود را در جریان خروجی استاندارد می‌نویسد\&.
.PP 
هنگامی که فایل‌ها شامل بخش‌های نشانگر یکسان باشند، محتوای هر یک از این بخش‌های
نشانگر در بخش \fIverb\fP تولیدشده گنجانده می‌شود\&. این امکان، درج خطوط غیرمتوالی
از فایل‌های منبع را در یک بخش \fIverb\fP فراهم می‌سازد\&.
.PP 
.SH "گزینه‌ها (OPTIONS)"
مقادیر پیش‌فرض گزینه‌ها در کنار هر یک از گزینه‌ها درون کروشه درج شده‌اند\&.
پیش‌فرض‌ها به‌گونه‌ای انتخاب شده‌اند که \fByodlverbinsert\fP رفتار نسخهٔ قدیمی‌تر
این برنامه را ارائه دهد، که همراه با \fBYodl\fP توزیع نمی‌شد\&.
.IP o 
\fB\-a\fP
.br 
پردازش تمام خطوط \fIfile\fP (به‌جز خطوط خالی آغازین و پایانی)\&. آرگومان
\fImarker\fP نباید مشخص شود\&.
.IP o 
\fB\-A\fP
.br 
مشابه گزینهٔ \fI\-a\fP، اما نادیده گرفتن تمام خطوطی که می‌توانند خطوط نشانگر
(پایانی) \fIyodlverbinsert\fP محسوب شوند\&.
.IP o 
\fB\-k\fP
.br 
حفظ خطوط جدید (newlines) پس از
.nf 
 و قبل از 
.fi 
\&. این خطوط جدید باعث ایجاد خطوط خالی اضافی پیش از اولین و پس از آخرین خطوط
کد منبع می‌شوند\&. از نسخهٔ 4\&.02\&.00 به بعد این خطوط به‌طور پیش‌فرض حذف می‌شوند\&.
.IP o 
\fB\-n\fP
.br 
بلافاصله پس از دندانه‌بندی: خطوط با شماره‌ها پیشوندگذاری می‌شوند، که ۲ ستون
را اشغال کرده و به دنبال آن‌ها یک دونقطه و یک فاصله قرار می‌گیرد\&.
.IP o 
\fB\-N\fP
.br 
نوشتن نویسهٔ خط جدید بلافاصله پس از پرانتز باز عبارت \fIverb\fP انجام نشود\&.
به‌طور پیش‌فرض این نویسه نوشته می‌شود، که باعث درج یک خط اضافی پیش از نخستین
خطی می‌شود که در عمل از یک فایل درج شده است\&.
.IP o 
\fB\-s\fP \fInSpaces\fP [0]
.br 
آغاز هر خطی که در بخش \fIverb\fP نوشته می‌شود با \fInSpaces\fP فاصلهٔ اضافی\&.
.IP o 
\fB\-S\fP \fInSpaces\fP [8]
.br 
افزودن پیشوند \fInSpaces\fP فاصلهٔ اضافی به عبارت \fIverb\fP در بخش \fIverb\fP\&.
.IP o 
\fB\-t\fP \fInTabs\fP [0]
.br 
آغاز هر خطی که در بخش \fIverb\fP نوشته می‌شود با \fInTabs\fP نویسهٔ تب اضافی\&.
اگر هر دو گزینهٔ \fI\-s\fP و \fI\-t\fP مشخص شوند، تب‌ها ابتدا درج می‌شوند\&.
.IP o 
\fB\-T\fP \fInTabs\fP [0]
.br 
افزودن پیشوند \fInTabs\fP نویسهٔ تب اضافی به عبارت \fIverb\fP در بخش \fIverb\fP\&.
اگر هر دو گزینهٔ \fI\-S\fP و \fI\-T\fP مشخص شوند، تب‌ها ابتدا درج می‌شوند\&.

.PP 
.SH "مثال‌ها (EXAMPLES)"

.PP 
فرض کنید فایل \fIdemo\fP شامل متن زیر است:
.nf 

preceding text

//+nest
//one
one 1

//=

/*two*/

    two

/**/
//+nest

trailing text
    
.fi 

.PP 
آنگاه دستورهای زیر خروجی نشان‌داده‌شده را در خروجی استاندارد برنامه می‌نویسند:
.IP o 
\fIyodlverbinsert //one demo\fP
.br 
.nf 
        verb(
one 1
)

.fi 
.IP o 
\fIyodlverbinsert \-N //one demo\fP
.br 
.nf 
        verb(one 1
)

.fi 
.IP o 
\fIyodlverbinsert \-n \-s4 \(cq\&/*two*/\(cq\& demo\fP
.br 
.nf 
        verb(
        1: two
)

.fi 

.IP 
.IP o 
\fIyodlverbinsert \-n //+nest\(cq\& demo\fP
.br 
.nf 
        verb(
 1: one 1
 2:
 3:
 4:
 5:     two
)

.fi 

.PP 
.SH "همچنین ببینید (SEE ALSO)"

.PP 
\fByodl\fP(1), 
\fByodlbuiltins\fP(7), 
\fByodlconverters\fP(1), 
\fByodlletter\fP(7), 
\fByodlmacros\fP(7), 
\fByodlmanpage\fP(7),
\fByodlpost\fP(1), 
\fByodlstriproff\fP(1), 
\fByodltables\fP(7)\&.
.PP 
.SH "گزارش باگ‌ها (BUGS)"

.PP 
\-
.PP 
.SH "نویسندگان (AUTHORS)"

.PP 
Frank B\&. Brokken (f\&.b\&.brokken@rug\&.nl),