1 files changed, 67 insertions, 0 deletions
diff --git a/debian/README.Debian b/debian/README.Debian
new file mode 100644
index 000000000..19ffe78a4
--- /dev/null
+++ b/debian/README.Debian
@@ -0,0 +1,67 @@
+Zsh for Debian
+==============
+
+You may find more uptodate information about Debian's zsh packages at
+https://wiki.debian.org/Zsh
+
+ -- Axel Beckert <abe@debian.org>, Mon, 20 Oct 2014 14:40:42 +0200
+
+This version of zsh has been compiled with support for maildir
+folders in MAIL and MAILPATH.
+
+ -- Clint Adams <schizo@debian.org>
+
+
+Using bash completion scripts with zsh
+--------------------------------------
+
+See http://zshwiki.org/home/convert/bash for instructions and example
+code on how to use bash completion scripts with zsh.
+
+ -- Axel Beckert <abe@debian.org>, Tue, 26 May 2015 14:46:31 +0200
+
+
+How to use the zsh-dbg package
+------------------------------
+
+In the first terminal execute:
+
+  sudo apt-get install zsh-dbg
+  apt-get source zsh
+  cd zsh-*
+
+In the second terminal invoke 'zsh -f' (or drop the '-f' if you
+don't want to start with a clean Zsh session). Execute all the
+relevant steps right *before* you can trigger the problem you
+want to inspect using gdb.
+
+Return to the first terminal where you're standing in Zsh's
+source directory.  Identify the process id of the Zsh instance
+you want to debug ("ps aux | grep '[z]sh'") and use it for $PID.
+Then execute:
+
+  gdb $(find . -type d -printf '-d %p ') attach $PID
+
+Now you can use the usual gdb commands like step / continue / ...
+to debug the Zsh process at source level.
+
+ -- Michael Prokop <mika@debian.org>
+
+
+Load-path for functions from other packages
+-------------------------------------------
+
+In respsonse to #620452, the zsh-binary from Debian's zsh package started to
+provide two entries to $fpath (the search path for loadable functions) for
+other packages to drop function files into:
+
+  - /usr/share/zsh/vendor-completions for functions that add functionality to
+    zsh's function based completion system (compsys)
+
+  - /usr/share/zsh/vendor-functions for all other functions
+
+If you maintain another Debian package that wants to add functions to zsh's
+function load-path, please use the those conventions when installing function
+files.
+
+ -- Frank Terbeck <ft@bewatermyfriend.org>, Wed, 21 May 2014 13:15:58 +0200