"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "man.cgi.8" between
mdocml-1.13.4rc1.tar.gz and mdocml-1.13.4rc2.tar.gz

About: mdocml is a suite of tools compiling "-mdoc", the roff macro package of choice for BSD manual pages, and "-man", the predominant historical package for UNIX manuals. Hint: The installed binary name is "mandoc". Release candidate.

man.cgi.8  (mdocml-1.13.4rc1):man.cgi.8  (mdocml-1.13.4rc2)
skipping to change at line 112 skipping to change at line 112
when opening mandoc.db(5) and manual page files. when opening mandoc.db(5) and manual page files.
SCRIPT_NAME SCRIPT_NAME
The initial component of URIs, to be specified without leading and trailing slashes. It can be The initial component of URIs, to be specified without leading and trailing slashes. It can be
empty. empty.
After editing cgi.h, run After editing cgi.h, run
make man.cgi make man.cgi
and copy the files to the proper locations. Reading the installcgi target and copy the resulting binary to the proper location, for example using the
in the Makefile can help with command:
that, but do not run it without carefully checking it because the directory
layouts of web servers vary make installcgi
greatly.
In addition to that, make sure the default manpath contains the files man1/
apropos.1 and man8/man.cgi.8,
or the documentation links at the bottom of the index page will not work.
URI interface URI interface
man.cgi uniform resource identifiers are not needed for interactive use, bu t can be useful for deep link- man.cgi uniform resource identifiers are not needed for interactive use, bu t can be useful for deep link-
ing. They consist of: ing. They consist of:
1. The http:// protocol specifier. 1. The http:// protocol specifier.
2. The host name. 2. The host name.
3. The SCRIPT_NAME, preceded by a slash unless empty. 3. The SCRIPT_NAME, preceded by a slash unless empty.
4. To show a single page, a slash, the manpath, another slash, and the na me of the requested file, for 4. To show a single page, a slash, the manpath, another slash, and the na me of the requested file, for
example /OpenBSD-current/man1/mandoc.1. This can be abbreviated accor ding to the following syntax: example /OpenBSD-current/man1/mandoc.1. This can be abbreviated accor ding to the following syntax:
[/manpath[/mansec][/arch]]/name[.sec] [/manpath][/mansec][/arch]/name[.sec]
5. For searches, a query string starting with a question mark and consist ing of key=value pairs, sepa- 5. For searches, a query string starting with a question mark and consist ing of key=value pairs, sepa-
rated by ampersands, for example ?manpath=OpenBSD-current&query=mandoc . Supported keys are manpath, rated by ampersands, for example ?manpath=OpenBSD-current&query=mandoc . Supported keys are manpath,
query, sec, arch, corresponding to apropos(1) -M, expression, -s, -S, respectively, and apropos, query, sec, arch, corresponding to apropos(1) -M, expression, -s, -S, respectively, and apropos,
which is a boolean parameter to select or deselect the apropos(1) quer y mode. For backward compati- which is a boolean parameter to select or deselect the apropos(1) quer y mode. For backward compati-
bility with the traditional man.cgi, sektion is supported as an alias for sec. bility with the traditional man.cgi, sektion is supported as an alias for sec.
Restricted character set Restricted character set
For security reasons, in particular to prevent cross site scripting attacks , some strings used by man.cgi For security reasons, in particular to prevent cross site scripting attacks , some strings used by man.cgi
can only contain the following characters: can only contain the following characters:
skipping to change at line 184 skipping to change at line 187
/htdocs /htdocs
The file system path to the server document root directory relative to the server chroot(2) direc- The file system path to the server document root directory relative to the server chroot(2) direc-
tory. This is part of the web server configuration and not specifi c to man.cgi. tory. This is part of the web server configuration and not specifi c to man.cgi.
/htdocs/mandoc.css /htdocs/mandoc.css
A style sheet for mandoc(1) HTML styling, referenced from each gene rated HTML page. A style sheet for mandoc(1) HTML styling, referenced from each gene rated HTML page.
/man Default man.cgi data directory containing all the manual trees. Ca n be overridden by MAN_DIR. /man Default man.cgi data directory containing all the manual trees. Ca n be overridden by MAN_DIR.
/man/mandoc/man1/apropos.1, /man/mandoc/man8/man.cgi.8
Manual pages documenting man.cgi itself, linked from the index page
.
/man/manpath.conf /man/manpath.conf
The list of available manpaths, one per line. If any of the lines in this file contains a slash The list of available manpaths, one per line. If any of the lines in this file contains a slash
(‘/’) or any character not contained in the Restricted character se t, man.cgi reports an internal (‘/’) or any character not contained in the Restricted character se t, man.cgi reports an internal
server error and exits without doing anything. server error and exits without doing anything.
/man/header.html /man/header.html
An optional file containing static HTML code to be inserted right a fter opening the <BODY> ele- An optional file containing static HTML code to be inserted right a fter opening the <BODY> ele-
ment. ment.
/man/footer.html /man/footer.html
 End of changes. 3 change blocks. 
10 lines changed or deleted 9 lines changed or added

Home  |  About  |  All  |  Newest  |  Fossies Dox  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTPS