doc:power: add Zsh completion location and update Bash install location
[be.git] / doc / power.txt
1 **************
2 Power features
3 **************
4
5 BE comes with a number of additional utilities and features that may
6 be useful to power users.  We'll try to keep an up to date list here,
7 but your best bet may be poking around in the source on your own.
8
9 Autocompletion
10 ==============
11
12 :file:`misc/completion` contains completion scripts for common shells
13 (if we don't have a completion script for your favorite shell, submit
14 one!).  Basic instructions for installing the completion file for a
15 given shell should be given in the completion script comments.
16
17 Packagers should install these completion scripts in their system's
18 usual spot (on Gentoo, the Bash completion script should be installed
19 as :file:`/usr/share/bash_completion/be` and Z shell completion script
20 should be installed as :file:`/usr/share/zsh/site-functions/_be`).
21
22 XML-handling utilities
23 ======================
24
25 Email threads are quite similar to the bugs/issues that BE tracks.
26 There are a number of useful scripts in :file:`misc/xml` to go back
27 and forth between the two formats using BE's XML format.  The commands
28 should be well documented.  Use the usual ``<command> --help`` for
29 more details on a given command.