f9165e2b6abbc1d31f2cc90799ef1809187114b3
kent
  Sat Aug 17 13:24:53 2019 -0700
Describing warn() and error() functions.

diff --git src/lib/strex.doc src/lib/strex.doc
index afa7368..a0cec09 100644
--- src/lib/strex.doc
+++ src/lib/strex.doc
@@ -135,15 +135,24 @@
 and - logical and operation extended to strings and numbers
      for logic - if all and-separated-values are tru, return true, else false
      for numbers - if all numbers are non-zero return true else false
      for strings - if all and-separated strings are nonempty, return true, else ""
    In mixed operations result is converted to strings if strings are involved or
    the values "" and "true" if no strings are involved.
 
 now() - returns current time and date in ISO 1806 format using the variant that has the local
         time and timezone,   for instance 2019-08-14T23:35:22-0700 for 11:35 pm in California
 	during daylight savings time.
 
 import("file.strex") - act as if the contents of file.strex, which should be a valid 
         strex expression but one that can span multiple lines, were here instead of this
 	import expression.  This is useful for debugging and reusing complex expressions.
 	(You'll get line numbers from the file in the error message, which helps localize it.)
+
+warn("message")  - returns the input message with a scary warning prefix added.  Also will
+        send a warning message you see when running the strex program.  Usually this is
+	used as the default of a pick or something to put at the end of a long chain of
+	ors or conditionals when you don't want to do a hard error.
+
+error("message") - causes strex to stop processing with the given error message.
+        It will cause whatever program strex is embedded in to stop processing too
+	unless it is fancy enough to catch an exception.