mdelfede freshly used T++ to document his new handy contribution to bazaar (a good sign and I have few comment:
First, I believe we should be using "short form" w.r.t. parmeteres. So while there is now:
bool Handle(int sig, Callback const &cb)
Installs a signal handler
sig ..................................Posix signal number
cb....................................Callback that will handle the signal
I would rather use
Installs a callback cb as handler of posix signal sig.
(both cb and sig being red, so it is still clear that these are params).
Second, please make attention that there are some predefined paragraph styles involved. Each section (which can document one or more coderefs) should start with 'begin' (which also introduces the horizontal ruler) and end with 'end'.