.\" This file is generated automatically by convert.pl from libutil/manual.in.
.TH GTAGS.CONF 5 "Nov 2015" "GNU Project"
.SH "نام (NAME)"
gtags.conf \- داده‌های پیکربندی سامانه برچسب‌گذاری گنو گلوبال (GNU Global)
.SH "خلاصه دستور (SYNOPSIS)"
\'gtags.conf\'
.br
\'~/.globalrc\'
.br
.SH "توضیحات (DESCRIPTION)"
فایل
\'gtags.conf\'
حاوی داده‌های پیکربندی برای دستورات
\fBglobal\fP(1)،
\fBgozilla\fP(1)،
\fBgtags\fP(1)
و
\fBhtags\fP(1)
است. این دستورات به ترتیب زیر به دنبال فایل‌های پیکربندی می‌گردند و تنظیمات را از اولین فایلی که موجود و قابل خواندن باشد می‌خوانند:
.TP
(1) --gtagsconf \fIfile\fP
.TP
(2) $GTAGSCONF
.TP
(3) [project root]/gtags.conf
.TP
(4) [project root]/[objdir]/gtags.conf
.TP
(5) $HOME/.globalrc
.TP
(6) /etc/gtags.conf
.TP
(7) [sysconfdir]/gtags.conf
.PP
مقدار
[sysconfdir]
به‌طور پیش‌فرض
\'/usr/local/etc\'
است؛ می‌توانید آن را با استفاده از گزینه
.B \-\-sysconfdir
در اسکریپت پیکربندی
(configure)
تغییر دهید. مقدار
[objdir]
نیز به‌طور پیش‌فرض
\'obj\'
است؛ که می‌توانید آن را از طریق متغیرهای
\fBGTAGSOBJDIR\fP
یا
\fBMAKEOBJDIR\fP
تغییر دهید.
.PP
نحو (Syntax) نگارش این فایل، به جز چند مورد توسعه‌یافته که در ادامه شرح داده شده است، مشابه
\fBtermcap\fP(5)
است. یک فایل شامل یک یا چند رکورد است. شما باید با استفاده از یک برچسب (label)، یک رکورد را انتخاب کنید. برچسب پیش‌فرض
\'default\'
است. در صورتی که متغیر
\fBGTAGSLABEL\fP
تنظیم شده باشد، مقدار آن استفاده می‌شود. لطفاً توجه داشته باشید که مفهوم
\'default\'
با مفهوم آن در
\fBtermcap\fP(5)
متفاوت است.
.PP
خطوطی که با
\'#\'
شروع می‌شوند نادیده گرفته می‌شوند. یک رکورد شامل یک یا چند فیلد است که با
\':\'
از یکدیگر جدا شده و با یک خط جدید پایان می‌یابد. فیلد اول باید حاوی نام برچسب باشد. هر یک از فیلدهای بعدی شامل تعریف یک متغیر است. سه نوع متغیر در این فایل وجود دارد:
.TP
.B "بولی (Boolean)"
این نوع هیچ مقداری ندارد؛ وجود متغیر به معنای درست (true) و عدم وجود آن به معنای نادرست (false) است.
.TP
.B "عددی (Number)"
این نوع پس از علامت
\'#\'
یک مقدار عددی دارد.
.TP
.B "رشته‌ای (String)"
این نوع پس از علامت
\'=\'
یک مقدار رشته‌ای دارد. بیشتر متغیرها از نوع رشته‌ای هستند.
.PP
اگر داده‌ها شامل
\':\'
یا خط جدید باشند، باید با استفاده از
\'\\\'
اسکیپ (quote) شوند. استفاده از فیلد خالی مجاز است، اما کاربرد یا معنای خاصی ندارد.
.PP
هنگامی که بیش از یک تعریف برای یک متغیر وجود داشته باشد، تعریف پیشین در نظر گرفته می‌شود. به عنوان یک استثنا، تمامی مقادیر متغیرهای
\fBskip\fP،
\fBlangmap\fP
و
\fBgtags_parser\fP
پذیرفته شده و به ترتیب به یکدیگر متصل می‌شوند.
.SH "جایگزینی متغیرها (VARIABLE SUBSTITUTION)"
قابلیت جایگزینی متغیرها مشابه با
\fBsh\fP(1)
در دسترس است. می‌توانید با استفاده از پیشوند
\'$\'
به هر متغیر رشته‌ای ارجاع دهید. به عنوان مثال، در نمونه زیر متغیر
\fBb\fP
دارای مقدار
\'XYZ\'
خواهد بود:
.nf
:a=Y:b=X${a}Z:
.fi
.SH "گنجاندن رکوردی دیگر (INCLUDING ANOTHER RECORD)"
متغیر
\fBTc\fP
یک متغیر ویژه است؛ این متغیر تعاریف موجود در یک رکورد دیگر را بارگذاری می‌کند. این قابلیت مشابه با
\fBtc\fP
در
\fBtermcap\fP(5)
است. نحو نگارش آن به صورت زیر می‌باشد:
.br
\fBtc\fP=\fIlabel\fP[@\fIfile\fP]
.br
اگر تنها یک
\fIlabel\fP
ارائه شود،
\fBtc\fP
از رکوردی خوانده می‌شود که توسط همان
\fIlabel\fP
در همان فایل مشخص شده است. اگر
@\fIfile\fP
نیز ارائه شده باشد،
\fBtc\fP
از رکوردی خوانده می‌شود که توسط
\fIlabel\fP
در
\fIfile\fP
مشخص‌شده تعیین گردیده است. مسیر
\fIfile\fP
باید یک مسیر مطلق باشد و نباید شامل متغیرها شود. بر خلاف
\fBtermcap\fP(5)،
می‌توانید از
\fBtc\fP
در هر زمان و در هر کجا استفاده کنید.
.SH "پیکربندی (CONFIGURATION)"
درباره متغیرهای مربوط به هر دستور، لطفاً به صفحه راهنمای اختصاصی همان دستور مراجعه کنید.
.PP
می‌توانید از متغیرهای محیطی زیر به عنوان متغیر رشته‌ای استفاده کنید. در صورتی که این متغیرها تنظیم شده باشند، متغیرهای محیطی با همین نام‌ها پیش از اجرای دستور اعمال می‌شوند:
.br
\fBGREP_COLOR\fP
.br
\fBGREP_COLORS\fP
.br
\fBGTAGSBLANKENCODE\fP
.br
\fBGTAGSCACHE\fP
.br
\fBGTAGSFORCECPP\fP
.br
\fBGTAGSGLOBAL\fP
.br
\fBGTAGSGTAGS\fP
.br
\fBGTAGSLIBPATH\fP
.br
\fBGTAGSLOGGING\fP
.br
\fBGTAGSTHROUGH\fP
.br
\fBGTAGS_OPTIONS\fP
.br
\fBHTAGS_OPTIONS\fP
.br
\fBMAKEOBJDIR\fP
.br
\fBMAKEOBJDIRPREFIX\fP
.br
\fBTMPDIR\fP
.br
.PP
متغیرهای زیر نیز به عنوان متغیر رشته‌ای در دسترس هستند. به‌طور پیش‌فرض، هر یک از آن‌ها حاوی مسیر دایرکتوری تعیین‌شده توسط اسکریپت پیکربندی
(configure)
است:
.br
\fBbindir\fP
.br
\fBdatadir\fP
.br
\fBlibdir\fP
.br
\fBlocalstatedir\fP
.br
\fBsysconfdir\fP
.br
.SH "محیط (ENVIRONMENT)"
متغیرهای محیطی زیر بر نحوه اجرای دستورات تأثیر می‌گذارند:
.PP
.TP
\fBGTAGSCONF\fP
اگر این متغیر تنظیم شده باشد، مقدار آن به عنوان فایل پیکربندی استفاده می‌شود.
.TP
\fBGTAGSLABEL\fP
اگر این متغیر تنظیم شده باشد، مقدار آن به عنوان برچسب فایل پیکربندی استفاده می‌شود. مقدار پیش‌فرض
\fIdefault\fP
است.
.SH "همچنین ببینید (SEE ALSO)"
\fBglobal\fP(1)،
\fBgozilla\fP(1)،
\fBgtags\fP(1)،
\fBhtags\fP(1).
.PP
سامانه برچسب‌گذاری کد منبع گنو گلوبال (GNU Global)
.br
(http://www.gnu.org/software/global).
.SH "تاریخچه (HISTORY)"
فایل
\fBgtags.conf\fP
نخستین بار در Global-3.0 (سال ۱۹۹۸) ظاهر شد.