1
=== added directory '.pc/90_fix-help-links.patch'
2
=== added directory '.pc/90_fix-help-links.patch/glchess'
3
=== added directory '.pc/90_fix-help-links.patch/glchess/help'
4
=== added directory '.pc/90_fix-help-links.patch/glchess/help/C'
5
=== added file '.pc/90_fix-help-links.patch/glchess/help/C/glchess.xml'
6
--- .pc/90_fix-help-links.patch/glchess/help/C/glchess.xml	1970-01-01 00:00:00 +0000
7
+++ .pc/90_fix-help-links.patch/glchess/help/C/glchess.xml	2012-12-26 19:18:24 +0000
8
@@ -0,0 +1,763 @@
9
1
<?xml version="1.0"?>
10
2
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
11
3
    "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
12
4
  <!ENTITY legal SYSTEM "legal.xml">
13
5
  <!ENTITY appversion "2.18">
14
6
  <!ENTITY manrevision "2.18">
15
7
  <!ENTITY date "December">
16
8
  <!ENTITY app "<application>Chess</application>">
17
9
  <!ENTITY appname "Chess">
18
10
  <!ENTITY version "2.22">
19
11
]>
20
12
21
13
<!-- 
22
14
      (Do not remove this comment block.)
23
15
  Maintained by the GNOME Documentation Project
24
16
  http://developer.gnome.org/projects/gdp
25
17
  Template version: 2.0 beta
26
18
  Template last modified Feb 12, 2002
27
19
-->
28
20
29
21
<!-- =============Document Header ============================= -->
30
22
<article id="index" lang="en">
31
23
<!-- please do not change the id; for translations, change lang to -->
32
24
<!-- appropriate code -->
33
25
<articleinfo>
34
26
 <title>&app; Manual</title>
35
27
 
36
28
 <abstract role="description">
37
29
       <para>
38
30
	glChess is a game for playing the classic board game of chess, 
39
31
	in which two players simulate a battle by capturing the opponents 
40
32
	pieces and ultimately the king. It can be played in 2D or 3D mode, 
41
33
	full screen or in a window.
42
34
       </para>
43
35
 </abstract>
44
36
 <copyright>
45
37
  <year>2006-2008</year>
46
38
  <holder>Andreas Røsdal</holder>
47
39
 </copyright>
48
40
<!-- translators: uncomment this:
49
41
50
42
  <copyright>
51
43
   <year>2002</year>
52
44
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
53
45
  </copyright>
54
46
55
47
   -->
56
48
<!-- An address can be added to the publisher information.  If a role is 
57
49
     not specified, the publisher/author is the same for all versions of the 
58
50
     document.  -->
59
51
    <publisher role="maintainer"> 
60
52
      <publishername> GNOME Documentation Project </publishername> 
61
53
    </publisher> 
62
54
63
55
   &legal;
64
56
   <!-- This file  contains link to license for the documentation (GNU FDL), and 
65
57
        other legal stuff such as "NO WARRANTY" statement. Please do not change 
66
58
	any of this. -->
67
59
68
60
    <authorgroup> 
69
61
      <author> 
70
62
	<firstname>Andreas</firstname> 
71
63
	<surname>Røsdal</surname> 
72
64
	<affiliation> 
73
65
	  <address> <email>andrearo@pvv.ntnu.no</email> </address> 
74
66
	</affiliation> 
75
67
      </author> 
76
68
<!-- This is appropriate place for other contributors: translators,
77
69
      maintainers,  etc. Commented out by default.
78
70
       <othercredit role="translator">
79
71
	<firstname>Latin</firstname> 
80
72
	<surname>Translator 1</surname> 
81
73
	<affiliation> 
82
74
	  <orgname>Latin Translation Team</orgname> 
83
75
	  <address> <email>translator@gnome.org</email> </address> 
84
76
	</affiliation>
85
77
	<contrib>Latin translation</contrib>
86
78
      </othercredit>
87
79
-->
88
80
    </authorgroup>
89
81
	
90
82
	<releaseinfo revision="2.26" role="review"/>
91
83
    
92
84
<revhistory>
93
85
      <revision> 
94
86
	<revnumber>&appname; Manual V&manrevision;</revnumber> 
95
87
	<date>&date;</date> 
96
88
	<revdescription> 
97
89
	  <para role="author">Andreas Røsdal
98
90
	    <email>andrearo@pvv.ntnu.no</email>
99
91
	  </para>
100
92
	  <para role="publisher">GNOME Documentation Project</para>
101
93
	</revdescription> 
102
94
      </revision>
103
95
  <revision>
104
96
   <revnumber>1</revnumber>
105
97
   <date>December 2006</date>
106
98
   <authorinitials>AR</authorinitials>
107
99
   <revremark>
108
100
   First draft completed.
109
101
   </revremark>
110
102
  </revision>
111
103
 </revhistory>
112
104
113
105
    <releaseinfo>This manual describes version &appversion; of &appname;.
114
106
    </releaseinfo>
115
107
    <!-- The following feedback information only applies to appliactions
116
108
    listed in bugzilla.gnome.org and bugzilla.ximian.com. For other
117
109
    applications, please provide your own feedback info or remove thsi
118
110
    section altogether -->
119
111
    <legalnotice> 
120
112
      <title>Feedback</title> 
121
113
      <para>To report a bug or make a suggestion regarding the &app; application or
122
114
	this manual, follow the directions in the 
123
115
	<ulink url="ghelp:user-guide?feedback-bugs"
124
116
	  type="help">GNOME Feedback Page</ulink>. 
125
117
      </para>
126
118
<!-- Translators may also add here feedback address for translations -->
127
119
    </legalnotice>
128
120
129
121
</articleinfo>
130
122
131
123
  <indexterm zone="index"> 
132
124
    <primary>glChess</primary> 
133
125
  </indexterm>
134
126
135
127
<!-- ============= Document Body ============================= -->
136
128
<!-- ============= Introduction ============================== -->
137
129
<sect1 id="intro">
138
130
 <title>Introduction</title>
139
131
 <sect2 id="what">
140
132
  <title>Overview of Chess</title>
141
133
  
142
134
  <para>
143
135
	Chess is a two-player strategy board game. <application>glChess</application> is a 2D/3D chess game, where games
144
136
	can be played between a combination of human and computer players. glChess detects known third party chess engines
145
137
	for computer players. The game was originally developed by Robert Ancell, now the game is included in gnome-games.
146
138
  </para>
147
139
148
140
  <para>
149
141
	<application>glChess</application> is written in Python and uses GTK+ and Cairo to render the chess board. 3D support is 
150
142
	optionally available using OpenGl,
151
143
	using the Python OpenGL and GtkGLExt libraries. As with most modern 3D programs hardware acceleration is recommended but it should
152
144
	run OK in software. glChess is bundled with GNU Chess as the default chess AI. glChess can be played in network mode against 
153
145
	other players on the Internet.
154
146
  </para>
155
147
  <para>
156
148
	Chess is played on a square chessboard, consisting of 64 squares of alternating color. Each player begins the game with sixteen pieces: one king, one queen, two rooks, two knights, two bishops, and eight pawns. One player controls the white pieces and the other player controls the black pieces; the player that controls white is the first to move. The players take turns moving pieces; certain moves involve a "capturing" of an opponent's piece, removing it from the chessboard. The object of the game is to checkmate the opponent's king. This occurs when the king is under immediate attack (in check) and there is no way to remove it from attack on the next move. Theoreticians have developed extensive chess strategies and tactics since the game's inception.
157
149
</para>
158
150
<para>
159
151
The current form of the game emerged in South Europe in the second half of the 15th century after evolving from similar, much older games of Asian origin. Chess is one of the world's most popular board games. The tradition of competitive chess began in the 16th century. The first official World Chess Champion, Wilhelm Steinitz, claimed his title in 1886; his modern equivalent, Vladimir Kramnik, is the 14th Champion in the lineage. There are also biennial world team events called Chess Olympiads. Since the 20th century, two international organizations, the World Chess Federation and the International Correspondence Chess Federation have organized and overseen the top chess competitions and international titles.
160
152
</para>
161
153
<para>
162
154
One of the goals of early computer scientists was to create a chess-playing machine, and today's chess is deeply influenced by the overwhelming abilities of current chess programs. In 1997, a match between Garry Kasparov, then World Champion, and IBM's Deep Blue chess program proved that computers are able to beat even the strongest human players.
163
155
</para>
164
156
165
157
  <para>
166
158
   To run <application>glChess</application>, select
167
159
   <guimenuitem>Chess</guimenuitem> from the
168
160
   <guisubmenu>Games</guisubmenu> submenu of the <guimenu>Main
169
161
   Menu</guimenu>, or type <command>glchess</command> on the
170
162
   command line. 
171
163
  </para>
172
164
 </sect2>
173
165
174
166
</sect1>
175
167
176
168
177
169
<sect1 id="playing-glchess">
178
170
 <title>Playing glChess</title>
179
171
 <sect2 id="main-game-window">
180
172
<title>Main game window</title>
181
173
182
174
     <para>
183
175
Starting glChess displays the main game window as shown below. The game is played
184
176
by moving chess pieces using the mouse. Each player alternates to move a piece in the appropriate
185
177
colour, from one board position to another valid board position. 
186
178
The main game window is organized in three main areas: In the top menu and toolbar area,
187
179
most common game actions can be made. The chess board is in the middle of the window,
188
180
where the game is played by moving chess pieces using the mouse. Finally, the game
189
181
history panel is shown at the bottom, where information about the game history, the remaining
190
182
move time and buttons for showing previous or next moves are available.
191
183
</para>
192
184
193
185
 <figure id="main-game-shot">
194
186
  <title>Main window in glChess</title>
195
187
  <screenshot>
196
188
    <mediaobject> 
197
189
    <imageobject>
198
190
  <imagedata fileref="figures/game.png" format="PNG" srccredit="Andreas"/>
199
191
   </imageobject>
200
192
    <textobject> 
201
193
      <phrase>Main window in glChess.</phrase> 
202
194
    </textobject> 
203
195
  </mediaobject>
204
196
  </screenshot>
205
197
 </figure>
206
198
</sect2>
207
199
208
200
<sect2>
209
201
<title>Starting a new game</title>
210
202
<para>
211
203
To start a new game, press the <guibutton>New Game</guibutton> buttton on the toolbar. 
212
204
The new game dialog is then shown, which allows you to setup a new game with the settings
213
205
of your choice. In the <interface>game properties</interface> section, the game name and time-limit for
214
206
each player's move is set. In the <interface>players</interface> section, it is possible to setup the
215
207
number of human and AI players. If you have installed any supported chess engines as AI players,
216
208
these will be displayed in the list of available players. Finally, the difficulty setting of the AI
217
209
players is set in the <interface>difficulty</interface> section.
218
210
</para>
219
211
220
212
 <figure id="new-game-shot">
221
213
  <title>Start new game dialog</title>
222
214
  <screenshot>
223
215
    <mediaobject> 
224
216
    <imageobject>
225
217
  <imagedata fileref="figures/new_game.png" format="PNG" srccredit="Andreas"/>
226
218
   </imageobject>
227
219
    <textobject> 
228
220
      <phrase>Start new game dialog for glChess.</phrase> 
229
221
    </textobject> 
230
222
  </mediaobject>
231
223
  </screenshot>
232
224
 </figure>
233
225
234
226
</sect2>
235
227
236
228
237
229
238
230
239
231
<sect2 id="menubar">
240
232
   <title>Menus</title>
241
233
   <para>
242
234
    The menu bar, located at the top of the <interface>Main
243
235
    Window</interface>, contains the following menus:
244
236
   </para>
245
237
246
238
   <variablelist>
247
239
    <varlistentry>
248
240
     <term><guimenu>Game</guimenu></term>
249
241
     <listitem>
250
242
      <para>
251
243
       This menu contains:
252
244
       <itemizedlist>
253
245
        <listitem>
254
246
         <para>
255
247
          <menuchoice>
256
248
           <shortcut>
257
249
            <keysym>Ctrl+N</keysym>
258
250
           </shortcut>
259
251
           <guimenuitem>New</guimenuitem>
260
252
          </menuchoice>
261
253
           This starts a new game of <application>Chess</application>.
262
254
         </para>
263
255
        </listitem>
264
256
	<listitem>
265
257
         <para>
266
258
          <menuchoice>
267
259
           <shortcut>
268
260
            <keysym>Ctrl+O</keysym>
269
261
           </shortcut>
270
262
           <guimenuitem>Open</guimenuitem>
271
263
          </menuchoice>
272
264
           Loads a previously saved game.
273
265
         </para>
274
266
        </listitem>
275
267
	<listitem>
276
268
         <para>
277
269
          <menuchoice>
278
270
           <shortcut>
279
271
            <keysym>Ctrl+S</keysym>
280
272
           </shortcut>
281
273
           <guimenuitem>Save</guimenuitem>
282
274
          </menuchoice>
283
275
           Saves the current game of chess.
284
276
         </para>
285
277
        </listitem>
286
278
	<listitem>
287
279
         <para>
288
280
          <menuchoice>
289
281
           <guimenuitem>Save As</guimenuitem>
290
282
          </menuchoice>
291
283
           Saves the current game of chess with a new filename.
292
284
         </para>
293
285
        </listitem>
294
286
295
287
        <listitem>
296
288
         <para>
297
289
          <menuchoice>
298
290
           <shortcut>
299
291
            <keysym>Ctrl+L</keysym>
300
292
           </shortcut>
301
293
           <guimenuitem>Network Game</guimenuitem>
302
294
          </menuchoice>
303
295
           This starts a network multiplayer game using GGZ Gaming Zone.
304
296
         </para>
305
297
        </listitem>
306
298
        <listitem>
307
299
         <para>
308
300
          <menuchoice>
309
301
           <guimenuitem>Resign</guimenuitem>
310
302
          </menuchoice>
311
303
           To concede loss of the game, so that the opponent wins the game. 
312
304
         </para>
313
305
        </listitem>
314
306
        <listitem>
315
307
         <para>
316
308
          <menuchoice>
317
309
           <guimenuitem>Claim Draw</guimenuitem>
318
310
          </menuchoice>
319
311
	    If a claimed draw is accepted, the game ends without victory for either player. 
320
312
          </para>
321
313
        </listitem>
322
314
        <listitem>
323
315
         <para>
324
316
          <menuchoice>
325
317
           <shortcut>
326
318
            <keysym>Ctrl+Q</keysym>
327
319
           </shortcut>
328
320
           <guimenuitem>Quit</guimenuitem>
329
321
          </menuchoice>
330
322
	 Ends the game.
331
323
         </para>
332
324
        </listitem>
333
325
       </itemizedlist>
334
326
      </para>
335
327
     </listitem>
336
328
    </varlistentry>
337
329
338
330
339
331
    <varlistentry>
340
332
     <term><guimenu>View</guimenu></term>
341
333
     <listitem>
342
334
      <para>
343
335
       This menu contains:
344
336
       <itemizedlist>
345
337
        <listitem>
346
338
         <para>
347
339
          <menuchoice>
348
340
           <shortcut>
349
341
            <keysym>F11</keysym>
350
342
           </shortcut>
351
343
           <guimenuitem>Fullscreen</guimenuitem>
352
344
          </menuchoice>
353
345
           Shows the game window in fullscreen mode.
354
346
         </para>
355
347
        </listitem>
356
348
	<listitem>
357
349
         <para>
358
350
          <menuchoice>
359
351
           <guimenuitem>3D Chess View</guimenuitem>
360
352
          </menuchoice>
361
353
           Enables 3D chess view mode using OpenGL. This requires Python OpenGL and Python GTKGLExt installed,
362
354
	   in addition to a 3D graphics card setup properly. Please contact your system administrator if you have problems,
363
355
	   either way you will always be able to play chess in 2D mode.
364
356
         </para>
365
357
        </listitem>
366
358
	 <listitem>
367
359
         <para>
368
360
          <menuchoice>
369
361
           <guimenuitem>Show Logs</guimenuitem>
370
362
          </menuchoice>
371
363
	  Show logs for debugging glChess and the active chess AI engines.
372
364
         </para>
373
365
        </listitem>
374
366
     </itemizedlist>
375
367
      </para>
376
368
     </listitem>
377
369
    </varlistentry>
378
370
379
371
   <varlistentry>
380
372
     <term><guimenu>Settings</guimenu></term>
381
373
     <listitem>
382
374
      <para>
383
375
       This menu contains:
384
376
       <itemizedlist>
385
377
        <listitem>
386
378
         <para>
387
379
          <menuchoice>
388
380
           <guimenuitem>Preferences</guimenuitem>
389
381
          </menuchoice>
390
382
            This opens your window to edit <link linkend="prefs">
391
383
           preferences.</link>
392
384
         </para>
393
385
        </listitem>
394
386
       </itemizedlist>
395
387
      </para>
396
388
     </listitem>
397
389
    </varlistentry>   
398
390
399
391
    <varlistentry>
400
392
     <term><guimenu>Help</guimenu></term>
401
393
     <listitem>
402
394
      <para>
403
395
       This menu contains:
404
396
       <itemizedlist>
405
397
        <listitem>
406
398
          <para>
407
399
          <menuchoice>
408
400
           <shortcut>
409
401
            <keysym>F1</keysym>
410
402
           </shortcut>
411
403
           <guimenuitem>Contents</guimenuitem>
412
404
          </menuchoice>
413
405
           Display this manual.
414
406
         </para>
415
407
         <para>
416
408
          <guimenuitem>About</guimenuitem>  This opens the
417
409
          <interface>About</interface> dialog which shows
418
410
          basic information about
419
411
          <application>glChess</application>, such as
420
412
          the author's name, the version number of the game.
421
413
         </para>
422
414
        </listitem>
423
415
       </itemizedlist>
424
416
      </para>
425
417
     </listitem>
426
418
    </varlistentry>
427
419
   </variablelist>
428
420
429
421
430
422
</sect2>
431
423
432
424
433
425
</sect1>
434
426
435
427
436
428
<sect1 id="chess-rules">
437
429
 <title>Chess Rules</title>
438
430
 <sect2 id="rules-of-chess">
439
431
  <title>The Rules of Chess</title>
440
432
<!--
441
433
The reference for this chapter is http://en.wikipedia.org/wiki/Chess
442
434
-->
443
435
  <para>
444
436
Chess is played on a square board of eight rows (called ranks and denoted with numbers 1 to 8) and eight columns (called files and denoted with letters a to h) of squares. The colors of the sixty-four squares alternate between light and dark, and are referred to as "light squares" and "dark squares". The chessboard is placed so that each player has a white square in the near right hand corner, and the pieces are set out as shown in the diagram, with each queen on a square that matches its color.
445
437
</para><para>
446
438
Each player begins the game with sixteen pieces: each player's pieces comprise one king, one queen, two rooks, two bishops, two knights and eight pawns. One player, referred to as White, controls the white pieces and the other player, Black, controls the black pieces; White is always the first player to move. The colors are chosen either by a friendly agreement, by a game of chance or by a tournament director. The players alternate moving one piece at a time (with the exception of castling, when two pieces are moved at the same time). Pieces are moved to either an unoccupied square, or one occupied by an opponent's piece, capturing it and removing it from play. With one exception (en passant), all pieces capture opponent's pieces by moving to the square that the opponent's piece occupies.
447
439
</para>
448
440
 <sect3 id="rules-piece-king">
449
441
  <title>King</title>
450
442
<para>When a king is under direct attack by one (or possibly two) of the opponent's pieces, the player is said to be in check. When in check, only moves that remove the king from attack are permitted. The player must not make any move that would place his king in check. The object of the game is to checkmate the opponent; this occurs when the opponent's king is in check, and there are no moves that remove the king from attack.
451
443
452
444
</para><para>
453
445
    The king can move only one square horizontally, vertically, or diagonally. Once in the game, each king is allowed to make a special double move, to castle. Castling consists of moving the king two squares towards a rook, then moving the rook onto the square over which the king crossed. Castling is only permissible if all of the following conditions hold:
454
446
</para>
455
447
<itemizedlist spacing="compact">
456
448
  <listitem>
457
449
   <para>The player must never have moved both the king and the rook involved in castling.</para>
458
450
  </listitem>
459
451
  <listitem>
460
452
   <para>There must be no pieces between the king and the rook.</para>
461
453
  </listitem>
462
454
  <listitem>
463
455
   <para>The king may not currently be in check, nor may the king pass through squares that are under attack by enemy pieces. As with any move, castling is illegal if it would place the king in check.</para>
464
456
 </listitem>
465
457
  <listitem>
466
458
   <para>The king and the rook must be on the same rank (to exclude castling with a promoted pawn).</para>
467
459
  </listitem>
468
460
</itemizedlist>
469
461
</sect3>
470
462
 <sect3 id="rules-piece-rook">
471
463
  <title>Rook</title>
