1HTAGS-SERVER(1)             General Commands Manual            HTAGS-SERVER(1)
2
3
4

NAME

6       htags-server - a private Web/CGI server for htags
7

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

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

EXAMPLES

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

DIAGNOSTICS

61       Htags-server  exits  with  a non-0 value if an error occurred, 0 other‐
62       wise.
63

SEE ALSO

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

AUTHOR

71       Shigio YAMAGUCHI.
72

HISTORY

74       The htags-server command appeared in GLOBAL-6.3 (2014).
75
76
77
78GNU Project                      November 2016                 HTAGS-SERVER(1)
Impressum