Patch from MJ Ray for items without link

  - link might not always exist, md5sum is always present, don't fail on no link.

Make sure that we feed the parser unicode data

    - Check if we get a unicode string back from feedparser
    - If not, re-encode so that it is
    - Remove explicit casting to utf-8 before it goes to the parser

More utf-8 handling for images

    - iff we get a string object rather than a unicode one, decode it from utf-8

Stop trying to decode image tags to utf-8

    - If the title/url contains a utf-8 character and we try to decode it it
      will fail due to not being present in the ascii set. Feedparser has already
      made sure that everything is utf-8 before we get it.

Change header encoding for From/To address to make sure they're utf-8 and so they are not invalidly encoded later.

Bug reported by Andre Klärner with pointers to what was going wrong - many thanks!

* Add https support (thanks to Andre Klärner)

Update so that we don't get a warning in python 2.6 and above, where the md5 module has been depricated

Fix silly typo

Add item fetched date header (X-rss2maildir-rundate)

guid might not always exist, link is always present, don't fail on no guid.

Fix bug when link/guid contains characters not in ascii by encoding the keys as utf-8

Small fix to title handling code to deal with unicode better

Fix for items that actually have no content.

Fix typo in previous charref fix

Fix bug in character reference handling code

Fix for title parsing

Fix some entity handling

    * fixes handling of numeric entities
    * fixes unittest for entities.

Another blockquote fix

Fix blockquote support

Fix issue with images having the same alt value but different urls

Update changelog

More entities

small fix to put images on seperate lines

Small fixes to list handling code

simple typo fix

Update TODO list

Entity handling fixes

* Make entities case sensitive
* Add unittest for simple check of entities
* Add escaping of subject line

Add (lots) more basic HTML entities.

fix silly regression on pre formatting

change images to ReST format

Normalise spaces where they should be.

Unicode handling of URLs fix

More unicode fixes

* Fix bad check on state directory

* Begin fixes to list handling code - there's 2 unittests that are failing due
  to this. (Previous revision had 7 unittests fail - bother)

* Small Unicode fix for img tags.

* Change all entity refs in to unicode strings
* Update <br> handling to be more effective
* Ignore unknown tags and just pretend they're part of the flow
* Add <img> support (very basic!)

Update TODO list

Rudimentary <a href="...">bleep</a> support.

* Handle unicode data more effectively.

Fix typo/thinko in handle_startendtag

* Update TODO list

* Update list handling code to deal with nested lists better and badly formed
  html

* unittest for mixture of different types of lists

* Serious reworking of HTML2Text to handle nested lists reasonably
* Adding more unittests for the nested lists

* Small improvements to the HTML2Text code
* Reorganize unittests for parsing to make it easier to add more tests later

* serious reworking of the HTML2Text parser

* fix README to have a more complete config example
* stop text width from being hardcoded

* add missing source files for unit tests
* small fix to paragraph handling

* add (first draft of) full test suite runner
* add test for well formed paragraph handling
* update UnorderedListTests to have better test naming scheme
* add suite function to UnorderedListTests

Update li handling a bit, and make the expected test results be what we'd
actually want (previous version might have been a bit of a work around)

* Move some of the list handling above the paragraph handling so that it
  doesn't get confused (bless it!)
* Make expected output match actual output, unittest now passes

* Add unit test for some of the badly formed lists that we get after the
  feedparser "sanitizer" has a word with the HTML (currently fails)

* Add unittest for unordered list
* make sure that the string that we use for plain text always ends in a new
  line character

Reformat code ready for adding test suite

* Update TODO list with further escaping needs

* Add item url to html parts

* Add item url to bottom of text only part

Update TODO list

* multiple posts with the same link but different guid support - still
  threaded, but don't keep delivering the same messages everytime until they
  leave the feed

* Add redirect support
* Try to get a URL 3 times (redirects are included in the count...)
* Refactor connection creation in to it's own function to lower duplication of
  code

Update TODO list

* fix typo for a particular entity

* Add a prelimanary todo list

* be slightly more forgiving on connection resets
* if there's no date in the feed, use todays date/time

Only download feeds that have changed (or that don't give us enough data to
workout if they've changed without downloading it all anyways)

Refactor <br /> handling code so that there's no duplication

* updated posts are now "threaded" - adds a References header with the previous
  message-id in it, then adds the previous message id to the current message-id
  so that further updates can reference that properly

Further reformatting to < 80 chars per line

* improve handling of unicode data

* tidy code to be mostly < 80 chars per line
* add unordered list support
* tidy paragraph handling code to work better

Remove references to mailbox module (doesn't let you write to maildir, which is
what we want, until python 2.5)

better utf-8 handling (though, we currently don't take in to account what
encoding we should be handling, so this could be "interesting" at best)

* improved entity handling

* fix blockquote support
* improve headings support
* add pre support

Fix documentation up a bit

* blockquote support - indents a blockquote with a "> "

* make db key actually unique for feed url + link url

* add support for &nbsp;
* add text wrapping for paragraphs (this is going to need more work, really)

Add licence information

Add basic HTML -> plain text parser

Update example file with planet alug and planet debian

* make mail messages multipart/alternative messages with a text/plain and
  text/html part
* create a seen database that logs wether or not we've seen an item before by
  using the url of the item as the key, then check the md5sum to see if we need
  to see that item anyways

Add a Message-ID header and set the type to the type of the content in the rss
feed.

Much better filename creation for the tmp file

* Parsing of the RSS feed using feedparser
* Creation of files for the maildir

Create Maildirs and Maildir root if possible for the feeds

Starting point of rss2maildir:
    * Config parser
    * Options parser