! when passing a preformatted error, the id needs to be html-safe

Signed-off-by: Spuds <spuds@spudsdesign.com>
! seems this can be an array, so lets avoid an error

Signed-off-by: Spuds <spuds@spudsdesign.com>
! minor docblock tweaks

Signed-off-by: Spuds <spuds@spudsdesign.com>
! bunch more minor docbloc fixes

Signed-off-by: Spuds <spuds@spudsdesign.com>
Merge pull request #1425 from Spuds/sp

Moar