472
464
<para>
473
465
   The rook moves any number of vacant squares vertically or horizontally (it is also involved in the king's special move of castling).
474
466
</para>
475
467
</sect3>
476
468
 <sect3 id="rules-piece-bishop">
477
469
  <title>Bishop</title>
478
470
<para>
479
471
    The bishop moves any number of vacant squares in any direction diagonally. Note that a bishop never changes square color, therefore players speak about "light-squared" or "dark-squared" bishops.
480
472
</para>
481
473
</sect3>
482
474
 <sect3 id="rules-piece-queen">
483
475
  <title>Queen</title>
484
476
<para>
485
477
    The queen can move any number of vacant squares diagonally, horizontally, or vertically.
486
478
</para>
487
479
</sect3>
488
480
 <sect3 id="rules-piece-knight">
489
481
  <title>Knight</title>
490
482
<para>
491
483
    The knight can jump over occupied squares and moves two spaces horizontally and one space vertically or vice versa, making an "L" shape. A knight in the middle of the board has eight squares to which it can move. Note that every time a knight moves, it changes square color.
492
484
493
485
</para>
494
486
</sect3>
495
487
 <sect3 id="rules-piece-pawns">
496
488
  <title>Pawns</title>
497
489
<para>
498
490
499
491
    Pawns have the most complex rules of movement: A pawn can move forward one square, if that square is unoccupied. If it has not moved yet, the pawn has the option of moving two squares forward, if both squares in front of the pawn are unoccupied. A pawn cannot move backward. When such an initial two square advance is made that puts that pawn horizontally adjacent to an opponent's pawn, the opponent's pawn can capture that pawn "en passant" as if it moved forward only one square rather than two, but only on the immediately subsequent move. Pawns are the only pieces that capture differently than they move. They can capture an enemy piece on either of the two spaces adjacent to the space in front of them (i.e., the two squares diagonally in front of them), but cannot move to these spaces if they are vacant. If a pawn advances all the way to its eighth rank, it is then promoted (converted) to a queen, rook, bishop, or knight of the same color. In practice, the pawn is almost always promoted to a queen.
500
492
</para>
501
493
</sect3>
502
494
503
495
<sect3 id="rules-movement-others">
504
496
<title>Remaining movement rules</title>
505
497
<para>
506
498
With the exception of the knight, pieces cannot jump over each other. One's own pieces ("friendly pieces") cannot be passed if they are in the line of movement, and a friendly piece can never replace another friendly piece. Enemy pieces cannot be passed, but they can be "captured". When a piece is captured (or taken), the attacking piece replaces the enemy piece on its square (en passant being the only exception). The captured piece is thus removed from the game and may not be returned to play for the remainder of the game. The king cannot be captured, only put in check. If a player is unable to get the king out of check, checkmate results, with the loss of the game.
507
499
508
500
</para><para>
509
501
Chess games do not have to end in checkmate — either player may resign if the situation looks hopeless. Games also may end in a draw (tie). A draw can occur in several situations, including draw by agreement, stalemate, threefold repetition of a position, the fifty move rule, or a draw by impossibility of checkmate (usually because of insufficient material to checkmate).
510
502
</para>
511
503
</sect3>
512
504
</sect2>
513
505
514
506
515
507
<sect2 id="timed-games">
516
508
<title>Timed Games</title>
517
509
<para>
518
510
Games can be played with a time-limit by setting a move time when creating a new game. In timed games each
519
511
player has a certain amount of time available for deciding which moves to make, and the time remaining 
520
512
for each player decreases only when it is their turn to move.
521
513
</para>
522
514
</sect2>
523
515
524
516
<sect2 id="draw">
525
517
<title>Game Draw</title>
526
518
<para>
527
519
A game that ends without victory for either player. Most drawn games are draws by agreement based upon the rules. The other ways that a game can end in a draw are stalemate, three-fold repetition, the fifty-move rule, and insufficient material. A position is said to be a draw (or a drawn position) if either player can, through correct play, eventually force the game into a position where the game must end in a draw, regardless of the moves made by the other player.
528
520
</para>
529
521
530
522
531
523
<sect3 id="stalemate">
532
524
<title>Stalemate</title>
533
525
<para>
534
526
A stalemate is a position in which the player whose turn it is to move has no legal move and his king is not in check. A stalemate results in an immediate draw.
535
527
</para>
536
528
</sect3>
537
529
538
530
<sect3 id="threefold-repetition">
539
531
<title>Threefold repetetion</title>
540
532
<para>
541
533
The game is drawn if the same position occurs three times with the same player to move, and with each player having the same set of legal moves each time (the latter includes the right to take en passant and the right to castle).
542
534
</para>
543
535
</sect3>
544
536
545
537
546
538
<sect3 id="fifty-move-rule">
547
539
<title>Fifty move rule</title>
548
540
<para>
549
541
The fifty move rule states that the game is drawn after fifty moves from each side without a pawn move or capture.
550
542
</para>
551
543
</sect3>
552
544
553
545
<sect3 id="insuff-material">
554
546
<title>Insufficient material</title>
555
547
<para>
556
548
An endgame scenario in which all pawns have been captured, and one side has only its king remaining while the other is down to just a king or a king plus one knight or one bishop. The position is a draw because it is impossible for the dominant side to deliver checkmate regardless of play. Situations where checkmate is possible only if the inferior side blunders are covered by the fifty-move rule.
557
549
</para>
558
550
</sect3>
559
551
560
552
561
553
</sect2>
562
554
563
555
</sect1>
564
556
565
557
566
558
567
559
568
560
<sect1 id="prefs">
569
561
 <title>Game Settings</title>
570
562
571
563
572
564
<sect2 id="game-prefs">
573
565
  <title>Game Preferences</title>
574
566
  <para>
575
567
  This preference dialog allows you to modify board orientation, move format and promotion type.
576
568
  </para>
577
569
578
570
 <figure id="preferences-game-shot">
579
571
  <title>Game preferences dialog for glChess</title>
580
572
  <screenshot>
581
573
    <mediaobject> 
582
574
    <imageobject>
583
575
  <imagedata fileref="figures/preferences_game.png" format="PNG" srccredit="Andreas"/>
584
576
   </imageobject>
585
577
    <textobject> 
586
578
      <phrase>Game preferences dialog for glChess.</phrase> 
587
579
    </textobject> 
588
580
  </mediaobject>
589
581
  </screenshot>
590
582
 </figure>
591
583
592
584
593
585
</sect2>
594
586
595
587
596
588
597
589
<sect2 id="view-prefs">
598
590
  <title>View Preferences</title>
599
591
  <para>
600
592
  This preference dialog allows you to modify the look and feel of glChess. 
601
593
  </para>
602
594
603
595
 <figure id="preferences-view-shot">
604
596
  <title>View preferences dialog for glChess</title>
605
597
  <screenshot>
606
598
    <mediaobject> 
607
599
    <imageobject>
608
600
  <imagedata fileref="figures/preferences_view.png" format="PNG" srccredit="Andreas"/>
609
601
   </imageobject>
610
602
    <textobject> 
611
603
      <phrase>View preferences dialog for glChess.</phrase> 
612
604
    </textobject> 
613
605
  </mediaobject>
614
606
  </screenshot>
615
607
 </figure>
616
608
617
609
618
610
</sect2>
619
611
620
612
</sect1>
621
613
622
614
623
615
<sect1 id="engines">
624
616
 <title>Chess Engines</title>
625
617
626
618
     <para>
627
619
	glChess should be able to use any Chess Engine Communication Protocol or Universal Chess Interface compatible chess engines, including these chess engines:
628
620
629
621
     </para>
630
622
631
623
<!-- Please keep AI list synchronized with glchess/data/ai.xml -->
632
624
<itemizedlist spacing="compact">
633
625
  <listitem>
634
626
	<para>GNUChess</para>
635
627
  </listitem>
636
628
  <listitem>
637
629
	<para>Sjeng</para>
638
630
  </listitem>
639
631
  <listitem>
640
632
	<para>Amy</para>
641
633
 </listitem>
642
634
  <listitem>
643
635
	<para>Crafty</para>
644
636
  </listitem>
645
637
  <listitem>
646
638
	<para>Faile</para>
647
639
  </listitem>
648
640
  <listitem>
649
641
	<para>Phalanx</para>
650
642
  </listitem>
651
643
  <listitem>
652
644
	<para>Glaurung</para>
653
645
  </listitem>
654
646
  <listitem>
655
647
	<para>HoiChess</para>
656
648
  </listitem>
657
649
  <listitem>
658
650
	<para>Diablo</para>
659
651
  </listitem>
660
652
  <listitem>
661
653
	<para>BBChess	</para>
662
654
  </listitem>
663
655
  <listitem>
664
656
	<para>Fruit</para>
665
657
  </listitem>
666
658
  <listitem>
667
659
	<para>Amundsen</para>
668
660
  </listitem>
669
661
  <listitem>
670
662
	<para>Shredder</para>
671
663
  </listitem>
672
664
  <listitem>
673
665
	<para>Toga II</para>
674
666
  </listitem>
675
667
  <listitem>
676
668
	<para>Boo's Chess Engine</para>
677
669
  </listitem>
678
670
679
671
680
672
</itemizedlist>
681
673
682
674
</sect1>
683
675
684
676
685
677
<sect1 id="bugs">
686
678
 <title>Known Bugs and Limitations</title>
687
679
688
680
 <itemizedlist mark="opencircle">
689
681
    <listitem>
690
682
     <para>
691
683
	There are no documented bugs or limitations in glChess. To find areas where you can help improve  
692
684
        glChess, please refer to the TODO file which is distributed with the game.	
693
685
     </para>
694
686
    </listitem>
695
687
 </itemizedlist>
696
688
697
689
</sect1>
698
690
699
691
<sect1 id="credits">
700
692
 <title>Authors</title>
701
693
  <para>
702
694
   <application>glChess</application> was written by Robert Ancell,
703
695
   and is now maintained in gnome-games. This documentation was originally written
704
696
   by Andreas Røsdal, with input from several GPL sources. 
705
697
   To report a bug or make a suggestion regarding this application or
706
698
   this manual, follow the directions in this 
707
699
   <ulink url="ghelp:user-guide?feedback-bugs" type="help">document</ulink>.
708
700
  </para>
709
701
710
702
  <!-- For translations: uncomment this:
711
703
712
704
  <para>
713
705
   Latin translation was done by ME
714
706
   (<email>MYNAME@MYADDRESS</email>). Please send all  comments  and
715
707
   suggestions regarding this translation to SOMEWHERE.
716
708
  </para>
717
709
718
710
  -->
719
711
720
712
 </sect1>
721
713
722
714
723
715
 <!-- ============= Application License ============================= -->
724
716
725
717
 <sect1 id="license">
726
718
  <title>License</title>
727
719
  <para>
728
720
   This program is free software; you can redistribute it and/or
729
721
   modify it under the terms of the <citetitle>GNU General Public
730
722
   License</citetitle> as published by the Free Software Foundation;
731
723
   either version 2 of the License, or (at your option) any later
732
724
   version.
733
725
  </para>
734
726
  <para>
735
727
   This program is distributed in the hope that it will be useful, but
736
728
   WITHOUT ANY WARRANTY; without even the implied warranty of
737
729
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
738
730
   <citetitle>GNU General Public License</citetitle> for more details.
739
731
  </para>
740
732
  <para>
741
733
   A copy of the <citetitle>GNU General Public License</citetitle> is
742
734
   included as an appendix to the <citetitle>GNOME Users
743
735
   Guide</citetitle>.  You may also obtain a copy of the
744
736
   <citetitle>GNU General Public License</citetitle> from the Free
745
737
   Software Foundation by visiting <ulink type="http"
746
738
   url="http://www.fsf.org">their Web site</ulink> or by writing to
747
739
   <address>
748
740
    Free Software Foundation, Inc.
749
741
    <street>59 Temple Place</street> - Suite 330
750
742
    <city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode>
751
743
    <country>USA</country>
752
744
   </address>
753
745
  </para>
754
746
 </sect1>
755
747
</article>
756
748
757
749
758
750
759
751
760
752
761
753
762
754
763
755
764
756
765
757
766
758
767
759
768
760
769
761
770
762
771
763
772
0
764
773
=== added file '.pc/90_fix-help-links.patch/glchess/help/C/index.docbook'
774
=== added file '.pc/90_fix-help-links.patch/glchess/help/Makefile.am'
775
--- .pc/90_fix-help-links.patch/glchess/help/Makefile.am	1970-01-01 00:00:00 +0000
776
+++ .pc/90_fix-help-links.patch/glchess/help/Makefile.am	2012-12-26 19:18:24 +0000
777
@@ -0,0 +1,15 @@
778
1
@YELP_HELP_RULES@
779
2
HELP_ID = glchess
780
3
781
4
HELP_MEDIA = figures/new_game.png \
782
5
	      figures/game.png \
783
6
              figures/preferences_game.png \
784
7
	      figures/preferences_view.png
785
8
786
9
HELP_FILES = \
787
10
	glchess.xml \
788
11
	legal.xml
789
12
790
13
HELP_LINGUAS = ca cs da de el en_GB es eu fr gl ja ko oc pt_BR ru sl sr sr@latin sv zh_CN
791
14
792
15
-include $(top_srcdir)/git.mk
793
0
16
794
=== added directory '.pc/90_fix-help-links.patch/gnect'
795
=== added directory '.pc/90_fix-help-links.patch/gnect/help'
796
=== added directory '.pc/90_fix-help-links.patch/gnect/help/C'
797
=== added file '.pc/90_fix-help-links.patch/gnect/help/C/gnect.xml'
798
--- .pc/90_fix-help-links.patch/gnect/help/C/gnect.xml	1970-01-01 00:00:00 +0000
799
+++ .pc/90_fix-help-links.patch/gnect/help/C/gnect.xml	2012-12-26 19:18:24 +0000
800
@@ -0,0 +1,529 @@
801
1
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
802
2
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
803
3
        "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"
804
4
[
805
5
  <!ENTITY legal SYSTEM "legal.xml">
806
6
  <!ENTITY appversion "2.12">
807
7
  <!ENTITY manrevision "2.8">
808
8
  <!ENTITY date "September 2004">
809
9
  <!ENTITY app "<application>Four-in-a-Row</application>">
810
10
  <!ENTITY appname "Four-in-a-Row">
811
11
  <!ENTITY version "2.8">
812
12
]>
813
13
814
14
815
15
<!-- ===== DOCUMENT HEADER ===== -->
816
16
817
17
<article id="index" lang="en">
818
18
<!-- please do not change the id -->
819
19
<!-- translators, change lang to the appropriate code -->
820
20
  <articleinfo>
821
21
    <title>&appname; Manual</title>
822
22
    <abstract role="description">
823
23
      <para>
824
24
	The object of Four-in-a-Row is to place four pieces in a vertical, 
825
25
	horizontal, or diagonal row while the opponent tries to block and
826
26
	make his/her own row of four. Four-in-a-Row can be played against 
827
27
	another human or the computer.
828
28
      </para>
829
29
    </abstract>
830
30
831
31
    <copyright>
832
32
      <year>2001-2002</year>
833
33
      <holder>Timothy Musson</holder>
834
34
    </copyright>
835
35
836
36
    <!-- translators: uncomment this:
837
37
838
38
    <copyright>
839
39
     <year>2000</year>
840
40
     <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
841
41
    </copyright>
842
42
843
43
    -->
844
44
845
45
    <publisher role="maintainer"> 
846
46
      <publishername> GNOME Documentation Project </publishername> 
847
47
    </publisher> 
848
48
849
49
    &legal;
850
50
851
51
    <authorgroup>
852
52
      <author>
853
53
        <firstname>Timothy</firstname>
854
54
        <surname>Musson</surname>
855
55
        <affiliation>
856
56
          <!-- <orgname></orgname> -->
857
57
          <address><email>trmusson@ihug.co.nz</email></address>
858
58
        </affiliation>
859
59
      </author>
860
60
861
61
<!-- This is appropriate place for other contributors: translators,
862
62
      maintainers,  etc. Commented out by default.
863
63
864
64
      <othercredit role="translator">
865
65
        <firstname>Latin</firstname> 
866
66
        <surname>Translator 1</surname> 
867
67
        <affiliation> 
868
68
          <orgname>Latin Translation Team</orgname> 
869
69
          <address> <email>translator@gnome.org</email> </address> 
870
70
        </affiliation>
871
71
        <contrib>Latin translation</contrib>
872
72
      </othercredit>
873
73
-->
874
74
    </authorgroup>
875
75
	
876
76
	<releaseinfo revision="2.26" role="review"/>
877
77
878
78
    <revhistory>
879
79
      <revision>
880
80
        <revnumber>&appname; Manual V&manrevision;</revnumber>
881
81
        <date>&date;</date>
882
82
        <revdescription>
883
83
          <para role="author">Timothy Musson
884
84
            <email>trmusson@ihug.co.nz</email>
885
85
          </para>
886
86
          <para role="publisher"></para>
887
87
        </revdescription>
888
88
      </revision>
889
89
    </revhistory>
890
90
891
91
    <releaseinfo>This manual describes version &appversion; of &appname;.
892
92
    </releaseinfo>
893
93
894
94
    <legalnotice>
895
95
      <title>Feedback</title>
896
96
      <para>To report a bug or make a suggestion regarding the &appname;
897
97
        application or this manual, follow the directions in the
898
98
        <ulink url="ghelp:user-guide?feedback-bugs"
899
99
               type="help">GNOME Feedback Page</ulink>.
900
100
      </para>
901
101
    </legalnotice>
902
102
  </articleinfo>
903
103
904
104
905
105
  <!-- ============= Document Body ============================= -->
906
106
907
107
  <!-- ============= Introduction ============================== -->
908
108
909
109
910
110
  <sect1 id="intro">
911
111
912
112
    <title>Introduction</title>
913
113
914
114
    <para>
915
115
      &app; is a four-in-a-row game for the GNOME Project.
916
116
      The object of the game is to build a line of four of your marbles
917
117
      while trying to stop your opponent (human or computer) building a
918
118
      line of his or her own. A line can be horizontal, vertical or
919
119
      diagonal.
920
120
    </para>
921
121
922
122
    <para>
923
123
      To run &app;, select
924
124
      <guimenuitem>&appname;</guimenuitem> from the
925
125
      <guisubmenu>Games</guisubmenu> submenu of the
926
126
      <guimenu>Main Menu</guimenu>, or type
927
127
      <command>gnect</command> on the command line.
928
128
    </para>
929
129
930
130
    <para>
931
131
      &app; is included in the <filename>GNOME-games</filename> package,
932
132
      which is part of the GNOME desktop environment. This document describes
933
133
      version &version; of &app;.
934
134
    </para>
935
135
936
136
   <para>
937
137
     &appname; also features multiplayer support with two 
938
138
     human players in hotseat mode.
939
139
   </para>
940
140
941
141
942
142
  </sect1>
943
143
944
144
945
145
  <!-- ============= Usage ===================================== -->
946
146
947
147
948
148
  <sect1 id="usage">
949
149
950
150
    <title>Basic Usage</title>
951
151
952
152
    <!-- ===== How to play ===== -->
953
153
954
154
    <sect2 id="playing">
955
155
956
156
      <title>Playing &appname;</title>
957
157
958
158
      <para>
959
159
        To start a new game of &appname; choose <menuchoice><guimenu>Game</guimenu><guimenuitem>New Game</guimenuitem></menuchoice>.
960
160
      </para>
961
161
962
162
      <para>
963
163
        The <interface>game board</interface> consists of seven columns and
964
164
        six rows. Above it, a special row indicates the current player and the marble about to be played. Each move consists of dropping a marble in one of the columns. The marble lands on the topmost empty row of the chosen column.
965
165
      </para>
966
166
        
967
167
      <para>To make a move, click on a column with the mouse. To play with the keyboard, move the marble in the top row with the left and right arrow keys, and drop it in place with the  down arrow key. Your marble will drop into the topmost empty row of that column.
968
168
      </para>
969
169
970
170
      <!-- Figure -->
971
171
      <mediaobject id="mainwindow-fig">
972
172
        <imageobject>
973
173
          <imagedata fileref="figures/mainwindow.png"
974
174
                     format="PNG"
975
175
                     srccredit="trm"/>
976
176
        </imageobject>
977
177
        <textobject>
978
178
          <phrase>&appname;'s Main Window</phrase>
979
179
        </textobject>
980
180
        <caption><para>&appname;'s Main Window</para></caption>
981
181
      </mediaobject>
982
182
983
183
      <para>
984
184
        The game is won when one of the two players manages to line up four
985
185
        of his or her marbles horizontally, vertically or diagonally. If the
986
186
        board fills up without a win, the game ends in a draw.
987
187
      </para>
988
188
989
189
    </sect2>
990
190
    
991
191
    <!-- ===== Commands ===== -->  
992
192
    
993
193
    <sect2 id="commands">
994
194
      <title>Commands</title>
995
195
      <anchor id="menubar"/><!-- id for removed section -->
996
196
      
997
197
      <para>To take back a move, choose <menuchoice>
998
198
                      <shortcut><keycombo>
999
199
                      <keysym>Ctrl</keysym><keycap>Z</keycap>
1000
200
                      </keycombo></shortcut>
1001
201
                      <guimenuitem>Undo move</guimenuitem>
1002
202
                    </menuchoice>.
1003
203
            If you're playing against a friend, this will undo one
1004
204
            move. If you're playing against the computer, this will
1005
205
            undo the computer's last move and then yours.
1006
206
            Repeating this will return the board to its initial
1007
207
            state.
1008
208
      </para>
1009
209
      <para>Choose <menuchoice>
1010
210
                      <shortcut><keycombo>
1011
211
                      <keysym>Ctrl</keysym><keycap>H</keycap>
1012
212
                      </keycombo></shortcut>
1013
213
        <guimenuitem>Hint</guimenuitem>
1014
214
      </menuchoice> to get a suggestion from the computer for your next move.
1015
215
      This is shown in the status bar.</para>
1016
216
      
1017
217
      <para>
1018
218
        Choose <menuchoice>
1019
219
          <guimenuitem>Scores</guimenuitem>
1020
220
        </menuchoice> to show a tally of wins and draws
1021
221
        for the current playing session. The scores will be reset to
1022
222
        zero if Player Selection is changed in Preferences.
1023
223
      </para>      
1024
224
1025
225
      
1026
226
    </sect2>  
1027
227
1028
228
    <!-- ===== Preferences ===== -->
1029
229
1030
230
    <sect2 id="prefsdialog">
1031
231
1032
232
      <title>Preferences</title>
1033
233
1034
234
      <para>
1035
235
        To change the game's settings, select
1036
236
        <guimenuitem>Preferences</guimenuitem> from the
1037
237
        <guimenu>Settings</guimenu> menu. This opens the
1038
238
        <interface>Preferences Dialog</interface>.
1039
239
      </para>
1040
240
1041
241
      <para>
1042
242
        Configuration options in the <guilabel>Game</guilabel>
1043
243
        tab are:
1044
244
1045
245
        <variablelist>
1046
246
1047
247
          <varlistentry>
1048
248
            <term>
1049
249
              <guilabel>Player One</guilabel> and
1050
250
              <guilabel>Player Two</guilabel>
1051
251
            </term>
1052
252
            <listitem>
1053
253
              <para>
1054
254
1055
255
                These two columns tell &app; who's playing and, if it is the computer, how hard they play. To play against a friend, select
1056
256
                Human for both Player One and Player Two.
1057
257
1058
258
              </para>
1059
259
            </listitem>
1060
260
          </varlistentry>
1061
261
1062
262
          <varlistentry>
1063
263
            <term><guilabel>Theme</guilabel></term>
1064
264
            <listitem>
1065
265
              <para>
1066
266
                The theme menu lists available themes and lets
1067
267
                you choose your favourite.
1068
268
              </para>
1069
269
            </listitem>
1070
270
          </varlistentry>
1071
271
1072
272
          <varlistentry>
1073
273
            <term><guilabel>Enable Animation</guilabel></term>
1074
274
            <listitem>
1075
275
              <para>
1076
276
                Here you can toggle the game's animation on or off.
1077
277
              </para>
1078
278
            </listitem>
1079
279
          </varlistentry>
1080
280
1081
281
        </variablelist>
1082
282
      </para>
1083
283
      <para>
1084
284
          Finally there is a <guilabel>Controls</guilabel> tab to
1085
285
          change the keyboard controls. To change a control, double click the
1086
286
          appropriate entry and then press the new key.
1087
287
      </para>
1088
288
1089
289
    </sect2>
1090
290
  </sect1>
1091
291
1092
292
1093
293
  <!-- ===== Custom Themes ===================================== -->
1094
294
1095
295
1096
296
  <sect1 id="custom">
1097
297
1098
298
    <title>Creating New Themes</title>
1099
299
1100
300
    <para>
1101
301
      This section's included in case you'd like to make your own themes for
1102
302
      &app;. It assumes you're familiar with basic text editing, graphics
1103
303
      software and the command line.
1104
304
    </para>
1105
305
1106
306
    <sect2 id="images">
1107
307
1108
308
      <title>Images</title>
1109
309
1110
310
      <para>
1111
311
        &app;'s tile sets contain six tiles of equal size, lined up
1112
312
        horizontally. From left to right:
1113
313
      </para>
1114
314
1115
315
      <orderedlist>
1116
316
        <listitem>
1117
317
          <para>Player One's marble as it appears on the game board</para>
1118
318
        </listitem>
1119
319
        <listitem>
1120
320
          <para>Player Two's marble as it appears on the game board</para>
1121
321
        </listitem>
1122
322
        <listitem>
1123
323
          <para>The game board's background</para>
1124
324
        </listitem>
1125
325
        <listitem>
1126
326
          <para>The top row's background</para>
1127
327
        </listitem>
1128
328
        <listitem>
1129
329
          <para>Player One's marble as it appears on the top row</para>
1130
330
        </listitem>
1131
331
        <listitem>
1132
332
          <para>Player Two's marble as it appears on the top row</para>
1133
333
        </listitem>
1134
334
      </orderedlist>
1135
335
1136
336
      <figure id="shot1">
1137
337
        <title>An example tile set</title>
1138
338
        <screenshot>
1139
339
          <screeninfo>This image shows the six tiles in a tile set</screeninfo>
1140
340
          <graphic format="PNG" fileref="figures/tileset.png" srccredit="TRM"></graphic>
1141
341
        </screenshot>
1142
342
      </figure>
1143
343
1144
344
      <para>
1145
345
        Tiles three and four will be repeated over the game board and
1146
346
        top row unless a full window background image is specified in the
1147
347
        theme file.
1148
348
      </para>
1149
349
1150
350
      <tip>
1151
351
        <title>TIP</title>
1152
352
        <para>
1153
353
          PNG format is recommended for tile sets. The first, second, fifth
1154
354
          and sixth tiles should contain some transparency if you want the
1155
355
          background to show through. The third and fourth tiles should be
1156
356
          solid, with no transparency, even if you'll be using a full
1157
357
          window background image with your theme.
1158
358
        </para>
1159
359
      </tip>
1160
360
1161
361
      <tip>
1162
362
        <title>TIP</title>
1163
363
        <para>
1164
364
          Tiles can be square or rectangular, and any size you like. Most
1165
365
          of the tile sets that come with &app; use square tiles measuring
1166
366
          50 pixels by 50 pixels.
1167
367
        </para>
1168
368
      </tip>
1169
369
1170
370
      <para>
1171
371
        For a full window background image, there's a bit more work to do.
1172
372
        Let's say your tiles measure 50 by 50 pixels each. The game's display
1173
373
        measures 7 by 7 tiles, including the top row, so the ideal background
1174
374
        image for your tile set measures 350 by 350 pixels.
1175
375
      </para>
1176
376
1177
377
      <tip>
1178
378
        <title>TIP</title>
1179
379
        <para>
1180
380
          &app; will automatically scale the background image if it doesn't
1181
381
          match the tile set. This means you can make "large" and "small"
1182
382
          versions of your theme, both using the same background image,
1183
383
          just by having a large and a small version of your tile set.
1184
384
        </para>
1185
385
      </tip>
1186
386
1187
387
      <para>
1188
388
        So, you now have a tile set and perhaps a background image to
1189
389
        go with it. The next step is to put them in the right place.
1190
390
      </para>
1191
391
1192
392
    </sect2>
1193
393
1194
394
1195
395
    <sect2 id="directories">
1196
396
1197
397
      <title>Putting It Together</title>
1198
398
1199
399
      <para>
1200
400
        The last step is to put your image(s) where &app; can
1201
401
        find them. You could put them in Four-in-a-row's install directory (which will
1202
402
        depend on your particular system), but your home directory's probably
1203
403
        a better idea.
1204
404
      </para>
1205
405
1206
406
      <para>
1207
407
        Make a <filename class="directory">~/.gnect</filename> directory,
1208
408
        and a <filename class="directory">~/.gnect/pixmaps</filename>
1209
409
        directory. Those names are important, as &app; won't look
1210
410
        anywhere else.
1211
411
      </para>
1212
412
1213
413
      <para>
1214
414
        Copy your image(s) into the pixmaps directory.
1215
415
      </para>
1216
416
1217
417
      <para>
1218
418
        If you start &app; from the command line, it'll give you clues about
1219
419
        any problems it has with your new theme. If it has none, you'll
1220
420
        find your new theme listed the
1221
421
        <interface>Preferences Dialog</interface>.
1222
422
      </para>
1223
423
1224
424
      <para>Have fun!</para>
1225
425
1226
426
    </sect2>
1227
427
1228
428
1229
429
  </sect1>
1230
430
1231
431
1232
432
  <!-- ===== Bugs ============================================== -->
1233
433
1234
434
1235
435
  <sect1 id="bugs">
1236
436
1237
437
    <title>Known Bugs and Limitations</title>
1238
438
1239
439
    <para>
1240
440
      Occasionally a marble-dropping animation doesn't look as smooth
1241
441
      as it should.
1242
442
    </para>
1243
443
1244
444
  </sect1>
1245
445
1246
446
1247
447
  <!-- ===== Authors =========================================== -->
1248
448
1249
449
1250
450
  <sect1 id="authors">
1251
451
1252
452
    <title>Authors</title>
1253
453
1254
454
    <para>
1255
455
      &app; was written by Timothy Musson (<email>trmusson@ihug.co.nz</email>)
1256
456
      and David Neary (<email>bolsh@gimp.org</email>). Various others
1257
457
      have taken the time to help in many ways since work on &app; began.
1258
458
    </para>
1259
459
    <para>
1260
460
      The <ulink type="http"
1261
461
        url="http://www.ce.unipr.it/~gbe/velena.html">Velena Engine</ulink>,
1262
462
      &app;'s main computer player, was written by Giuliano Bertoletti.
1263
463
      We're grateful to him for allowing us to include his work, without
1264
464
      which &app; wouldn't be nearly as worthwhile.
1265
465
    </para>
1266
466
    <para>
1267
467
      This manual was written by Timothy Musson.
1268
468
    </para>
1269
469
    <para>
