نام (NAME)

htags-server - یک سرور Web/CGI اختصاصی برای htags

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

htags-server [-b ip-address][-u language][--retry[=n]][port]

توضیحات (DESCRIPTION)

دستور htags-server یک سرور Web/CGI اختصاصی برای ابرمتن‌های تولید شده توسط htags(1) است.

پیش از استفاده از این دستور، باید htags(1) را اجرا کنید. سپس می‌توانید htags-server را در همان مکان اجرا نمایید. به‌طور پیش‌فرض، می‌توانید مرور را از 'http://localhost:8000' آغاز کنید. برای متوقف کردن سرور، کافی است کلید‌های 'CTRL-C' را فشار دهید.

پایتون ۲/۳ یا روبیِ مجهز به WEBrick مورد نیاز است. به‌طور پیش‌فرض، htags-server ابتدا به‌دنبال python می‌گردد؛ در صورت پیدا نشدن، به‌دنبال ruby خواهد گشت.

گزینه‌ها (OPTIONS)

گزینه‌های زیر در دسترس هستند:

-b, --bind ip-address: آدرس IP که htags-server روی آن به درخواست‌ها گوش می‌دهد را مشخص می‌کند. مقدار پیش‌فرض 127.0.0.1 است.
-u, --use language: زبانی که باید استفاده شود را مشخص می‌کند، که می‌تواند یکی از موارد ´python´ و ´ruby´ باشد.
--retry[=n]: اگر درگاه از قبل در حال استفاده باشد، با افزایش شمارهٔ port، به تعداد n بار دوباره تلاش می‌کند. مقدار پیش‌فرض n برابر ۲۰ است.
port: درگاهی را مشخص می‌کند که htags-server روی آن گوش می‌دهد. اگر می‌خواهید از چندین نشست استفاده کنید، باید برای هر htags-server از شماره‌ای یکتا استفاده کنید. مقدار پیش‌فرض 8000 است.

مثال‌ها (EXAMPLES)

$ gtags
$ htags --suggest2
$ htags-server
Python2 http/cgi server
Serving HTTP on 127.0.0.1 port 8000 ...

(another terminal)
$ firefox http://localhost:8000

$ 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 ...

خطاها (DIAGNOSTICS)

در صورت بروز خطا، htags-server با مقداری غیر از ۰ خارج می‌شود، و در غیر این صورت ۰ را برمی‌گرداند.

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

global(1), gtags(1), htags(1), python(1), ruby(1).

سامانه برچسب‌گذاری کد مبدا گنو گلوبال (GNU Global)
(http://www.gnu.org/software/global).

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

Shigio YAMAGUCHI.

تاریخچه (HISTORY)

دستور htags-server در Global-6.3 (سال ۲۰۱۴) پدیدار شد.