# 
# 
# patch "ChangeLog"
#  from [55197c737a6842fb8dab905917079c7f108bcd8f]
#    to [2564a35ca99c8d7ef12152c3baab7c1cfd1f5565]
# 
# patch "automate.cc"
#  from [26adf3b2dcdc940a6d897f41bd62f94990526d3c]
#    to [99b63a3e6e2f9bac5b9418e30d2c8576b28a8c75]
# 
# patch "monotone.texi"
#  from [428d5bc4fb9ddce9307d8a7cd0d9381e9888a044]
#    to [13a896f8d0436594a45496dc1d2843973fb057d7]
# 
============================================================
--- ChangeLog	55197c737a6842fb8dab905917079c7f108bcd8f
+++ ChangeLog	2564a35ca99c8d7ef12152c3baab7c1cfd1f5565
@@ -15,6 +15,8 @@ 2006-12-18  Christof Petig <christof.pet
 	  tests/automate_put_revision/__driver__.lua:
 		tests for the new features
 
+	* monotone.texi: document new commands
+
 2006-12-18  Christof Petig <address@hidden>
 
 	* basic_io.hh (peek): use widen to distinguish '\xff' and EOF
============================================================
--- automate.cc	26adf3b2dcdc940a6d897f41bd62f94990526d3c
+++ automate.cc	99b63a3e6e2f9bac5b9418e30d2c8576b28a8c75
@@ -1774,7 +1774,14 @@ AUTOMATE(db_get, N_("DOMAIN NAME"), opti
   utf8 name = idx(args, 1);
   var_key key(domain, var_name(name()));
   var_value value;
-  app.db.get_var(key, value);
+  try
+  {
+    app.db.get_var(key, value);
+  }
+  catch (std::logic_error)
+  {
+    N(false, F("variable not found"));
+  }
   output << value();
 }
 
============================================================
--- monotone.texi	428d5bc4fb9ddce9307d8a7cd0d9381e9888a044
+++ monotone.texi	13a896f8d0436594a45496dc1d2843973fb057d7
@@ -7278,6 +7278,172 @@ @section Automation
 
 @end table
 
address@hidden mtn automate db_get @var{domain} @var{name}
+
address@hidden @strong item Arguments:
+
+The @var{domain} and @var{name} specify the database variable 
+which is returned.
+
address@hidden Added in:
+
+4.1
+
address@hidden Purpose:
+
+Read a database variable, see also @ref{Vars}.
+
address@hidden Sample output:
+
address@hidden off.net end verbatim
+
address@hidden Output format:
+
+Exactly the variable's content. Since this command is mainly intended for 
address@hidden stdio} it will not add a trailing newline.
+
address@hidden Error conditions:
+
+If the variable is unknown prints an error message to stderr and exits with
+status 1.
+
address@hidden table
+
address@hidden mtn automate db_put @var{domain} @var{name} @{value}
+
address@hidden @strong item Arguments:
+
+The @var{domain} and @var{name} specify the database variable 
+which is changed to @var{value}.
+
address@hidden Added in:
+
+4.1
+
address@hidden Purpose:
+
+Change a database variable, see also @ref{Vars}.
+
address@hidden Sample usage:
+
address@hidden mtn automate db_set database default-server off.net end verbatim
+
address@hidden Output format:
+
+No output.
+
address@hidden Error conditions:
+
+None.
+
address@hidden table
+
address@hidden mtn automate put_file @var{[base-id]} @var{contents}
+
address@hidden @strong item Arguments:
+
+The optional @var{base-id} specifies a file-id on which the contents are
+based on. This is used for diff encoding. @var{contents} are the contents of
+the new file.
+
address@hidden Added in:
+
+4.1
+
address@hidden Purpose:
+
+Preparation of a workspace-less commit. 
+See also @command{automate put_revision}. Normally used via 
address@hidden stdio}.
+
address@hidden Sample output:
+
address@hidden 70a0f283898a18815a83df37c902e5f1492e9aa2 end verbatim
+
address@hidden Output format:
+
+The sha1 sum of the contents, hex encoded.
+
address@hidden Error conditions:
+
+If the optional base id is unknown prints an error message to stderr and 
+exits with status 1.
+
address@hidden table
+
address@hidden mtn automate put_revision @var{change-set-data}
+
address@hidden @strong item Arguments:
+
address@hidden is one changeset part of a revision. See example
+below.
+
address@hidden Added in:
+
+4.1
+
address@hidden Purpose:
+
+Workspace-less commit. Normally used via @command{automate stdio}.
+
address@hidden Sample argument:
+
address@hidden
address@hidden
+old_revision []
+
+add_dir ""
+
+add_file "foo"
+content [5bf1fd927dfb8679496a2e6cf00cbe50c1c87145]
address@hidden group
address@hidden smallexample
+
address@hidden Sample output:
+
address@hidden 4c2c1d846fa561601254200918fba1fd71e6795d end verbatim
+
address@hidden Output format:
+
+The new revision, hex encoded.
+
address@hidden Error conditions:
+
+If the changeset is invalid prints an error message to stderr and 
+exits with status 1. May abort on invalid formats.
+
address@hidden table
+
address@hidden mtn automate cert @var{revision} @var{name} @var{value}
+
address@hidden @strong item Arguments:
+
address@hidden is an existing revision, @var{name} is the certificate name
+and @{value} its value.
+
address@hidden Added in:
+
+4.1
+
address@hidden Purpose:
+
address@hidden stdio} capable variant of @command{mtn cert}.
+
address@hidden Sample usage:
+
address@hidden mtn automate cert 4c2c1d846fa561601254200918fba1fd71e6795d author address@hidden end verbatim
+
address@hidden Output format:
+
+No output.
+
address@hidden Error conditions:
+
+If the revision is invalid prints an error message to stderr and 
+exits with status 1.
+
address@hidden table
+
 @end ftable
 
 @page