1270
470
   To report a bug or make a suggestion regarding this application or
1271
471
   this manual, follow the directions in this 
1272
472
   <ulink url="ghelp:user-guide?feedback-bugs" type="help">document</ulink>.
1273
473
    </para>
1274
474
1275
475
1276
476
<!-- For translations: uncomment this:
1277
477
1278
478
  <para>
1279
479
    Latin translation was done by ME
1280
480
    (<email>MYNAME@MYADDRESS</email>). Please send all comments and
1281
481
    suggestions regarding this translation to SOMEWHERE.
1282
482
  </para>
1283
483
1284
484
-->
1285
485
1286
486
  </sect1>
1287
487
1288
488
1289
489
  <!-- ============= License =================================== -->
1290
490
1291
491
1292
492
  <sect1 id="license">
1293
493
1294
494
    <title>License</title>
1295
495
1296
496
    <para>
1297
497
      This program is free software; you can redistribute it and/or
1298
498
      modify it under the terms of the <citetitle>GNU General Public
1299
499
      License</citetitle> as published by the Free Software Foundation;
1300
500
      either version 2 of the License, or (at your option) any later
1301
501
      version.
1302
502
    </para>
1303
503
1304
504
    <para>
1305
505
      This program is distributed in the hope that it will be useful, but
1306
506
      WITHOUT ANY WARRANTY; without even the implied warranty of
1307
507
      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
1308
508
      <citetitle>GNU General Public License</citetitle> for more details.
1309
509
    </para>
1310
510
1311
511
    <para>
1312
512
      A copy of the <citetitle>GNU General Public License</citetitle> is
1313
513
      included as an appendix to the <citetitle>GNOME Users
1314
514
      Guide</citetitle>.  You may also obtain a copy of the
1315
515
      <citetitle>GNU General Public License</citetitle> from the Free
1316
516
      Software Foundation by visiting
1317
517
      <ulink url="http://www.fsf.org" type="http">their Web site</ulink> or
1318
518
      by writing to
1319
519
      <address>
1320
520
        Free Software Foundation, Inc.
1321
521
        <street>59 Temple Place</street> - Suite 330
1322
522
        <city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode>
1323
523
        <country>USA</country>
1324
524
      </address>
1325
525
    </para>
1326
526
1327
527
  </sect1>
1328
528
1329
529
</article>
1330
0
530
1331
=== added file '.pc/90_fix-help-links.patch/gnect/help/C/index.docbook'
1332
=== added file '.pc/90_fix-help-links.patch/gnect/help/Makefile.am'
1333
--- .pc/90_fix-help-links.patch/gnect/help/Makefile.am	1970-01-01 00:00:00 +0000
1334
+++ .pc/90_fix-help-links.patch/gnect/help/Makefile.am	2012-12-26 19:18:24 +0000
1335
@@ -0,0 +1,16 @@
1336
1
@YELP_HELP_RULES@
1337
2
HELP_ID = gnect
1338
3
1339
4
HELP_MEDIA = \
1340
5
	figures/mainwindow.png \
1341
6
	figures/tileset.png \
1342
7
	figures/connect.png \
1343
8
	figures/tables.png 
1344
9
1345
10
HELP_FILES = \
1346
11
	gnect.xml \
1347
12
	legal.xml
1348
13
1349
14
HELP_LINGUAS = ca cs da de el en_GB es eu fi fr it oc sl sr sr@latin sv zh_CN
1350
15
1351
16
-include $(top_srcdir)/git.mk
1352
0
17
1353
=== added directory '.pc/90_fix-help-links.patch/gnibbles'
1354
=== added directory '.pc/90_fix-help-links.patch/gnibbles/help'
1355
=== added directory '.pc/90_fix-help-links.patch/gnibbles/help/C'
1356
=== added file '.pc/90_fix-help-links.patch/gnibbles/help/C/gnibbles.xml'
1357
--- .pc/90_fix-help-links.patch/gnibbles/help/C/gnibbles.xml	1970-01-01 00:00:00 +0000
1358
+++ .pc/90_fix-help-links.patch/gnibbles/help/C/gnibbles.xml	2012-12-26 19:18:24 +0000
1359
@@ -0,0 +1,592 @@
1360
1
<?xml version="1.0"?>
1361
2
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
1362
3
    "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
1363
4
  <!ENTITY legal SYSTEM "legal.xml">
1364
5
  <!ENTITY appversion "2.20">
1365
6
  <!ENTITY manrevision "2.20">
1366
7
  <!ENTITY date "May 2007">
1367
8
  <!ENTITY app "<application>Nibbles</application>">
1368
9
  <!ENTITY appname "Nibbles">
1369
10
  <!ENTITY VERSION "2.20">
1370
11
]>
1371
12
1372
13
<!-- 
1373
14
      (Do not remove this comment block.)
1374
15
  Maintained by the GNOME Documentation Project
1375
16
  http://developer.gnome.org/projects/gdp
1376
17
  Template version: 2.0 beta
1377
18
  Template last modified Feb 12, 2002
1378
19
-->
1379
20
1380
21
<!-- =============Document Header ============================= -->
1381
22
1382
23
<article id="index" lang="en">
1383
24
<!-- please do not change the id; for translations, change lang to -->
1384
25
<!-- appropriate code -->
1385
26
 <articleinfo>
1386
27
  <title>&app; Manual</title>
1387
28
1388
29
    <abstract role="description">
1389
30
      <para>
1390
31
	Nibbles is a worm game for GNOME. The player controls a 2D 
1391
32
	worm while trying to get food. Getting food gives points, 
1392
33
	but hitting anything causes a loss of points. When all points 
1393
34
	are lost, the player loses.
1394
35
      </para>
1395
36
    </abstract>
1396
37
1397
38
  <copyright>
1398
39
   <year>2000</year>
1399
40
   <holder>Kevin Breit</holder>
1400
41
  </copyright>
1401
42
1402
43
  <!-- translators: uncomment this:
1403
44
1404
45
  <copyright>
1405
46
   <year>2000</year>
1406
47
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
1407
48
  </copyright>
1408
49
1409
50
   -->
1410
51
1411
52
<!-- An address can be added to the publisher information.  If a role is 
1412
53
     not specified, the publisher/author is the same for all versions of the 
1413
54
     document.  -->
1414
55
    <publisher> 
1415
56
      <publishername> GNOME Documentation Project </publishername> 
1416
57
    </publisher> 
1417
58
1418
59
   &legal;
1419
60
   <!-- This file  contains link to license for the documentation (GNU FDL), and 
1420
61
        other legal stuff such as "NO WARRANTY" statement. Please do not change 
1421
62
	any of this. -->
1422
63
1423
64
    <authorgroup> 
1424
65
      <author role="maintainer"> 
1425
66
	<firstname>Kevin</firstname> 
1426
67
	<surname>Breit</surname> 
1427
68
	<affiliation> 
1428
69
	  <orgname>GNOME Documentation Project</orgname> 
1429
70
	  <address> <email>battery841@mypad.com</email> </address> 
1430
71
	</affiliation> 
1431
72
      </author> 
1432
73
<!-- This is appropriate place for other contributors: translators,
1433
74
      maintainers,  etc. Commented out by default.
1434
75
       <othercredit role="translator">
1435
76
	<firstname>Latin</firstname> 
1436
77
	<surname>Translator 1</surname> 
1437
78
	<affiliation> 
1438
79
	  <orgname>Latin Translation Team</orgname> 
1439
80
	  <address> <email>translator@gnome.org</email> </address> 
1440
81
	</affiliation>
1441
82
	<contrib>Latin translation</contrib>
1442
83
      </othercredit>
1443
84
-->
1444
85
    </authorgroup>
1445
86
	
1446
87
	<releaseinfo revision="2.26" role="review"/>
1447
88
    
1448
89
    <revhistory>
1449
90
      <revision> 
1450
91
	<revnumber>&appname; Manual V&manrevision;</revnumber> 
1451
92
	<date>&date;</date> 
1452
93
	<revdescription> 
1453
94
	  <para role="author">Kevin Breit
1454
95
	    <email>battery841@mypad.com</email>
1455
96
	  </para>
1456
97
	  <para role="publisher">GNOME Documentation Project</para>
1457
98
	</revdescription> 
1458
99
      </revision> 
1459
100
    </revhistory> 
1460
101
1461
102
    <releaseinfo>This manual describes version &appversion; of &appname;.
1462
103
    </releaseinfo>
1463
104
    <!-- The following feedback information only applies to appliactions
1464
105
    listed in bugzilla.gnome.org and bugzilla.ximian.com. For other
1465
106
    applications, please provide your own feedback info or remove thsi
1466
107
    section altogether -->
1467
108
    <legalnotice> 
1468
109
      <title>Feedback</title> 
1469
110
      <para>To report a bug or make a suggestion regarding the &app; application or
1470
111
	this manual, follow the directions in the 
1471
112
	<ulink url="ghelp:user-guide?feedback-bugs"
1472
113
	  type="help">GNOME Feedback Page</ulink>. 
1473
114
      </para>
1474
115
<!-- Translators may also add here feedback address for translations -->
1475
116
    </legalnotice>
1476
117
 </articleinfo>
1477
118
1478
119
  <indexterm zone="index"> 
1479
120
    <primary>Nibbles</primary> 
1480
121
  </indexterm> 
1481
122
1482
123
 <!-- ============= Document Body ============================= -->
1483
124
1484
125
 <!-- ============= Introduction ============================== -->
1485
126
 <sect1 id="intro">
1486
127
  <title>Introduction</title>
1487
128
1488
129
  <para>
1489
130
   <application>Nibbles</application> is a game where the user controls a worm.  The worm moves around the board, eating diamonds while avoiding the walls   placed around it. 
1490
131
  </para>
1491
132
1492
133
  <para>
1493
134
   To run <application>Nibbles</application>, select
1494
135
   <menuchoice>
1495
136
    <guisubmenu>Games</guisubmenu>
1496
137
    <guimenuitem>Nibbles</guimenuitem>
1497
138
   </menuchoice>
1498
139
   from the <guimenu>Applications</guimenu> menu, or type
1499
140
   <command>gnibbles</command> on the command line. 
1500
141
  </para>
1501
142
1502
143
  <para>
1503
144
   <application>Nibbles</application> is included in the
1504
145
   <filename>gnome-games</filename> package, which is part of the
1505
146
   GNOME desktop environment. This document describes version
1506
147
   &VERSION; of <application>Nibbles</application>.
1507
148
  </para>
1508
149
 </sect1>
1509
150
1510
151
 <sect1 id="objective">
1511
152
 <title>Nibbles Objective</title>
1512
153
  <para>
1513
154
    The objective of Nibbles is quite simple.  You control the worm and
1514
155
    if the worm runs into a wall or runs into itself, you die.  You get ten
1515
156
    lives before your game is over.  You win by either beating your own high
1516
157
    score (or a friend's) or by completing all the levels. It is also 
1517
158
    possible to play against worms with artificial intelligence.
1518
159
  </para>
1519
160
  <para>
1520
161
    &appname; also features multiplayer support with up to six competing
1521
162
    human players in hotseat mode.
1522
163
  </para>
1523
164
 </sect1>
1524
165
1525
166
 <!-- ================ Usage ================================ -->
1526
167
 <!-- This section should describe basic usage of the application. -->
1527
168
1528
169
 <sect1 id="usage">
1529
170
  <title>Using Nibbles</title>
1530
171
  <para>
1531
172
   <application>Nibbles</application> is a simple game to play.  The only keys
1532
173
   that are needed are the arrow keys.
1533
174
  </para>
1534
175
1535
176
  <!-- ========= Basic Usage =========================== -->
1536
177
<sect2 id="mainwin">
1537
178
<title>Basic usage</title>
1538
179
<para>
1539
180
Starting <application>Nibbles</application> opens 
1540
181
the <interface>main window</interface> shown below.
1541
182
<figure id="intro-fig">
1542
183
<title>Nibbles Introduction Window</title>
1543
184
<screenshot>
1544
185
 <mediaobject> 
1545
186
    <imageobject>
1546
187
<imagedata fileref="figures/intro.png" format="PNG"/>
1547
188
    </imageobject>
1548
189
    <textobject> 
1549
190
      <phrase>Nibbles Introduction Window.</phrase> 
1550
191
    </textobject> 
1551
192
  </mediaobject>
1552
193
</screenshot>
1553
194
</figure>
1554
195
</para>
1555
196
<para>
1556
197
To start the game, select <menuchoice><guimenu>Game</guimenu>
1557
198
<guimenuitem>New Game</guimenuitem></menuchoice>.
1558
199
</para>
1559
200
<para>
1560
201
When the game starts, the worm will come out of the left side of the
1561
202
screen.  You use the up arrow to make the direction of the worm go up.
1562
203
Use the right arrow to turn the worm right, left arrow to turn the worm
1563
204
left, and down arrow to turn the worm down.
1564
205
<figure id="gameplay">
1565
206
<title>Nibbles During Gameplay</title>
1566
207
<screenshot>
1567
208
  <mediaobject> 
1568
209
    <imageobject>
1569
210
  <imagedata fileref="figures/playing.png" format="PNG"/>
1570
211
    </imageobject>
1571
212
    <textobject> 
1572
213
      <phrase>Nibbles During Gameplay.</phrase> 
1573
214
    </textobject> 
1574
215
  </mediaobject>
1575
216
</screenshot>
1576
217
</figure>
1577
218
</para>
1578
219
</sect2>
1579
220
1580
221
<!-- This section should also describe main elements of graphic user
1581
222
interface, such as menus and buttons, unless this description
1582
223
is too long - in that case, it should be moved to a separate
1583
224
section. For example -->
1584
225
1585
226
1586
227
<!-- ========= Menus =========================== -->
1587
228
<sect2 id="menubar">
1588
229
   <title>Menus</title>
1589
230
   <para>
1590
231
    The menu bar, located at the top of the <interface>Main
1591
232
    Window</interface>, contains the following menus:
1592
233
   </para>
1593
234
1594
235
   <variablelist>
1595
236
    <varlistentry>
1596
237
     <term><guimenu>Game</guimenu></term>
1597
238
     <listitem>
1598
239
      <para>
1599
240
       This menu contains:
1600
241
       <itemizedlist>
1601
242
        <listitem>
1602
243
         <para>
1603
244
          <menuchoice>
1604
245
           <shortcut>
1605
246
            <keysym>Ctrl+N</keysym>
1606
247
           </shortcut>
1607
248
           <guimenuitem>New Game</guimenuitem>
1608
249
          </menuchoice>
1609
250
           This starts a new game of <application>Nibbles</application>.
1610
251
         </para>
1611
252
        </listitem>
1612
253
        <listitem>
1613
254
         <para>
1614
255
          <menuchoice>
1615
256
           <guimenuitem>Scores</guimenuitem>
1616
257
          </menuchoice>
1617
258
           This shows the high scores.
1618
259
         </para>
1619
260
        </listitem>
1620
261
        <listitem>
1621
262
         <para>
1622
263
          <menuchoice>
1623
264
           <guimenuitem>Pause game</guimenuitem>
1624
265
          </menuchoice>
1625
266
           This will pause your game.  Click on the <quote>Pause Game
1626
267
          </quote> menu option to resume game.
1627
268
         </para>
1628
269
        </listitem>
1629
270
        <listitem>
1630
271
         <para>
1631
272
          <menuchoice>
1632
273
           <guimenuitem>End Game</guimenuitem>
1633
274
          </menuchoice>
1634
275
           End the current game and return to the title screen.
1635
276
         </para>
1636
277
        </listitem>
1637
278
        <listitem>
1638
279
         <para>
1639
280
          <menuchoice>
1640
281
           <shortcut>
1641
282
            <keysym>Ctrl-Q</keysym>
1642
283
           </shortcut>
1643
284
           <guimenuitem>Exit</guimenuitem>
1644
285
          </menuchoice>
1645
286
           This quits the application.
1646
287
         </para>
1647
288
        </listitem>
1648
289
       </itemizedlist>
1649
290
      </para>
1650
291
     </listitem>
1651
292
    </varlistentry>
1652
293
1653
294
   <varlistentry>
1654
295
     <term><guimenu>View</guimenu></term>
1655
296
     <listitem>
1656
297
      <para>
1657
298
       This menu contains:
1658
299
       <itemizedlist>
1659
300
        <listitem>
1660
301
         <para>
1661
302
          <menuchoice>
1662
303
           <guimenuitem>Fullscreen</guimenuitem>
1663
304
          </menuchoice>
1664
305
            This toggles your game window to be fullscreen. 
1665
306
         </para>
1666
307
        </listitem>
1667
308
       </itemizedlist>
1668
309
      </para>
1669
310
     </listitem>
1670
311
    </varlistentry>   
1671
312
1672
313
    <varlistentry>
1673
314
     <term><guimenu>Settings</guimenu></term>
1674
315
     <listitem>
1675
316
      <para>
1676
317
       This menu contains:
1677
318
       <itemizedlist>
1678
319
        <listitem>
1679
320
         <para>
1680
321
          <menuchoice>
1681
322
           <guimenuitem>Preferences</guimenuitem>
1682
323
          </menuchoice>
1683
324
            This opens your window to edit <link linkend="prefs">
1684
325
           preferences.</link>
1685
326
         </para>
1686
327
        </listitem>
1687
328
       </itemizedlist>
1688
329
      </para>
1689
330
     </listitem>
1690
331
    </varlistentry>   
1691
332
1692
333
    <varlistentry>
1693
334
     <term><guimenu>Help</guimenu></term>
1694
335
     <listitem>
1695
336
      <para>
1696
337
       This menu contains:
1697
338
       <itemizedlist>
1698
339
        <listitem>
1699
340
          <para>
1700
341
          <menuchoice>
1701
342
           <shortcut>
1702
343
            <keysym>F1</keysym>
1703
344
           </shortcut>
1704
345
           <guimenuitem>Contents</guimenuitem>
1705
346
          </menuchoice>
1706
347
           Display this manual.
1707
348
         </para>
1708
349
         <para>
1709
350
          <guimenuitem>About</guimenuitem>  This opens the
1710
351
          <interface>About</interface> dialog which shows
1711
352
          basic information about
1712
353
          <application>Nibbles</application>, such as
1713
354
          the author's name, the version number of the game.
1714
355
         </para>
1715
356
        </listitem>
1716
357
       </itemizedlist>
1717
358
      </para>
1718
359
     </listitem>
1719
360
    </varlistentry>
1720
361
   </variablelist>
1721
362
  </sect2>
1722
363
  <sect2 id="diamonds">
1723
364
  <title>Diamonds</title>
1724
365
   <para>
1725
366
    <application>Nibbles</application> has numerous different
1726
367
    diamonds to eat.  They are each a different color and serve
1727
368
    a different function. Only the pale purple diamond is guaranteed
1728
369
    to be around long enough for you to eat it (in fact, you have to
1729
370
    eat them to finish the level). The other diamonds are all bonuses,
1730
371
    but they only stick around for a short time. We'll leave it up to
1731
372
    you to discover just what the bonus each colour gives, but they
1732
373
    all affect either the score, the length of the worm, or both. Be careful
1733
374
    when going for these bonus diamonds, don't cut yourself off from
1734
375
    the ordinary diamonds that you need to finish the level.
1735
376
  </para>
1736
377
  </sect2>   
1737
378
 </sect1>
1738
379
1739
380
1740
381
 <!-- ============= Customization ============================= -->
1741
382
 <sect1 id="prefs">
1742
383
  <title>Customization</title>
1743
384
  <para>
1744
385
   To change the application settings, select
1745
386
   <menuchoice>
1746
387
    <guimenu>Settings</guimenu>
1747
388
    <guimenuitem>Preferences</guimenuitem>
1748
389
   </menuchoice>.  This opens the
1749
390
   <interface>Preferences</interface> dialog. All preferences are
1750
391
    automatically saved and applied as you change them.
1751
392
  </para>
1752
393
1753
394
  <figure id="game-prefs">
1754
395
    <title>Game Preferences Tab</title>
1755
396
    <screenshot>
1756
397
       <mediaobject> 
1757
398
    <imageobject>
1758
399
      <imagedata fileref="figures/game.png" format="PNG" srccredit="Kevin Breit"/>
1759
400
          </imageobject>
1760
401
    <textobject> 
1761
402
      <phrase>Game Preferences Tab.</phrase> 
1762
403
    </textobject> 
1763
404
  </mediaobject>
1764
405
    </screenshot>
1765
406
  </figure>
1766
407
1767
408
  <para>
1768
409
   The properties in the <guilabel>Game</guilabel> tab are:
1769
410
   <variablelist>
1770
411
    <varlistentry>
1771
412
    <term>Speed</term>
1772
413
    <listitem>
1773
414
     <para>
1774
415
      This controls the speed of the worm.
1775
416
     </para>
1776
417
    </listitem>
1777
418
    </varlistentry>
1778
419
    <varlistentry>
1779
420
     <term>Play levels in random order</term>
1780
421
    <listitem>
1781
422
     <para>
1782
423
      Selecting this causes the level
1783
424
      advancement to happen in random order.
1784
425
     </para>
1785
426
    </listitem>
1786
427
    </varlistentry>
1787
428
    <varlistentry>
1788
429
     <term>Enable fake bonuses</term>
1789
430
    <listitem>
1790
431
     <para>
1791
432
      When enabled, this allows for two blue diamonds on
1792
433
      the screen at a time.  One diamond makes you shrink instead of grow when
1793
434
      eaten.
1794
435
     </para>
1795
436
    </listitem>
1796
437
    </varlistentry>
1797
438
    <varlistentry>
1798
439
    <term>Enable sounds</term>
1799
440
     <listitem>
1800
441
      <para>
1801
442
       Controls the use of sound in the game. 
1802
443
      </para>
1803
444
     </listitem>
1804
445
    </varlistentry>
1805
446
    <varlistentry>
1806
447
    <term>Starting level</term>
1807
448
     <listitem>
1808
449
      <para>
1809
450
       Which level to start with. Use this if you want to jump
1810
451
       immediately to a challenging level.
1811
452
      </para>
1812
453
     </listitem>
1813
454
    </varlistentry>
1814
455
    <varlistentry>
1815
456
    <term>Number of human players</term>
1816
457
     <listitem>
1817
458
      <para>
1818
459
       There is room for up to six players.
1819
460
      </para>
1820
461
     </listitem>
1821
462
    </varlistentry>
1822
463
    <varlistentry>
1823
464
    <term>Number of AI players</term>
1824
465
     <listitem>
1825
466
      <para>
1826
467
       There is room for up to six AI players. Note that the total
1827
468
       number of human and AI players must be less than or equal to six.
1828
469
      </para>
1829
470
     </listitem>
1830
471
    </varlistentry>
1831
472
   </variablelist>
1832
473
  </para>
1833
474
  <para>
1834
475
1835
476
  <figure id="worm-prefs">
1836
477
    <title>Worm Preferences Tab</title>
1837
478
    <screenshot>
1838
479
       <mediaobject> 
1839
480
    <imageobject>
1840
481
  <imagedata fileref="figures/worm_op.png" format="PNG" srccredit="Kevin Breit"/>
1841
482
         </imageobject>
1842
483
    <textobject> 
1843
484
      <phrase>Worm Preferences Tab.</phrase> 
1844
485
    </textobject> 
1845
486
  </mediaobject>
1846
487
    </screenshot>
1847
488
  </figure>
1848
489
1849
490
   The properties in the <guilabel>Worm 1 </guilabel>through <guilabel> Worm 
1850
491
6</guilabel> tabs let you set individual preferences for the different worms. 
1851
492
1852
493
   <variablelist>
1853
494
    <varlistentry>
1854
495
    <term>Keyboard controls</term>
1855
496
    <listitem>
1856
497
     <para>
1857
498
      This list let you change the keyboard controls for the given
1858
499
      worm. To change a control, double click on the appropriate entry and
1859
500
      then press the key you want to use for that control.
1860
501
     </para>
1861
502
    </listitem>
1862
503
    </varlistentry>
1863
504
    <varlistentry>
1864
505
     <term>Use relative motion</term>
1865
506
    <listitem>
1866
507
     <para>
1867
508
      Rather than left sending your worm toward the left of the screen,
1868
509
      right toward the right and so on, the left and right keys make
1869
510
      the worm perform a left or right turn. For example, if the worm
1870
511
      is moving to the left and you press the left control it turns to
1871
512
      head toward the bottom of the screen.
1872
513
     </para>
1873
514
    </listitem>
1874
515
    </varlistentry>
1875
516
    <varlistentry>
1876
517
     <term>Worm color</term>
1877
518
    <listitem>
1878
519
     <para>
1879
520
      Customize the color of your worm so you can tell it from your
1880
521
      opponent's worm in multi-player mode.
1881
522
     </para>
1882
523
    </listitem>
1883
524
    </varlistentry>
1884
525
   </variablelist>
1885
526
1886
527
  </para>
1887
528
1888
529
 </sect1>
1889
530
1890
531
<!-- ============= Authors ================================ -->
1891
532
1892
533
 <sect1 id="authors">
1893
534
  <title>Authors</title>
1894
535
  <para>
1895
536
   <application>Nibbles</application> was written by Sean MacIsaac 
1896
537
   <email>sjm@acm.org</email> and Ian Peters <email>itp@gnu.org</email>. 
1897
538
   This manual was written by Kevin Breit <email>battery841@mypad.com</email>.
1898
539
   Nibbles was updated with network support by Andreas Røsdal <email>andreasr@gnome.org</email>.
1899
540
   To report a bug or make a suggestion regarding this application or
1900
541
   this manual, follow the directions in this 
1901
542
   <ulink url="ghelp:user-guide?feedback-bugs" type="help">document</ulink>.
1902
543
  </para> 
1903
544
1904
545
  <!-- For translations: uncomment this:
1905
546
1906
547
  <para>
1907
548
   Latin translation was done by ME
1908
549
   (<email>MYNAME@MYADDRESS</email>). Please send all  comments  and
1909
550
   suggestions regarding this translation to SOMEWHERE.
1910
551
  </para>
1911
552
1912
553
  -->
1913
554
1914
555
 </sect1>
1915
556
1916
557
1917
558
 <!-- ============= Application License ============================= -->
1918
559
1919
560
 <sect1 id="license">
1920
561
  <title>License</title>
1921
562
  <para>
1922
563
   This program is free software; you can redistribute it and/or
1923
564
   modify it under the terms of the <ulink type="help" url="gnome-help:gpl">
1924
565
   <citetitle>GNU General Public
1925
566
   License</citetitle></ulink> as published by the Free Software Foundation;
1926
567
   either version 2 of the License, or (at your option) any later
1927
568
   version.
1928
569
  </para>
1929
570
  <para>
1930
571
   This program is distributed in the hope that it will be useful, but
1931
572
   WITHOUT ANY WARRANTY; without even the implied warranty of
1932
573
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
1933
574
   <citetitle>GNU General Public License</citetitle> for more details.
1934
575
  </para>
1935
576
  <para>
1936
577
   A copy of the <citetitle>GNU General Public License</citetitle> is
1937
578
   included as an appendix to the <citetitle>GNOME Users
1938
579
   Guide</citetitle>.  You may also obtain a copy of the
1939
580
   <citetitle>GNU General Public License</citetitle> from the Free
1940
581
   Software Foundation by visiting <ulink type="http"
1941
582
   url="http://www.fsf.org">their Web site</ulink> or by writing to
1942
583
   <address>
1943
584
    Free Software Foundation, Inc.
1944
585
    59 Temple Place - Suite 330
1945
586
    Boston, MA 02111-1307
1946
587
    USA
1947
588
   </address>
1948
589
  </para>
1949
590
 </sect1>
1950
591
</article>
1951
592
1952
0
593
1953
=== added file '.pc/90_fix-help-links.patch/gnibbles/help/C/index.docbook'
1954
=== added file '.pc/90_fix-help-links.patch/gnibbles/help/Makefile.am'
1955
--- .pc/90_fix-help-links.patch/gnibbles/help/Makefile.am	1970-01-01 00:00:00 +0000
1956
+++ .pc/90_fix-help-links.patch/gnibbles/help/Makefile.am	2012-12-26 19:18:24 +0000
1957
@@ -0,0 +1,18 @@
1958
1
@YELP_HELP_RULES@
1959
2
HELP_ID = gnibbles
1960
3
1961
4
HELP_MEDIA = \
1962
5
	figures/game.png \
1963
6
	figures/intro.png \
1964
7
	figures/playing.png \
1965
8
	figures/connect.png \
1966
9
	figures/tables.png \
1967
10
	figures/worm_op.png
1968
11
1969
12
HELP_FILES = \
1970
13
	gnibbles.xml \
1971
14
	legal.xml
1972
15
1973
16
HELP_LINGUAS = ca cs de el en_GB es eu fr it oc sl sr sr@latin sv zh_CN
1974
17
1975
18
-include $(top_srcdir)/git.mk
1976
0
19
1977
=== added directory '.pc/90_fix-help-links.patch/gnobots2'
1978
=== added directory '.pc/90_fix-help-links.patch/gnobots2/help'
1979
=== added directory '.pc/90_fix-help-links.patch/gnobots2/help/C'
1980
=== added file '.pc/90_fix-help-links.patch/gnobots2/help/C/gnobots2.xml'
1981
--- .pc/90_fix-help-links.patch/gnobots2/help/C/gnobots2.xml	1970-01-01 00:00:00 +0000
1982
+++ .pc/90_fix-help-links.patch/gnobots2/help/C/gnobots2.xml	2012-12-26 19:18:24 +0000
1983
@@ -0,0 +1,666 @@
1984
1
<?xml version="1.0"?>
1985
2
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
1986
3
    "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
1987
4
  <!ENTITY legal SYSTEM "legal.xml">
1988
5
  <!ENTITY appversion "2.18">
1989
6
  <!ENTITY manrevision "2.9">
1990
7
  <!ENTITY date "August 2007">
1991
8
  <!ENTITY app "<application>Robots</application>">
1992
9
  <!ENTITY appname "Robots">
1993
10
]>
1994
11
1995
12
<!-- 
1996
13
      (Do not remove this comment block.)
