Check-in Lasker-2.2.3 tar ball from samba.org
[capablanca.git] / lasker-2.2.3 / data / help / examine
1
2 examine
3
4 Usage:  examine [player1 [player2, game_number]
5
6   This command starts a game in the examine mode where you, as the examiner,
7 can move the pieces for both white and black, take moves back and analyze side
8 variations.  You can examine a new game from scratch, a stored (adjourned)
9 game, a finished game from "history" or a game in someone's "journal".
10
11
12 STARTING EXAMINE MODE
13
14   There are four ways to begin an examine session:
15
16   1) New Game from Scratch -- "Examine" used alone without any player names
17      begins examine mode for a new game and, in essence, you will be playing
18      yourself.  Typing "match your_handle" is also a way to enter examine mode
19      for a new game.
20
21   2) Stored Games (adjourned) -- "Examine player1" will examine your stored
22      game against player1 (if one exists).  "Examine white_player
23      black_player" will examine the stored game (adjourned) between the two
24      players.  Example: "examine dav thedane".
25
26   3) Completed Game from History -- "Examine player1 game_number" will examine
27      that game from player1's "history".  Example: "examine theviking 45".
28
29   4) Game from a Journal -- "Examine player1 game_slot" will examine that game
30      from player1's "journal" (unless the journal is private, namely
31      "jprivate" variable has been set to non-zero).  Example: "examine sms B".
32
33
34 EXAMINE MODE
35
36   No matter how you start the examine functions, the game will be played from
37 the starting position, not the last, stored position.
38
39   While in examine mode, you can move the pieces in order to set up a position
40 and/or analyze side variations.  There are three special commands you can use
41 when examining a stored game:
42
43     forward [#]      goes forward # moves (default n=1)
44
45     backward [#]     goes backward # moves (default n=1)
46
47     revert           goes back to the main variation (the last branch)
48
49 For new games, only "backward" works; the other commands have no affect since
50 there is no main line stored.  Therefore, once you go backward, you will need
51 to move the pieces again in order to move forward.
52
53   Lastly, the command "unexamine" leaves the examine mode and ends your
54 analysis of the game.
55
56
57 GROUP EXAMINE
58
59   Other users can also examine the game you are reviewing.  But must you
60 decide who these other examiners are.  Here are the steps involved:
61
62   (1) The other examiner must first "observe" your game.
63
64   (2) You, as the main examiner, must type "mexamine <user>" in order to give
65       "user" access to the examine mode.
66
67   As long as there is at least one designated examiner of a game, the analysis
68 can continue even when the first examiner who started the examine session
69 leaves.
70
71   In order to communicate with another examiner of the game, it is best to use
72 the "kibitz" command.  If you use "whisper", the game's observers but not
73 examiners will hear your message.
74
75
76 SPECIAL NOTES
77
78 (1)  Players examining games have a # next to their handles in the (short)
79 "who" display, and examined games are listed in both the "games"  and
80 "allobservers" displays.
81
82 (2)  "Unexamine" stops your participation in the analysis, and also stops your
83 observer status.  Other examiners of the game may continue, however, even if
84 you started the examine session initially.
85
86 (3)  Clock times displayed are unimportant, of course, since time is not a
87 factor when analyzing games.
88
89
90 See Also:  allobservers  backward  forward  games  history  kibitz  journal  
91 match  mexamine  observe  stored  unexamine  variables  whisper  who
92
93 [Last modified: December 17, 1995 -- Friar]
94