Avoid accessing backup, auto-save files, etc, with include-lookup.

[userv.git] / spec.sgml

diff --git a/spec.sgml b/spec.sgml
index 86d612e98095314682b22c459f785e30810db5d0..57329a46255a4327a112c98d6e3385f51a85c905 100644 (file)
--- a/spec.sgml
+++ b/spec.sgml
@@ -3,7 +3,7 @@
 <book>
 <title>User service daemon and client specification
 <author>Ian Jackson <email>ian@davenant.greenend.org.uk
-<version>0.62</version>
+<version>0.64.1</version>
 
 <abstract>
 This is a specification for a Unix system facility to allow one
@@ -30,7 +30,7 @@ You should have received a copy of the GNU General Public License
 along with <prgn/userv/; if not, write to the Free Software
 Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
 
-<toc sect1>
+<toc sect>
 
 <chapt id="intro">Introduction
 <p>
@@ -641,11 +641,12 @@ the directory cannot be accessed.
 
 <p>
 A translation will be applied to values before they are used to
-construct a filename, so that the lookup cannot access dotfiles or
-files in other directories: values starting with full stops will have
-a colon prepended (making <tt/:./), colons will be doubled, and each
-slash will be replaced with a colon followed by a hyphen <tt>:-</>.  A
-parameter value which is the empty string will be replaced with
+construct a filename, so that the lookup cannot access dotfiles,
+backup files, files in other directories and the like: each slash will
+be replaced with a colon followed by a hyphen <tt>:-</>, and all
+characters which are not lowercase alphanumerics, hyphens or
+underscores will have a colon prepended (so that colons are doubled).
+A parameter value which is the empty string will be replaced with
 <tt/:empty/ (note that this is different from a parameter not having
 any values).
 
@@ -954,14 +955,11 @@ to be parsed).
 <tag/<tt/help//
 <item>
 Displays a list of the understood builtin service names and arguments.
-
-<tag/<tt/shutdown//
-<item>
-Arranges for the <prgn/uservd/ to shut down.  Available only when the
-service user is root.  This only affects new requests; it doesn't
-terminate any currently-running requests
 </taglist>
 
+In the future other builtin services may be defined which do more than
+just print information.
+
 <tag/<tt/set-environment//
 <tag/<tt/no-set-environment//
 <item>