version 1.15, 2016/03/18 13:22:27 |
version 1.19, 2016/07/10 10:05:33 |
|
|
.\" $Id$ |
.\" $Id$ |
.\" |
.\" |
.\" Copyright (c) 2014, 2015, 2016 Ingo Schwarze <schwarze@openbsd.org> |
.\" Copyright (c) 2014, 2015, 2016 Ingo Schwarze <schwarze@openbsd.org> |
.\" |
.\" |
|
|
CGI program searches for manual pages on a WWW server |
CGI program searches for manual pages on a WWW server |
and displays them to HTTP clients, |
and displays them to HTTP clients, |
providing functionality equivalent to the |
providing functionality equivalent to the |
.Xr apropos 1 |
|
and |
|
.Xr man 1 |
.Xr man 1 |
|
and |
|
.Xr apropos 1 |
utilities. |
utilities. |
It can use multiple manual trees in parallel. |
It can use multiple manual trees in parallel. |
.Ss HTML search interface |
.Ss HTML search interface |
Line 51 The effect of prepending a backslash to another charac |
|
Line 51 The effect of prepending a backslash to another charac |
|
in the current implementation, it has no effect. |
in the current implementation, it has no effect. |
.It |
.It |
A |
A |
.Dq Submit |
|
button to send a search request from the client to the server. |
|
.It |
|
A |
|
.Dq Reset |
|
button to undo any changes to the input boxes and the dropdown menus |
|
and reset them to the values contained in the |
|
.Ev QUERY_STRING . |
|
.It |
|
Radio buttons to select pages either by name like in |
|
.Xr man 1 |
.Xr man 1 |
or using |
submit button. |
|
The string in the input box is interpreted as the name of a manual page. |
|
.It |
|
An |
.Xr apropos 1 |
.Xr apropos 1 |
queries. |
submit button. |
|
The string in the input box is interpreted as a search |
|
.Ar expression . |
.It |
.It |
A dropdown menu to optionally select a manual section. |
A dropdown menu to optionally select a manual section. |
If one is provided, it has the same effect as the |
If one is provided, it has the same effect as the |
Line 162 Configure your web server to execute CGI programs loca |
|
Line 157 Configure your web server to execute CGI programs loca |
|
.Pa /cgi-bin . |
.Pa /cgi-bin . |
When using |
When using |
.Ox |
.Ox |
.Xr httpd 8 |
.Xr httpd 8 , |
or |
|
.Xr nginx 8 , |
|
the |
the |
.Xr slowcgi 8 |
.Xr slowcgi 8 |
proxy daemon is needed to translate FastCGI requests to plain old CGI. |
proxy daemon is needed to translate FastCGI requests to plain old CGI. |
|
|
.Pp |
.Pp |
.Dl make man.cgi |
.Dl make man.cgi |
.Pp |
.Pp |
and copy the files to the proper locations. |
and copy the resulting binary to the proper location, |
Reading the |
for example using the command: |
.Cm installcgi |
.Pp |
target in the |
.Dl make installcgi |
.Pa Makefile |
.Pp |
can help with that, but do not run it without carefully checking it |
In addition to that, make sure the default manpath contains the files |
because the directory layouts of web servers vary greatly. |
.Pa man1/apropos.1 |
|
and |
|
.Pa man8/man.cgi.8 , |
|
or the documentation links at the bottom of the index page will not work. |
.Ss URI interface |
.Ss URI interface |
.Nm |
.Nm |
uniform resource identifiers are not needed for interactive use, |
uniform resource identifiers are not needed for interactive use, |
Line 318 The web server may pass the following CGI variables to |
|
Line 314 The web server may pass the following CGI variables to |
|
.Nm : |
.Nm : |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
.It Ev SCRIPT_NAME |
.It Ev SCRIPT_NAME |
The initial part of the the URI passed from the client to the server, |
The initial part of the URI passed from the client to the server, |
starting after the server's host name and ending before |
starting after the server's host name and ending before |
.Ev PATH_INFO . |
.Ev PATH_INFO . |
This is ignored by |
This is ignored by |
|
|
data directory containing all the manual trees. |
data directory containing all the manual trees. |
Can be overridden by |
Can be overridden by |
.Dv MAN_DIR . |
.Dv MAN_DIR . |
.It Pa /man/mandoc/man1/apropos.1 , /man/mandoc/man8/man.cgi.8 |
|
Manual pages documenting |
|
.Nm |
|
itself, linked from the index page. |
|
.It Pa /man/manpath.conf |
.It Pa /man/manpath.conf |
The list of available manpaths, one per line. |
The list of available manpaths, one per line. |
If any of the lines in this file contains a slash |
If any of the lines in this file contains a slash |