hwdocs: ReSTify PFIFO docs

Please merge these two patches:
First patch fixes few warnings (and fixes formatting of MMIO registers lists in some cases)
Second converts documentation if fifo directory to ReST format.