Documentation update: Fixes issue #1557

- Moves entire documentation to Markdown format. Much simpler.
- Fully supports Doxygen 1.8.7+
- All documentation targets updated: user_doc, share/man, doc and doc/refman.pdf.
- Tested across Ubuntu, CentOS and Mac OS.

Output preview:
- [User HTML Docs](http://thebespokepixel.com/fish/user_doc/html/index.html)
- [Man pages (as .zip file)](http://thebespokepixel.com/fish/man1.zip)
- [Developer docs](http://thebespokepixel.com/fish/doc/html/index.html)
- [Developer PDF manual](http://thebespokepixel.com/fish/doc/refman.pdf)
Presumably this should be 

```sh
	cd doc/latex && \
	make && \
	mv refman.pdf ..
```

i.e. don't run commands if previous ones failed. And the trailing `cd ../..` is unnecessary if you simply don't escape the newline.