[winetest] Updated the README to reflect a bit of research into using Winetest to report Wine (on Linux/Mac) results, not only Windows results.

Jeremy White jwhite at codeweavers.com
Tue Feb 5 09:51:44 CST 2008


---
 programs/winetest/README |   52 ++++++++++++++++++++++++++++++++++++++++++++-
 1 files changed, 50 insertions(+), 2 deletions(-)

diff --git a/programs/winetest/README b/programs/winetest/README
index 90e8acc..b50efac 100644
--- a/programs/winetest/README
+++ b/programs/winetest/README
@@ -3,20 +3,68 @@

 Winetest is a single-executable version of all the DLL conformance
 test programs suitable for unattended testing and report submission.
-People assigned to build winetest must take care of the following
-files, which are only used by 'make dist':
+
+There are two ways that you can use Winetest.  First, a team of
+volunteers uses Winetest to build date specific versions of winetest.exe
+which other testers can download and run on their Windows computers.
+
+Second, you can invoke winetest directly from the winetest build
+directory on your native system.
+
+Winetest requires three files which are only used by 'make dist':

 * build.id

 Contains a single (either CR or CR-LF) terminated line providing the
 build identification.  The accepted characters are [-.0-9a-zA-Z].

+The current convention is that this is set to the date and time that
+a given Winetest.exe was built, e.g., 200802050743.
+
+However, whatever you use will be used as the primary index when
+it is reported to test.winehq.org, so it will be visible and will
+affect the organizational structure of the reports on that site, so please
+choose your build.id with care.
+
 * tests.url

 Also contains a single terminated line providing the archive URL of
 the testing suite being built.

+The current convention is that this points to a location that someone
+can use to download the winetest.exe that is being built.
+
 * build.nfo

 Contains a block of terminated lines providing miscellaneous
 information about the build, like eg. the tools being used.
+
+
+Running Winetest from the Wine source tree:
+  Running Winetest is essentially identical to running 'make -k test'
+  with the added benefit that the results are reported to a central
+  server.
+
+  To do this, you must first populate the three files given above.
+  Only the build.id is truly critical, as that will control where
+  the result is cataloged.
+
+  Then, invoke
+    make dist
+    make
+  Followed by:
+    ./winetest-dist [-h]
+
+  Without arguments, winetest will run interactively; a -h will
+  show you a list of other choices, including a non interactive mode.
+
+  Most useful is:
+    ./winetest-dist -c -t "your-tag-here"
+  which will run in an unattended mode.
+
+Determining a Tag ID:
+  Winetest will require a tag id when run.  There is no hard and fast
+  convention for this.  Ideally you would include your name or some
+  identifier that would allow someone to trace the report back to you,
+  along with enough information for you to distinguish amongst your
+  test systems, presuming you have multiple.
-- 
1.5.3.6




More information about the wine-patches mailing list