debian/control: Add missing build-dependency on flex. Fixes FTBFS. Report from Aurel...

[userv.git] / spec.sgml

diff --git a/spec.sgml b/spec.sgml
index ea30b7ee15fd4a30e74754d614910e76a6b41e57..f10e0aeec6b59a51422c43aa5891c11bdfa8fcf5 100644 (file)
--- a/spec.sgml
+++ b/spec.sgml
@@ -2,8 +2,8 @@
 
 <book>
 <title>User service daemon and client specification
-<author>Ian Jackson <email>ian@davenant.greenend.org.uk
-<version>1.0.3</version>
+<author>Ian Jackson and contributors
+<version>1.2.1~beta2</version>
 
 <abstract>
 This is a specification for a Unix system facility to allow one
@@ -11,12 +11,16 @@ program to invoke another when only limited trust exists
 between them.
 
 <copyright>
-<prgn/userv/ is Copyright 1996-2003 Ian Jackson.
+<prgn/userv/ is
+Copyright 1996-2021 Ian Jackson;
+Copyright 2021 Genome Research Limited apropos work by Matthew Vernon;
+Copyright 2000 Ben Harris;
+Copyright 2016-2017 Peter Benie.
 <p>
 
 <prgn/userv/ is free software; you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
-the Free Software Foundation; either version 2 of the License, or (at
+the Free Software Foundation; either version 3 of the License, or (at
 your option) any later version.
 <p>
 
@@ -27,8 +31,8 @@ the GNU General Public License for more details.
 <p>
 
 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.
+along with <prgn/userv/; if not, see
+<tt>http://www.gnu.org/licenses/</tt>.
 
 <toc sect>
 
@@ -61,7 +65,7 @@ userv <var/options/ -B|--builtin [--] <var/builtin-service/ [<var/info-argument/
 <p>
 
 <var/service-user/ specifies which user is to provide the service.
-The user may be a login name or a numeric uid, or <tt/-/ to indicate
+The user must be a login name, or <tt/-/ to indicate
 that the service user is to be the same as the calling user.
 <p>
 
@@ -649,6 +653,13 @@ 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).
 
+<p>
+(In older versions of userv, a different translation was applied:
+See <tt>https://bugs.debian.org/837391</tt>.  The old translation
+can be requested (for subsequent directives) with
+<tt/include-lookup-quote-old/, which is undone by
+<tt/include-lookup-quote-new/ and <tt/reset/.)
+
 <tag/<tt/include-directory <var/directory///
 <item>
 Read configuration from all files in directory <var/directory/ which
@@ -824,7 +835,7 @@ strings; in this case any condition which tests it will be false, and
 
 </taglist>
 
-<tag/<tt/errors-push/ <var/filename//
+<tag/<tt/errors-push//
 <tag/<tt/srorre//
 <item>
 Stacks the error handling behaviour currently in effect.  Any changes