some content does not format correctly in asciidoctor

the files devel/hacking.txt docs/decode.txt and docs/refclock.txt do not format correctly when building with asciidoctor; but they should. suggested patch