1HTAGS-SERVER(1) General Commands Manual HTAGS-SERVER(1)
2
3
4
6 htags-server - a private Web/CGI server for htags
7
9 htags-server [-b ip-address][-u language][--retry[=n]][port]
10
12 Htags-server is a private Web/CGI server for the hyper-text generated
13 by htags(1).
14
15 In advance of using this command, you should execute htags(1). Then
16 you can execute htags-server at the same place. You can start browsing
17 at 'http://localhost:8000/' by default. To stop the server, just press
18 on 'CTRL-C'.
19
20 Python 2/3 or Ruby equipped with WEBrick is required. By default,
21 htags-server looks for python first, if not found then looks for ruby.
22
24 The following options are available:
25
26 -b, --bind ip-address
27 Specifies the IP address on which htags-server listen. The
28 default value is 127.0.0.1.
29
30 -u, --use language
31 Specifies language to use, which may be one of: ´python´ and
32 ´ruby´.
33
34 --retry[=n]
35 If the port is already in use, retry n times with incrementing
36 the port number. The default of n is 20.
37
38 port Specifies the port on which htags-server listen. If you want to
39 use multiple sessions, you must use unique number for each
40 htags-server. The default value is 8000.
41
43 $ gtags
44 $ htags --suggest2
45 $ htags-server
46 Python2 http/cgi server
47 Serving HTTP on 127.0.0.1 port 8000 ...
48
49 (another terminal)
50 $ firefox http://localhost:8000/
51
52 $ htags-server
53 Error: port 8000 already in use.
54 $ htags-server --retry
55 Warning: port 8000 already in use (skipped)
56 Please access at http://127.0.0.1:8001
57 Python2 http/cgi server
58 Serving HTTP on 127.0.0.1 port 8001 ...
59
61 Htags-server exits with a non-0 value if an error occurred, 0 other‐
62 wise.
63
65 global(1), gtags(1), htags(1), python(1), ruby(1).
66
67 GNU GLOBAL source code tag system
68 (http://www.gnu.org/software/global/).
69
71 Shigio YAMAGUCHI.
72
74 The htags-server command appeared in GLOBAL-6.3 (2014).
75
76
77
78GNU Project November 2016 HTAGS-SERVER(1)