On Mon, Mar 11, 2013 at 10:12:35PM -0700, Alexis Metaireau wrote:
> From these docs I have no idea what this is made for.

I think the current docs clearly explain what `PATH_METADATA` does and
how it is used.  As for why it was make: I wanted to extract the date
from directory names, not filenames, so I added a way to extract
general metadata from the full (relative) path.

If backwards compatibility wasn't an issue, I'd remove
`FILENAME_METADATA` completely in favor of `PATH_METADATA`.  The only
benefit to using `FILENAME_METADATA` is that the filename splitting is
done in Python, so you don't have to worry about OS-dependent
separators.

Maybe I'm too close to be able to write good docs for this.  If anyone
else wants to suggest changes, I'd be happy to work them in…