jmc@ pointed out i forgot to fix the missing SRPL_LEAVE in the synopsis.

sprinkle some .Ft on the things that act like functions while here.

tweak the pages based on feedback from jmc@

they could do with some examples too.

Move LOCKED macros to teir own manual.

This will allow us to better document them and add examples.

Disccussed with dlg@