[cleanup] Ignore the file 'compile', created by recent AutoTools
[documentation] Hide friend declarations in doxygen output

The clutter the output.  I can't believe anyone really wants to see
the friend relationships in doxygen.
[cleanup] Remove some out-commented code