• Lynn A (56/56) Sep 01 2004
• Nick (6/22) Sep 01 2004 No, I think you are entirely correct. The documentation example will onl...
• Lynn Allan (4/7) Sep 01 2004 Per your confirmation, I have submitted the documentation adjustment via...
• J C Calvarese (8/17) Sep 02 2004 Walter is the maintainer of the official D specification at

Lynn A <Lynn_member pathlink.com> writes:

<alert content="newbie">

I'm either unclear about using -unittest (likely), or the example in the
documentation is not only incomplete, but flawed (i.e. won't compile).

from: http://www.digitalmars.com/d/class.html#unittest

"For example, given a class Sum that is used to add two values: "

#class Sum










With the above code, "dmd Sum.d" compiles fine, but "dmd -unittest Sum.d"
results in error message:
need 'this' to access member add

Should the code snippet actually be something like the following:









With the above change, the following test.d that imports Sum will compile and
work:

#import std.stdio;
#import Sum;

#void main (char[][] args)








Am I confused and leaving something out such that the original code snippet will
compile and work?

Also, the documentation would benefit from specifically noting how to enable
unittest code. After some head-scratching, I looked in the archives and the
output from "dmd" with no commandline argurments. Currently the documentation
reads:
"A compiler or linker switch will remove the test code from the final build."

Perhaps this would be more helpful to newbies like myself if it read:
"The -unittest dmd switch will include the test code in the build. The -release
switch will leave out the unittest code from the final build."

From The WB circa 2002-April:
http://www.digitalmars.com/d/archives/4607.html
"Unit testing [along with DBC] has in my mind risen to become a main feature of
D."

Lynn A.

</alert>

Nick <Nick_member pathlink.com> writes:

In article <ch4mk4$2a68$1 digitaldaemon.com>, Lynn A says...
[...]
Should the code snippet actually be something like the following:









[...]

Am I confused and leaving something out such that the original code snippet
will compile and work?

No, I think you are entirely correct. The documentation example will only work
if add() is made static.

Perhaps this would be more helpful to newbies like myself if it read:
"The -unittest dmd switch will include the test code in the build. The -release
switch will leave out the unittest code from the final build."

I agree. But you should only mention the -unittest flag in this context. The
-release option doesn't effect unittest code at all.

Nick

"Lynn Allan" <l_d_allan adelphia.net> writes:

 No, I think you are entirely correct. The documentation example will only 
 work
 if add() is made static.

Per your confirmation, I have submitted the documentation adjustment via 
wiki4d to the author/maintainer of the "Classes#unittest" documentation (The 
WB or jcc7?)
http://www.prowiki.org/wiki4d/wiki.cgi?DocComments/Class

J C Calvarese <jcc7 cox.net> writes:

Lynn Allan wrote:
No, I think you are entirely correct. The documentation example will only 
work
if add() is made static.

 
 
 Per your confirmation, I have submitted the documentation adjustment via 
 wiki4d to the author/maintainer of the "Classes#unittest" documentation (The 
 WB or jcc7?)
 http://www.prowiki.org/wiki4d/wiki.cgi?DocComments/Class

Walter is the maintainer of the official D specification at 
digitalmars.com.

Anyone can contribute to the Wiki4D pages. (I just happen to be the most 
active Wiki contributor at the moment.)

-- 
Justin (a/k/a jcc7)
http://jcc_7.tripod.com/d/