.\" این فایل به‌صورت خودکار توسط convert.pl از htags-server/manual.in تولید شده است.
.TH HTAGS-SERVER 1 "نوامبر 2016" "GNU Project"
.SH "نام (NAME)"
htags\-server \- یک سرور Web/CGI اختصاصی برای htags
.SH "خلاصه دستور (SYNOPSIS)"
\fBhtags-server\fP [-b ip-address][-u language][--retry[=n]][\fIport\fP]
.br
.SH "توضیحات (DESCRIPTION)"
دستور \fBhtags-server\fP یک سرور Web/CGI اختصاصی برای ابرمتن‌های تولید شده توسط \fBhtags\fP(1) است.
.PP
پیش از استفاده از این دستور، باید \fBhtags\fP(1) را اجرا کنید.
سپس می‌توانید htags-server را در همان مکان اجرا نمایید.
به‌طور پیش‌فرض، می‌توانید مرور را از 'http://localhost:8000' آغاز کنید.
برای متوقف کردن سرور، کافی است کلید‌های 'CTRL-C' را فشار دهید.
.PP
پایتون ۲/۳ یا روبیِ مجهز به WEBrick مورد نیاز است.
به‌طور پیش‌فرض، \fBhtags-server\fP ابتدا به‌دنبال python می‌گردد؛ در صورت پیدا نشدن، به‌دنبال ruby خواهد گشت.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های زیر در دسترس هستند:
.TP
\fB-b\fP, \fB--bind\fP \fIip-address\fP
آدرس IP که \fBhtags-server\fP روی آن به درخواست‌ها گوش می‌دهد را مشخص می‌کند.
مقدار پیش‌فرض 127.0.0.1 است.
.TP
\fB-u\fP, \fB--use\fP \fIlanguage\fP
زبانی که باید استفاده شود را مشخص می‌کند، که می‌تواند یکی از موارد \'python\' و \'ruby\' باشد.
.TP
\fB--retry\fP[=\fIn\fP]
اگر درگاه از قبل در حال استفاده باشد، با افزایش شمارهٔ \fIport\fP، به تعداد \fIn\fP بار دوباره تلاش می‌کند. مقدار پیش‌فرض \fIn\fP برابر ۲۰ است.
.TP
\fIport\fP
درگاهی را مشخص می‌کند که \fBhtags-server\fP روی آن گوش می‌دهد.
اگر می‌خواهید از چندین نشست استفاده کنید، باید برای هر \fBhtags-server\fP از شماره‌ای یکتا استفاده کنید. مقدار پیش‌فرض 8000 است.
.SH "مثال‌ها (EXAMPLES)"
.nf
$ gtags
$ htags --suggest2
$ htags-server
Python2 http/cgi server
Serving HTTP on 127.0.0.1 port 8000 ...
.PP
(another terminal)
$ firefox http://localhost:8000
.PP
$ htags-server
Error: port 8000 already in use.
$ htags-server --retry
Warning: port 8000 already in use (skipped)
Please access at http://127.0.0.1:8001
Python2 http/cgi server
Serving HTTP on 127.0.0.1 port 8001 ...
.fi
.SH "خطاها (DIAGNOSTICS)"
در صورت بروز خطا، \fBhtags-server\fP با مقداری غیر از ۰ خارج می‌شود، و در غیر این صورت ۰ را برمی‌گرداند.
.SH "همچنین ببینید (SEE ALSO)"
\fBglobal\fP(1),
\fBgtags\fP(1),
\fBhtags\fP(1),
\fBpython\fP(1),
\fBruby\fP(1).
.PP
سامانه برچسب‌گذاری کد مبدا گنو گلوبال (GNU Global)
.br
(http://www.gnu.org/software/global).
.SH "نویسندگان (AUTHORS)"
Shigio YAMAGUCHI.
.SH "تاریخچه (HISTORY)"
دستور \fBhtags-server\fP در Global-6.3 (سال ۲۰۱۴) پدیدار شد.