Alter Makefile to force 32-bit compile
[capablanca.git] / lasker-2.2.3 / data / help / match
1
2 match
3
4 Usage: match user [rated|unrated] [Start] [Inc] [Black_Start Black_Inc]
5 [White|Black] [board_category board]
6
7
8 SUMMARY
9 ~~~~~~~
10   This command allows you to challenge a given user to a game of chess.  To
11 challenge USER to a match, type "match USER".  The type of match being offered
12 depends on (a) your variable settings (preferences) and (b) information you
13 give in the match request.  USER will need to accept or decline the challenge. 
14 You can cancel a challenge you have made using the "withdraw" command.
15
16
17 MATCH VARIABLES
18 ~~~~~~~~~~~~~~~
19   You can specify the parameters for the match.  If no parameters are
20 specified, (a) the challenger's variable settings for "rated|unrated", "Start"
21 and "Inc" will be used (see "variables"), (b) the clock times will be the same
22 for both players, (c) the colors will be chosen by the server, and (d) the
23 board_category will be standard.  Here are details about each variable of the
24 match command.
25
26
27 RATED|UNRATED -- Sets whether the match will be rated or unrated.  If
28 undesignated, the challenger's variable setting for "Rated" will be used.  If
29 designated, it will override the challenger's "Rated" setting.  Example:
30 "match user rated".
31
32 START and INC -- Determine the clock variables for the match, where Start is
33 in minutes and Inc is in seconds.  If only 'Start' is given then 'Inc' is
34 assumed to be zero (example, "match user 5").  If values are given for Black
35 then the challenger will play the White side (example, "match user 5 0 5 0");
36 otherwise the side will be chosen "fairly".
37
38 WHITE|BLACK -- If a color is given, White or Black (w/b), that will be the
39 color of the challenger (example, "match user w").
40
41 BOARD_CATEGORY BOARD -- These two parameters must be used together.  They
42 specify a particular starting position for the game.  These parameters can
43 only be included when all of the other parameters have also been given.  If a
44 particular starting position is not supplied, then "standard" and "standard"
45 are used (that is, the "regular" starting position for pieces will be used
46 with no particular opening).  (See the "boards" help file for the categories.)
47
48
49 EXAMPLES OF MATCH REQUESTS (challenges):
50 ~~~~~~~~~~~~~~~~~~~~~~~~~~
51 match red
52   Challenges user "red" to a match using your default values for Rated, Start
53   and Inc.
54
55 match red 5
56   Challenges user "red" to a match with Start = 5 and Inc = 0 using your
57   default value for Rated.
58
59 match red 30 30 u
60   Challenges user "red" to an unrated match using a 30 minute Start time and
61   30 second Increments per move ("match red 30 30 0 0" would give the same
62   result.)
63
64 match red 30 0 15 0 w
65   Challenges user "red" to a non-standard, time-odds match with the challenger
66   playing White and "red" playing Black.  White will Start with 30 minutes on
67   the clock, and Black will Start with 15 minutes (note that all four values
68   for the time controls must be given for a match with time odds).
69
70 match red 2 12 0 0 openings ruy-lopez
71   Challenges user "red" to a match using the ruy-lopez opening position.
72   (Note that to start from a given board, you must give all four time control
73   values; in this example, you may NOT omit the two zeros.)
74
75 match red 2 12 0 0 wild 3
76   Challenges user "red" to a match using the wild 3 starting position.
77   (Again, all four time control values must be given.)
78
79 match red 5 12 bughouse
80   Challenges user "red" to a bughouse match, once the bughouse teams have been
81   arranged.  The word "wild" does not need to be used.
82
83
84 SPECIAL NOTES
85 ~~~~~~~~~~~~~
86
87 (a)  COUNTER OFFERS:  If you receive a match request from a user and you
88 request a match with different time controls, then in essence you (a) decline
89 the first request but (b) make a request of your own.  If your counter request
90 has the same time controls, a game will begin.
91
92 (b)  RESUMING ADJOURNED GAMES:  Use the "match" command to resume an adjourned
93 game.  Resuming an adjourned game takes precedence over starting a new game. 
94 The match request, of course, can be declined by your opponent.  Adjudications
95 of adjourned games are possible.  
96
97 (c)  USING FORMULAS TO FILTER OUT MATCH REQUESTS:  Match requests from other
98 users can be filtered by using a formula.  If a request fails to meet your
99 formula, it is declined automatically for you.  Also, you will not receive
100 challenges from users on your "censor" list.
101
102 (d)  ALIASES:  Using aliases can make it easier to challenge other players to
103 matches.
104
105 (e)  EXAMINE MODE:  Matching yourself ("match your_handle") is a way to enter
106 examine mode.
107
108 (f)  MATCH TYPE:  It is not possible to request a type of match directly, such
109 as "match user blitz".  How a match is classified depends upon both the Start
110 time and the Inc time.  An equation is used to determine whether a match will
111 be blitz or standard (see the "blitz" help file).  You can, however, request a
112 bughouse match directly.
113
114 (g)  NOPLAY LIST:  If you do not want to receive match requests from a
115 particular user, place that person on your "noplay" list.
116
117
118 See Also:  accept  adjourn  adjudicate  alias  blitz  boards  bughouse  censor 
119 decline  examine  formula  intro_playing  noplay  variables [rated, start,
120 inc, etc.]  withdraw
121
122 [Last modified: December 25, 1995 -- Friar]
123