commit 808787b11095bd7d342d96b49c0f43a6dd8e37a8
parent 3d55baac1d8c246cbe27a4850aced1a15a934c71
Author: uriel@soma <unknown>
Date: Fri, 10 Jul 2009 02:53:18 +0000
Documentation updates.
- Fix dumb mistake in wman docs
- Document Plan 9's httpd setup.
Diffstat:
2 files changed, 44 insertions(+), 1 deletion(-)
diff --git a/sites/werc.cat-v.org/apps/wman/index.md b/sites/werc.cat-v.org/apps/wman/index.md
@@ -31,3 +31,4 @@ TODO
* We don't handle compressed man pages, but this should be trivial to add.
* Unix systems might use different macros for their man pages.
* Search (using keywords? Google? grep?)
+* Inferno contains man pages named like 'foo-0intro', which are refered as foo-intro(X), should automatically add (or remove) the extra '0' (Examples: sys-intro(2) and draw-intro(2)).
diff --git a/sites/werc.cat-v.org/docs/web_server_setup/plan_9_httpd.md b/sites/werc.cat-v.org/docs/web_server_setup/plan_9_httpd.md
@@ -1,4 +1,46 @@
Setup werc with Plan 9's httpd
==============================
-Coming soon, thanks to soul9!
+
+There are two main options, you can use Russ Cox's magic to cgi translator
+(found in his contrib dir as cgi.c), or you can use the following script which
+while simpler, it also lacks some features at the moment.
+
+Thanks to soul9 for the original idea of wrapping werc in a shell script that
+would setup a cgi-like environment!
+
+
+ #!/bin/rc
+
+ SERVER_NAME=$2
+ REQUEST_URI=`{echo $*(15)}
+ REQUEST_URI=$REQUEST_URI(2)
+ REQUEST_URI=/
+ REQUEST_METHOD=$*(16)
+ PLAN9=/
+
+
+ echo 'HTTP/1.0 200 Ok
+ Connection: close
+ Server: werc/9.9.9' # This is whatever you like
+
+
+ cd /usr/web/bin/
+ rfork
+ /bin/rc < ./werc.rc >[2]/usr/glenda/tmp/w/log # Use whatever location you like to log stderr, but make sure it is writable by none.
+
+Call this script werc-wrap, and put it in /rc/bin/ip/httpd/
+
+Then in your /sys/lib/httpd.rewrite add a line like:
+
+ /w @/magic/werc-wrap
+
+And this will run werc for all stuff under /w. Note that apparently httpd is
+incapable of internally remapping the root directory, so until a solution is
+found for this, you will have to keep your site in a sub-directory of the web
+server root.
+
+**Notes**: This is experimental and work in progress, there are a couple of issues
+with the werc code itself that might need fixing, in particular you will need
+to replace the '%($"extraHeaders%)' in lib/headers.tpl with '% echo
+$"extraHeaders' no clue why.
