improved Javadoc and made the fake implementations even easier to use.
Authored by: mrieser 2009-07-19
Parent: [r7947]
Child: [r7949]
