Beginnings of installer for 4.4.0. HGM asked me to forward the nsi file,
[xboard.git] / winboard / install / files / root / PSWBTM / doc / tourney.html
diff --git a/winboard/install/files/root/PSWBTM/doc/tourney.html b/winboard/install/files/root/PSWBTM/doc/tourney.html
new file mode 100644 (file)
index 0000000..64fb527
--- /dev/null
@@ -0,0 +1,148 @@
+<html>\r
+<header>\r
+<title>WGP: Running a Tournament with PSWBTM</title>\r
+</header>\r
+<body>\r
+<table cellpadding="20"><tr><td>\r
+<h1>The WinBoard Gold Pack 4.4.0</h1>\r
+<h2>For the ultimate WinBoard experience!</h2>\r
+</td><td>\r
+<img src="../../WinBoard/doc/mini.gif">\r
+</td></tr></table>\r
+<h3>Setting up  Tournament with PSWBTM</h3>\r
+<p>\r
+The first two step for using PSWBTM,\r
+<a href="configure.html">configuring</a> it, \r
+and <a href="install.html">instaling some engines</a> into its database,\r
+have been described on an earlier page of this tutorial.\r
+In the WinBoard Gold Pack PSWBTM comes fully configured,\r
+with two engines pre-installed, so for a first trial these steps\r
+can be skipped.\r
+</p>\r
+<p>\r
+The third step in using PSWBTM is to set up a tournament.\r
+For this you select the "Tools -> New Tournament" menu item.\r
+This pops up a complex window with lot of controls and input fields.\r
+Here you have to provide all details about the tournament.\r
+But don't despair: most of the time you only change a few of these fields,\r
+and leave all others as they were for your last tournament.\r
+It is thus not as bad as it looks!\r
+</p>\r
+<p>\r
+We will start at the top and work our way down.\r
+You can give a name to your tourney,\r
+wich will appear in the PGN headers of all games.\r
+This is optional.\r
+The next line you will have to enter the name of a PGN file,\r
+to which all games of the tourney will then be added.\r
+You thus can select an existing file,\r
+and to this end there is a "Browse" button, to spare you typing the name.\r
+The other two lines of the "File Settings" panel are not important now;\r
+we skip them, making sure the checkboxes in front of them are unchecked.\r
+</p><p>\r
+The fields of the next panel, "Tournament Type", are essential.\r
+You have to choose between Gauntlet and Round-Robin with the radio-buttons on the left.\r
+If you have selected "Gauntlet",\r
+(meaning a single engine against one or more others),\r
+it is essential that you select the engine that has to play the gauntlet\r
+with the combo-box.\r
+This combo box shows you (when you open it) the same list of engines you saw in the\r
+engine-manager window.\r
+Just select one by clicking it.\r
+For a Round-Robin this field is ignored.\r
+So for now, click "Round-Robin".\r
+You then must specify how many times the engines will have to play each other\r
+(usually 1 or 2 times, we select 2).\r
+</p>\r
+<img src="tour.png">\r
+<p>\r
+Then you have to select the time control for the tourney.\r
+The panel is more or less self-explanatory,\r
+and supports all time controls known by WinBoard,\r
+including fixed time or fixed depth.\r
+You can also select here if the engines will ponder or not.\r
+To make for a few quick games, select "incremental", with 1 min + 0 sec/move.\r
+</p><p>\r
+Then you have to select the starting position.\r
+The default starting position will do for now,\r
+and in that case all other data in the panel is ignored.\r
+But the combo-box on the left also allows you to select \r
+to play from positions given in a PGN or FEN file.\r
+If you select that, you will have to give the corresponding file name in\r
+the field right of it, or browse to such a file.\r
+In that case you will also have to tick if you want to play each position\r
+once, or twice (with reversed colors).\r
+</p><p>\r
+The "Initial Pairing Import" panel can be ignored.\r
+</p><p>\r
+The last, but most important task, is to select the participants to the tourney.\r
+As only two engines are installed initially,\r
+we need both of them to participate.\r
+Just double-click them in the list on the right\r
+(which is again a display of the engine-manager database),\r
+and this will transfer them to the box on the left\r
+(which shows the participants).\r
+Once both engines are in, the tourney is fully specified,\r
+and we can click "OK" to quit the tournament-setup window.\r
+(As long as the tournament is not started, you can call up the \r
+"New Tournment" dialog again to correct possible errors.)\r
+</p><p>\r
+This brings us back into the PSWBTM main window.\r
+The four tabs now all contain some information.\r
+The first one shows the pairings for every round.\r
+(With only two participants, te tourney will finish in  single round, though.)\r
+The fourth shows an overview of all the settings for the tourney,\r
+which you just entered.\r
+So you can check there if you goofed.\r
+The fourth and final step, however,\r
+is to go to the "Control" tab.\r
+That is where the buttons are located that allow you to start the tourney,\r
+abort it permanently, or pause it \r
+(immediately, or after finishing the game in progress).\r
+The only confusing thing is that to start the tourney,\r
+you have to press "Resume".\r
+(The button is named this way because the same button is used to restart after a pause.)\r
+After that, the tournament will start,\r
+and run automatically to completion.\r
+While it is running you can use the PSWBTM "Standings" tab sheet to see\r
+how the participants are doing upto now.\r
+And watch and enjoy the games, of course.\r
+WinBoard will pop up as you left it last time,\r
+but noting you change now (including the size and position of all its windows) will be remembered for the next game of the tourney.\r
+</p>\r
+<img src="pswbtm.png">\r
+<p>\r
+After two games our small round-robin will be finished.\r
+The games will have been saved in the PGN file you selected.\r
+</p><p>\r
+<strong>Congratulations!</strong>\r
+You now have played your first tournament\r
+with PSWBTM + WinBoard.\r
+That is all there is to it.\r
+Now just <a href="install.html">install some more engines</a>,\r
+and you are in business!\r
+</p>\r
+<h3>Links</h3>\r
+<p>\r
+<a href=".html"></a>\r
+</br>\r
+<a href=".html"></a>\r
+</br>\r
+<a href=".html"></a>\r
+</br>\r
+<a href=".html"></a>\r
+</br>\r
+<a href=""></a>\r
+</br>\r
+<a href=""></a>\r
+</br>\r
+<a href=""></a>\r
+</p><p>\r
+</p><p>\r
+</p><p>\r
+</p><p>\r
+</p><p>\r
+\r
+</p>\r
+</body>\r
+</html>
\ No newline at end of file