1997
14
  Maintained by the GNOME Documentation Project
1998
15
  http://developer.gnome.org/projects/gdp
1999
16
  Template version: 2.0 beta
2000
17
  Template last modified Feb 12, 2002
2001
18
-->
2002
19
2003
20
<!-- =============Document Header ============================= -->
2004
21
2005
22
<article id="index" lang="en"> 
2006
23
<!-- please do not change the id; for translations, change lang to -->
2007
24
<!-- appropriate code -->
2008
25
  <articleinfo>
2009
26
    <title>&app; Manual</title>
2010
27
2011
28
    <abstract role="description">
2012
29
      <para>
2013
30
	Robots is a graphical version of the original text based 
2014
31
	robots game, which can be found on a number of UNIX systems. 
2015
32
	The player must outwit the robots chasing him/her by getting 
2016
33
	them to run into each other.
2017
34
      </para>
2018
35
    </abstract>
2019
36
2020
37
      <copyright>
2021
38
        <year>2001</year>
2022
39
        <holder>Patanjali Somayaji, Mark Rae</holder>
2023
40
      </copyright>
2024
41
2025
42
    <!-- translators: uncomment this:
2026
43
2027
44
    <copyright>
2028
45
      <year>2000</year>
2029
46
      <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
2030
47
    </copyright>
2031
48
2032
49
    -->
2033
50
2034
51
<!-- An address can be added to the publisher information.  If a role is 
2035
52
     not specified, the publisher/author is the same for all versions of the 
2036
53
     document.  -->
2037
54
    <publisher> 
2038
55
      <publishername> GNOME Documentation Project </publishername> 
2039
56
    </publisher> 
2040
57
2041
58
   &legal;
2042
59
   <!-- This file  contains link to license for the documentation (GNU FDL), and 
2043
60
        other legal stuff such as "NO WARRANTY" statement. Please do not change 
2044
61
	any of this. -->
2045
62
2046
63
    <authorgroup> 
2047
64
      <author role="maintainer"> 
2048
65
	<firstname>Patanjali</firstname> 
2049
66
	<surname>Somayaji</surname> 
2050
67
	<affiliation> 
2051
68
	  <address> <email>patanjali@mindless.com</email> </address> 
2052
69
	</affiliation> 
2053
70
      </author> 
2054
71
      <author> 
2055
72
	<firstname>Mark</firstname> 
2056
73
	<surname>Rae</surname> 
2057
74
	<affiliation> 
2058
75
	  <address> <email>m.rae@inpharmatica.co.uk</email> </address> 
2059
76
	</affiliation> 
2060
77
      </author> 
2061
78
<!-- This is appropriate place for other contributors: translators,
2062
79
      maintainers,  etc. Commented out by default.
2063
80
       <othercredit role="translator">
2064
81
	<firstname>Latin</firstname> 
2065
82
	<surname>Translator 1</surname> 
2066
83
	<affiliation> 
2067
84
	  <orgname>Latin Translation Team</orgname> 
2068
85
	  <address> <email>translator@gnome.org</email> </address> 
2069
86
	</affiliation>
2070
87
	<contrib>Latin translation</contrib>
2071
88
      </othercredit>
2072
89
-->
2073
90
    </authorgroup>
2074
91
	
2075
92
	<releaseinfo revision="2.26" role="review"/>
2076
93
2077
94
    <revhistory>
2078
95
      <revision> 
2079
96
	<revnumber>&appname; Manual V2.8</revnumber> 
2080
97
	<date>September 2004</date> 
2081
98
	<revdescription> 
2082
99
	  <para role="author">Patanjali Somayaji
2083
100
	    <email>patanjali@mindless.com</email>
2084
101
	  </para>
2085
102
	  <para role="author">Mark Rae
2086
103
	    <email>m.rae@inpharmatica.co.uk</email>
2087
104
	  </para>
2088
105
	  <para role="publisher">GNOME Documentation Project</para>
2089
106
	</revdescription> 
2090
107
      </revision> 
2091
108
      <revision> 
2092
109
	<revnumber>&appname; Manual V&manrevision;</revnumber> 
2093
110
	<date>&date;</date> 
2094
111
	<revdescription> 
2095
112
	  <para role="author">Claude Paroz
2096
113
	    <email>claude@2xlibre.net</email>
2097
114
	  </para>
2098
115
	  <para role="publisher">GNOME Documentation Project</para>
2099
116
	</revdescription> 
2100
117
      </revision> 
2101
118
    </revhistory> 
2102
119
2103
120
    <releaseinfo>This manual describes version &appversion; of &appname;.
2104
121
    </releaseinfo>
2105
122
    <!-- The following feedback information only applies to appliactions
2106
123
    listed in bugzilla.gnome.org and bugzilla.ximian.com. For other
2107
124
    applications, please provide your own feedback info or remove thsi
2108
125
    section altogether -->
2109
126
    <legalnotice> 
2110
127
      <title>Feedback</title> 
2111
128
      <para>To report a bug or make a suggestion regarding the &app; application or
2112
129
	this manual, follow the directions in the 
2113
130
	<ulink url="ghelp:user-guide?feedback-bugs"
2114
131
	  type="help">GNOME Feedback Page</ulink>. 
2115
132
      </para>
2116
133
<!-- Translators may also add here feedback address for translations -->
2117
134
    </legalnotice> 
2118
135
2119
136
  </articleinfo>
2120
137
2121
138
  <indexterm zone="index"> 
2122
139
    <primary>GNOME Robots</primary> 
2123
140
  </indexterm>
2124
141
2125
142
   <!-- ============= Document Body ============================= -->
2126
143
2127
144
   <!-- ============= Introduction ============================== -->
2128
145
   <sect1 id="intro">
2129
146
     <title>Introduction</title>
2130
147
2131
148
     <para>
2132
149
       <application>GNOME Robots</application> is a game where you try
2133
150
       and avoid a band of marauding robots which are,
2134
151
       for no adequately explained reason, trying to kill you. It is
2135
152
       based on the text-based robots game which can be found
2136
153
       on a number of UNIX systems.
2137
154
     </para>
2138
155
     <para>
2139
156
       This new version includes two types of robots, movable
2140
157
       junkheaps, multiple game configurations, user definable
2141
158
       keyboard layouts, and sound, as well as all of the features
2142
159
       which were present in the original GNOME Robots game.
2143
160
     </para>
2144
161
2145
162
     <para>
2146
163
       To run <application>GNOME Robots</application>, select
2147
164
       <menuchoice>
2148
165
       <guisubmenu>Games</guisubmenu>
2149
166
       <guimenuitem>Robots</guimenuitem>
2150
167
       </menuchoice>
2151
168
       from the <guimenu>Main Menu</guimenu>, or type
2152
169
       <command>gnobots2</command> on the command line.
2153
170
     </para>
2154
171
2155
172
     <para>
2156
173
       <application>GNOME Robots</application> is included in the
2157
174
       <filename>gnome-games</filename> package, which is part of the
2158
175
       GNOME desktop environment. This document describes version
2159
176
       &appversion; of <application>GNOME Robots</application>.
2160
177
     </para>
2161
178
   </sect1>
2162
179
 
2163
180
   <sect1 id="objective">
2164
181
     <title>GNOME Robots Objective</title>
2165
182
     <para>
2166
183
       The objective of GNOME Robots is quite simple. You are surrounded by a 
2167
184
       number of robots or other hostile adversaries. As you move about 
2168
185
       they will move directly towards you for every move that you make. 
2169
186
       Their goal is to kill you. Your goal is to kill all the robots on the 
2170
187
       board by taking advantage of their vulnerabilities. 
2171
188
     </para>
2172
189
   
2173
190
     <para>
2174
191
       Robots are destroyed when they collide with each other, or when they
2175
192
       collide with the debris of some previous collision. You die if a robot
2176
193
       ends up right next to you.
2177
194
     </para>
2178
195
2179
196
     <para> In some of the game configurations (you can choose from
2180
197
       five different sets of rules), you can push the
2181
198
       junkheaps around to form barricades to protect you. Also, if you
2182
199
       are daring enough, you can Splat! the robots by pushing
2183
200
       junkheaps on top of them for an additional bonus.  </para>
2184
201
     <para>
2185
202
       You can also save yourself by teleporting yourself to a random location. 
2186
203
       Unfortunately, randomly teleporting means that
2187
204
       you might end up being right next to a robot, so they can kill you when
2188
205
       they make their move. Luckily, there are also
2189
206
       safe teleports which will place you out of immediate danger, but
2190
207
       there are only a limited supply of them. You can earn
2191
208
       more free teleports as you go along (how you gain them depends on the 
2192
209
       chosen game), but typically you get one for each robot that is
2193
210
       destroyed while you are 'waiting', up to a maximum of 10. If you don't
2194
211
       want to waste your saved-up safe teleports, you can choose to teleport
2195
212
       randomly if you think it's safe enough. 
2196
213
     </para>
2197
214
   
2198
215
     <para>
2199
216
       If you press the <guibutton>Wait</guibutton> button (see below) you will no longer be able to
2200
217
       move until either all of the robots (which still move towards you) are
2201
218
       gone, or you are killed. Doing this is risky, but may earn you extra 
2202
219
       safe teleports.
2203
220
     </para>
2204
221
   
2205
222
     <para> If you manage to reach the point where more than half of
2206
223
       the screen is occupied by robots, the number of robots will be
2207
224
       reset to the starting amount, allowing you to continue.
2208
225
     </para>
2209
226
  </sect1>
2210
227
2211
228
2212
229
  <!-- ================ Usage ================================ -->
2213
230
  <!-- This section should describe basic usage of the application. -->
2214
231
2215
232
  <sect1 id="usage">
2216
233
    <title>Using GNOME Robots</title>
2217
234
    <para>
2218
235
      <application>GNOME Robots</application> is extremely simple to play. 
2219
236
      You can use either the mouse or the keyboard.
2220
237
       This section describes basic usage of
2221
238
      <application>GNOME Robots</application>.
2222
239
    </para>
2223
240
2224
241
    <!-- ========= Basic Usage =========================== -->
2225
242
    <sect2 id="mainwin">
2226
243
      <title>Basic usage</title>
2227
244
      <para>
2228
245
        Starting <application>GNOME Robots</application> opens the
2229
246
        <interface>Main window</interface>, shown in <xref
2230
247
        linkend="mainwindow-fig"/>. 
2231
248
2232
249
        <!-- ==== Figure ==== -->
2233
250
        <figure id="mainwindow-fig">
2234
251
	  <title>GNOME Robots Main Window</title>
2235
252
	  <screenshot>
2236
253
	  <mediaobject> 
2237
254
 	   <imageobject>
2238
255
 	 <imagedata fileref="figures/gnobots2-main.png" format="PNG" srccredit="Patanjali"/>
2239
256
 	   </imageobject>
2240
257
 	   <textobject> 
2241
258
 	     <phrase>GNOME Robots Main Window.</phrase> 
2242
259
 	   </textobject> 
2243
260
 	 </mediaobject>
2244
261
	  </screenshot>
2245
262
	</figure>
2246
263
      <!-- ==== End of Figure ==== -->
2247
264
      </para> 
2248
265
2249
266
      <para>
2250
267
        To start a new game, choose <guimenuitem>New</guimenuitem> in the 
2251
268
        <guimenu>Game</guimenu> menu or click on the <guibutton>New</guibutton> button
2252
269
        on the toolbar. 
2253
270
      </para>
2254
271
2255
272
      <para>
2256
273
        To move, either click in the direction you want to move (the
2257
274
        cursor will show you which way you will go) or press the
2258
275
        appropriate key on the keyboard (keypad by default). Clicking on the little man
2259
276
        will keep you still. To teleport (safely or unsafely), and to
2260
277
        wait, use the buttons on the toolbar or use the items in the
2261
278
        <guimenu>Move</guimenu> menu.
2262
279
	</para>
2263
280
    </sect2>
2264
281
  </sect1>
2265
282
    
2266
283
2267
284
  
2268
285
  <!-- ========= Menus =========================== --> 
2269
286
  
2270
287
   <sect1 id="menubar">
2271
288
    <title>Menus</title>
2272
289
    <para>
2273
290
      The menu bar, located at the top of the <interface>game   
2274
291
      board</interface>, contains the following menus:
2275
292
    </para>
2276
293
2277
294
2278
295
    <variablelist>
2279
296
      <varlistentry>
2280
297
        <term><guimenu>Game</guimenu></term>
2281
298
        <listitem>
2282
299
        <para>
2283
300
          This menu contains three items:
2284
301
          <itemizedlist>	
2285
302
            <listitem>
2286
303
	    <para>
2287
304
            <menuchoice> 
2288
305
	       <shortcut><keysym>Ctrl-N</keysym></shortcut>
2289
306
               <guimenuitem>New</guimenuitem> 
2290
307
		  </menuchoice> — starts a new game of GNOME Robots.
2291
308
	   
2292
309
            </para>
2293
310
            </listitem>     
2294
311
       
2295
312
	    <listitem>
2296
313
	    <para>
2297
314
              <menuchoice>
2298
315
              <guimenuitem>Scores</guimenuitem>
2299
316
		  </menuchoice> — shows the higher scores.
2300
317
		</para>
2301
318
            </listitem>
2302
319
2303
320
       	    <listitem>
2304
321
            <para>
2305
322
              <menuchoice>
2306
323
              <shortcut><keysym>Ctrl-Q</keysym></shortcut>
2307
324
              <guimenuitem>Quit</guimenuitem>
2308
325
              </menuchoice>
2309
326
            </para>
2310
327
            </listitem>
2311
328
          </itemizedlist>
2312
329
        </para>
2313
330
        </listitem>
2314
331
      </varlistentry>
2315
332
2316
333
      <varlistentry>
2317
334
        <term><guimenu>Move</guimenu></term>
2318
335
        <listitem>
2319
336
        <para>
2320
337
          This menu contains:
2321
338
          <itemizedlist>
2322
339
          <listitem>
2323
340
            <para>
2324
341
              <guimenuitem>Teleport</guimenuitem>—
2325
342
              teleports you in a safe location.
2326
343
            </para>
2327
344
          </listitem>
2328
345
          <listitem>
2329
346
          <para>
2330
347
            <guimenuitem>Random</guimenuitem>— teleports you in
2331
348
            a random location.
2332
349
          </para>
2333
350
          </listitem>
2334
351
          <listitem>
2335
352
          <para>
2336
353
            <guimenuitem>Wait</guimenuitem>— places you in wait mode.
2337
354
          </para>
2338
355
          </listitem>
2339
356
        </itemizedlist>
2340
357
2341
358
        </para>
2342
359
        </listitem>
2343
360
      </varlistentry>
2344
361
2345
362
      <varlistentry>
2346
363
        <term><guimenu>Settings</guimenu></term>
2347
364
	<listitem>
2348
365
	<para>
2349
366
          The <guimenu>Settings</guimenu> menu contains only one item:
2350
367
          <itemizedlist>
2351
368
	    <listitem>
2352
369
	    <para>
2353
370
              <guimenuitem>Preferences</guimenuitem>
2354
371
              which brings up the preferences dialog box.
2355
372
            </para>
2356
373
	    </listitem>
2357
374
	  </itemizedlist>
2358
375
        </para>
2359
376
	</listitem>
2360
377
      </varlistentry>
2361
378
2362
379
      <varlistentry>
2363
380
        <term><guimenu>Help</guimenu></term>
2364
381
        <listitem>
2365
382
        <para>
2366
383
          This menu contains:
2367
384
          <itemizedlist>
2368
385
          <listitem>
2369
386
            <para>
2370
387
              <guimenuitem>Contents</guimenuitem>—
2371
388
              shows this manual.
2372
389
            </para>
2373
390
          </listitem>
2374
391
          <listitem>
2375
392
          <para>
2376
393
            <guimenuitem>About</guimenuitem>— shows
2377
394
              basic information about
2378
395
              <application>GNOME Robots</application>, such as
2379
396
              the author's name and the application version number.
2380
397
          </para>
2381
398
          </listitem>
2382
399
        </itemizedlist>
2383
400
2384
401
        </para>
2385
402
        </listitem>
2386
403
      </varlistentry>
2387
404
    </variablelist>
2388
405
  </sect1>
2389
406
 
2390
407
 <!-- =========Using the Keyboard============== -->
2391
408
 
2392
409
  
2393
410
  <sect1 id="keyboard">
2394
411
    <title>Using the keyboard</title>
2395
412
    <para>
2396
413
    You can use the keyboard to control the little man. By default, the keys from
2397
414
    the keypad are configured for the game. However you can customize the key
2398
415
    mappings in the <guimenuitem>Keyboard</guimenuitem> tab in the
2399
416
    <guimenuitem>Preferences</guimenuitem> dialog. To select a different key
2400
417
    for a command, double-click on the line for that command and then
2401
418
    press the key you want to use.
2402
419
    </para>
2403
420
2404
421
      <sect2 id="default-keys">     
2405
422
      <title>
2406
423
        Default Key Mappings
2407
424
      </title>
2408
425
      <para>
2409
426
        By default, you use the numeric keypad on the
2410
427
        right-hand side of the keyboard (not the separate arrow keys).
2411
428
        <note>
2412
429
        <title>Switch off the NumLock Key</title>
2413
430
          <para>
2414
431
            You may need to switch off the NumLock to make these work.
2415
432
          </para>
2416
433
        </note>
2417
434
        <orderedlist>
2418
435
          <listitem><para>
2419
436
            Up Left: <keycap>Home</keycap>
2420
437
          </para></listitem> 
2421
438
          <listitem><para>
2422
439
            Up: <keycap>Up</keycap>	      
2423
440
          </para></listitem>
2424
441
          <listitem><para>
2425
442
            Up Right: <keycap>Page Up</keycap>	      
2426
443
          </para></listitem>
2427
444
          <listitem><para>
2428
445
            Left: <keycap>Left</keycap>	      
2429
446
          </para></listitem>
2430
447
          <listitem><para>
2431
448
            Stand Still: <keycap>Begin</keycap>	      
2432
449
          </para></listitem>
2433
450
          <listitem><para>
2434
451
            Right: <keycap>Right</keycap>	      
2435
452
          </para></listitem>
2436
453
          <listitem><para>
2437
454
            Down Left: <keycap>End</keycap>	      
2438
455
          </para></listitem>
2439
456
          <listitem><para>
2440
457
            Down: <keycap>Down</keycap>	      
2441
458
          </para></listitem>
2442
459
          <listitem><para>
2443
460
            Down Right: <keycap>Page Down</keycap>	      
2444
461
          </para></listitem>
2445
462
          <listitem><para>
2446
463
            Teleport: <keycap>+</keycap>	      
2447
464
          </para></listitem>
2448
465
          <listitem><para>
2449
466
            Randomly Teleport: <keycap>*</keycap>	      
2450
467
          </para></listitem>
2451
468
          <listitem><para>
2452
469
            Wait: <keycap>Enter</keycap>	      
2453
470
          </para></listitem>
2454
471
        </orderedlist>
2455
472
2456
473
      </para>	  
2457
474
    </sect2>
2458
475
2459
476
      
2460
477
  </sect1>
2461
478
   
2462
479
  <!-- ============= Customization ============================= -->
2463
480
  
2464
481
  <sect1 id="customization">
2465
482
    <title>Customizing GNOME Robots</title>
2466
483
    <para>
2467
484
      You can modify the behaviour and appearance of
2468
485
      the game by selecting <guimenuitem>
2469
486
      Preferences</guimenuitem>
2470
487
      under the <guimenu>Settings</guimenu> menu. This brings up a
2471
488
      dialog with three tabs:
2472
489
      <itemizedlist>
2473
490
        <listitem>
2474
491
        <para>
2475
492
	    <guimenuitem>Game</guimenuitem> — This page allows
2476
493
        you to choose the type of game you want to play.  The
2477
494
        drop-down box at the top of the page allows you to choose from
2478
495
        a number of predefined games. You can't change these options in
2479
496
        the middle of a game, so they will be disabled then. There are
2480
497
        also several options at the bottom of the dialog:
2481
498
	
2482
499
	
2483
500
        <orderedlist>
2484
501
          <listitem><para> The safe moves option will help you to
2485
502
	    avoid being killed due to a mistake.  If you try to make a
2486
503
	    move that would lead to your death when there is a safe
2487
504
	    move available, you will not be allowed to proceed. But be
2488
505
	    warned: if there was no safe move available, other than
2489
506
	    teleporting, the move will be allowed to proceed.
2490
507
	      
2491
508
          </para></listitem>
2492
509
          <listitem><para>
2493
510
	  
2494
511
            There is also a <quote>super safe mode</quote>.  If you select this,
2495
512
            you get beeped when there is no safe move and your only
2496
513
            option is to teleport out.
2497
514
	  
2498
515
          </para></listitem>
2499
516
          <listitem><para>
2500
517
	  
2501
518
            If you select the sound checkbox the game will play
2502
519
            sounds for various events throughout the game.
2503
520
	  
2504
521
          </para></listitem>
2505
522
          <listitem><para>
2506
523
           
2507
524
	    The <quote>Splats</quote> checkbox selects whether you want the sound
2508
525
            played and a small <quote>Splat!</quote> to appear on the screen.
2509
526
	  
2510
527
          </para></listitem>
2511
528
        </orderedlist>
2512
529
	
2513
530
	</para>
2514
531
	</listitem>
2515
532
        <listitem>
2516
533
        <para>
2517
534
	    <guimenuitem>Appearance</guimenuitem> — This page
2518
535
          allows you to select the graphics used throughout the game
2519
536
          from the list in the dropdown-box. You can also select the
2520
537
          background colour from this tab.
2521
538
        </para>
2522
539
        </listitem>
2523
540
2524
541
        <listitem>
2525
542
        
2526
543
        <para>
