`shorten_fname`: Use `strlen` instead of `STRLEN`
Use Doxygen comments
Rename `shorten_fname` -> `path_shorten_fname`