Add example for repo.walk pydoc
Fix document generation and move example to pydoc

- Fix issues introduced in prev commit
- Move all documentation for Repository.walk from log.rst to
  pydoc in repository.c to make it available in both html and pydoc
- Extend documentation with sort types description