2527
544
	    <guimenuitem>Keyboard</guimenuitem> —
2528
545
          This screen allows you to define your own keyboard
2529
546
          controls. To select a different key
2530
547
          for a command, double-click on the button for that command and then
2531
548
          press the key you want to use.
2532
549
        </para>
2533
550
        </listitem>
2534
551
      </itemizedlist>
2535
552
    </para>
2536
553
2537
554
    <para>
2538
555
Any changes you make take effect immediately and are automatically saved.
2539
556
</para>
2540
557
2541
558
    <para>
2542
559
      You can design your own graphics for the game if you want. The graphics
2543
560
      files are found in
2544
561
      <filename class="directory">
2545
562
      $PREFIX/share/gnome-games/gnobots2/pixmaps
2546
563
      </filename>, where $PREFIX is the prefix into which GNOME
2547
564
      was installed. This is usually either 
2548
565
      <filename class="directory">/usr</filename>
2549
566
      or 
2550
567
      <filename class="directory">/usr/local</filename>.
2551
568
    </para>
2552
569
    <para>
2553
570
      Each character is 16x16 pixels and there are 14 of them arranged in
2554
571
      a PNG file which is 224x16 pixels in size. You can look at the existing
2555
572
      files to see the order in which they must be arranged to produce the correct
2556
573
      animated sequences.
2557
574
    </para>
2558
575
    <para>
2559
576
      Any graphics files which are placed in the directory are auto-detected,
2560
577
      so you don't need to alter any configuration files.
2561
578
      You can also define your own game configurations by creating extra
2562
579
      <filename>
2563
580
      .cfg
2564
581
      </filename> files which are stored in the 
2565
582
      <filename class="directory">
2566
583
      $PREFIX/share/gnome-games/gnobots2/games
2567
584
      </filename>
2568
585
      directory.
2569
586
    </para>
2570
587
  </sect1> 
2571
588
 
2572
589
  <!-- ============= Various Sections ============================= -->
2573
590
 
2574
591
 
2575
592
  <!-- ============= Bugs ================================== -->
2576
593
  <!-- This section should describe known bugs and limitations of
2577
594
      the program if there are any - please be frank and list all
2578
595
      problems you know of. -->
2579
596
<!--  <sect1 id="bugs">
2580
597
    <title>Known Bugs and Limitations</title>
2581
598
    <para>
2582
599
      This application has no known bugs.
2583
600
    </para>
2584
601
  </sect1>
2585
602
-->
2586
603
2587
604
<!-- ============= Authors ================================ -->
2588
605
2589
606
  <sect1 id="authors">
2590
607
    <title>Authors</title>
2591
608
    <para>
2592
609
      <application>GNOME Robots</application> was written by Mark Rae
2593
610
      (<email>m.rae@inpharmatica.co.uk</email>). 
2594
611
      This manual was written by Patanjali Somayaji
2595
612
      (<email>patanjali@mindless.com</email>), from the original 
2596
613
      HTML documentation by Mark Rae.
2597
614
   To report a bug or make a suggestion regarding this application or
2598
615
   this manual, follow the directions in this 
2599
616
   <ulink url="ghelp:user-guide?feedback-bugs" type="help">document</ulink>.
2600
617
    </para>
2601
618
2602
619
    <!-- For translations: uncomment this:
2603
620
2604
621
    <para>
2605
622
      Latin translation was done by ME
2606
623
      (<email>MYNAME@MYADDRESS</email>). Please send all  comments  and
2607
624
      suggestions regarding this translation to SOMEWHERE.
2608
625
    </para>
2609
626
2610
627
    -->
2611
628
2612
629
  </sect1>
2613
630
2614
631
2615
632
  <!-- ============= Application License ============================= -->
2616
633
2617
634
  <sect1 id="license">
2618
635
    <title>License</title>
2619
636
    <para>
2620
637
      This program is free software; you can redistribute it and/or
2621
638
      modify it under the terms of the  <ulink type="help" url="gnome-help:gpl">
2622
639
      <citetitle>GNU General Public License</citetitle></ulink> as
2623
640
      published by the Free Software Foundation; 
2624
641
      either version 2 of the License, or (at your option) any later
2625
642
      version.
2626
643
    </para>
2627
644
    <para>
2628
645
      This program is distributed in the hope that it will be useful, but
2629
646
      WITHOUT ANY WARRANTY; without even the implied warranty of
2630
647
      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
2631
648
      <citetitle>GNU General Public License</citetitle> for more details.
2632
649
    </para>
2633
650
    <para>
2634
651
      A copy of the <citetitle>GNU General Public License</citetitle> is
2635
652
      included as an appendix to the <citetitle>GNOME Users
2636
653
      Guide</citetitle>.  You may also obtain a copy of the
2637
654
      <citetitle>GNU General Public License</citetitle> from the Free
2638
655
      Software Foundation by visiting <ulink type="http"
2639
656
      url="http://www.fsf.org">their Web site</ulink> or by writing to
2640
657
      <address>
2641
658
        Free Software Foundation, Inc.
2642
659
        <street>51 Franklin Street, Fifth Floor</street>
2643
660
        <city>Boston</city>, <state>MA</state> <postcode>02110-1301</postcode>
2644
661
        <country>USA</country>
2645
662
      </address>
2646
663
    </para>
2647
664
  </sect1>
2648
665
2649
666
</article>
2650
0
667
2651
=== added file '.pc/90_fix-help-links.patch/gnobots2/help/C/index.docbook'
2652
=== added file '.pc/90_fix-help-links.patch/gnobots2/help/Makefile.am'
2653
--- .pc/90_fix-help-links.patch/gnobots2/help/Makefile.am	1970-01-01 00:00:00 +0000
2654
+++ .pc/90_fix-help-links.patch/gnobots2/help/Makefile.am	2012-12-26 19:18:24 +0000
2655
@@ -0,0 +1,13 @@
2656
1
@YELP_HELP_RULES@
2657
2
HELP_ID = gnobots2
2658
3
2659
4
HELP_MEDIA = \
2660
5
	figures/gnobots2-main.png
2661
6
2662
7
HELP_FILES = \
2663
8
	gnobots2.xml \
2664
9
	legal.xml
2665
10
2666
11
HELP_LINGUAS = ca cs da de el en_GB es eu fr it oc sl sr sr@latin sv zh_CN
2667
12
2668
13
-include $(top_srcdir)/git.mk
2669
0
14
2670
=== added directory '.pc/90_fix-help-links.patch/gnotski'
2671
=== added directory '.pc/90_fix-help-links.patch/gnotski/help'
2672
=== added directory '.pc/90_fix-help-links.patch/gnotski/help/C'
2673
=== added file '.pc/90_fix-help-links.patch/gnotski/help/C/gnotski.xml'
2674
--- .pc/90_fix-help-links.patch/gnotski/help/C/gnotski.xml	1970-01-01 00:00:00 +0000
2675
+++ .pc/90_fix-help-links.patch/gnotski/help/C/gnotski.xml	2012-12-26 19:18:24 +0000
2676
@@ -0,0 +1,407 @@
2677
1
<?xml version="1.0"?>
2678
2
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
2679
3
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
2680
4
  <!ENTITY legal SYSTEM "legal.xml">
2681
5
  <!ENTITY appversion "2.12">
2682
6
  <!ENTITY manrevision "2.10">
2683
7
  <!ENTITY date "March 2004">
2684
8
  <!ENTITY app "<application>Klotski</application>">
2685
9
  <!-- Information about the entities
2686
10
       The legal.xml file contains legal information, there is no need to edit the file. 
2687
11
       Use the appversion entity to specify the version of the application.
2688
12
       Use the manrevision entity to specify the revision number of this manual.
2689
13
       Use the date entity to specify the release date of this manual.
2690
14
       Use the app entity to specify the name of the application. -->
2691
15
]>
2692
16
2693
17
<!-- 
2694
18
  Maintained by the GNOME Documentation Project
2695
19
  http://developer.gnome.org/projects/gdp
2696
20
  Template version: 2.0 beta
2697
21
  Template last modified Apr 11, 2002
2698
22
-->
2699
23
<!-- =============Document Header ============================= -->
2700
24
<article id="index" lang="en">
2701
25
<!-- please do not change the id; for translations, change lang to -->
2702
26
<!-- appropriate code -->
2703
27
  <articleinfo> 
2704
28
    <title>&app; Manual</title>
2705
29
2706
30
    <abstract role="description">
2707
31
      <para>
2708
32
	Klotski is a puzzle game of which the objective is to get the 
2709
33
	patterned block to the marker, which is done by moving the blocks 
2710
34
	in its way.
2711
35
      </para>
2712
36
    </abstract>
2713
37
2714
38
    <copyright>
2715
39
      <year>2002</year> 
2716
40
      <holder>Andrew Sobala</holder> 
2717
41
    </copyright>
2718
42
<!-- translators: uncomment this:
2719
43
2720
44
  <copyright>
2721
45
   <year>2002</year>
2722
46
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
2723
47
  </copyright>
2724
48
2725
49
   -->
2726
50
<!-- An address can be added to the publisher information.  If a role is 
2727
51
     not specified, the publisher/author is the same for all versions of the 
2728
52
     document.  -->
2729
53
    <publisher> 
2730
54
      <publishername> GNOME Documentation Project </publishername> 
2731
55
    </publisher> 
2732
56
2733
57
   &legal;
2734
58
   <!-- This file  contains link to license for the documentation (GNU FDL), and 
2735
59
        other legal stuff such as "NO WARRANTY" statement. Please do not change 
2736
60
	any of this. -->
2737
61
2738
62
    <authorgroup> 
2739
63
      <author> 
2740
64
		<firstname>Andrew</firstname> 
2741
65
		<surname>Sobala</surname> 
2742
66
		<affiliation> 
2743
67
	  		<orgname>GNOME Documentation Project</orgname> 
2744
68
	  		<address> <email>andrew@sobala.net</email> </address> 
2745
69
		</affiliation> 
2746
70
      </author> 
2747
71
2748
72
	<othercredit role="author">
2749
73
		<firstname>Lars</firstname>
2750
74
		<surname>Rydlinge</surname>
2751
75
		<affiliation>
2752
76
			<orgname>GNOME Project</orgname>
2753
77
			<address> <email> Lars.Rydlinge@HIG.SE </email> </address>
2754
78
		</affiliation>
2755
79
	</othercredit>
2756
80
2757
81
	<othercredit role="maintainer">
2758
82
		<firstname>Ross</firstname>
2759
83
		<surname>Burton</surname>
2760
84
		<affiliation>
2761
85
			<orgname>GNOME Project</orgname>
2762
86
			<address> <email> ross@burtonini.com </email> </address>
2763
87
		</affiliation>
2764
88
	</othercredit>
2765
89
2766
90
<!-- This is appropriate place for other contributors: translators,
2767
91
     maintainers,  etc.
2768
92
     
2769
93
      <othercredit role="translator">
2770
94
		<firstname>Latin</firstname> 
2771
95
		<surname>Translator 1</surname> 
2772
96
		<affiliation> 
2773
97
	  		<orgname>Latin Translation Team</orgname> 
2774
98
	  		<address> <email>translator@gnome.org</email> </address> 
2775
99
		</affiliation>
2776
100
		<contrib>Latin translation</contrib>
2777
101
      </othercredit>
2778
102
-->
2779
103
    </authorgroup>
2780
104
	
2781
105
	<releaseinfo revision="2.26" role="review"/>
2782
106
2783
107
2784
108
<!-- According to GNU FDL, revision history is mandatory if you are -->
2785
109
<!-- modifying/reusing someone else's document.  If not, you can omit it. -->
2786
110
<!-- Remember to remove the &manrevision; entity from the revision entries other
2787
111
-->
2788
112
<!-- than the current revision. -->
2789
113
<!-- The revision numbering system for GNOME manuals is as follows: -->
2790
114
<!-- * the revision number consists of two components -->
2791
115
<!-- * the first component of the revision number reflects the release version of the GNOME desktop. -->
2792
116
<!-- * the second component of the revision number is a decimal unit that is incremented with each revision of the manual. -->
2793
117
<!-- For example, if the GNOME desktop release is V2.x, the first version of the manual that -->
2794
118
<!-- is written in that desktop timeframe is V2.0, the second version of the manual is V2.1, etc. -->
2795
119
<!-- When the desktop release version changes to V3.x, the revision number of the manual changes -->
2796
120
<!-- to V3.0, and so on. -->  
2797
121
    <revhistory>
2798
122
<!--
2799
123
      <revision> 
2800
124
		<revnumber>Full title of previous manual.</revnumber> 
2801
125
		<date>Release date of previous manual.</date> 
2802
126
		<revdescription> 
2803
127
	  		<para role="author">Documentation Writer 1 
2804
128
	    	<email>docwriter1@gnome.org</email>
2805
129
	  		</para>
2806
130
	  		<para role="publisher">GNOME Documentation Project</para>
2807
131
		</revdescription> 
2808
132
      </revision> 
2809
133
-->
2810
134
2811
135
	<revision>
2812
136
		<revnumber>V2.0</revnumber>
2813
137
		<date>13 August 2002</date>
2814
138
		<revdescription>
2815
139
	  		<para role="author">Andrew Sobala
2816
140
			<email>andrew@sobala.net</email>
2817
141
	  		</para>
2818
142
	  		<para role="publisher">GNOME Documentation Project</para>
2819
143
		</revdescription> 
2820
144
	</revision>
2821
145
2822
146
    </revhistory> 
2823
147
2824
148
    <releaseinfo>This manual describes version &appversion; of GNOME Klotski.
2825
149
    </releaseinfo> 
2826
150
    <legalnotice> 
2827
151
      <title>Feedback</title> 
2828
152
      <para>To report a bug or make a suggestion regarding the &app; application or
2829
153
      this manual, follow the directions in the <ulink url="ghelp:user-guide?feedback-bugs"
2830
154
	  type="help">GNOME Feedback Page</ulink>. 
2831
155
      </para>
2832
156
<!-- Translators may also add here feedback address for translations -->
2833
157
    </legalnotice> 
2834
158
  </articleinfo> 
2835
159
2836
160
  <indexterm zone="index"> 
2837
161
    <primary>GNOME Klotski</primary> 
2838
162
  </indexterm> 
2839
163
2840
164
<!-- ============= Document Body ============================= -->
2841
165
<!-- ============= Introduction ============================== -->
2842
166
  <sect1 id="gnotski-introduction"> 
2843
167
	<title>Introduction</title> 
2844
168
	<para>The &app; application is a clone of the Klotski game. The objective is to move the patterned block to 
2845
169
	the area bordered by green markers.</para>
2846
170
2847
171
	<para> &app; was written by Lars Rydlinge
2848
172
	(<email>Lars.Rydlinge@HIG.SE</email>).</para>
2849
173
2850
174
	<para>&app; is included in the gnome-games package, which is part of the GNOME desktop environment. 
2851
175
	This document describes version &appversion; of &app;. </para>
2852
176
2853
177
	<para> This program is distributed under the terms of the GNU
2854
178
	General Public license as published by the Free Software
2855
179
	Foundation; either version 2 of the License, or (at your option)
2856
180
	any later version. A copy of this license can be found at this
2857
181
	<ulink url="ghelp:gpl" type="help">link</ulink>, or in the file
2858
182
	COPYING included with the source code of this program. </para>
2859
183
2860
184
	<para>
2861
185
	To report a bug or make a suggestion regarding this application or
2862
186
	this manual, follow the directions in this 
2863
187
	<ulink url="ghelp:user-guide?feedback-bugs" type="help">document</ulink>.
2864
188
	</para>
2865
189
  </sect1>
2866
190
2867
191
<!-- ===========Objective ============================== -->
2868
192
<sect1 id="gnotski-objective">
2869
193
	<title>Objective</title>
2870
194
	<para>The objective of &app; is to move the patterned block to the green markers in as few moves as 
2871
195
	possible. You do this by moving the blocks one at a time with the mouse until you can get the patterned
2872
196
	block to the markers.
2873
197
2874
198
	<!-- ==== Figure ==== -->
2875
199
	<figure id="gnotski-figure-win"> 
2876
200
		<title>The winning move</title> 
2877
201
		<screenshot> 
2878
202
			<mediaobject> 
2879
203
			<imageobject>
2880
204
				<imagedata fileref="figures/gnotski_win.png" format="PNG"/> 
2881
205
			</imageobject>
2882
206
			<textobject> 
2883
207
				<phrase>The patterned block should be moved to the space bordered by the green
2884
208
				markers.</phrase> 
2885
209
			</textobject> 
2886
210
	        	</mediaobject> 
2887
211
		</screenshot>
2888
212
	</figure></para>
2889
213
	<!-- ==== End of Figure ==== -->
2890
214
</sect1>
2891
215
2892
216
<!-- =========== Getting Started ============================== -->
2893
217
2894
218
  <sect1 id="gnotski-playing"> 
2895
219
	<title>Playing &app;</title> 
2896
220
	<para>
2897
221
	<itemizedlist> 
2898
222
	<listitem> 
2899
223
		<para> 
2900
224
		<xref linkend="gnotski-start"/></para> 
2901
225
	</listitem>
2902
226
	<listitem> 
2903
227
		<para> 
2904
228
		<xref linkend="gnotski-ui"/></para> 
2905
229
	</listitem> 
2906
230
	<listitem> 
2907
231
		<para> 
2908
232
		<xref linkend="gnotski-new-game"/></para> 
2909
233
	</listitem> 
2910
234
	<listitem> 
2911
235
		<para> 
2912
236
		<xref linkend="gnotski-moving"/></para> 
2913
237
	</listitem>
2914
238
	</itemizedlist> </para>
2915
239
2916
240
	<!-- =========== To start gnotski ============================== -->
2917
241
	<sect2 id="gnotski-start">
2918
242
		<title>To Start &app;</title>
2919
243
		<para>You can start &app; from the Applications menu by choosing
2920
244
		<menuchoice>
2921
245
			<guisubmenu>Games</guisubmenu>
2922
246
		    	<guimenuitem>Gnotski</guimenuitem>
2923
247
		</menuchoice>.</para>
2924
248
	</sect2>
2925
249
2926
250
	<!-- =========== The main window ============================== -->
2927
251
	<sect2 id="gnotski-ui">
2928
252
		<title>The main window</title>
2929
253
		<para>When you start <application>&app;</application>, the following window is displayed.</para>
2930
254
2931
255
		<!-- ==== Figure ==== -->
2932
256
		<figure id="gnotski-figure-mainwindow"> 
2933
257
			<title>&app; Start Up Window</title> 
2934
258
			<screenshot> 
2935
259
				<mediaobject> 
2936
260
				<imageobject>
2937
261
					<imagedata fileref="figures/gnotski_start_window.png" format="PNG"/> 
2938
262
				</imageobject>
2939
263
				<textobject> 
2940
264
					<phrase>Shows &app; main window. Contains titlebar, menubar, game area
2941
265
					and statusbar. Menubar contains Game and Help menus. </phrase> 
2942
266
				</textobject> 
2943
267
		        	</mediaobject> 
2944
268
			</screenshot>
2945
269
		</figure>
2946
270
		<!-- ==== End of Figure ==== -->
2947
271
2948
272
		<para>The &app; window contains the following elements:
2949
273
		<variablelist>
2950
274
		<varlistentry>
2951
275
			<term>Menubar</term>
2952
276
			<listitem>
2953
277
			<variablelist>
2954
278
			<varlistentry>
2955
279
				<term>Game menu</term>
2956
280
				<listitem>
2957
281
				<para>The game menu allows you to start new games, view the highest scores and
2958
282
				quit the program.</para>
2959
283
				</listitem>
2960
284
			</varlistentry>
2961
285
			<varlistentry>
2962
286
				<term>Help menu</term>
2963
287
				<listitem>
2964
288
				<para>The help menu allows you to view the documentation for &app;</para>
2965
289
				</listitem>
2966
290
			</varlistentry>
2967
291
			</variablelist>
2968
292
			</listitem>
2969
293
		</varlistentry>
2970
294
		<varlistentry>
2971
295
			<term>Game area</term>
2972
296
			<listitem>
2973
297
			<para>The game area shows the blocks in the current game. You can drag the blocks around with 
2974
298
			the mouse as described in <xref linkend="gnotski-moving"/>.
2975
299
			</para>
2976
300
			</listitem>
2977
301
		</varlistentry>
2978
302
		<varlistentry>
2979
303
			<term>Statusbar</term>
2980
304
			<listitem>
2981
305
			<para>The statusbar shows how many moves you have taken so far.</para>
2982
306
			</listitem>
2983
307
		</varlistentry>
2984
308
		</variablelist></para>
2985
309
2986
310
	</sect2>
2987
311
2988
312
	<!-- =========== Starting a new game ============================== -->
2989
313
	<sect2 id="gnotski-new-game">
2990
314
		<title>Starting a new game</title>
2991
315
		<para>Use the <guimenu>Game menu</guimenu> to start a new game. The items 
2992
316
		<guimenuitem>Next Puzzle</guimenuitem> and <guimenuitem>Previous Puzzle</guimenuitem> allows you to
2993
317
		navigate the puzzles sequentially. Each puzzle belongs to one of the three categories found in the 
2994
318
		submenus named <guisubmenu>HuaRong Trail</guisubmenu>, <guisubmenu>Challenge Pack</guisubmenu> and
2995
319
		<guisubmenu>Skill Pack</guisubmenu>.In these submenus, 
2996
320
		each puzzle name refers to a game scenario.
2997
321
		</para>
2998
322
		<example>
2999
323
		<title>Starting a game</title>
3000
324
		<para>To start a game, choose
3001
325
		<menuchoice>
3002
326
			<guimenu>Game</guimenu>
3003
327
			<guisubmenu>[category]</guisubmenu>
3004
328
			<guimenuitem>[game scenario]</guimenuitem>
3005
329
		</menuchoice>
3006
330
		</para></example>
3007
331
	</sect2>
3008
332
3009
333
	<!-- ===========Moving blocks ============================== -->
3010
334
	<sect2 id="gnotski-moving">
3011
335
		<title>Moving blocks</title>
3012
336
		<para>To move a block, click on it, hold down the mouse button and drag it to its new location.
3013
337
		You cannot move the green blocks or the block that borders the game. You cannot move a block to a
3014
338
		space already occupied by another block, with the exception that you may move the patterned block 
3015
339
		through the green blocks to win.
3016
340
		</para>
3017
341
	</sect2>
3018
342
3019
343
</sect1>
3020
344
3021
345
<!-- Known bugs.  Try to manage user expectations and warn them of known bugs
3022
346
but it is better to omit this section than give a false sense of perfection
3023
347
<sect1 id="gnotski-bugs">
3024
348
	<title>Known Bugs and Limitations</title>
3025
349
	<para>
3026
350
        There are no known bugs in this game.
3027
351
	</para>
3028
352
</sect1>
3029
353
-->
3030
354
3031
355
<sect1 id="authors">
3032
356
  <title>Authors</title>
3033
357
  <para>
3034
358
   <application>Klotski</application> was written by Lars Rydlinge
3035
359
   (<email>lars.rydlinge@hig.se</email>). This manual was written by Andrew Sobala.
3036
360
   To report a bug or make a suggestion regarding this application or
3037
361
   this manual, follow the directions in this
3038
362
   <ulink url="ghelp:user-guide?feedback-bugs" type="help">document</ulink>.
3039
363
  </para>
3040
364
3041
365
  <!-- For translations: uncomment this:
3042
366
3043
367
  <para>
3044
368
   Latin translation was done by ME
3045
369
   (<email>MYNAME@MYADDRESS</email>). Please send all  comments  and
3046
370
   suggestions regarding this translation to SOMEWHERE.
3047
371
  </para>
3048
372
3049
373
  -->
3050
374
</sect1>
3051
375
3052
376
 <sect1 id="license">
3053
377
  <title>License</title>
3054
378
  <para>
3055
379
   This program and tile artwork is free software; you can redistribute it and/or
3056
380
   modify it under the terms of the <citetitle>GNU General Public
3057
381
   License</citetitle> as published by the Free Software Foundation;
3058
382
   either version 2 of the License, or (at your option) any later
3059
383
   version.
3060
384
  </para>
3061
385
  <para>
3062
386
   This program is distributed in the hope that it will be useful, but
3063
387
   WITHOUT ANY WARRANTY; without even the implied warranty of
3064
388
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
3065
389
   <citetitle>GNU General Public License</citetitle> for more details.
3066
390
  </para>
3067
391
  <para>
3068
392
   A copy of the <citetitle>GNU General Public License</citetitle> is
3069
393
   included as an appendix to the <citetitle>GNOME Users
3070
394
   Guide</citetitle>.  You may also obtain a copy of the
3071
395
   <citetitle>GNU General Public License</citetitle> from the Free
3072
396
   Software Foundation by visiting <ulink type="http"
3073
397
   url="http://www.fsf.org">their Web site</ulink> or by writing to
3074
398
   <address>
3075
399
    Free Software Foundation, Inc.
3076
400
    <street>59 Temple Place</street> - Suite 330
3077
401
    <city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode>
3078
402
    <country>USA</country>
3079
403
   </address>
3080
404
  </para>
3081
405
 </sect1>
3082
406
3083
407
</article>
3084
0
408
3085
=== added file '.pc/90_fix-help-links.patch/gnotski/help/C/index.docbook'
3086
=== added file '.pc/90_fix-help-links.patch/gnotski/help/Makefile.am'
3087
--- .pc/90_fix-help-links.patch/gnotski/help/Makefile.am	1970-01-01 00:00:00 +0000
3088
+++ .pc/90_fix-help-links.patch/gnotski/help/Makefile.am	2012-12-26 19:18:24 +0000
3089
@@ -0,0 +1,14 @@
3090
1
@YELP_HELP_RULES@
3091
2
HELP_ID = gnotski
3092
3
3093
4
HELP_MEDIA = \
3094
5
	figures/gnotski_start_window.png \
3095
6
	figures/gnotski_win.png
