r4121 - trunk/varnish-cache/bin/varnishd

[ssm at projects.linpro.no]

Author: ssm
Date: 2009-06-18 10:03:33 +0200 (Thu, 18 Jun 2009)
New Revision: 4121

Modified:
   trunk/varnish-cache/bin/varnishd/varnishd.1
Log:
Use correct syntax for quotes, emphasis and punctuation in varnishd.1

Modified: trunk/varnish-cache/bin/varnishd/varnishd.1
===================================================================
--- trunk/varnish-cache/bin/varnishd/varnishd.1	2009-06-17 14:30:42 UTC (rev 4120)
+++ trunk/varnish-cache/bin/varnishd/varnishd.1	2009-06-18 08:03:33 UTC (rev 4121)
@@ -375,15 +375,18 @@
 or
 .Va server.ip
 depending on the presence of a Host: header in the request sent by the
-client.  The object hash may be modified further by
+client.
+The object hash may be modified further by
 .Va VCL.
 .It Cm purge.list
 Display the purge list.
 .Pp
 All requests for objects from the cache are matched against items on
-the purge list.  If an object in the cache is older than a matching
-purge list item, it is considered "purged", and will be fetched from
-the backend instead.
+the purge list.
+If an object in the cache is older than a matching purge list item, it
+is considered
+.Qq purged ,
+and will be fetched from the backend instead.
 .Pp
 When a purge expression is older than all the objects in the cache, it
 is removed from the list.
@@ -633,9 +636,10 @@
 .Dv off .
 .El
 .Ss Purge expressions
-A purge expression consists of one or more conditions.  A condition
-consists of a field, a operator, and an argument. Conditions can be
-ANDed together with "&&".
+A purge expression consists of one or more conditions.
+A condition consists of a field, an operator, and an argument.
+Conditions can be ANDed together with
+.Qq && .
 .Pp
 A field can be any of the variables from VCL, for instance
 .Va req.url ,
@@ -643,13 +647,27 @@
 or
 .Va obj.set-cookie .
 .Pp
-Operators are "==" for direct comparision, "~" for a regular
-expression match, and ">" or "<" for size comparisons.  Prepending an
-operator with "!" negates the expression.
+Operators are
+.Qq ==
+for direct comparision,
+.Qq ~
+for a regular expression match, and
+.Qq >
+or
+.Qq <
+for size comparisons.
+Prepending an operator with
+.Qq \&!
+negates the expression.
 .Pp
 The argument could be a quoted string, a regexp, or an integer.
-Integers can have "KB", "MB", "GB" or "TB" appended for size related
-fields.
+Integers can have 
+.Qq KB ,
+.Qq MB ,
+.Qq GB
+or
+.Qq TB
+appended for size related fields.
 .Pp
 Simple example: All requests where
 .Va req.url
@@ -660,15 +678,19 @@
 req.url == "/news"
 .Ed
 .Pp
-Example: Purge all documents where the name does not end with ".ogg",
+Example: Purge all documents where the name does not end with
+.Qq .ogg ,
 and where the size of the object is greater than 10 megabytes.
 .Bd -literal -offset 4n
 req.url !~ "\\.ogg$" && obj.size > 10MB
 .Ed
 .Pp
-Example: Purge all documents where the serving host is "example.com"
-or "www.example.com", and where the Set-Cookie header received from
-the backend contains "USERID=1663".
+Example: Purge all documents where the serving host is
+.Qq example.com
+or
+.Qq www.example.com ,
+and where the Set-Cookie header received from the backend contains
+.Qq USERID=1663 .
 .Bd -literal -offset 4n
 req.http.host ~ "^(www\\.)example.com$" && obj.set-cookie ~ "USERID=1663"
 .Ed