Re: [MO-java-dev] Java Doc

[Jeff M. <je...@mk...>]

On Mon, 2002-08-26 at 22:06, Nat Pryce wrote:
> Just to stick my oar in... the mock objects library is really divided
> into two parts, the core com.mockobjects package, which contains the
> expectation classes and MockObject base class, and then the packages of
> classes that mock actual APIs.  
> 
Actual there's now three. The alt tree which provides mockable versions
of unmockable classes.

This probably needs some java doc as it may not be totally apparent what
they're for. (See earlier discussion with Tim re alt.java.io.File)


> The com.mockobjects package is so simple that I have not found a need
> for documentation beyond the source and tests.  The other packages
> implement predefined interfaces (already documented by Sun, for
> example), and add setExpected... and setup... methods, the names of
> which follow strict conventions and are derived from the method and
> parameter names defined by the API.
> 
> The steepest part of the learning curve, in my experience, was learning
> the naming conventions and how to apply the com.mockobject classes to
> the mocking of my own interfaces.  The source to the mocked API packages
> was useful guidance.
> 
> So, perhaps it would be better to write some tutorial documents,
> explaining the naming conventions and how to use the classes in
> com.mockobjects to create new mocks.  There already is a document on
> naming conventions, but it is quite terse and the link is tucked away in
> the corner of the mock objects home page.
> 
> Cheers,
> 	Nat. 
> 
> -- 
> Dr. Nathaniel Pryce, Technical Director, B13media Ltd.
> Studio 3a, 22-24 Highbury Grove, London N5 2EA, UK
> http://www.b13media.com
> 
> 
> 
> 
> -------------------------------------------------------
> This sf.net email is sponsored by: OSDN - Tired of that same old
> cell phone?  Get a new here for FREE!
> https://www.inphonic.com/r.asp?r=sourceforge1&refcode1=vs3390
> _______________________________________________
> Mockobjects-java-dev mailing list
> Moc...@li...
> https://lists.sourceforge.net/lists/listinfo/mockobjects-java-dev
-- 
jeff martin
information technologist
mkodo limited

mobile: 44 (0) 78 5547 8331
phone: 44 (0) 20 2226 4545
email: je...@mk...

www.mkodo.com