I think I've included the right markup, but the current web documentation looks like rubbish.
I really can't convince gtk-doc to recognize that the signals are signals, or to pick up the markup and descriptions that I've so lovingly explained.
Any help really appreciated.
EDIT: Dan Winship to the rescue: it's because your object struct name doesn't have a “_” at the beginning of it ie, it has to be “typedef struct _PkClient PkClient”