3096
7
3097
8
HELP_FILES = \
3098
9
	gnotski.xml \
3099
10
	legal.xml
3100
11
3101
12
HELP_LINGUAS = ca cs da de el en_GB es eu fr it oc sl sr sr@latin sv zh_CN
3102
13
3103
14
-include $(top_srcdir)/git.mk
3104
0
15
3105
=== added directory '.pc/90_fix-help-links.patch/gtali'
3106
=== added directory '.pc/90_fix-help-links.patch/gtali/help'
3107
=== added directory '.pc/90_fix-help-links.patch/gtali/help/C'
3108
=== added file '.pc/90_fix-help-links.patch/gtali/help/C/gtali.xml'
3109
--- .pc/90_fix-help-links.patch/gtali/help/C/gtali.xml	1970-01-01 00:00:00 +0000
3110
+++ .pc/90_fix-help-links.patch/gtali/help/C/gtali.xml	2012-12-26 19:18:24 +0000
3111
@@ -0,0 +1,492 @@
3112
1
<?xml version="1.0"?>
3113
2
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
3114
3
    "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
3115
4
  <!ENTITY legal SYSTEM "legal.xml">
3116
5
  <!ENTITY appversion "2.12">
3117
6
  <!ENTITY manrevision "2.8">
3118
7
  <!ENTITY date "September 2004">
3119
8
  <!ENTITY app "<application>Tali</application>">
3120
9
  <!ENTITY appname "Tali">
3121
10
  <!ENTITY version "2.8"> 
3122
11
]>
3123
12
3124
13
<!-- 
3125
14
      (Do not remove this comment block.)
3126
15
  Maintained by the GNOME Documentation Project
3127
16
  http://developer.gnome.org/projects/gdp
3128
17
  Template version: 2.0 beta
3129
18
  Template last modified Feb 12, 2002
3130
19
-->
3131
20
3132
21
<!-- =============Document Header ============================= -->
3133
22
3134
23
<article id="index" lang="en">
3135
24
<!-- please do not change the id; for translations, change lang to -->
3136
25
<!-- appropriate code -->
3137
26
  <articleinfo>
3138
27
    <title>&app; Manual</title>
3139
28
    <abstract role="description">
3140
29
      <para>
3141
30
	Tali is like Yahtzee for GNOME or like poker with dice. The player 
3142
31
	rolls dice to try to make the best possible combinations, like 
3143
32
	4 of a kind, small straight, and full house. The player is allowed 
3144
33
	3 rolls per turn and can hold certain dice with each roll.
3145
34
      </para>
3146
35
    </abstract>
3147
36
    <copyright>
3148
37
      <year>2001</year>
3149
38
      <holder>Scott D. Heavner</holder>
3150
39
    </copyright>
3151
40
3152
41
  <!-- translators: uncomment this:
3153
42
3154
43
  <copyright>
3155
44
   <year>2000</year>
3156
45
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
3157
46
  </copyright>
3158
47
3159
48
   -->
3160
49
<!-- An address can be added to the publisher information.  If a role is 
3161
50
     not specified, the publisher/author is the same for all versions of the 
3162
51
     document.  -->
3163
52
    <publisher> 
3164
53
      <publishername> GNOME Documentation Project </publishername> 
3165
54
    </publisher> 
3166
55
3167
56
   &legal;
3168
57
   <!-- This file  contains link to license for the documentation (GNU FDL), and 
3169
58
        other legal stuff such as "NO WARRANTY" statement. Please do not change 
3170
59
	any of this. -->
3171
60
	
3172
61
    <authorgroup> 
3173
62
      <author role="maintainer"> 
3174
63
	<firstname>Scott D</firstname> 
3175
64
	<surname>Heavner</surname> 
3176
65
	<affiliation> 
3177
66
	  <address> <email>sdh@po.cwru.edu</email> </address> 
3178
67
	</affiliation> 
3179
68
      </author> 
3180
69
<!-- This is appropriate place for other contributors: translators,
3181
70
      maintainers,  etc. Commented out by default.
3182
71
       <othercredit role="translator">
3183
72
	<firstname>Latin</firstname> 
3184
73
	<surname>Translator 1</surname> 
3185
74
	<affiliation> 
3186
75
	  <orgname>Latin Translation Team</orgname> 
3187
76
	  <address> <email>translator@gnome.org</email> </address> 
3188
77
	</affiliation>
3189
78
	<contrib>Latin translation</contrib>
3190
79
      </othercredit>
3191
80
-->
3192
81
    </authorgroup>
3193
82
	
3194
83
	<releaseinfo revision="2.26" role="review"/>
3195
84
3196
85
    <revhistory>
3197
86
      <revision> 
3198
87
	<revnumber>&appname; Manual V&manrevision;</revnumber> 
3199
88
	<date>&date;</date> 
3200
89
	<revdescription> 
3201
90
	  <para role="author">Scott D Heavner
3202
91
	    <email>sdh@po.cwru.edu</email>
3203
92
	  </para>
3204
93
	  <para role="publisher">GNOME Documentation Project</para>
3205
94
	</revdescription> 
3206
95
      </revision> 
3207
96
    </revhistory> 
3208
97
3209
98
    <releaseinfo>This manual describes version &appversion; of &appname;.
3210
99
    </releaseinfo>
3211
100
    <!-- The following feedback information only applies to appliactions
3212
101
    listed in bugzilla.gnome.org and bugzilla.ximian.com. For other
3213
102
    applications, please provide your own feedback info or remove thsi
3214
103
    section altogether -->
3215
104
    <legalnotice> 
3216
105
      <title>Feedback</title> 
3217
106
      <para>To report a bug or make a suggestion regarding the &app; application or
3218
107
	this manual, follow the directions in the 
3219
108
	<ulink url="ghelp:user-guide?feedback-bugs"
3220
109
	  type="help">GNOME Feedback Page</ulink>. 
3221
110
      </para>
3222
111
<!-- Translators may also add here feedback address for translations -->
3223
112
    </legalnotice>
3224
113
3225
114
  </articleinfo>
3226
115
3227
116
  <indexterm zone="index"> 
3228
117
    <primary>GNOME Tali</primary> 
3229
118
  </indexterm>
3230
119
3231
120
 <!-- ============= Document Body ============================= -->
3232
121
3233
122
  <sect1 id="intro">
3234
123
    <title>Introduction</title>
3235
124
3236
125
    <para>
3237
126
       <application>GNOME Tali</application> is a sort of poker with
3238
127
       dice and less money.  You roll five dice three times and try to
3239
128
       create the best <quote>hand</quote>. Your two rerolls may include
3240
129
       any or all of your dice.
3241
130
    </para>
3242
131
    <para>
3243
132
      <application>GNOME Tali</application> is very similar to the
3244
133
      dice game Yahtzee which is a trademark of Hasbro, Inc.
3245
134
    </para>
3246
135
3247
136
    <para>
3248
137
      To run <application>GNOME Tali</application>, select
3249
138
      <menuchoice>
3250
139
	<guisubmenu>Games</guisubmenu>
3251
140
	<guimenuitem>GNOME Tali</guimenuitem>
3252
141
      </menuchoice>
3253
142
      from the <guimenu>Main Menu</guimenu>, or type
3254
143
      <command>gtali</command> on the command line.
3255
144
    </para>
3256
145
3257
146
    <para>
3258
147
      <application>GNOME Tali</application> is included in the
3259
148
      <filename>gnome-games</filename> package, which is part of the
3260
149
      GNOME desktop environment. This document describes version
3261
150
      &version; of <application>GNOME Tali</application>.
3262
151
    </para>
3263
152
  </sect1>
3264
153
3265
154
  <sect1 id="playing">
3266
155
    <title>Playing GNOME Tali</title>
3267
156
3268
157
    <figure id="shot1">
3269
158
      <title>GNOME Tali in action</title>
3270
159
      <screenshot>
3271
160
	 <mediaobject> 
3272
161
    <imageobject>
3273
162
  <imagedata fileref="figures/mainwindow.png" format="PNG"
3274
163
	srccredit="Trevor Curtis"/>
3275
164
	</imageobject>
3276
165
    <textobject> 
3277
166
      <phrase>GNOME Tali main window screenshot.</phrase> 
3278
167
    </textobject> 
3279
168
  </mediaobject>
3280
169
      </screenshot>
3281
170
    </figure>
3282
171
3283
172
    <para>
3284
173
      When play starts, you see the results of your first throw of the
3285
174
      dice.      
3286
175
    </para>
3287
176
3288
177
      <orderedlist>
3289
178
        <listitem>
3290
179
          <para>Click on the dice you wish to roll again.
3291
180
	  </para>
3292
181
        </listitem>
3293
182
        <listitem>
3294
183
          <para>When you have selected all the dice you wish to reroll,
3295
184
            press the <guibutton>Roll!</guibutton> button.
3296
185
	  </para>
3297
186
        </listitem>
3298
187
        <listitem>
3299
188
	  <para>When you have a hand you like or have run out of chances
3300
189
          to throw the dice, click on a row corresponding to what you think
3301
190
          is your best scoring combination.  It is very possible to have
3302
191
          a score of zero and if you click on the wrong row, you
3303
192
          will be scored accordingly. (Say for example, you get
3304
193
          yahtzee -- 5 of a kind -- and click on the large straight row,
3305
194
          you will receive a zero in your large straight score).</para>
3306
195
      </listitem>
3307
196
    </orderedlist>
3308
197
3309
198
    <para>You can only use each combination once, i.e. once you've entered
3310
199
      something in a slot, you can't change the score later if you roll a
3311
200
      better hand.
3312
201
    </para>
3313
202
3314
203
    <para>There is one exception to this rule, if you roll a yahtzee a
3315
204
     second time you can put it in the yahtzee row again for an extra
3316
205
     fifty points. You can keep doing this each time you get another
3317
206
     yahtzee. At the end of the game you will be given extra rolls to
3318
207
     fill in the other rows. Be warned that if you score zero in your
3319
208
     yahtzee row (i.e. you filled that row with something that wasn't
3320
209
     a yahtzee) then you can't put a yahtzee in afterward, zero is all
3321
210
     you will score.
3322
211
    </para>
3323
212
3324
213
    <para>There is also a bonus of 35 points if you score a total of
3325
214
    63 points or more in the top six rows.
3326
215
    </para>
3327
216
3328
217
    <sect2 id="keyboard">
3329
218
    <title>Using the keyboard</title> 
3330
219
3331
220
      <para>As an alternative to using the mouse, the keys 1 through 5
3332
221
    toggle the dice just as if you had clicked them. The key 1
3333
222
    corresponds to the first die and so on. Use the usual controls to
3334
223
    roll the dice and select a row. i.e. use tab to switch between the
3335
224
    roll button and the score area, use the arrow keys to navigate up
3336
225
    and down the rows and use space to select.</para>
3337
226
    
3338
227
    </sect2>
3339
228
3340
229
  </sect1>
3341
230
3342
231
  <sect1 id="options">
3343
232
    <title>Game Options</title>
3344
233
3345
234
    <figure id="shot2">
3346
235
      <title>GNOME Tali preferences</title>
3347
236
      <screenshot>
3348
237
	 <mediaobject> 
3349
238
    <imageobject>
3350
239
  <imagedata fileref="figures/preferences.png" format="PNG"
3351
240
	srccredit="Trevor Curtis"/>
3352
241
	</imageobject>
3353
242
    <textobject> 
3354
243
      <phrase>GNOME Tali preferences dialog box.</phrase> 
3355
244
    </textobject> 
3356
245
  </mediaobject>
3357
246
      </screenshot>
3358
247
    </figure>
3359
248
      <variablelist><title>Human Players</title>
3360
249
	<varlistentry>
3361
250
	  <term><guimenuitem>Number of players</guimenuitem></term>
3362
251
	  <listitem>
3363
252
            <para>Selects the number of human players.  As described
3364
253
	      above you are only allowed six total
3365
254
	      players.
3366
255
            </para>
3367
256
          </listitem>
3368
257
	</varlistentry>
3369
258
      </variablelist>  
3370
259
      
3371
260
    <variablelist><title>Computer Opponents</title>
3372
261
      <varlistentry>
3373
262
        <term><guimenuitem>Delay between rolls</guimenuitem></term>
3374
263
	<listitem>
3375
264
	  <para>Make the computer opponents pause between rolls
3376
265
	    of the dice so you can see what they are doing.  Slows down
3377
266
	    game play some.
3378
267
          </para>
3379
268
        </listitem>
3380
269
	</varlistentry>
3381
270
	<varlistentry>
3382
271
	  <term><guimenuitem>Number of opponents</guimenuitem></term>
3383
272
	  <listitem>
3384
273
            <para>Select the number of computer opponents.  You are allowed a
3385
274
	      total of six human and computer players.  If you attempt to
3386
275
	      increase this number near the limit, the number of human players
3387
276
	      will be decreased to maintain only six total
3388
277
	      players.
3389
278
            </para>
3390
279
          </listitem>
3391
280
	</varlistentry>
3392
281
      </variablelist>
3393
282
      
3394
283
    <variablelist><title>Game Type</title>
3395
284
      <varlistentry>
3396
285
        <term><guimenuitem>Version of the game to play</guimenuitem></term>
3397
286
	<listitem>
3398
287
	  <para>Play either the regular version (similar to Yahtzee) or the
3399
288
	    version with colors (similar to Kismet). When you change game type,
3400
289
        you must restart the game to see use the new game type.
3401
290
          </para>
3402
291
        </listitem>
3403
292
	</varlistentry>
3404
293
      </variablelist>
3405
294
      
3406
295
      <variablelist>
3407
296
	<varlistentry>
3408
297
	    <term><guimenuitem>Player Names</guimenuitem></term>
3409
298
	    <listitem>
3410
299
	      <para>To change the names of the players just enter new
3411
300
	      names in the boxes.
3412
301
	      </para>
3413
302
	    </listitem>
3414
303
	</varlistentry>
3415
304
      </variablelist>
3416
305
    </sect1>
3417
306
3418
307
    <sect1 id="strategy">
3419
308
      <title>Game Strategy</title>
3420
309
      <para>The 63 points needed for the bonus in the upper half
3421
310
      corresponds to getting three of each die type in each row. If
3422
311
      you score more than three dice in the fives and sixes rows then
3423
312
      you can afford to place a bad roll in either the ones row or the
3424
313
      twos row and still get the bonus.
3425
314
      In the Colors version, you get a bonus of 55 if your upper half total
3426
315
      is between 71 and 77, and a bonus of 75 if your upper half total is
3427
316
      greater than 77.
3428
317
      </para>
3429
318
      <para>Don't forget about multiple yahtzees, if you roll a second
3430
319
       yahtzee you can also put it in the yahtzee row for even more points.
3431
320
       This only applies to the regular game.
3432
321
      </para>
3433
322
    </sect1>	
3434
323
 <!-- ============= Bugs ================================== -->
3435
324
 <!-- This section should describe known bugs and limitations of
3436
325
      the program if there are any - please be frank and list all
3437
326
      problems you know of. 
3438
327
      
3439
328
      Better to leave this section out than to say something unhelpful. 
3440
329
-->
3441
330
3442
331
 <sect1 id="bugs">
3443
332
  <title>Known Bugs and Limitations</title>
3444
333
  <para>
3445
334
   When you switch game type, the game does not use the new dice images
3446
335
   until you restart gtali. It should play correctly with the "wrong" dice.
3447
336
  </para>
3448
337
 </sect1>
3449
338
3450
339
3451
340
 <sect1 id="glossary">
3452
341
   <title>Glossary</title>
3453
342
   <note>
3454
343
     <para>Remember that the order of the dice is not important.</para>
3455
344
   </note>
3456
345
   <glossary>
3457
346
       <glossentry id="threeofakind"><glossterm>3 of a Kind</glossterm>
3458
347
         <glossdef><para>
3459
348
	   Three of the dice have the same number. The score is the
3460
349
   total of all the dice. e.g. 1, 2, 2, 2, 5.
3461
350
	 </para></glossdef>
3462
351
       </glossentry>
3463
352
       <glossentry id="fourofakind"><glossterm>4 of a Kind</glossterm>
3464
353
         <glossdef><para>
3465
354
	   Four of the dice have the same number. The score is the
3466
355
   total of all the dice. e.g. 2, 5, 5, 5, 5.
3467
356
   In the Colors game, the score is 25 plus the total of all the dice.
3468
357
	 </para></glossdef>
3469
358
       </glossentry>
3470
359
       <glossentry id="yahtzee"><glossterm>5 of a Kind</glossterm>
3471
360
         <glossdef><para>
3472
361
	   Five identical dice. e.g. 3, 3, 3, 3, 3.
3473
362
   In the Colors game, the score is 50 plus the total of all the dice.
3474
363
	 </para></glossdef>
3475
364
       </glossentry>
3476
365
       <glossentry id="fullhouse"><glossterm>Full House</glossterm>
3477
366
         <glossdef><para>
3478
367
	   Five dice consisting of two groups: One group of three with
3479
368
   the same numbers and another group of two with the same
3480
369
   numbers. e.g. 1, 1, 1, 4, 4.
3481
370
   In the Colors game, the score is 15 plus the total of all the dice.
3482
371
	 </para></glossdef>
3483
372
       </glossentry>
3484
373
       <glossentry id="fullhousesamecolor"><glossterm>Full House Same Color</glossterm>
3485
374
         <glossdef><para>
3486
375
       This category is only used in the Colors game.
3487
376
   Five dice consisting of two groups: One group of three with
3488
377
   the same numbers and another group of two with the same
3489
378
   numbers. The numbers must be all the same color. e.g. 3, 3, 3, 4, 4.
3490
379
   Two dice are the same color if their numbers total 7: 1 and 6 are black,
3491
380
   2 and 5 are red, and 3 and 4 are green.
3492
381
   The score is 20 plus the total of all the dice.
3493
382
	 </para></glossdef>
3494
383
       </glossentry>
3495
384
       <glossentry id="twopairsamecolor"><glossterm>Two Pair Same Color</glossterm>
3496
385
         <glossdef><para>
3497
386
       This category is only used in the Colors game.
3498
387
   Five dice consisting of two groups: One group of two with
3499
388
   the same numbers and another group of two with the same
3500
389
   numbers. The pairs must be all the same color. e.g. 3, 3, 4, 4.
3501
390
   Two dice are the same color if their numbers total 7: 1 and 6 are black,
3502
391
   2 and 5 are red, and 3 and 4 are green. The fifth die can be any value.
3503
392
   The score is the total of all the dice.
3504
393
	 </para></glossdef>
3505
394
       </glossentry>
3506
395
       <glossentry id="flush"><glossterm>Flush</glossterm>
3507
396
         <glossdef><para>
3508
397
       This category is only used in the Colors game.
3509
398
   Five dice that are all the same "color":
3510
399
   Two dice are the same color if their numbers total 7: 1 and 6 are black,
3511
400
   2 and 5 are red, and 3 and 4 are green. The fifth die can be any value.
3512
401
   The score is 35 points.
3513
402
	 </para></glossdef>
3514
403
       </glossentry>
3515
404
       <glossentry id="largestraight"><glossterm>Large Straight</glossterm>
3516
405
         <glossdef><para>
3517
406
	   Five dice with consecutive numbers. e.g. 2, 3, 4, 5, 6.
3518
407
   The score is 40 points.
3519
408
	 </para></glossdef>
3520
409
       </glossentry>
3521
410
       <glossentry id="smallstraight"><glossterm>Small Straight</glossterm>
3522
411
         <glossdef><para>
3523
412
	   Four dice with consecutive numbers. The fifth die can be
3524
413
   any number. e.g. 2, 3, 4, 5, 5.
3525
414
   This category is only used in the regular game.
3526
415
   The score is 30 points.
3527
416
	 </para></glossdef>
3528
417
       </glossentry>
3529
418
   </glossary>
3530
419
 </sect1>
3531
420
3532
421
3533
422
<!-- ============= Authors ================================ -->
3534
423
3535
424
 <sect1 id="authors">
3536
425
  <title>Authors</title>
3537
426
  <para>
3538
427
   <application>GNOME Tali</application> was written by Scott Heavner
3539
428
   (<email>sdh@po.cwru.edu</email>) and Orest Zborowski. 
3540
429
   This manual was written by Scott D Heavner
3541
430
   (<email>sdh@po.cwru.edu</email>) with extra material added by
3542
431
   Callum McKenzie (<email>callum@physics.otago.ac.nz</email>).
3543
432
   To report a bug or make a suggestion regarding this application or
3544
433
   this manual, follow the directions in this 
3545
434
   <ulink url="ghelp:user-guide?feedback-bugs" type="help">document</ulink>.
3546
435
  </para>
3547
436
3548
437
3549
438
  <!-- For translations: uncomment this:
3550
439
3551
440
  <para>
3552
441
   Latin translation was done by ME
3553
442
   (<email>MYNAME@MYADDRESS</email>). Please send all  comments  and
3554
443
   suggestions regarding this translation to SOMEWHERE.
3555
444
  </para>
3556
445
3557
446
  -->
3558
447
3559
448
 </sect1>
3560
449
3561
450
 <!-- ============= Application License ============================= -->
3562
451
3563
452
 <sect1 id="license">
3564
453
  <title>License</title>
3565
454
  <para>
3566
455
   This program is free software; you can redistribute it and/or
3567
456
   modify it under the terms of the  <ulink type="help" url="gnome-help:gpl">
3568
457
    <citetitle>GNU General Public License</citetitle></ulink> as
3569
458
   published by the Free Software Foundation; 
3570
459
   either version 2 of the License, or (at your option) any later
3571
460
   version.
3572
461
  </para>
3573
462
  <para>
3574
463
   This program is distributed in the hope that it will be useful, but
3575
464
   WITHOUT ANY WARRANTY; without even the implied warranty of
3576
465
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
3577
466
   <citetitle>GNU General Public License</citetitle> for more details.
3578
467
  </para>
3579
468
  <para>
3580
469
   A copy of the <citetitle>GNU General Public License</citetitle> is
3581
470
   included as an appendix to the <citetitle>GNOME Users
3582
471
   Guide</citetitle>.  You may also obtain a copy of the
3583
472
   <citetitle>GNU General Public License</citetitle> from the Free
3584
473
   Software Foundation by visiting <ulink type="http"
3585
474
   url="http://www.fsf.org">their Web site</ulink> or by writing to
3586
475
   <address>
3587
476
    Free Software Foundation, Inc.
3588
477
    <street>59 Temple Place</street> - Suite 330
3589
478
    <city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode>
3590
479
    <country>USA</country>
3591
480
   </address>
3592
481
  </para>
3593
482
 </sect1>
3594
483
</article>
3595
484
3596
485
3597
486
3598
487
3599
488
3600
489
3601
490
3602
491
3603
492
3604
0
493
3605
=== added file '.pc/90_fix-help-links.patch/gtali/help/C/index.docbook'
3606
=== added file '.pc/90_fix-help-links.patch/gtali/help/Makefile.am'
3607
--- .pc/90_fix-help-links.patch/gtali/help/Makefile.am	1970-01-01 00:00:00 +0000
3608
+++ .pc/90_fix-help-links.patch/gtali/help/Makefile.am	2012-12-26 19:18:24 +0000
3609
@@ -0,0 +1,14 @@
3610
1
@YELP_HELP_RULES@
3611
2
HELP_ID = gtali
3612
3
3613
4
HELP_MEDIA = \
3614
5
	figures/mainwindow.png \
3615
6
	figures/preferences.png
3616
7
3617
8
HELP_FILES = \
3618
9
	gtali.xml \
3619
10
	legal.xml
