.\" Text automatically generated by txt2man
.TH src2man 1 "14 July 2024" "txt2man-1.7.1" ""
.SH "نام (NAME)"
src2man \- استخراج صفحات راهنما از فایل‌های منبع
.SH "خلاصه دستور (SYNOPSIS)"
.nf
.fam C
\fBsrc2man\fP [\fB-n\fP][\fB-d\fP date][\fB-v\fP volume][\fB-r\fP \fIrelease\fP] [\fIsrcfile\fP \.\.\.]
.fam T
.fi
.fam T
.fi
.SH "توضیحات (DESCRIPTION)"
دستور \fBsrc2man\fP فایل منبع \fIsrcfile\fP را بررسی می‌کند. در حال حاضر تنها
فایل‌های منبع C پشتیبانی می‌شوند. بلوک‌های توضیحات که با "/** num" شروع
می‌شوند (که در آن num شمارهٔ بخش است)، با استفاده از \fBtxt2man\fP(1) به
یک فایل man تبدیل می‌شوند.
.PP
نخستین خط از بلوک توضیح باید شامل نام صفحهٔ راهنما (معمولاً نام تابع)،
و به دنبال آن یک "-" و شرحی کوتاه باشد. خطوط بعدی محتوای بخش
"DESCRIPTION" خواهند بود، مگر اینکه با حروف بزرگ نوشته شده باشند که
در این صورت بخش جدیدی را تعریف می‌کنند.
.PP
اگر خطِ بعد از یک بلوک توضیح خالی باشد، هیچ بخش "SYNOPSIS" تولید
نخواهد شد. در غیر این صورت، \fBsrc2man\fP در خطوط بعدی منبع به دنبال اعلان اولیهٔ تابع (prototype)
یا تعریف نوع (مانند struct، union، typedef و \.\.\.) متناظر با نام صفحهٔ راهنما
می‌گردد و آن را در بخش "SYNOPSIS" می‌گنجاند. این کار از تکرار تعریف نوع
یا اعلان تابع در بلوک توضیح جلوگیری می‌کند.
.PP
بهترین مکان برای مستندسازی کد در همان فایل منبع است که بدنه در آن پیاده‌سازی
شده است، نه فایل سرآیند (header) که فقط حاوی اعلان اولیه است. \fBsrc2man\fP
به‌طور خودکار وجود اعلان اولیه را در فایل سرآیند مربوطه جستجو می‌کند و در
صورت یافتن، یک عبارت "#include" را در خلاصه دستور (synopsis) درج می‌نماید.
.SH "گزینه‌ها (OPTIONS)"
.TP
.B
\fB-d\fP date
تنظیم تاریخ صفحات راهنما. پیش‌فرض تاریخ جاری است.
.TP
.B
\fB-n\fP
هیچ صفحهٔ راهنمایی ایجاد نمی‌شود. نام صفحات راهنمایی که قرار بود ایجاد
شوند چاپ می‌شود.
.TP
.B
\fB-v\fP volume
مشخص کردن نام جلد (volume) برای چاپ در وسط سربرگ صفحات man تولیدشده.
.TP
.B
\fB-r\fP \fIrelease\fP
مشخص کردن نام پروژه و شمارهٔ انتشار (\fIrelease\fP) برای صفحهٔ man تولیدشده.
.SH "محیط (ENVIRONMENT)"
.TP
.B
SOURCE_DATE_EPOCH
برچسب زمانی یونیکس (Unix timestamp) که به جای تاریخ جاری برای تاریخ در سربرگ استفاده می‌شود.
.SH "مثال‌ها (EXAMPLES)"
مثال زیر کد C و توضیحات را برای تولید صفحهٔ راهنمای foobar.3 نمایش می‌دهد:
.SS     /** 3
.IP \(bu 3
foobar - a sample dummy function
.IP \(bu 3
This line is now the first of the description section.
.IP \(bu 3
Note that function parameters parm1 and parm2 are highlighted
.IP \(bu 3
in the generated man page.
.SS      */
int \fBfoobar\fP(char *parm1, int parm2)
.SS     {
.SS        \.\.\.
return 0;
.SS     }

.SH "همچنین ببینید (SEE ALSO)"
\fBtxt2man\fP(1), \fBbookman\fP(1).
.SH "نویسندگان (AUTHORS)"
Marc Vertes <mvertes@free.fr>