CGI documentation notes in INSTALL/TODO

CGI documentation notes in INSTALL/TODO

[Kristaps Dzonsons]

[-- Attachment #1: Type: text/plain, Size: 170 bytes --]

Hi,

Enclosed are some minor notes uncovered while deploying man.cgi from 
HEAD on a Mac.  No code here: just documentation and a little wish-list.

Ok?

Best,

Kristaps

[-- Attachment #2: cgi-doc.diff --]
[-- Type: text/plain, Size: 1764 bytes --]

Index: INSTALL
===================================================================
RCS file: /usr/vhosts/mdocml.bsd.lv/cvs/mdocml/INSTALL,v
retrieving revision 1.4
diff -u -p -r1.4 INSTALL
--- INSTALL	16 Aug 2014 19:00:01 -0000	1.4
+++ INSTALL	18 Aug 2014 10:12:29 -0000
@@ -42,7 +42,8 @@ system, please consult your operating sy
 To install mandoc manually, the following steps are needed:
 
 1. If you want to build the CGI program, man.cgi(8), too, run the
-command "echo BUILD_CGI=1 > configure.local".
+command "echo BUILD_CGI=1 > configure.local".  Then run "cp
+cgi.h.examples cgi.h" and edit cgi.h as desired.
 
 2. Run "./configure".
 This script attempts autoconfiguration of mandoc for your system.
Index: TODO
===================================================================
RCS file: /usr/vhosts/mdocml.bsd.lv/cvs/mdocml/TODO,v
retrieving revision 1.178
diff -u -p -r1.178 TODO
--- TODO	13 Aug 2014 22:17:51 -0000	1.178
+++ TODO	18 Aug 2014 10:12:29 -0000
@@ -442,3 +442,16 @@ Several areas can be cleaned up to make 
   abstract from the database structure, too.
   suggested by espie@  Sat, 19 Apr 2014 14:52:57 +0200
 
+************************************************************************
+* CGI issues
+************************************************************************
+
+ - Enable HTTP compression by detecting gzip encoding and filtering
+   output through libz.
+ - Sandbox (see OpenSSH).
+ - Enable caching support via HTTP 304 and If-Modified-Since.
+ - Allow for cgi.h to be overridden by CGI environment variables.
+   Otherwise, binary distributions will inherit the compile-time
+   behaviour, which is not optimal.
+ - Have Mac OSX systems automatically disable -static compilation of the
+   CGI: -static isn't supported.