Annotation of mandoc/man.cgi.7, Revision 1.9
1.8 kristaps 1: .Dd $Mdocdate: December 11 2011 $
1.1 kristaps 2: .Dt MAN.CGI 7
3: .Os
4: .Sh NAME
5: .Nm man.cgi
6: .Nd cgi for manpage query and display
7: .Sh SYNOPSIS
8: .Nm
9: .Sh DESCRIPTION
10: The
11: .Nm
12: script queries and displays manual pages.
13: It interfaces with
14: .Xr mandocdb 8
1.5 kristaps 15: databases cached with
1.2 kristaps 16: .Xr catman 8 .
1.1 kristaps 17: .Pp
1.2 kristaps 18: To use
19: .Nm ,
1.5 kristaps 20: create a manual cache in
1.2 kristaps 21: .Xr catman 8 .
1.5 kristaps 22: Assign this directory to the environment variable
23: .Ev CACHE_DIR ,
24: defaulting to
25: .Pa /cache/man.cgi .
26: Copy the
27: .Pa man.cgi
28: script into your CGI directory (see
29: .Sx FILES
30: for other relevant files).
31: .Pp
32: Multiple
33: .Xr catman 8
34: trees may be managed by
35: .Nm :
36: directories under
1.1 kristaps 37: .Ev CACHE_DIR
1.5 kristaps 38: containing
39: .Pa etc/catman.conf
40: are identified as
41: .Qq manroots .
1.6 kristaps 42: The path of a manroot under
1.5 kristaps 43: .Ev CACHE_DIR
44: is converted to a name by replacing path separators with spaces.
45: .Pp
46: Thus, if
47: .Ev CACHE_DIR
48: is the default
49: .Pa /cache/man.cgi ,
50: the web-server is jailed to
51: .Pa /var/www ,
52: and cache subdirectories
53: .Pa ./foo/1
54: and
55: .Pa ./bar/2
56: contain
57: .Pa etc/catman.conf ,
58: .Nm
59: will assign these to manroots
60: .Qq foo 1
61: and
62: .Qq bar 2 ,
63: respectively.
64: These names will appear as choices when searching for manuals.
65: .Pp
66: If
67: .Nm
68: finds only one manroot, or none, then the selection box is omitted.
69: If no manroot is specified during search, the first manroot is used by
70: default.
1.1 kristaps 71: .Sh ENVIRONMENT
72: .Bl -tag -width Ds
1.8 kristaps 73: .It Ev CACHE_DIR
1.1 kristaps 74: The absolute path of the
1.2 kristaps 75: .Xr catman 8
1.1 kristaps 76: cache directory.
1.9 ! kristaps 77: This must not have a trailing slash.
1.8 kristaps 78: .It Ev CSS_DIR
1.7 kristaps 79: Prepended to CSS file links.
1.9 ! kristaps 80: This must not have a trailing slash.
1.1 kristaps 81: .El
82: .Sh FILES
1.4 kristaps 83: .Bl -tag -width Ds
84: .It Pa etc/catman.conf
85: Built by
86: .Xr catman 8
1.5 kristaps 87: and must exist at least once under the configuration directory root.
1.4 kristaps 88: .It Pa man.css
89: Must be visible in the server document root, used for styling source
90: manual page output.
91: .It Pa catman.css
92: Must be visible in the server document root, used for styling
93: pre-formatted manual page output.
94: .It Pa man.cgi.css
95: Must be visible in the server document root, used for general styling of
96: .Nm
97: search and error pages.
98: .El
1.5 kristaps 99: .Sh COMPATIBILITY
100: The
101: .Nm
102: script is call-compatible with queries from the traditional
103: .Pa man.cgi
104: script by Wolfram Schneider.
105: However, the results may not be quite the same.
1.1 kristaps 106: .Sh SEE ALSO
1.2 kristaps 107: .Xr catman 8 ,
1.1 kristaps 108: .Xr mandocdb 8
109: .Sh AUTHORS
110: The
111: .Nm
112: utility was written by
113: .An Kristaps Dzonsons ,
114: .Mt kristaps@bsd.lv .
1.5 kristaps 115: .Sh CAVEATS
116: If you're running in a jailed web-server, make sure the
117: .Pa /tmp
118: directory exists and is writable.
119: The databases may need this for scratch space.
CVSweb