some pyramid.path API doc improvements