documentation

[Roger Gregory <roger>]

There is an ambiguity in our documentation plans.  It is interface vs.
implementation.  Especially, the common interface needs to be documented in
away that isn't too redundant & confusing.  Thus we don't want the same 
comment on all versions of the foo() method, especially super::foo()
and sub::foo() should somehow refer to the same documentation especially
wrt the common interface, if there are any special notes on sub::foo() they
should be available somewhere.  What is a reasonable way to do this?