replace 'note' with 'versionadded'
make path API docs a bit more concise
Merge pull request #821 from tshepang/path

some pyramid.path API doc improvements