Document parser changes.

diff --git a/doc/UPGRADE b/doc/UPGRADE
index 685eaf6a7824af9b8cfa30d872dae4ea107fc361..0b015c2c01e92256c498138176700b31e75474b4 100644 (file)
--- a/doc/UPGRADE
+++ b/doc/UPGRADE
@@ -3,6 +3,33 @@ Notes on upgrading from an older release
 
 o Upgrading from a version prior to 1.8.1:
 
+    Changes in the sudoers parser could result in parse errors for
+    existing sudoers file.  These changes cause certain erroneous
+    entries to be flagged as errors where before they allowed.
+    Changes include:
+
+    Combining multiple Defaults entries with a backslash.  E.g.
+
+       Defaults set_path \
+       Defaults syslog
+
+    which should be:
+
+       Defaults set_path
+       Defaults syslog
+
+    Also, double-quoted strings with a missing end-quote are now
+    detected and result in an error.  Previously, text starting a
+    double quote and ending with a newline was ignored.  E.g.
+
+       Defaults set_path"foo
+
+    In previous versions of sudo, the `"foo' portion would have
+    been ignored.
+
+    To avoid problems, sudo 1.8.1's "make install" will not install
+    a new sudo binary if the existing sudoers file has errors.
+
     In Sudo 1.8.1 the "noexec" functionality has moved out of the
     sudoers policy plugin and into the sudo front-end.  As a result,
     the path to the noexec file is now specified in the sudo.conf