[MERGE] Hook documentation

[Michael Ernst]

This patch improves the User Guide's documentation of hooks.

The text no longer intersperses discussion of what a user does with a
descripton of the code.  Nor does it confusingly use first person to
describe what the code does.  It puts two lists of hooks together in one
place.  It fixes bugs in hook examples (per
https://lists.ubuntu.com/archives/bazaar/2008q3/047498.html).  It clarifies
where each hook is run (on the client, the server, or both).

                    -Michael Ernst

-------------- next part --------------
An embedded and charset-unspecified text was scrubbed...
Name: doc-hooks.patch
Url: https://lists.ubuntu.com/archives/bazaar/attachments/20081020/65cb4038/attachment.diff