discuss@mandoc.bsd.lv
 help / color / mirror / Atom feed
From: Kristaps Dzonsons <kristaps@bsd.lv>
To: discuss@mdocml.bsd.lv
Subject: CGI documentation notes in INSTALL/TODO
Date: Mon, 18 Aug 2014 12:13:09 +0200	[thread overview]
Message-ID: <53F1D1B5.4050305@bsd.lv> (raw)

[-- 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.

                 reply	other threads:[~2014-08-18 10:13 UTC|newest]

Thread overview: [no followups] expand[flat|nested]  mbox.gz  Atom feed

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=53F1D1B5.4050305@bsd.lv \
    --to=kristaps@bsd.lv \
    --cc=discuss@mdocml.bsd.lv \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).