Re: [Cppunit-devel] TestRunner

[Steve M. R. <ste...@vi...>]

On Tue, Jun 05, 2001 at 11:35:58PM +0200, Baptiste Lepilleur wrote:
> ----- Original Message -----
> From: "Steve M. Robbins" <ste...@vi...>
> To: "CppUnit Development" <cpp...@li...>
> Sent: Sunday, June 03, 2001 2:46 AM
> Subject: [Cppunit-devel] TestRunner
> 
> 
> >
> > Looking at the documentation generated using Doxygen,
> > I see that there is ONE class defined outside the CppUnit
> > namespace, namely TestRunner.
> >
> > Is this a simple oversight?
> > Or is it intended only as example code?
>     TestRunner is the GUI TestRunner for VC++. It is not in the CppUnit
> namespace because I did not want to take that name within the namespace.

The reason I was asking is that I thought the doxygen-docs should
document stuff only in the CppUnit namespace.  

If you accept this, and I grant that it is a *personal* aesthetic,
then either TestRunner should be in CppUnit, or it should not be in
the documentation.

That is why I asked whether it is "example" code.  Examples, like in
the examples subdirectory, would not typically be documented.

But it doesn't seem like mere example code.  It is on par with the
TextTestRunner, isn't it?  If so, it ought to get documented.


>     If you have suggestions about the name/namespace, they are welcome.

Namespaces can be nested.  How about CppUnit::TestRunner::Text
and CppUnit::TestRunner::<name-of-UI> ?  I don't know what the proper
UI name would be: MSVC?  MFC?  

I'm still struggling with grasping the "big picture" of CppUnit,
myself.  It still seems to me to have a lot of separate bits of
unrelated infrastructure.  So any naming scheme that clarifies
things is most welcome!

Speaking of separate bits, what is the origin of
include/cppunit/extensions?  I find that the macros in HelperMacros.h
are, well, incredibly helpful!  To my mind, they should be promoted as
the primary interface, at least for newbies.


-- 
by Rocket to the Moon,
by Airplane to the Rocket,
by Taxi to the Airport,
by Frontdoor to the Taxi,
by throwing back the blanket and laying down the legs ...
- They Might Be Giants