docs/en winedev-testing.sgml

[Dimi Paun]

ChangeSet ID:	1117424638159788596983166
CVSROOT:	/cvsroot/wine
Module name:	docs
Changes by:	[e-mail]	2005/05/29 20:43:58

Modified files:
    en             : winedev-testing.sgml

Log message:
    Dan Kegel 
    Add instructions on how to build tests standalone on Windows
    using the Microsoft C++ Toolkit.

Old revision  New revision  Changes     Path
 1.1.1.1       1.2           +45 -0      docs/en/winedev-testing.sgml

Index: docs/en/winedev-testing.sgml
diff -u -p docs/en/winedev-testing.sgml:1.1.1.1 docs/en/winedev-testing.sgml:1.2
--- docs/en/winedev-testing.sgml	30 May 2005  3:43:58 -0000
+++ /dev/null	30 May 2005  3:43:58 -0000
@@ -350,6 +350,51 @@ thread.c: 86 tests executed, 5 marked as
          'make crosstest' to start building the tests.
         </para>
       </sect2>
+      <sect2>
+        <title>Standalone, using the Microsoft C++ Toolkit</title>
+        <para>
+         Sometimes it's nice to be able to build a new unit test
+         on Windows without Wine, and without buying Microsoft Visual C++.
+         Here's the simplest way to do that on a Windows system:
+        <itemizedlist>
+          <listitem><para>
+           Download and install the free-as-in-beer 
+           <ulink url="http://msdn.microsoft.com/visualc/vctoolkit2003">Microsoft C++ Toolkit</>
+           and the 
+           <ulink url="http://www.microsoft.com/msdownload/platformsdk/sdkupdate">Microsoft Platform SDK</>.
+          </para></listitem>
+          <listitem><para>
+           Make a directory <filename>wine</> underneath your work directory,
+           and copy the file <filename>wine/test.h</> from the Wine source tree there.
+           (You can download this file from the latest revision at
+            <ulink url="http://cvs.winehq.org/cvsweb/wine/include/wine/test.h">http://cvs.winehq.org/cvsweb/wine/include/wine/test.h</>).
+          </para></listitem>
+          <listitem><para>
+           Copy some existing test from the Wine source tree, or
+           create your test program (say, <filename>mytest.c</>) using Notepad,
+           being sure to begin it with <function>#include &lt;wine/test.h></>
+           following the usual Wine test style.
+          </para></listitem>
+          <listitem><para>
+           Finally, in a command prompt window, compile the test with the command
+<screen>
+<prompt>C:\your\work\dir&gt;</>cl -I. -DSTANDALONE -D_X86_ mytest.c
+</screen>
+          </para></listitem>
+          <listitem><para>
+           Once that's working, try running the program under Wine without
+           recompiling it.   See?  No Wine source required at all,
+           save for that one header, <filename>wine/test.h</>.
+          </para></listitem>
+          <listitem><para>
+           If you want to use the Microsoft C++ Toolkit under Wine,
+           install it under Windows, then copy it to your fake C drive;
+           it'll work fine there.  See <ulink url="http://kegel.com/wine/cl-howto.html">CL Howto</>
+           for some tips on making it easy to use from the Linux commandline.
+          </para></listitem>
+        </itemizedlist>
+        </para>
+      </sect2>
     </sect1>