3620
11
3621
12
HELP_LINGUAS = ca cs da de el en_GB es eu fr gl it oc pt_BR sl sr sr@latin sv zh_CN
3622
13
3623
14
-include $(top_srcdir)/git.mk
3624
0
15
3625
=== modified file '.pc/applied-patches'
3626
--- .pc/applied-patches	2012-04-17 16:31:36 +0000
3627
+++ .pc/applied-patches	2012-12-26 19:18:24 +0000
3628
@@ -1,3 +1,7 @@
3629
1
01_lpi.patch
1
01_lpi.patch
3630
2
02_desktop-path.patch
2
02_desktop-path.patch
3631
3
03_add-keywords.patch
3
03_add-keywords.patch
3632
4
90_fix-help-links.patch
3633
5
en_passant_pawns_only.patch
3634
6
en_passant_remove_victim.patch
3635
7
cant_castle_after_rook_taken.patch
3636
4
8
3637
=== added directory '.pc/cant_castle_after_rook_taken.patch'
3638
=== added directory '.pc/cant_castle_after_rook_taken.patch/glchess'
3639
=== added directory '.pc/cant_castle_after_rook_taken.patch/glchess/src'
3640
=== added file '.pc/cant_castle_after_rook_taken.patch/glchess/src/chess-game.vala'
3641
--- .pc/cant_castle_after_rook_taken.patch/glchess/src/chess-game.vala	1970-01-01 00:00:00 +0000
3642
+++ .pc/cant_castle_after_rook_taken.patch/glchess/src/chess-game.vala	2012-12-26 19:18:24 +0000
3643
@@ -0,0 +1,1428 @@
3644
1
public enum Color
3645
2
{
3646
3
    WHITE,
3647
4
    BLACK
3648
5
}
3649
6
3650
7
public class ChessPlayer : Object
3651
8
{
3652
9
    public Color color;
3653
10
    public signal void start_turn ();
3654
11
    public signal bool do_move (string move, bool apply);
3655
12
    public signal void do_undo ();
3656
13
    public signal bool do_resign ();
3657
14
    public signal bool do_claim_draw ();
3658
15
3659
16
    public ChessPlayer (Color color)
3660
17
    {
3661
18
        this.color = color;
3662
19
    }
3663
20
3664
21
    public bool move (string move, bool apply = true)
3665
22
    {
3666
23
        return do_move (move, apply);
3667
24
    }
3668
25
3669
26
    public bool move_with_coords (int r0, int f0, int r1, int f1, bool apply = true)
3670
27
    {
3671
28
        string move = "%c%d%c%d".printf ('a' + f0, r0 + 1, 'a' + f1, r1 + 1);    
3672
29
        return do_move (move, apply);
3673
30
    }
3674
31
3675
32
    public void undo ()
3676
33
    {
3677
34
        do_undo ();
3678
35
    }
3679
36
3680
37
    public bool resign ()
3681
38
    {
3682
39
        return do_resign ();
3683
40
    }
3684
41
    
3685
42
    public bool claim_draw ()
3686
43
    {
3687
44
        return do_claim_draw ();
3688
45
    }
3689
46
}
3690
47
3691
48
public enum PieceType
3692
49
{
3693
50
    PAWN,
3694
51
    ROOK,
3695
52
    KNIGHT,
3696
53
    BISHOP,
3697
54
    QUEEN,
3698
55
    KING
3699
56
}
3700
57
3701
58
public class ChessPiece
3702
59
{
3703
60
    public ChessPlayer player;
3704
61
    public PieceType type;
3705
62
3706
63
    public signal void moved ();
3707
64
    public signal void promoted ();
3708
65
    public signal void died ();
3709
66
    
3710
67
    public Color color
3711
68
    {
3712
69
        get { return player.color; }
3713
70
    }
3714
71
3715
72
    public unichar symbol
3716
73
    {
3717
74
        get
3718
75
        {
3719
76
            unichar c = ' ';
3720
77
            switch (type)
3721
78
            {
3722
79
            case PieceType.PAWN:
3723
80
                c = 'p';
3724
81
                break;
3725
82
            case PieceType.ROOK:
3726
83
                c = 'r';
3727
84
                break;
3728
85
            case PieceType.KNIGHT:
3729
86
                c = 'k';
3730
87
                break;
3731
88
            case PieceType.BISHOP:
3732
89
                c = 'b';
3733
90
                break;
3734
91
            case PieceType.QUEEN:
3735
92
                c = 'q';
3736
93
                break;
3737
94
            case PieceType.KING:
3738
95
                c = 'k';
3739
96
                break;
3740
97
            }
3741
98
            if (player.color == Color.WHITE)
3742
99
                c = c.toupper ();
3743
100
            return c;
3744
101
        }
3745
102
    }
3746
103
3747
104
    public ChessPiece (ChessPlayer player, PieceType type)
3748
105
    {
3749
106
        this.player = player;
3750
107
        this.type = type;
3751
108
    }
3752
109
}
3753
110
3754
111
public enum CheckState
3755
112
{
3756
113
    NONE,
3757
114
    CHECK,
3758
115
    CHECKMATE
3759
116
}
3760
117
3761
118
public class ChessMove
3762
119
{
3763
120
    public int number;
3764
121
    public ChessPiece piece;
3765
122
    public ChessPiece? promotion_piece;
3766
123
    public ChessPiece? moved_rook;
3767
124
    public ChessPiece? victim;
3768
125
    public int r0;
3769
126
    public int f0;
3770
127
    public int r1;
3771
128
    public int f1;
3772
129
    public bool ambiguous_rank;
3773
130
    public bool ambiguous_file;
3774
131
    public CheckState check_state;
3775
132
3776
133
    public string get_lan ()
3777
134
    {
3778
135
        if (moved_rook != null)
3779
136
        {
3780
137
            if (f1 > f0)
3781
138
                return "O-O";
3782
139
            else
3783
140
                return "O-O-O";
3784
141
        }
3785
142
3786
143
        var builder = new StringBuilder ();
3787
144
        if (victim != null)
3788
145
            builder.append_printf ("%c%dx%c%d", 'a' + f0, r0 + 1, 'a' + f1, r1 + 1);
3789
146
        else
3790
147
            builder.append_printf ("%c%d-%c%d", 'a' + f0, r0 + 1, 'a' + f1, r1 + 1);
3791
148
3792
149
        const char promotion_symbols[] = {' ', 'R', 'N', 'B', 'Q', 'K'};
3793
150
        if (promotion_piece != null)
3794
151
            builder.append_printf ("=%c", promotion_symbols[promotion_piece.type]);
3795
152
3796
153
        switch (check_state)
3797
154
        {
3798
155
        case CheckState.CHECK:
3799
156
            builder.append_c ('+');
3800
157
            break;
3801
158
        case CheckState.CHECKMATE:
3802
159
            builder.append_c ('#');
3803
160
            break;
3804
161
        }
3805
162
3806
163
        return builder.str;
3807
164
    }
3808
165
3809
166
    public string get_san ()
3810
167
    {
3811
168
        const string piece_names[] = {"", "R", "N", "B", "Q", "K"};
3812
169
        return make_san ((string[]) piece_names);
3813
170
    }
3814
171
3815
172
    public string get_fan ()
3816
173
    {
3817
174
        const string white_piece_names[] = {"", "♞", "♝", "♜", "♛", "♚"};
3818
175
        const string black_piece_names[] = {"", "♘", "♗", "♖", "♕", "♔"};
3819
176
        if (piece.color == Color.WHITE)
3820
177
            return make_san ((string[]) white_piece_names);
3821
178
        else
3822
179
            return make_san ((string[]) black_piece_names);
3823
180
    }
3824
181
3825
182
    private string make_san (string[] piece_names)
3826
183
    {
3827
184
        if (moved_rook != null)
3828
185
        {
3829
186
            if (f1 > f0)
3830
187
                return "O-O";
3831
188
            else
3832
189
                return "O-O-O";
3833
190
        }
3834
191
3835
192
        var builder = new StringBuilder ();
3836
193
        builder.append (piece_names[piece.type]);
3837
194
        if (ambiguous_file)
3838
195
            builder.append_printf ("%c", 'a' + f0);
3839
196
        if (ambiguous_rank)
3840
197
            builder.append_printf ("%d", r0 + 1);
3841
198
        if (victim != null)
3842
199
            builder.append ("x");
3843
200
        builder.append_printf ("%c%d", 'a' + f1, r1 + 1);
3844
201
3845
202
        if (promotion_piece != null)
3846
203
            builder.append_printf ("=%s", piece_names[promotion_piece.type]);
3847
204
3848
205
        switch (check_state)
3849
206
        {
3850
207
        case CheckState.CHECK:
3851
208
            builder.append_c ('+');
3852
209
            break;
3853
210
        case CheckState.CHECKMATE:
3854
211
            builder.append_c ('#');
3855
212
            break;
3856
213
        }
3857
214
3858
215
        return builder.str;
3859
216
    }
3860
217
3861
218
    /* Move suitable for a chess engine (CECP/UCI) */
3862
219
    public string get_engine ()
3863
220
    {
3864
221
        var builder = new StringBuilder ();
3865
222
        const char promotion_symbols[] = {' ', 'r', 'n', 'b', 'q', ' '};
3866
223
        if (promotion_piece != null)
3867
224
            builder.append_printf ("%c%d%c%d%c", 'a' + f0, r0 + 1, 'a' + f1, r1 + 1, promotion_symbols[promotion_piece.type]);
3868
225
        else
3869
226
            builder.append_printf ("%c%d%c%d", 'a' + f0, r0 + 1, 'a' + f1, r1 + 1);
3870
227
        return builder.str;
3871
228
    }
3872
229
3873
230
    public ChessMove copy ()
3874
231
    {
3875
232
        var move = new ChessMove ();
3876
233
        move.number = number;
3877
234
        move.piece = piece;
3878
235
        move.promotion_piece = promotion_piece;
3879
236
        move.moved_rook = moved_rook;
3880
237
        move.victim = victim;
3881
238
        move.r0 = r0;
3882
239
        move.f0 = f0;
3883
240
        move.r1 = r1;
3884
241
        move.f1 = f1;
3885
242
        move.ambiguous_rank = ambiguous_rank;
3886
243
        move.ambiguous_file = ambiguous_file;
3887
244
        move.check_state = check_state;
3888
245
        return move;
3889
246
    }
3890
247
}
3891
248
3892
249
public class ChessState
3893
250
{
3894
251
    public int number = 0;
3895
252
    public ChessPlayer players[2];
3896
253
    public ChessPlayer current_player;
3897
254
    public ChessPlayer opponent
3898
255
    {
3899
256
        get { return current_player.color == Color.WHITE ? players[Color.BLACK] : players[Color.WHITE]; }
3900
257
    }
3901
258
    public bool can_castle_kingside[2];
3902
259
    public bool can_castle_queenside[2];
3903
260
    public int en_passant_index = -1;
3904
261
    public CheckState check_state;
3905
262
    public int halfmove_clock;
3906
263
3907
264
    public ChessPiece board[64];
3908
265
    public ChessMove? last_move = null;
3909
266
3910
267
    /* Bitmap of all the pieces */
3911
268
    private int64 piece_masks[2];
3912
269
3913
270
    private ChessState.empty ()
3914
271
    {
3915
272
    }
3916
273
3917
274
    public ChessState (string fen)
3918
275
    {
3919
276
        players[Color.WHITE] = new ChessPlayer (Color.WHITE);
3920
277
        players[Color.BLACK] = new ChessPlayer (Color.BLACK);
3921
278
        for (int i = 0; i < 64; i++)
3922
279
            board[i] = null;
3923
280
3924
281
        string[] fields = fen.split (" ");
3925
282
        //if (fields.length != 6)
3926
283
        //    throw new Error ("Invalid FEN string");
3927
284
3928
285
        /* Field 1: Piece placement */
3929
286
        string[] ranks = fields[0].split ("/");
3930
287
        //if (ranks.length != 8)
3931
288
        //    throw new Error ("Invalid piece placement");
3932
289
        for (int rank = 0; rank < 8; rank++)
3933
290
        {
3934
291
            var rank_string = ranks[7 - rank];
3935
292
            for (int file = 0, offset = 0; file < 8 && offset < rank_string.length; offset++)
3936
293
            {
3937
294
                var c = rank_string[offset];
3938
295
                if (c >= '1' && c <= '8')
3939
296
                {
3940
297
                    file += c - '0';
3941
298
                    continue;
3942
299
                }
3943
300
3944
301
                PieceType type;
3945
302
                var color = c.isupper () ? Color.WHITE : Color.BLACK;
3946
303
                if (!decode_piece_type (c.toupper (), out type))
3947
304
                    ;//throw new Error ("");
3948
305
3949
306
                int index = get_index (rank, file);
3950
307
                ChessPiece piece = new ChessPiece (players[color], type);
3951
308
                board[index] = piece;
3952
309
                int64 mask = BitBoard.set_location_masks[index];
3953
310
                piece_masks[color] |= mask;
3954
311
                file++;
3955
312
            }
3956
313
        }
3957
314
3958
315
        /* Field 2: Active color */
3959
316
        if (fields[1] == "w")
3960
317
            current_player = players[Color.WHITE];
3961
318
        else if (fields[1] == "b")
3962
319
            current_player = players[Color.BLACK];
3963
320
        //else
3964
321
        //    throw new Error ("Unknown active color: %s", fields[1]);
3965
322
3966
323
        /* Field 3: Castling availability */
3967
324
        if (fields[2] != "-")
3968
325
        {
3969
326
            for (int i = 0; i < fields[2].length; i++)
3970
327
            {
3971
328
                var c = fields[2][i];
3972
329
                if (c == 'K')
3973
330
                    can_castle_kingside[Color.WHITE] = true;
3974
331
                else if (c == 'Q')
3975
332
                    can_castle_queenside[Color.WHITE] = true;
3976
333
                else if (c == 'k')
3977
334
                    can_castle_kingside[Color.BLACK] = true;
3978
335
                else if (c == 'q')
3979
336
                    can_castle_queenside[Color.BLACK] = true;
3980
337
                //else
3981
338
                //    throw new Error ("");
3982
339
            }
3983
340
        }
3984
341
3985
342
        /* Field 4: En passant target square */
3986
343
        if (fields[3] != "-")
3987
344
        {
3988
345
            //if (fields[3].length != 2)
3989
346
            //    throw new Error ("");
3990
347
            en_passant_index = get_index (fields[3][1] - '1', fields[3][0] - 'a');
3991
348
        }
3992
349
3993
350
        /* Field 5: Halfmove clock */
3994
351
        halfmove_clock = int.parse (fields[4]);
3995
352
3996
353
        /* Field 6: Fullmove number */
3997
354
        number = (int.parse (fields[5]) - 1) * 2;
3998
355
        if (current_player.color == Color.BLACK)
3999
356
            number++;
4000
357
4001
358
        check_state = get_check_state (current_player);
4002
359
    }
4003
360
4004
361
    public ChessState copy ()
4005
362
    {
4006
363
        ChessState state = new ChessState.empty ();
4007
364
4008
365
        state.number = number;
4009
366
        state.players[Color.WHITE] = players[Color.WHITE];
4010
367
        state.players[Color.BLACK] = players[Color.BLACK];
4011
368
        state.current_player = current_player;
4012
369
        state.can_castle_kingside[Color.WHITE] = can_castle_kingside[Color.WHITE];
4013
370
        state.can_castle_queenside[Color.WHITE] = can_castle_queenside[Color.WHITE];        
4014
371
        state.can_castle_kingside[Color.BLACK] = can_castle_kingside[Color.BLACK];
4015
372
        state.can_castle_queenside[Color.BLACK] = can_castle_queenside[Color.BLACK];
4016
373
        state.en_passant_index = en_passant_index;
4017
374
        state.check_state = check_state;
4018
375
        if (last_move != null)
4019
376
            state.last_move = last_move.copy();
4020
377
        for (int i = 0; i < 64; i++)
4021
378
            state.board[i] = board[i];
4022
379
        state.piece_masks[Color.WHITE] = piece_masks[Color.WHITE];
4023
380
        state.piece_masks[Color.BLACK] = piece_masks[Color.BLACK];
4024
381
4025
382
        return state;
4026
383
    }
4027
384
4028
385
    public bool equals (ChessState state)
4029
386
    {
4030
387
        /* Check first if there is the same layout of pieces (unlikely),
4031
388
         * then the move castling and en-passant state are the same,
4032
389
         * then finally that it is the same move */
4033
390
        if (piece_masks[Color.WHITE] != state.piece_masks[Color.WHITE] ||
4034
391
            piece_masks[Color.BLACK] != state.piece_masks[Color.BLACK] || 
4035
392
            can_castle_kingside[Color.WHITE] != state.can_castle_kingside[Color.WHITE] ||
4036
393
            can_castle_queenside[Color.WHITE] != state.can_castle_queenside[Color.WHITE] ||
4037
394
            can_castle_kingside[Color.BLACK] != state.can_castle_kingside[Color.BLACK] ||
4038
395
            can_castle_queenside[Color.BLACK] != state.can_castle_queenside[Color.BLACK] ||
4039
396
            en_passant_index != state.en_passant_index ||
4040
397
            (last_move != null) != (state.last_move != null) ||
4041
398
            last_move.piece.type != state.last_move.piece.type ||
4042
399
            last_move.r0 != state.last_move.r0 ||
4043
400
            last_move.f0 != state.last_move.f0 ||
4044
401
            last_move.r1 != state.last_move.r1 ||
4045
402
            last_move.f1 != state.last_move.f1)
4046
403
            return false;
4047
404
4048
405
        /* Finally check the same piece types are present */
4049
406
        for (int i = 0; i < 64; i++)
4050
407
        {
4051
408
            if (board[i] != null && board[i].type != state.board[i].type)
4052
409
                return false;
4053
410
        }
4054
411
4055
412
        return true;
4056
413
    }
4057
414
4058
415
    public string get_fen ()
4059
416
    {
4060
417
        var value = new StringBuilder ();
4061
418
4062
419
        for (int rank = 7; rank >= 0; rank--)
4063
420
        {
4064
421
            int skip_count = 0;
4065
422
            for (int file = 0; file < 8; file++)
4066
423
            {
4067
424
                var p = board[get_index (rank, file)];
4068
425
                if (p == null)
4069
426
                    skip_count++;
4070
427
                else
4071
428
                {
4072
429
                    if (skip_count > 0)
4073
430
                    {
4074
431
                        value.append_printf ("%d", skip_count);
4075
432
                        skip_count = 0;
4076
433
                    }
4077
434
                    value.append_printf ("%c", (int) p.symbol);
4078
435
                }
4079
436
            }
4080
437
            if (skip_count > 0)
4081
438
                value.append_printf ("%d", skip_count);
4082
439
            if (rank != 0)
4083
440
                value.append_c ('/');
4084
441
        }
4085
442
        
4086
443
        value.append_c (' ');
4087
444
        if (current_player.color == Color.WHITE)
4088
445
            value.append_c ('w');
4089
446
        else
4090
447
            value.append_c ('b');
4091
448
4092
449
        value.append_c (' ');
4093
450
        if (can_castle_kingside[Color.WHITE])
4094
451
            value.append_c ('K');
4095
452
        if (can_castle_queenside[Color.WHITE])
4096
453
            value.append_c ('Q');
4097
454
        if (can_castle_kingside[Color.BLACK])
4098
455
            value.append_c ('k');
4099
456
        if (can_castle_queenside[Color.BLACK])
4100
457
            value.append_c ('q');
4101
458
        if (!(can_castle_kingside[Color.WHITE] | can_castle_queenside[Color.WHITE] | can_castle_kingside[Color.BLACK] | can_castle_queenside[Color.BLACK]))
4102
459
            value.append_c ('-');
4103
460
4104
461
        value.append_c (' ');
4105
462
        if (en_passant_index >= 0)
4106
463
            value.append_printf ("%c%d", 'a' + get_file (en_passant_index), get_rank (en_passant_index) + 1);
4107
464
        else
4108
465
            value.append_c ('-');
4109
466
4110
467
        value.append_c (' ');
4111
468
        value.append_printf ("%d", halfmove_clock);
4112
469
4113
470
        value.append_c (' ');
4114
471
        if (current_player.color == Color.WHITE)
4115
472
            value.append_printf ("%d", number / 2);
4116
473
        else
4117
474
            value.append_printf ("%d", number / 2 + 1);
4118
475
4119
476
        return value.str;
4120
477
    }
4121
478
4122
479
    public int get_index (int rank, int file)
4123
480
    {
4124
481
        return rank * 8 + file;
4125
482
    }
4126
483
    
4127
484
    public int get_rank (int index)
4128
485
    {
4129
486
        return index / 8;
4130
487
    }
4131
488
4132
489
    public int get_file (int index)
4133
490
    {
4134
491
        return index % 8;
4135
492
    }
4136
493
4137
494
    public bool move (string move, bool apply = true)
4138
495
    {
4139
496
        int r0, f0, r1, f1;
4140
497
        PieceType promotion_type;
4141
498
4142
499
        if (!decode_move (current_player, move, out r0, out f0, out r1, out f1, out promotion_type))
4143
500
            return false;
4144
501
4145
502
        if (!move_with_coords (current_player, r0, f0, r1, f1, promotion_type, apply))
4146
503
            return false;
4147
504
4148
505
        return true;
4149
506
    }
4150
507
4151
508
    public bool move_with_coords (ChessPlayer player,
4152
509
                                  int r0, int f0, int r1, int f1,
4153
510
                                  PieceType promotion_type = PieceType.QUEEN,
4154
511
                                  bool apply = true, bool test_check = true)
4155
512
    {
4156
513
        // FIXME: Make this use indexes to be faster
4157
514
        var start = get_index (r0, f0);
4158
515
        var end = get_index (r1, f1);
4159
516
4160
517
        var color = player.color;
4161
518
        var opponent_color = color == Color.WHITE ? Color.BLACK : Color.WHITE;
4162
519
4163
520
        /* Must be moving own piece */
4164
521
        var piece = board[start];
4165
522
        if (piece == null || piece.player != player)
4166
523
            return false;
4167
524
4168
525
        /* Check valid move */
4169
526
        int64 end_mask = BitBoard.set_location_masks[end];
4170
527
        int64 move_mask = BitBoard.move_masks[color * 64*6 + piece.type * 64 + start];
4171
528
        if ((end_mask & move_mask) == 0)
4172
529
            return false;
4173
530
4174
531
        /* Check no pieces in the way */
4175
532
        int64 over_mask = BitBoard.over_masks[start * 64 + end];
4176
533
        if ((over_mask & (piece_masks[Color.WHITE] | piece_masks[Color.BLACK])) != 0)
4177
534
            return false;
4178
535
4179
536
        /* Get victim of move */
4180
537
        var victim = board[end];
4181
538
        var victim_index = end;
4182
539
4183
540
        /* Can't take own pieces */
4184
541
        if (victim != null && victim.player == player)
4185
542
            return false;
4186
543
4187
544
        /* Check special moves */
4188
545
        int rook_start = -1, rook_end = -1;
4189
546
        bool is_promotion = false;
4190
547
        bool ambiguous_rank = false;
4191
548
        bool ambiguous_file = false;
4192
549
        switch (piece.type)
4193
550
        {
4194
551
        case PieceType.PAWN:
4195
552
            /* Check if taking an marched pawn */
4196
553
            if (victim == null && end == en_passant_index)
4197
554
            {
4198
555
                victim_index = get_index (r1 == 2 ? 3 : 4, f1);
4199
556
                victim = board[victim_index];
4200
557
            }
4201
558
4202
559
            /* If moving diagonally there must be a victim */
4203
560
            if (f0 != f1)
4204
561
            {
4205
562
                if (victim == null)
4206
563
                    return false;
4207
564
            }
4208
565
            else
4209
566
            {
4210
567
                /* If moving forward can't take enemy */
4211
568
                if (victim != null)
4212
569
                    return false;
4213
570
            }
4214
571
            is_promotion = r1 == 0 || r1 == 7;
4215
572
            
4216
573
            /* Always show the file of a pawn capturing */
4217
574
            if (victim != null)
4218
575
                ambiguous_file = true;
4219
576
            break;
4220
577
        case PieceType.KING:
4221
578
            /* If moving more than one square must be castling */
4222
579
            if ((f0 - f1).abs () > 1)
4223
580
            {
4224
581
                /* File the rook is on */
4225
582
                rook_start = get_index (r0, f1 > f0 ? 7 : 0);
4226
583
                rook_end = get_index (r0, f1 > f0 ? f1 - 1 : f1 + 1);
4227
584
4228
585
                /* Check if can castle */
4229
586
                if (f1 > f0)
4230
587
                {
4231
588
                    if (!can_castle_kingside[color])
4232
589
                        return false;
4233
590
                }
4234
591
                else
4235
592
                {
4236
593
                    if (!can_castle_queenside[color])
4237
594
                        return false;                
4238
595
                }
4239
596
4240
597
                var rook = board[rook_start];
4241
598
                if (rook == null)
4242
599
                    return false;
4243
600
4244
601
                /* Check rook can move */
4245
602
                int64 rook_over_mask = BitBoard.over_masks[rook_start * 64 + rook_end];
4246
603
                if ((rook_over_mask & (piece_masks[Color.WHITE] | piece_masks[Color.BLACK])) != 0)
4247
604
                    return false;
4248
605
4249
606
                /* Can't castle when in check */
4250
607
                if (check_state == CheckState.CHECK)
4251
608
                    return false;
4252
609
4253
610
                /* Square moved across can't be under attack */
4254
611
                for (int i = 0; i < 64; i++)
4255
612
                {
4256
613
                    if (move_with_coords (opponent, get_rank (i), get_file (i), get_rank (rook_end), get_file (rook_end), PieceType.QUEEN, false, false))
4257
614
                        return false;
4258
615
                }
4259
616
            }
4260
617
            break;
4261
618
        default:
4262
619
            break;
4263
620
        }
4264
621
4265
622
        if (!apply && !test_check)
4266
623
            return true;
4267
624
4268
625
        /* Check if other pieces of the same type can make this move - this is required for SAN notation */
4269
626
        if (apply)
4270
627
        {
4271
628
            for (int i = 0; i < 64; i++)
4272
629
            {
4273
630
                /* Ignore our move */
4274
631
                if (i == start)
4275
632
                    continue;
4276
633
4277
634
                /* Check for a friendly piece of the same type */
4278
635
                var p = board[i];
4279
636
                if (p == null || p.player != player || p.type != piece.type)
4280
637
                    continue;
4281
638
4282
639
                /* If more than one piece can move then the rank and/or file are ambiguous */
4283
640
                var r = get_rank (i);
4284
641
                var f = get_file (i);
4285
642
                if (move_with_coords (player, r, f, r1, f1, PieceType.QUEEN, false))
4286
643
                {
4287
644
                    if (r != r0)
4288
645
                        ambiguous_rank = true;
4289
646
                    if (f != f0)
4290
647
                        ambiguous_file = true;
4291
648
                }
4292
649
            }
4293
650
        }
4294
651
4295
652
        var old_white_mask = piece_masks[Color.WHITE];
4296
653
        var old_black_mask = piece_masks[Color.BLACK];
4297
654
        var old_white_can_castle_kingside = can_castle_kingside[Color.WHITE];
4298
655
        var old_white_can_castle_queenside = can_castle_queenside[Color.WHITE];
4299
656
        var old_black_can_castle_kingside = can_castle_kingside[Color.BLACK];
4300
657
        var old_black_can_castle_queenside = can_castle_queenside[Color.BLACK];
4301
658
        var old_en_passant_index = en_passant_index;
4302
659
        var old_halfmove_clock = halfmove_clock;
4303
660
4304
661
        /* Update board */
4305
662
        board[start] = null;
4306
663
        piece_masks[Color.WHITE] &= BitBoard.clear_location_masks[start];
4307
664
        piece_masks[Color.BLACK] &= BitBoard.clear_location_masks[start];
4308
665
        if (victim != null)
4309
666
        {
4310
667
            board[victim_index] = null;
4311
668
            piece_masks[Color.WHITE] &= BitBoard.clear_location_masks[victim_index];
4312
669
            piece_masks[Color.BLACK] &= BitBoard.clear_location_masks[victim_index];
4313
670
        }
4314
671
        if (is_promotion)
4315
672
            board[end] = new ChessPiece (player, promotion_type);
4316
673
        else
4317
674
            board[end] = piece;
4318
675
        piece_masks[color] |= end_mask;
4319
676
        piece_masks[opponent_color] &= BitBoard.clear_location_masks[end];
4320
677
        if (rook_start >= 0)
4321
678
        {
4322
679
            var rook = board[rook_start];
4323
680
            board[rook_start] = null;
4324
681
            piece_masks[color] &= BitBoard.clear_location_masks[rook_start];
4325
682
            board[rook_end] = rook;
4326
683
            piece_masks[color] |= BitBoard.set_location_masks[rook_end];
4327
684
        }
4328
685
4329
686
        /* Can't castle once king has moved */
4330
687
        if (piece.type == PieceType.KING)
4331
688
        {
4332
689
            can_castle_kingside[color] = false;
4333
690
            can_castle_queenside[color] = false;
4334
691
        }
4335
692
        /* Can't castle once rooks have moved */
4336
693
        else if (piece.type == PieceType.ROOK)
4337
694
        {
4338
695
            int base_rank = color == Color.WHITE ? 0 : 7;
4339
696
            if (r0 == base_rank)
4340
697
            {
4341
698
                if (f0 == 0)
4342
699
                    can_castle_queenside[color] = false;
4343
700
                else if (f0 == 7)
4344
701
                    can_castle_kingside[color] = false;
4345
702
            }
4346
703
        }
4347
704
4348
705
        /* Pawn square moved over is vulnerable */
4349
706
        if (piece.type == PieceType.PAWN && over_mask != 0)
4350
707
            en_passant_index = get_index ((r0 + r1) / 2, f0);
4351
708
        else
4352
709
            en_passant_index = -1;
4353
710
4354
711
        /* Reset halfmove count when pawn moved or piece taken */
4355
712
        if (piece.type == PieceType.PAWN || victim != null)
4356
713
            halfmove_clock = 0;
4357
714
        else
4358
715
            halfmove_clock++;
4359
716
4360
717
        /* Test if this move would leave that player in check */
4361
718
        bool result = true;
4362
719
        if (test_check && is_in_check (player))
4363
720
            result = false;
4364
721
4365
722
        /* Undo move */
4366
723
        if (!apply || !result)
4367
724
        {
4368
725
            board[start] = piece;
4369
726
            board[end] = null;
4370
727
            if (victim != null)
4371
728
                board[victim_index] = victim;
4372
729
            if (rook_start >= 0)
4373
730
            {
4374
731
                var rook = board[rook_end];
4375
732
                board[rook_start] = rook;
4376
733
                board[rook_end] = null;
4377
734
            }
4378
735
            piece_masks[Color.WHITE] = old_white_mask;
4379
736
            piece_masks[Color.BLACK] = old_black_mask;
4380
737
            can_castle_kingside[Color.WHITE] = old_white_can_castle_kingside;
4381
738
            can_castle_queenside[Color.WHITE] = old_white_can_castle_queenside;
4382
739
            can_castle_kingside[Color.BLACK] = old_black_can_castle_kingside;
4383
740
            can_castle_queenside[Color.BLACK] = old_black_can_castle_queenside;
4384
741
            en_passant_index = old_en_passant_index;
4385
742
            halfmove_clock = old_halfmove_clock;
4386
743
4387
744
            return result;
4388
745
        }
4389
746
4390
747
        current_player = color == Color.WHITE ? players[Color.BLACK] : players[Color.WHITE];
4391
748
        check_state = get_check_state (current_player);
4392
749
4393
750
        last_move = new ChessMove ();
4394
751
        last_move.number = number;
4395
752
        last_move.piece = piece;
4396
753
        if (is_promotion)
4397
754
            last_move.promotion_piece = board[end];
4398
755
        last_move.victim = victim;
4399
756
        if (rook_end >= 0)
4400
757
            last_move.moved_rook = board[rook_end];
4401
758
        last_move.r0 = r0;
4402
759
        last_move.f0 = f0;
4403
760
        last_move.r1 = r1;
4404
761
        last_move.f1 = f1;
4405
762
        last_move.ambiguous_rank = ambiguous_rank;
4406
763
        last_move.ambiguous_file = ambiguous_file;
4407
764
        last_move.check_state = check_state;
4408
765
4409
766
        return true;
4410
767
    }
4411
768
4412
769
    public ChessResult get_result (out ChessRule rule)
4413
770
    {
4414
771
        rule = ChessRule.CHECKMATE;
4415
772
        if (check_state == CheckState.CHECKMATE)
4416
773
        {
4417
774
            if (current_player.color == Color.WHITE)
4418
775
            {
4419
776
                rule = ChessRule.CHECKMATE;
4420
777
                return ChessResult.BLACK_WON;
4421
778
            }
4422
779
            else
4423
780
            {
4424
781
                rule = ChessRule.CHECKMATE;
4425
782
                return ChessResult.WHITE_WON;
4426
783
            }
4427
784
        }
4428
785
4429
786
        if (!can_move (current_player))
4430
787
        {
4431
788
            rule = ChessRule.STALEMATE;
4432
789
            return ChessResult.DRAW;
4433
790
        }
4434
791
4435
792
        if (last_move != null && last_move.victim != null && !have_sufficient_material ())
4436
793
        {
4437
794
            rule = ChessRule.INSUFFICIENT_MATERIAL;
4438
795
            return ChessResult.DRAW;
4439
796
        }
4440
797
4441
798
        return ChessResult.IN_PROGRESS;
4442
799
    }
4443
800
4444
801
    private CheckState get_check_state (ChessPlayer player)
4445
802
    {
4446
803
        if (is_in_check (player))
4447
804
        {
4448
805
            if (is_in_checkmate (player))
4449
806
                return CheckState.CHECKMATE;
4450
807
            else
4451
808
                return CheckState.CHECK;
4452
809
        }
4453
810
        return CheckState.NONE;
4454
811
    }
4455
812
4456
813
    private bool is_in_check (ChessPlayer player)
4457
814
    {
4458
815
        var opponent = player.color == Color.WHITE ? players[Color.BLACK] : players[Color.WHITE];
4459
816
4460
817
        /* Is in check if any piece can take the king */
4461
818
        for (int king_index = 0; king_index < 64; king_index++)
4462
819
        {
4463
820
            var p = board[king_index];
4464
821
            if (p != null && p.player == player && p.type == PieceType.KING)
4465
822
            {
4466
823
                /* See if any enemy pieces can take the king */
4467
824
                for (int start = 0; start < 64; start++)
4468
825
                {
4469
826
                    if (move_with_coords (opponent,
4470
827
                                          get_rank (start), get_file (start),
4471
828
                                          get_rank (king_index), get_file (king_index),
4472
829
                                          PieceType.QUEEN, false, false))
4473
830
                        return true;
4474
831
                }
4475
832
            }
4476
833
        }
4477
834
4478
835
        return false;
4479
836
    }
4480
837
4481
838
    private bool is_in_checkmate (ChessPlayer player)
4482
839
    {
4483
840
        /* Is in checkmate if no pieces can move */
4484
841
        for (int piece_index = 0; piece_index < 64; piece_index++)
4485
842
        {
4486
843
            var p = board[piece_index];
4487
844
            if (p != null && p.player == player)
4488
845
            {
4489
846
                for (int end = 0; end < 64; end++)
4490
847
                {
4491
848
                    if (move_with_coords (player,
4492
849
                                          get_rank (piece_index), get_file (piece_index),
4493
850
                                          get_rank (end), get_file (end),
4494
851
                                          PieceType.QUEEN, false, true))
4495
852
                        return false;
4496
853
                }
4497
854
            }
4498
855
        }
4499
856
4500
857
        return true;
4501
858
    }
4502
859
4503
860
    private bool can_move (ChessPlayer player)
4504
861
    {
4505
862
        bool have_pieces = false;
4506
863
4507
864
        for (int start = 0; start < 64; start++)
4508
865
        {
4509
866
            var p = board[start];
4510
867
            if (p != null && p.player == player)
4511
868
            {
4512
869
                have_pieces = true;
4513
870
4514
871
                /* See if can move anywhere */
4515
872
                for (int end = 0; end < 64; end++)
4516
873
                {
4517
874
                    if (move_with_coords (player,
4518
875
                                          get_rank (start), get_file (start),
4519
876
                                          get_rank (end), get_file (end),
4520
877
                                          PieceType.QUEEN, false, true))
4521
878
                        return true;
4522
879
                }
4523
880
            }
4524
881
        }
4525
882
4526
883
        /* Only mark as stalemate if have at least one piece */
4527
884
        if (have_pieces)
4528
885
            return false;
4529
886
        else
4530
887
            return true;
4531
888
    }
4532
889
4533
890
    public bool have_sufficient_material ()
4534
891
    {
4535
892
        var white_knight_count = 0;
4536
893
        var white_bishop_count = 0;
4537
894
        var white_bishop_on_white_square = false;
4538
895
        var white_bishop_on_black_square = false;
4539
896
        var black_knight_count = 0;
4540
897
        var black_bishop_count = 0;
4541
898
        var black_bishop_on_white_square = false;
4542
899
        var black_bishop_on_black_square = false;
4543
900
4544
901
        for (int i = 0; i < 64; i++)
4545
902
        {
4546
903
            var p = board[i];
4547
904
            if (p == null)
4548
905
                continue;
4549
906
4550
907
            /* Any pawns, rooks or queens can perform checkmate */
4551
908
            if (p.type == PieceType.PAWN || p.type == PieceType.ROOK || p.type == PieceType.QUEEN)
4552
909
                return true;
4553
910
4554
911
            /* Otherwise, count the minor pieces for each colour... */
4555
912
            if (p.type == PieceType.KNIGHT)
4556
913
            {
4557
914
                if (p.color == Color.WHITE)
4558
915
                    white_knight_count++;
4559
916
                else
4560
917
                    black_knight_count++;
4561
918
            }
4562
919
4563
920
            if (p.type == PieceType.BISHOP)
4564
921
            {
4565
922
                var color = Color.BLACK;
4566
923
                if ((i + i/8) % 2 != 0)
4567
924
                    color = Color.WHITE;
4568
925
4569
926
                if (p.color == Color.WHITE)
4570
927
                {
4571
928
                    if (color == Color.WHITE)
4572
929
                        white_bishop_on_white_square = true;
4573
930
                    else
4574
931
                        white_bishop_on_black_square = true;
4575
932
                    white_bishop_count++;
4576
933
                }
4577
934
                else
4578
935
                {
4579
936
                    if (color == Color.WHITE)
4580
937
                        black_bishop_on_white_square = true;
4581
938
                    else
4582
939
                        black_bishop_on_black_square = true;
4583
940
                    black_bishop_count++;
4584
941
                }
4585
942
            }
4586
943
4587
944
            /* Three knights versus king can checkmate */
4588
945
            if (white_knight_count > 2 || black_knight_count > 2)
4589
946
                return true;
4590
947
4591
948
            /* Bishop and knight versus king can checkmate */
4592
949
            if (white_bishop_count > 0 && white_knight_count > 0)
4593
950
                return true;
4594
951
            if (black_bishop_count > 0 && black_knight_count > 0)
4595
952
                return true;
4596
953
4597
954
            /* King and bishops versus king can checkmate as long as the bishops are on both colours */
4598
955
            if (white_bishop_on_white_square && white_bishop_on_black_square)
4599
956
                return true;
4600
957
            if (black_bishop_on_white_square && black_bishop_on_black_square)
4601
958
                return true;
4602
959
        }
4603
960
4604
961
        return false;
4605
962
    }
4606
963
4607
964
    private bool decode_piece_type (unichar c, out PieceType type)
4608
965
    {
4609
966
        type = PieceType.PAWN;
4610
967
        switch (c)
4611
968
        {
4612
969
        case 'P':
4613
970
            type = PieceType.PAWN;
4614
971
            return true;
4615
972
        case 'R':
4616
973
            type = PieceType.ROOK;
4617
974
            return true;
4618
975
        case 'N':
4619
976
            type = PieceType.KNIGHT;
4620
977
            return true;
4621
978
        case 'B':
4622
979
            type = PieceType.BISHOP;
4623
980
            return true;
4624
981
        case 'Q':
4625
982
            type = PieceType.QUEEN;
4626
983
            return true;
4627
984
        case 'K':
4628
985
            type = PieceType.KING;
4629
986
            return true;
4630
987
        default:
4631
988
            return false;
4632
989
        }
4633
990
    }
4634
991
4635
992
    private bool decode_move (ChessPlayer player, string move, out int r0, out int f0, out int r1, out int f1, out PieceType promotion_type)
4636
993
    {
4637
994
        int i = 0;
4638
995
4639
996
        promotion_type = PieceType.QUEEN;
4640
997
        if (move.has_prefix ("O-O-O"))
4641
998
        {
4642
999
            if (player.color == Color.WHITE)
4643
1000
                r0 = r1 = 0;
4644
1001
            else
4645
1002
                r0 = r1 = 7;
4646
1003
            f0 = 4;
4647
1004
            f1 = 2;
4648
1005
            i += (int) "O-O-O".length;
4649
1006
        }
4650
1007
        else if (move.has_prefix ("O-O"))
4651
1008
        {
4652
1009
            if (player.color == Color.WHITE)
4653
1010
                r0 = r1 = 0;
4654
1011
            else
4655
1012
                r0 = r1 = 7;
4656
1013
            f0 = 4;
4657
1014
            f1 = 6;
4658
1015
            i += (int) "O-O".length;
4659
1016
        }
4660
1017
        else
4661
1018
        {
4662
1019
            PieceType type = PieceType.PAWN;
4663
1020
            if (decode_piece_type (move[i], out type))
4664
1021
                i++;
4665
1022
4666
1023
            r0 = f0 = r1 = f1 = -1;
4667
1024
            if (move[i] >= 'a' && move[i] <= 'h')
4668
1025
            {
4669
1026
                f1 = (int) (move[i] - 'a');
4670
1027
                i++;
4671
1028
            }
4672
1029
            if (move[i] >= '1' && move[i] <= '8')
4673
1030
            {
4674
1031
                r1 = (int) (move[i] - '1');
4675
1032
                i++;
4676
1033
            }
4677
1034
            if (move[i] == 'x')
4678
1035
                i++;
4679
1036
            if (move[i] >= 'a' && move[i] <= 'h')
4680
1037
            {
4681
1038
                f0 = f1;
4682
1039
                f1 = (int) (move[i] - 'a');
4683
1040
                i++;
4684
1041
            }
4685
1042
            if (move[i] >= '1' && move[i] <= '8')
4686
1043
            {
4687
1044
                r0 = r1;
4688
1045
                r1 = (int) (move[i] - '1');
4689
1046
                i++;
4690
1047
            }
4691
1048
            if (move[i] == '=')
4692
1049
            {
4693
1050
                i++;
4694
1051
                if (decode_piece_type (move[i], out promotion_type))
4695
1052
                    i++;
4696
1053
            }
4697
1054
            else if (move[i] != '\0')
4698
1055
            {
4699
1056
                switch (move[i])
4700
1057
                {
4701
1058
                case 'q':
4702
1059
                    promotion_type = PieceType.QUEEN;
4703
1060
                    i++;
4704
1061
                    break;
4705
1062
                case 'n':
4706
1063
                    promotion_type = PieceType.KNIGHT;
4707
1064
                    i++;
4708
1065
                    break;
4709
1066
                case 'r':
4710
1067
                    promotion_type = PieceType.ROOK;
4711
1068
                    i++;
4712
1069
                    break;
4713
1070
                case 'b':
4714
1071
                    promotion_type = PieceType.BISHOP;
4715
1072
                    i++;
4716
1073
                    break;
4717
1074
                }
4718
1075
            }
4719
1076
4720
1077
            /* Don't have a destination to move to */
4721
1078
            if (r1 < 0 || f1 < 0)
4722
1079
            {
4723
1080
                debug ("Move %s missing destination", move);
4724
1081
                return false;
4725
1082
            }
4726
1083
4727
1084
            /* Find source piece */
4728
1085
            if (r0 < 0 || f0 < 0)
4729
1086
            {
4730
1087
                int match_rank = -1, match_file = -1;
4731
1088
4732
1089
                for (int file = 0; file < 8; file++)
4733
1090
                {
4734
1091
                    if (f0 >= 0 && file != f0)
4735
1092
                        continue;
4736
1093
4737
1094
                    for (int rank = 0; rank < 8; rank++)
4738
1095
                    {
4739
1096
                        if (r0 >= 0 && rank != r0)
4740
1097
                            continue;
4741
1098
4742
1099
                        /* Only check this players pieces of the correct type */
4743
1100
                        var piece = board[get_index (rank, file)];
4744
1101
                        if (piece == null || piece.type != type || piece.player != player)
4745
1102
                            continue;
4746
1103
4747
1104
                        /* See if can move here */
4748
1105
                        if (!this.move_with_coords (player, rank, file, r1, f1, PieceType.QUEEN, false))
4749
1106
                            continue;
4750
1107
4751
1108
                        /* Duplicate match */
4752
1109
                        if (match_rank >= 0)
4753
1110
                        {
4754
1111
                            debug ("Move %s is ambiguous", move);
4755
1112
                            return false;
4756
1113
                        }
4757
1114
4758
1115
                        match_rank = rank;
4759
1116
                        match_file = file;
4760
1117
                    }
4761
1118
                }
4762
1119
4763
1120
                if (match_rank < 0)
4764
1121
                {
4765
1122
                    debug ("Move %s has no matches", move);
4766
1123
                    return false;
4767
1124
                }
4768
1125
4769
1126
                r0 = match_rank;
4770
1127
                f0 = match_file;
4771
1128
            }
4772
1129
        }
4773
1130
4774
1131
        if (move[i] == '+')
4775
1132
            i++;
4776
1133
        else if (move[i] == '#')
4777
1134
            i++;
4778
1135
4779
1136
        if (move[i] != '\0')
4780
1137
        {
4781
1138
            debug ("Move %s has unexpected characters", move);
4782
1139
            return false;
4783
1140
        }
4784
1141
4785
1142
        return true;
4786
1143
    }
4787
1144
}
4788
1145
4789
1146
public enum ChessResult
4790
1147
{
4791
1148
    IN_PROGRESS,
4792
1149
    WHITE_WON,
4793
1150
    BLACK_WON,
4794
1151
    DRAW
4795
1152
}
4796
1153
4797
1154
public enum ChessRule
4798
1155
{
4799
1156
    CHECKMATE,
4800
1157
    STALEMATE,
4801
1158
    FIFTY_MOVES,
4802
1159
    TIMEOUT,
4803
1160
    THREE_FOLD_REPETITION,
4804
1161
    INSUFFICIENT_MATERIAL,
4805
1162
    RESIGN,
4806
1163
    ABANDONMENT,
4807
1164
    DEATH
4808
1165
}
4809
1166
4810
1167
public class ChessGame
4811
1168
{
4812
1169
    public bool is_started;
4813
1170
    public ChessResult result;
4814
1171
    public ChessRule rule;
4815
1172
    public List<ChessState> move_stack;
4816
1173
    
4817
1174
    private int hold_count = 0;
4818
1175
4819
1176
    public const string STANDARD_SETUP = "rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1";
4820
1177
4821
1178
    public signal void started ();
4822
1179
    public signal void turn_started (ChessPlayer player);
4823
1180
    public signal void moved (ChessMove move);
4824
1181
    public signal void undo ();
4825
1182
    public signal void ended ();
4826
1183
    
4827
1184
    public ChessState current_state
4828
1185
    {
4829
1186
       get { return move_stack.data; }
4830
1187
    }
4831
1188
4832
1189
    public ChessPlayer white
4833
1190
    {
4834
1191
        get { return current_state.players[Color.WHITE]; }
4835
1192
    }
4836
1193
    public ChessPlayer black
4837
1194
    {
4838
1195
        get { return current_state.players[Color.BLACK]; }
4839
1196
    }
4840
1197
    public ChessPlayer current_player
4841
1198
    {
4842
1199
        get { return current_state.current_player; }
4843
1200
    }
4844
1201
    public ChessPlayer opponent
4845
1202
    {
4846
1203
        get { return current_state.opponent; }
4847
1204
    }
4848
1205
    private ChessClock? _clock;
4849
1206
    public ChessClock? clock
4850
1207
    {
4851
1208
        get { return _clock; }
4852
1209
        set
4853
1210
        {
4854
1211
            if (is_started)
4855
1212
                return;
4856
1213
            _clock = value;
4857
1214
        }
4858
1215
    }
4859
1216
4860
1217
    public ChessGame (string fen = STANDARD_SETUP, string[]? moves = null)
4861
1218
    {
4862
1219
        is_started = false;
4863
1220
        move_stack.prepend (new ChessState (fen));
4864
1221
        result = ChessResult.IN_PROGRESS;
4865
1222
4866
1223
        if (moves != null)
4867
1224
        {
4868
1225
            for (var i = 0; i < moves.length; i++)
4869
1226
            {
4870
1227
                if (!do_move (current_player, moves[i], true))
4871
1228
                    warning ("Invalid move %s", moves[i]);
4872
1229
            }
4873
1230
        }
4874
1231
4875
1232
        white.do_move.connect (move_cb);
4876
1233
        white.do_undo.connect (undo_cb);
4877
1234
        white.do_resign.connect (resign_cb);
4878
1235
        white.do_claim_draw.connect (claim_draw_cb);
4879
1236
        black.do_move.connect (move_cb);
4880
1237
        black.do_undo.connect (undo_cb);
4881
1238
        black.do_resign.connect (resign_cb);
4882
1239
        black.do_claim_draw.connect (claim_draw_cb);
4883
1240
    }
4884
1241
4885
1242
    private bool move_cb (ChessPlayer player, string move, bool apply)
4886
1243
    {
4887
1244
        if (!is_started)
4888
1245
            return false;
4889
1246
4890
1247
        return do_move (player, move, apply);
4891
1248
    }
4892
1249
4893
1250
    private bool do_move (ChessPlayer player, string? move, bool apply)
4894
1251
    {
4895
1252
        if (player != current_player)
4896
1253
            return false;
4897
1254
4898
1255
        var state = current_state.copy ();
4899
1256
        state.number++;
4900
1257
        if (!state.move (move, apply))
4901
1258
            return false;
4902
1259
4903
1260
        if (!apply)
4904
1261
            return true;
4905
1262
4906
1263
        move_stack.prepend (state);
4907
1264
        if (state.last_move.victim != null)
4908
1265
            state.last_move.victim.died ();
4909
1266
        state.last_move.piece.moved ();
4910
1267
        if (state.last_move.moved_rook != null)
4911
1268
            state.last_move.moved_rook.moved ();
4912
1269
        moved (state.last_move);
4913
1270
        complete_move ();
4914
1271
4915
1272
        return true;
4916
1273
    }
4917
1274
4918
1275
    public void add_hold ()
4919
1276
    {
4920
1277
        hold_count++;
4921
1278
    }
4922
1279
4923
1280
    public void remove_hold ()
4924
1281
    {
4925
1282
        return_if_fail (hold_count > 0);
4926
1283
4927
1284
        hold_count--;
4928
1285
        if (hold_count == 0)
4929
1286
            complete_move ();
4930
1287
    }
4931
1288
4932
1289
    private void complete_move ()
4933
1290
    {
4934
1291
        /* Wait until the hold is removed */
4935
1292
        if (hold_count > 0)
4936
1293
            return;
4937
1294
            
4938
1295
        ChessRule rule;
4939
1296
        var result = current_state.get_result (out rule);
4940
1297
        if (result != ChessResult.IN_PROGRESS)
4941
1298
        {
4942
1299
            stop (result, rule);
4943
1300
        }
4944
1301
        else
4945
1302
        {
4946
1303
            if (_clock != null)
4947
1304
                _clock.active_color = current_player.color;
4948
1305
            current_player.start_turn ();
4949
1306
            turn_started (current_player);
4950
1307
        }
4951
1308
    }
4952
1309
4953
1310
    private void undo_cb (ChessPlayer player)
4954
1311
    {
4955
1312
        /* If this players turn undo their opponents move first */
4956
1313
        if (player == current_player)
4957
1314
            undo_cb (opponent);
4958
1315
4959
1316
        /* Don't pop off starting move */
4960
1317
        if (move_stack.next == null)
4961
1318
            return;
4962
1319
4963
1320
        /* Pop off the move state and notify */
4964
1321
        move_stack.remove_link (move_stack);
4965
1322
        undo ();
4966
1323
    }
4967
1324
4968
1325
    private bool resign_cb (ChessPlayer player)
4969
1326
    {
4970
1327
        if (!is_started)
4971
1328
            return false;
4972
1329
4973
1330
        if (player.color == Color.WHITE)
4974
1331
            stop (ChessResult.BLACK_WON, ChessRule.RESIGN);
4975
1332
        else
4976
1333
            stop (ChessResult.WHITE_WON, ChessRule.RESIGN);
4977
1334
4978
1335
        return true;
4979
1336
    }
4980
1337
4981
1338
    private bool claim_draw_cb (ChessPlayer player)
4982
1339
    {
4983
1340
        if (!is_started)
4984
1341
            return false;
4985
1342
4986
1343
        if (current_state.halfmove_clock >= 100)
4987
1344
            stop (ChessResult.DRAW, ChessRule.FIFTY_MOVES);
4988
1345
        else if (is_three_fold_repeat ())
4989
1346
            stop (ChessResult.DRAW, ChessRule.THREE_FOLD_REPETITION);
4990
1347
        else
4991
1348
            return false;
4992
1349
4993
1350
        return true;
4994
1351
    }
4995
1352
4996
1353
    public void start ()
4997
1354
    {
4998
1355
        if (result != ChessResult.IN_PROGRESS)
4999
1356
            return;
5000
1357
Reviewer	Review Type	Date Requested	Status
Ubuntu Development Team		2012-12-26	Pending
Review via email: mp+141287@code.launchpad.net