Adjust update_copyright.py to handle _mailfilterrc and _procmailrc

Gour re-released _mailfilterrc under GPLv2+ following Chris'
suggestion:

  Date: Fri, 25 Jun 2010 14:23:46 -0400
  From: Chris Ball
  Subject: Re: [Be-devel] procmail & maildrop
  ...
  As an aside, the Public Domain license on it is mildly concerning,
  but I think I'm willing to take it anyway since it's just a
  standalone file.  There are guidelines against using Public Domain
  declarations for software, because they have different meaning in
  different areas, and some areas are even thought to deny disclaiming
  "moral rights" like this; I've heard that France is in this
  situation.
  ...

Seems reasonable, so I'm doing that for my _procmailrc too.

This also means that _mailfilterrc no longer needs to be in
update_copyright.IGNORED_FILES, so I removed it.  Actually,
since it lackes a '^# Copyright' line, it never had to be
there in the first place.  Lazy me ;).

Merge branch 'master' of physics.drexel.edu/~wking/code/git/be

Merge commit 'refs/merge-requests/2' of git://gitorious.org/be/be

Changed license for _mailfilterrc from Public Domain to GPLv2+

Added _mailfilterrc to update_copyright.IGNORED_FILES

Gour released it to the Public Domain.

Merge remote branch 'gour/master'

Reworked `be list --extra-strings REGEXP` logic.

Previous implementation only matched if *every* regexp matched *every*
string.  Current implementation matches is *any* regexp matches *any*
string.

Remove 'CFBE. ' prefix from bug summaries now that we're using tags.

Added --tags to `be list`.

And broke out tagging functions in libbe.command.tag, so they are
accessible to other commands.

Added CFBE tags to all CFBE bugs.

Merge branch 'master' of physics.drexel.edu/~wking/code/git/be

Configure CherryPy to use UTF-8

Merged Chris' response bea/275/672

Reply to wking

Merge branch 'master' of physics.drexel.edu/~wking/code/git/be

Marked bea/d99 (CFBE inclusion) as fixed

Commented on Chris' bea/275/27c

rc file for maildrop filter

Rename cfbe bug to match "CFBE. " style used elsewhere

Merge branch 'master' of wking.cfbe

Pull .be/ directory from cfbe.

Conflicts:
update_copyright.py

Add aliases to update_copyright.py for some recent commits

Merge CFBE bugs into the main BE bug repo

Merge branch 'master' of physics.drexel.edu/~wking/code/git/be

Merge branch 'cfbe'

Add a 1.0 target (/773) and assign a cfbe Unicode bug to it (/275)

cfbe: API: Report each of the targets a bug has

