[MERGE] small updates to doc strings

[John Arbash Meinel]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

The attached patch just cleans up some of our docstrings to make epydoc happy.

It is something I've had lying around for a while, and just never got submitted.

So here goes.

It doesn't clean up all errors, but it is at least a start in getting 'make
api-docs' to be happy.

By the way, with bzrtools installed, I get some really weird results.
Specifically, when I run "make api-docs" I get:

Error importing 'bzrlib.plugins.bzrtools.setup': usage: (imported)
[global_opts] cmd1 [cmd1_opts] [cmd2 [cmd2_opts] ...]
   or: (imported) --help [cmd1 cmd2 ...]
   or: (imported) --help-commands
   or: (imported) cmd --help

error: no commands supplied
........1 out of 1 hunk FAILED -- saving rejects to file test_file.rej


It really looks like it is somehow running the bzrtools test suite. Any ideas
why it would be doing that?

John
=:->

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.7 (Darwin)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFGhERfJdeBCYSNAAMRAnpVAKDOkppdkiFXDYfNlC5+hKHZPuDbtACgoRtO
HYkyveE6SPQrdT4g7W0L6L8=
=v30M
-----END PGP SIGNATURE-----
-------------- next part --------------
An embedded and charset-unspecified text was scrubbed...
Name: doc-cleanup.patch
Url: https://lists.ubuntu.com/archives/bazaar/attachments/20070628/fe4c2522/attachment-0001.diff