Fix c.m.satisfies documentation

Syntax updates to handle the note and highlight the return
and return type

Signed-off-by: Adam Stokes <adam.stokes@ubuntu.com>