Converted Bzr -> Git references in README and doc/*.txt

Little fix to setup.py

I applied Gianluca's patch, but used "revision" in both the Makefile
command for _version.py and setup.py, rather than using "revision_id"
in both places.  With Git, there is no longer a need to distinguish
revision IDs from revision numbers.

cfbe: API: More shortname -> bug.id.user()

cfbe: API: bd.bug_from_shortname(id) -> bug_comment_from_user_id(bd, id)

Ran update_copyright.py

Updated update_copyright to work with git/hg/bzr.

I'd added the extra VCS support when I took it over to Hooke.

cfbe: API: bugdir.root -> bug_root

cfbe: API: bugdir.bug_shortname(bug) -> bug.id.user()

FIXME: More instances here.

cfbe: API: Use bug.severity == target instead of bug.target.  (FIXME)

FIXME:  There are still many more instances of bug.target; I'm just going
through tracebacks one at a time at the moment.

Use git log instead of git show in Makefile

Moved .bzrignore -> .gitignore and updated

Updated _version.py and version.py to work with Git

cfbe: Use new storage API

Merge from Trevor.

Merged Chris' tutorial BE server URL update

Remove stub interfaces/web/.be

Moved CFBE bugs from interfaces/web/.be into .be/

Added 'CFBE' prefix to all CFBE bugs for clarity

Upgraded interfaces/web/.be to Bugs Everywhere Directory v1.4

be$ bzr mv .be .be-orig
be$ bzr mv interfaces/web/.be .be
be$ be list
  <go through upgrade process>
be$ bzr mv .be interfaces/web/.be
be$ bzr mv .be-orig .be

Merged Darcs fixes

Many markup fixes in doc/

Also added subdir option to generate-libbe-txt.make_module_txt(), in
the hopes that subdir='.' would fix the missing reference errors, but
no luck (although it did reduce them).  I'm sticking with
subdir='libbe' for now to avoid cluttering doc/ with autogenerated
cruft.

Darcs should look in ~/.darcs/author not ~/.darcs/prefs/author

From:
  http://darcs.net/manual/node7.html#env:DARCS_EMAIL

Darcs._vcs_get_user_id() now also checks ~/.darcs/prefs/author|email.

Thanks to Gour for pointing out that it should.

Use 'darcs add --boring' for Darcs > 0.9.10

Change location of be --serve'd bugs URL to bugs.bugseverywhere.org/

Merge with Trevor

Use os.path.join in libbe.storage.util.config.path.

Versus previous hardcoded "~/.bugs_everywhere".

Also improve docstrings for
* libbe.storage.util.config.path
* libbe.ui.util.user.get_user_id

Added -c/--creator to `be new`

Following Gour's suggestion on the mailing list.

Use Sphinx autosummary (required by numpydoc)

Added intersphinx_mapping to doc/conf.py.

See
  http://sphinx.pocoo.org/ext/intersphinx.html#confval-intersphinx_mapping

Set up for running from top-level be dir, i.e.:

% python interfaces/web/cfbe.py

Remove the .be/ copy from inside cfbe dir

Merge Steve Losh's cfbe tree, from:
http://bitbucket.org/sjl/cherryflavoredbugseverywhere/

Merge with Trevor.

Fixed Eric Kow's _darcs/prefs/author bug.

Use _vcs_get_file_contents (vs get_file_contents) in Darcs._vcs_get_user_id

Merged Eric Kow's _darcs/prefs/author bug.

Use getreader (not getwriter) for wrapping stdin

Created bug 592 (_darcs/prefs/author).

Created a bug (wontfix) for Anton Batenev's default-EDITOR comments.

Also fixed a UserError typo in import_xml.py.

Merged Anton Batenev's report of Nicolas Alvarez' unicode-in-be-new bug

Reported bug with utf-8 strings

Fix relative links from bug pages in `be html`.

Introduced by bugs/XXX.html -> bugs/XXX/index.html in
  wking@drexel.edu-20100220181238-j5ecst02y0k9ioo9

Use truncated_id in `be html` comment <div id="">

Fix len(char) assertion typo in libbe.util.utility.underlined()

Added `be html --min-id-length INT` option

Merged Gianluca's truncated-IDs in `be html` output patch.

Or at least merged the general idea.  Changes in the implementation
listed in #bea/01e/2f9#.

Variable lenght of the file name in the be html command.

Fixed a bug in the be html command.

  File "/usr/lib/python2.5/site-packages/libbe/command/html.py", line 371, in _escape
    return xml.sax.saxutils.escape(char)
NameError: global name 'char' is not defined

Merged Gianluca's fix of my version of Eric's patch ;)

Merged Trevor's tree

Merged Eric Kow's HTML escaping patch

Merged initial Sphinx documentation structure.

There's still a long way to go in this direction, but the basic
framework is now in place.  Toss in numpydoc-style docstrings
  http://projects.scipy.org/numpy/wiki/CodingStyleGuidelines
when you have time, and things will gradually improve over time.

I also punted our user ID creation/parsing in libbe.ui.util.user to
the email module.  This way IDs are handled in an RFC-compliant way
(less suprising for users) and by someone else (less work for us :).

Consolidated Makefile and doc/man/module.mk.  Incorperated doc/Makefile.

Now
  make sphinx
builds the Sphinx HTML documentation (in doc/.build/html), and
  make clean
cleans up everything.

Having a separate module.mk was just making things confusing, so I
took it out ;).

Fixed docstrings so only Sphinx errors are "autosummary" and "missing attribute"

Use email.utils.formataddr/parseaddr to generate/parse user IDs

Use numpydoc and generate-libbe-txt.py to autogenerate API documentation

Added bugdir and comment modules to Sphinx docs

Added libbe.bug to the Sphinx documentation

Broke out install.txt + reStructuredText markup fixes

Added page titles to the documentation & adjusted section levels.

Sphynx now gets version string automatically.

Moved manpage source doc/src to doc/man

Created Sphinx framework with sphinx-quickstart and added .txt extensiosns

Avoid double-escaping in 'be html'.

Use ${HOME}/.local as default prefix.
This is apparently a new standard.

Sort comments in `be html`.

Fix be-xml-to-mbox handling of non-text/* content types

Restore "content_type" kwarg to Comment.new_reply().

It had been removed in
    revno: 473.1.43
    committer: W. Trevor King <wking@drexel.edu>
    branch nick: be.restructure
    timestamp: Mon 2009-12-14 07:37:51 -0500
    message:
      Transitioned comment to Command format
when we pushed unicode encoding/decoding back to the Storage backend.

However, with the addition of libbe.util.id.short_to_long_text(),
we need it again.

Also add a Doctest showing a non-text/* comment, so utilities dealing
with them can see what they'll be working with.

Made Bzr/Darcs.version_cmp() more robust in response to Chris' email.

From: Chris Ball <cjb@laptop.org>
Subject: Test suite status

...
I ran the wking@drexel.edu-20100130162439-pmh5tg6kuq92x3l5 testsuite
on Fedora 13/Rawhide.  Had to downgrade Mercurial (bzr-hg doesn't
support 1.4.2 yet) and bzr (my Fedora package contained a "b4" in the
version string, which breaks libbe/storage/vcs/bzr.py:version_cmp()).
...

Fixed Chris' "zero name length for Mercurial w/o ~/.hgrc" bug.

From: Chris Ball <cjb@laptop.org>
Subject: Test suite status
Date: Mon, 01 Feb 2010 11:27:53 -0500
Message-id: <m38wbcor92.fsf@pullcord.laptop.org>

...

I hit the "assert len(name) > 0" in libbe/ui/util/libbe.py, coming from
hg.py when running with no ~/.hgrc.  Fixed by the following patch:

=== modified file 'libbe/storage/vcs/hg.py'
--- libbe/storage/vcs/hg.py     2010-01-21 17:45:49 +0000
+++ libbe/storage/vcs/hg.py     2010-02-01 16:17:03 +0000
@@ -87,7 +87,14 @@
         return tmp_stdout.getvalue().rstrip('\n')

     def _vcs_get_user_id(self):
-        return self._u_invoke_client('showconfig', 'ui.username')
+        output = self._u_invoke_client('showconfig', 'ui.username')
+        if output != "":
+            return output.rstrip('\n')
+        else:
+            # guess missing info
+            name = libbe.ui.util.user.get_fallback_username()
+            email = libbe.ui.util.user.get_fallback_email()
+            return libbe.ui.util.user.create_user_id(name, email)

     def _vcs_detect(self, path):
         """Detect whether a directory is revision-controlled using Mercurial"""

Fix command name output of `be --complete`.

By adding command_names option to libbe.command.commands.  Previous
versions of `be --complete` printed "import_xml", not "import-xml".

Also fixed libbe.command.base's doctests, so test.py can run them.

Clearer UnicodeDecodeError message in command_line.dispatch().

See #bea/e30# ("Where should the vcs-name and encoding configuration
options live?")  for details.

libbe.command.html.HTMLGen._long_to_linked_user() handles failed conversion.

Before, anything matching libbe.util.id.REGEXP was convert-or-die.
Now it's convert-or-no-op.  Much safer ;).  The new
_long_to_linked_user doctest would have failed with the old
implementation.