man: update `BUGS` section

Remove the JSON escape bug from the man page since it was fixed by #24.

Add a link to the issue tracker so the section is not left empty.

Close #26