Path fixes in md2man script and README

The move of the manpages to docs/man left a few trailing ends. This patch cleans a few of these up. Paths in the manpage readme are updated to reflect the new path. The md2man script has been updated to generate the manpages in subdirectories of docs/man/