[BACK]Return to cgi.h.example CVS log [TXT][DIR] Up to [cvsweb.bsd.lv] / mandoc

File: [cvsweb.bsd.lv] / mandoc / cgi.h.example (download)

Revision 1.3, Mon Jul 21 15:45:17 2014 UTC (6 years, 4 months ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_13_3, VERSION_1_13_2, VERSION_1_13_1
Changes since 1.2: +2 -1 lines

Kristaps points out that the current HTTP/1.1 draft standard (RFC
2616) requires the Location: response-header field to be an absolute
URI (14.30), and only the most recent proposed standard (RFC 7231),
which is barely a month old, allows a relative Location: (7.1.2).
While most modern browsers appear to support relative Location:
headers, some may not, and it's maybe a bit early to rely on relative
Location: headers.

I'm not going back to the HTTP_HOST or SERVER_NAME CGI variables,
though.  While some CGI programs certainly require those, in which
case both the CGI programmer and the web server admin have to be
very careful to keep the system secure and reliable, man.cgi(8)
does not really need them.  We always know at compile time which
domain we are running for, and for man.cgi(8), security and reliability
are definitely much more important than flexibility.  So make HTTP_HOST
a compile-time definition for now.

/* Example compile-time configuration file for man.cgi(8). */

#define	HTTP_HOST "mdocml.bsd.lv"
#define	MAN_DIR "/var/www/man"
#define	CSS_DIR ""
#define	CUSTOMIZE_TITLE "Manual pages with mandoc"
#define	CUSTOMIZE_BEGIN "<H2>\nManual pages with " \
	"<A HREF=\"http://mdocml.bsd.lv/\">mandoc</A>\n</H2>"
#define	COMPAT_OLDURI Yes