Hello,

This finally adds the -Wunused-function warning to the list of warnings 
enforced with -Werror.  It also mentions it in the doco.

comments, doco ok?
Andrew