about summary refs log tree commit diff
path: root/README
diff options
context:
space:
mode:
Diffstat (limited to 'README')
-rw-r--r--README16
1 files changed, 15 insertions, 1 deletions
diff --git a/README b/README
index b6b023789..b4f4ce42f 100644
--- a/README
+++ b/README
@@ -24,7 +24,8 @@ details, see the documentation.
 Possible incompatibilities
 ---------------------------
 
-Some particular differences you may notice between version 3.0 and 4.0:
+Some particular differences you may notice between version 3.0 and 4.0
+(mostly based on 3.0.8; there are other differences from earlier versions):
 
   o  The options ALWAYS_LAST_PROMPT (return to the line you were
      editing after displaying completion lists) and LIST_AMBIGUOUS
@@ -42,6 +43,19 @@ Some particular differences you may notice between version 3.0 and 4.0:
      hitting ESCAPE to exit insert mode.  Purists who object to this can
      unbind the appropriate key sequences (see zshzle(1)).  Most beginning
      users of zsh apparently find the current behaviour preferable.
+  o  History file format is incompatible with versions older than 3.0.6,
+     but this should only affect people who try to share history files
+     between the two versions -- 4.0 can read the old format, 3.0.6 and
+     later can read the new format.  Just beware of INC_APPEND_HISTORY,
+     which could conceivably mix the two.
+  o  Default compctl completions have been removed for some builtin
+     commands.  Either use the new compinit-derived system, use the
+     improved compctls from Misc/compctl-examples, or restore these
+     equivalents yourself:
+	 compctl -b bindkey
+	 compctl -v export typeset vared
+	 compctl -o setopt unsetopt
+         compctl -c which
 
 Documentation
 -------------