games/mix: implement Knuth's specification for comments

[plan9front.git] / sys / man / 4 / webfs

diff --git a/sys/man/4/webfs b/sys/man/4/webfs
index 2a50a54abd8a402071d69090b60e0fe6b01ae243..b50385370fcd3717a1b521c254d5514e627a0713 100644 (file)
--- a/sys/man/4/webfs
+++ b/sys/man/4/webfs
@@ -31,11 +31,11 @@ and, if
 is specified, will post a service file descriptor in 
 .BR /srv/\fIservice .
 .PP
-If the enviroment variable
+If the environment variable
 .B httpproxy
 is set, all HTTP request initiated by
 .I webfs
-will be made thru that proxy url.
+will be made through that proxy url.
 .PP
 .I Webfs
 presents a three-level file system suggestive
@@ -44,7 +44,7 @@ of the network protocol hierarchies
 and
 .IR ether (3).
 .PP
-The top level contains the files files:
+The top level contains the two files:
 .BR ctl ,
 and
 .BR clone .
@@ -59,6 +59,32 @@ file yields the current values of the parameters.
 Writing strings of the form
 .RB `` attr " " value ''
 sets a particular attribute.
+.PP
+The following global parameters can be set:
+.TP
+.B useragent
+Sets the HTTP user agent string.
+.TP
+.B timeout
+Sets the request timeout in seconds.
+.TP
+.BI flushauth " url"
+Flushes any associated authentication information for
+resources under
+.I url
+or all resources if no url was given.
+.TP
+.BI preauth " url realm"
+Preauthenticates all resources under
+.I url
+with the given
+.I realm
+using HTTP Basic authentication. This will cause
+.I webfs
+to preemptively send the resulting authorization information
+not waiting for the server to respond with an
+HTTP 401 Unauthorized status.
+.PP
 The top-level directory also contains
 numbered directories corresponding to connections, which
 may be used to fetch a single URL.
@@ -85,9 +111,9 @@ The
 .B baseurl
 attribute sets the URL against which relative URLs
 are interpreted.
-Once the URL has been set by wrting to the
+Once the URL has been set by writing to the
 .B ctl
-file of the connetcion, its pieces can be retrieved via
+file of the connection, its pieces can be retrieved via
 individual files in the
 .B parsed
 directory:
@@ -122,12 +148,12 @@ file will fail and return a error string.
 .PP
 When the
 .B body
-file has been opend, response headers appear
+file has been opened, response headers appear
 as files in the connection directory. For example
 reading the
 .B contenttype
 file yields the MIME content type of the body data.
-If the request was redirected, the URL represended
+If the request was redirected, the URL represented
 by the
 .B parsed
 directory will change to the final destination.
@@ -149,13 +175,13 @@ Sets a custom useragent string to be used with the request.
 Sets the MIME content type of the postbody.
 .TP
 .B request
-Usualy, the HTTP method used is
+Usually, the HTTP method used is
 .B POST
 when
 .B postbody
 file is opend first or
 .B GET
-otherwise. This can be overriden with the
+otherwise. This can be overridden with the
 .B request
 attribute so send arbitrary HTTP requests.
 .TP
@@ -176,3 +202,7 @@ For cookies to work,
 should be running and mounted on
 .B /mnt/webcookies
 otherwise cookies will be ignored.
+.SH HISTORY
+.I Webfs
+first appeared in Plan 9 from Bell Labs. It was
+rewritten from scratch for 9front (January, 2012).