[Date Prev][Date Next][Thread Prev][Thread Next][Author Index][Date Index][Thread Index]

documentation



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?