summaryrefslogtreecommitdiffstats
path: root/doc/en/index.docbook
blob: 99b75a39d65e56390f97dbf0ebc980fb7c60e218 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "Knights">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % English "INCLUDE" > <!-- change language only here -->
]>

<book lang="&language;">
	<bookinfo>
		<title>
			The Knights Handbook
		</title>
		<authorgroup>
			<author>
				<firstname>Troy</firstname>
				<surname>Corbin Jr.</surname>
				<affiliation>
					<address><email>tcorbin@users.sf.net</email></address>
				</affiliation>
			</author>
			<othercredit role="developer">
				<firstname>Troy</firstname>
				<surname>Corbin Jr.</surname>
				<affiliation>
					<address><email>tcorbin@users.sf.net</email></address>
				</affiliation>
				<contrib>Developer</contrib>
			</othercredit>
		</authorgroup>
		<!-- TRANS:ROLES_OF_TRANSLATORS -->
		<copyright>
			<year>2001, 2002</year>
			<holder>Troy Corbin Jr.</holder>
		</copyright>
		<legalnotice>
			&FDLNotice;
		</legalnotice>
		<date>
			2003-05-17
		</date>
		<releaseinfo>
			0.6
		</releaseinfo>
		<abstract>
			<para>
				Knights is a graphical chess interface for &kde;. It supports chess matches against computer engines like GNUChess and Crafty, watching two computer engines play against each other, solitaire chess, matches played via Internet Chess Servers, and reviewing matches saved in Portable Game Notation.
			</para>
		</abstract>
		<keywordset>
			<keyword>knights</keyword>
			<keyword>KDE</keyword>
			<keyword>game</keyword>
			<keyword>chess</keyword>
			<keyword>gnuchess</keyword>
			<keyword>crafty</keyword>
			<keyword>ICS</keyword>
			<keyword>SAN</keyword>
			<keyword>PGN</keyword>
		</keywordset>
	</bookinfo>

	<chapter id="introduction">
		<title>Introduction</title>
		<para>
			Chess is a game of strategy with a long history and many variations, and Knights aims to be the ultimate chess resource on your computer. Knights provides a virtual chess board and pieces which you can use to play against a variety of opponents. Currently, those opponents include yourself ( Solitaire chess is a wonderful way to improve your skill at the game ), computer opponents ( sometimes called chess engines ) which you have installed on your computer, and people connected to an internet chess server. In the future, you will also be able to play against a friend using email.
		</para>
		<para>
			If you like to review chess matches which other people have played, Knights can help. Using Portable Game Notation ( <acronym>PGN</acronym> ), Knights can exchange recorded chess matches with most other computer chess programs. You can also record your own matches with Knights, and share them with anyone.
		</para>
		<para>
			Future versions of Knights will include comprehensive chess education in the form of interactive tutorials. These tutorials will help new players grasp the basics, and help them evolve into advanced players.
		</para>
	</chapter>

	<chapter id="getting-started">
		<title>Getting Started</title>
			<para>
				The following sections will help you become familiar with Knights quickly.
			</para>
			<sect1 id="interface-chessboard">
				<title>The Chessboard</title>
					<para>
						If you've ever played chess before, then Knights' chessboard should be easy to understand. It always displays one player at the top of the screen and the other at the bottom. By default, your pieces always start at the bottom while your opponent's start at the top.
					</para>
					<para>
						Directly below the board are two clocks. The left clock has a white background and always shows the time for the white player. The right clock is always black and shows the time for the black player.
					</para>
					<sect2 id="interface-chessboard-move">
						<title>Making a Move</title>
							<para>
							To move a chessman, simply click the left mouse button while your pointer is over the chessman you wish to move. If it's your turn to move, the chessman will become highlighted. This lets you know that Knights is ready to move that chessman for you. Now, move your pointer to the position where you want your chessman to move to. Click the left mouse button. You've just moved your chessman!
						</para>
						<para>
							You can also move your chessman using "Drag and Drop". Hold down the left mouse button over the chessman you wish to move and, while still holding down the mouse button, move your chessman to it's new position and release the button.
						</para>
					</sect2>
					<sect2 id="interface-chessboard-preview">
						<title>Using Preview</title>
							<para>
								The Preview feature shows you where each chessman can move on a given turn. To use this feature, move your pointer so that it is over the chessman you wish to examine. Now, click the right mouse button. Any position which that chessman can move to will be highlighted. Moves which will result in a chessman being captured are colored differently.
							</para>
							<para>
								If the chessman you are examining is yours, and it is your turn, you may go head and move him by left clicking on the desired square.
							</para>
							<tip>
								<para>
									You can tell Knights to automatically preview possible moves every time you left click on a chessman. See the <link linkend="configure-display-general">Display Settings</link> chapter to find out how.
								</para>
							</tip>
					</sect2>
					<sect2 id="interface-chessboard-notation">
						<title>SAN Notation</title>
						<para>
							You will notice that in the lower-right corner, there is a button which displays the last move using Standard Algebraic Notation ( <acronym>SAN</acronym> ). Clicking this button will display all the moves in this match. You can review a previous position by selecting it from this list. Another way to move through this list is to use the <keycombo action="simul"><keycap>Up</keycap></keycombo> and <keycombo action="simul"><keycap>Down</keycap></keycombo> arrow keys on your keyboard. This will step through each move one at a time.
						</para>
						<note>
							<para>
								You can not make your next move while you are reviewing the match. You must return to the most recent entry in the list before you can make your move. If someone else makes a move while you are reviewing a previous position, Knights will automatically return you to the current position.
							</para>
						</note>
					</sect2>
			</sect1>
			<sect1 id="new-match">
				<title>Starting a New Match</title>
					<para>
						To start a new match, click on the <menuchoice><guimenu>File</guimenu></menuchoice> menu, then select <menuchoice><guimenu>New Match...</guimenu></menuchoice>.
					</para>
					<sect2 id="new-match-dialog">
						<title>The New Match Window</title>
							<para>
								The New Match Window lets you change the type of chess match you'd like to play.
							</para>
							<note>
								<para>
									Online games can not be started from here. If you'd like to play chess online, please see the section of this document titled <link linkend="online">Using Knights Online</link>.
								</para>
							</note>
							<para>
								Clicking <menuchoice><guimenu>Human</guimenu></menuchoice> will tell Knights that you want to control this color yourself.
							</para>
							<para>
								The <menuchoice><guimenu>Computer</guimenu></menuchoice> option, if available, will tell Knights that a Computer Opponent ( also known as a Chess Engine ) should control this color. Another window will pop up with a list of opponents that you have installed. After selecting an opponent, you should use the <menuchoice><guimenu>Player Strength</guimenu></menuchoice> slider to customize your opponent's skill level. Due to the fact that each computer opponent is unique, some which are set to <menuchoice><guimenu>Weak</guimenu></menuchoice> may actually be better than opponents set to <menuchoice><guimenu>Strong</guimenu></menuchoice>. Also note that some may completely ignore your preference and play that same no matter what skill level you select.
							</para>
							<para>
								The <menuchoice><guimenu>Email</guimenu></menuchoice> option is not yet supported by Knights.
							</para>
							<para>
								Once you've selected the players, you'll want to select the time controls for this match. <menuchoice><guimenu>Base Time</guimenu></menuchoice> is the number of minutes that this player has at the beginning of the match. After you make a number of moves, you'll receive extra time on your clock. <menuchoice><guimenu>Moves Per Base Time</guimenu></menuchoice> controls the number of moves needed to receive that extra time. <menuchoice><guimenu>Increment Per Move</guimenu></menuchoice> is yet another time bonus that you receive after every move.
							</para>
					</sect2>
			</sect1>
		</chapter>

	<chapter id="online">
		<title>Using Knights Online</title>
		<para>
			Knights can connect you with thousands of other chess players around the globe. You can play games, observe others playing, attend live classes, or just relax and chat.
		</para>
		<para>
			Although Knights tries to make it easy to use a chess server, there are many commands and functions for each server that are beyond the scope of this document. You should check with the chess server you intend to use for a full description of these.
		</para>
		<sect1 id="getting-started-online">
			<title>Getting Started</title>
			<para>
				If you used the Setup Wizard when you first installed Knights, then Knights will connect to the <ulink url="http://www.freechess.org">Free Internet Chess Server</ulink> by default. If you did not use the Setup Wizard, or you'd prefer to connect to another chess server, you'll need to change Knights' settings. See the section of this document titled <link linkend="configure-servers">Chess Servers</link> for instructions on doing this.
			</para>
			<para>
				Your computer will need to be connected to the Internet before you attempt to connect to a chess server. Knights will display an error message if it can not access the Internet.
			</para>
			<para>
				Some chess servers will require you to have a membership, which sometimes includes paying a membership fee. You will need to visit the website of your chosen chess server to sign up for membership.
			</para>
			<para>
				If you are not interested in obtaining a membership, but you still want to play chess online, some chess servers will allow you to play as a free guest without signing up for anything. This is strongly suggested for those who have never played chess online before.
			</para>
			<sect2 id="getting-started-online-connecting">
				<title>Connecting to a Server</title>
					<para>
						To connect to a chess server, click on <menuchoice><guimenu>File</guimenu></menuchoice>, and then select <menuchoice><guimenuitem>Connect to Server</guimenuitem></menuchoice>.
					</para>
					<para>
						A new window will pop up asking for your <menuchoice><guimenu>Login</guimenu></menuchoice> and <menuchoice><guimenu>Password</guimenu></menuchoice>. You should have recieved these when you signed up for membership with this chess server. If you do not have a membership yet, click on the <menuchoice><guimenu>Log in as guest</guimenu></menuchoice> option.
					</para>
			</sect2>
		</sect1>
		<sect1 id="online-tools">
			<title>Online Tools</title>
			<para>
				Once Knights has established a connection with your chosen chess server, several new tools will be displayed to help you make the most of your time online.
			</para>
			<sect2 id="online-tools-console">
				<title>The Console</title>
					<para>
						The Console is your primary communications tool while you're online. All of the messages that are sent to you are displayed here.
					</para>
					<para>
						Messages can be colored differently depending on the type of message. For example, a message from a chat channel may be displayed in blue, while message sent specifically to you may be in green. These colors ( and fonts ) may be customized by going to <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Knights...</guimenuitem></menuchoice>. Then click on <menuchoice><guimenu>Display</guimenu></menuchoice>, and then the <menuchoice><guimenu>Console</guimenu></menuchoice> tab.
					</para>
					<para>
						This is also where you send your messages out. Just start typing on your keyboard to write a message, and press <keycombo action="simul"><keycap>Enter</keycap></keycombo> to send it. Knights will remember the last 100 messages you sent out, which you can access by pressing <keycombo action="simul"><keycap>SHIFT + UP</keycap></keycombo> and <keycombo action="simul"><keycap>SHIFT + DOWN</keycap></keycombo>.
					</para>
					<para>
						There are several shortcuts available for the most commonly used server commands. To see a list of these, your should read the section of this document titled <link linkend="key-bindings">Command Reference</link>.
					</para>
			</sect2>
			<sect2 id="online-tools-sought-list">
				<title>The Sought Games List</title>
					<para>
						Ok, you've connected to a chess server. Now how do you play chess on it?
					</para>
					<para>
						The Sought Games List will help. Right click on it, and select <menuchoice><guimenu>Seek Matches</guimenu></menuchoice>. A list of other players, who are also interested in playing a game of chess, will appear. When you find one you like, simply left click on it to start playing.
					</para>
					<para>
						As you'll notice, there are a number of actions you can take when you right click on a match. They are:
					</para>
					<itemizedlist>
						<listitem>
							<para>
								<menuchoice><guimenu>Tell...</guimenu></menuchoice> will begin a private message between you and the player offering this match. Simply select this and type your message.
							</para>
						</listitem>
						<listitem>
							<para>
								<menuchoice><guimenu>Assess</guimenu></menuchoice> will display a graph that shows you how your rating will be effected if you play a match against this opponent.
							</para>
						</listitem>
						<listitem>
							<para>
								<menuchoice><guimenu>Player Info</guimenu></menuchoice>, otherwise known as "Finger", will display a wealth of information about this player. This information can include how long the player has been online, his rating for different types of chess matches, win/loss statistics, etc.
							</para>
						</listitem>
						<listitem>
							<para>
								<menuchoice><guimenu>Player History</guimenu></menuchoice> shows the results of the last 14 or so games played by this opponent. There are columns in the history display for the players and their ratings (as adjusted by the result of the match), the winner, the type of match (blitz/standard, rated/unrated) and the date.
							</para>
						</listitem>
						<listitem>
							<para>
								<menuchoice><guimenu>Add to Friends</guimenu></menuchoice> tells your ICS that you want to be notified whenever this player logs on and off the server. In the future, Knights will display your friends list so you can easily send them messages, observe their matches, and more.
							</para>
						</listitem>
						<listitem>
							<para>
								<menuchoice><guimenu>Ignore This Player</guimenu></menuchoice> keeps you from hearing anything this player says, including private messages.
							</para>
						</listitem>
					</itemizedlist>
			</sect2>
			<sect2 id="online-tools-sought-graph">
				<title>The Sought Games Graph</title>
					<para>
						The Sought Games Graph performs the same function as the Sought Games List, but with one difference: Instead of displaying a list of players, it displays a graph.
					</para>
					<para>
						Usually, when you're interested in playing a chess match, you already know how long you want the match to be, and you already know that you want to play against an opponent of a particular skill level. The graph is very useful for this, because it organizes the available games based on it's length, and on your opponent's strength.
					</para>
					<para>
						Stronger opponents are listed at the top of the graph, while weaker opponents are listed at the bottom. Shorter games are listed at the left, while longer games are listed at the right. Rated games are displayed using a solid square, while unrated games use a hollow square.
					</para>
					<para>
						Right clicking on a match will display the same menu used in the Sought Games List. That menu includes:
					</para>
					<itemizedlist>
						<listitem>
							<para>
								<menuchoice><guimenu>Tell...</guimenu></menuchoice> will begin a private message between you and the player offering this match. Simply select this and type your message.
							</para>
						</listitem>
						<listitem>
							<para>
								<menuchoice><guimenu>Assess</guimenu></menuchoice> will display a graph that shows you how your rating will be effected if you play a match against this opponent.
							</para>
						</listitem>
						<listitem>
							<para>
								<menuchoice><guimenu>Player Info</guimenu></menuchoice>, otherwise known as "Finger", will display a wealth of information about this player. This information can include how long the player has been online, his rating for different types of chess matches, win/loss statistics, etc.
							</para>
						</listitem>
						<listitem>
							<para>
								<menuchoice><guimenu>Player History</guimenu></menuchoice> shows the results of the last 14 or so games played by this opponent. There are columns in the history display for the players and their ratings (as adjusted by the result of the match), the winner, the type of match (blitz/standard, rated/unrated) and the date.
							</para>
						</listitem>
						<listitem>
							<para>
								<menuchoice><guimenu>Add to Friends</guimenu></menuchoice> tells your ICS that you want to be notified whenever this player logs on and off the server. In the future, Knights will display your friends list so you can easily send them messages, observe their matches, and more.
							</para>
						</listitem>
						<listitem>
							<para>
								<menuchoice><guimenu>Ignore This Player</guimenu></menuchoice> keeps you from hearing anything this player says, including private messages.
							</para>
						</listitem>
					</itemizedlist>
			</sect2>
		</sect1>
	</chapter>

	<chapter id="organizing-tabs">
		<title>Organizing Your Tabs</title>
		<para>
			Knights often must display more than just the chessboard. For example, when you play chess online, Knights must open up a new window containing several new tools. These tools are stacked on top of each other using tabs to help keep your desktop from getting too cluttered, but what if you want to see more than one of these tools at a time?
		</para>
		<para>
				At the top of each tab, you'll find a Grip widget. It looks like three horizontal lines, and when you move your pointer over it, the pointer will change into four arrows. When this happens, you can click and drag that tab to a different position on the screen. If you drag it to another tab, then they will merge together into the same window. If you do not drag it onto another tab, it will create it's own window at the new location.
		</para>
		<para>
			To the right of the Grip is a Close button. Clicking on this button will close out this Tab. If this was the only Tab in it's window, then the window will be closed as well.
		</para>
		<note>
			<para>
				Whenever a tab is closed, Knights will remember the size of that tab.
			</para>
		</note>
	</chapter>

	<chapter id="configure">
		<title>Settings</title>
		<para>
			One of our primary goals is to make Knights easy to setup and customize. When you need to customize Knights, select <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Knights...</guimenuitem></menuchoice>. A new window will be displayed. The following sections describe the various options available from this new window.
		</para>
		<sect1 id="configure-general">
			<title>General</title>
				<para>
					<menuchoice><guimenu>Your Name</guimenu></menuchoice> is the name Knights records on saved games for you.
				</para>
				<para>
					<menuchoice><guimenu>When Knights Begins It Should:</guimenu></menuchoice> This allows you to customize Knights' behavior when you run the program.
				</para>
				<para>
					<menuchoice><guimenu>Save Match on Close?</guimenu></menuchoice> When you close a chess match, Knights can automatically save it for you. If this match doesn't yet have a file name, you will be prompted for one.
				</para>
				<para>
					The <menuchoice><guimenu>Append to Save File</guimenu></menuchoice> option tells Knights that you wish to save all your games to a single pgn file. This is useful for players who wish to analyze their matches later in a chess database program like <ulink url="http://scid.sourceforge.net/">SCID</ulink>.
				</para>
				<para>
					<menuchoice><guimenu>Pause on Minimize</guimenu></menuchoice> This will cause Knights to pause all your matches when you minimize the Knights window.
				</para>
				<note>
					<para>
						Some types of matches ( like matches on <acronym>ICS</acronym> ) can not be paused in this way.
					</para>
				</note>
				<para>
					<menuchoice><guimenu>Always Promote to Queen</guimenu></menuchoice> When checked, any of your pawns that get promoted will automatically become a queen. Otherwise Knights will prompt you each time a pawn is promoted.
				</para>
				<para>
					<menuchoice><guimenu>Call Flag Automatically</guimenu></menuchoice> This option will automatically declare you the winner of the match if your opponent's clock runs out of time.
				</para>
				<para>
					<menuchoice><guimenu>Delete Log Files on Exit</guimenu></menuchoice> If set, chess engine log files will be deleted on exit. Only files named "game.###" and "log.###" placed in the user home folder will be removed
				</para>
		</sect1>
		<sect1 id="configure-display">
			<title>Display</title>
			<sect2 id="configure-display-general">
				<title>General</title>
				<para>
					Use the <menuchoice><guimenu>Install New Themes</guimenu></menuchoice> button to install themes that you've downloaded.
				</para>
				<para>
					Use the <menuchoice><guimenu>Board Themes</guimenu></menuchoice> and <menuchoice><guimenu>Chessman Themes</guimenu></menuchoice> buttons to select the look of your board. Knights only includes one board theme and one chessman theme, but others are available for download.<ulink url="http://sourceforge.net/project/showfiles.php?group_id=31461">Click here</ulink> to download the Knights Themepack.
				</para>
				<para>
					<menuchoice><guimenu>Theme Size</guimenu></menuchoice> can be adjusted to make the board larger or smaller.
				</para>
				<para>
					Using the <menuchoice><guimenu>Reverse Board Orientation</guimenu></menuchoice> option is like turning the chessboard 180 degrees. Normally, the board is displayed with your army on the bottom and your opponent's army on top. Checking this option puts your army on the top and your opponent's army on the bottom.
				</para>
				<para>
					<menuchoice><guimenu>Display Startup Logo</guimenu></menuchoice> toggles the welcome screen.
				</para>
				<para>
					<menuchoice><guimenu>Automatic Preview</guimenu></menuchoice> will enable the Preview feature for the left mouse button.
				</para>
				<para>
					<menuchoice><guimenu>Show Last Move</guimenu></menuchoice> will highlight the chessman that moved on the previous turn.
				</para>
				<para>
					<menuchoice><guimenu>Show Coordinates</guimenu></menuchoice> will draw the Rank and File coordinates on the board.
				</para>
			</sect2>
			<sect2 id="configure-display-console">
				<title>Console</title>
				<para>
					The Font buttons allow you to alter the font for each different kind of text displayed on the console. The Color buttons beside them let you change the color which that font will be displayed in. The seventh extra Color button changes the background color.
				</para>
				<para>
					<menuchoice><guimenu>Restore Defaults</guimenu></menuchoice> will disregard any changes you've made to the font and color options, returning them to their original state.
				</para>
			</sect2>
		</sect1>
		<sect1 id="configure-audio">
			<title>Audio</title>
			<para>
				Knights uses sounds to keep you informed of important events both on and off the board. For example, Knights can play a sound when a chessman is moved, or play another sound when someone sends you a private message online. This section describes the different options you have when it comes to Knights' sounds.
			</para>
			<para>
				The <menuchoice><guimenu>enable Audio</guimenu></menuchoice> checkbox is like the power button on your stereo. Uncheck this, and all of Knights' sounds are turned off.
			</para>
			<para>
				<menuchoice><guimenu>Audio Themes</guimenu></menuchoice> allows you to choose between different audio themes, which are similar to the graphical themes. Knights only includes one sound theme, but others may be available for download from the internet.
			</para>
			<para>
				The <menuchoice><guimenu>Volume</guimenu></menuchoice> slider allows you to adjust how loudly Knights will play it's sounds.
			</para>
			<note>
				<para>
					This is independent of the volume controls in your mixer and on your speakers. In other words, if the volume in Knights is at maximum, but your mixer's volume is at minimum, then you will not be able to hear Knights' sounds.
				</para>
			</note>
			<para>
				<menuchoice><guimenu>For Current Match Only</guimenu></menuchoice> is a checkbox that allows you to turn off all sounds from chess matches that you are not actively watching. So if you have a match vs. GNUChess running, but you're looking at your match vs. Crafty, only the Crafty match will make sounds. When you click on the GNUChess match again, then it will make sounds again and the Crafty match will fall silent.
			</para>
		</sect1>
		<sect1 id="configure-engines">
			<title>Computer Opponents</title>
			<para>
				Here you'll be able to configure Knights to use various "Chess Engines", which are computer opponents you can play chess against. These engines are separate programs that do not come with Knights. To use them, you must first download a chess engine. Tim Mann's <ulink url="http://www.tim-mann.org/engines.html">Chess Engines</ulink> page has a great list of available engines for you to download. Knights should work with all of these. See the README and INSTALL instructions that come with each engine to install it.
			</para>
			<para>
				Once you have a chess engine installed, click the <guimenu>Add...</guimenu> button on the right hand side of the window. A new window will be displayed.
			</para>
			<para>
				The only things that you MUST enter to use the engine are the <guimenu>Protocol</guimenu> and the <guimenu>Engine Filename</guimenu>.
			</para>
			<para>
				<guimenu>Engine Name</guimenu> is what Knights will call this engine when you select it as an opponent, or if there is an error. This is set for you if you leave it blank.
			</para>
			<para>
				<guimenu>Protocol</guimenu> is a list of "languages" that computer opponents can speak. Knights acts like a translator by taking what the engine says and converting it into a move on the virtual chessboard. It is important to have the correct protocol or else the engine won't be able to play.
			</para>
			<note>
				<para>
					For most engines, you should select XBoard as the protocol. The Knights protocol is reserved for future engines to use.
				</para>
			</note>
			<para>
				<guimenu>Engine Filename</guimenu> should contain the actual location of the engine on your filesystem. Include the full path, unless the engine is in the search path. If you don't want to type this in, you can browse your filesystem with the folder icon on the right. Simply find the engine, left click on it, and left click Open.
			</para>
			<para>
				<guimenu>Command Line Arguments</guimenu> is where you should add any special options for this engine. See the engine's documentation for a list of options and their useage.
			</para>
			<para>
				<guimenu>Log File</guimenu> is a special text document which records the "conversation" between Knights and the engine. This is very useful for engine developers and for users who are having trouble getting Knights to work with a particular engine. Most users can leave this blank.
			</para>
			<para>
				Click OK and Knights is now ready to use this engine!
			</para>
			<para>
				You'll notice options which enable "Book Engines". Book engines are a kind of helper for the computer opponent. These types of engines are new and experimental. Therefore, you should not enable these unless you are a chess engine developer or unless you're sure that the engine supports "Bookengine" mode ( XBoard version 3 and Knights protocols ).
			</para>
		</sect1>
		<sect1 id="configure-servers">
			<title>Chess Servers</title>
			<para>
				This section is where you'll configure all your options related to Internet Chess Servers.
			</para>
			<sect2 id="configure-servers-servers">
				<title>Servers</title>
				<para>
					If you'd like to configure Knights to use a new Chess Server, click the "Add..." button on the right hand side of the window. A new window will be displayed.
				</para>
				<para>
					This window is used to tell Knights how it can connect to our chess server. <menuchoice><guimenu>Server Name</guimenu></menuchoice> is a descriptive title for the server. You can enter anything you want here. "My Chess Server", "FICS", etc.
				</para>
				<para>
					<menuchoice><guimenu>Server URL</guimenu></menuchoice> is the address of the server.
				</para>
				<para>
					<menuchoice><guimenu>Server Port</guimenu></menuchoice> tells Knights which port to communicate with the server on. If this is left blank, Knights will try to guess the port number.
				</para>
				<para>
					<menuchoice><guimenu>Username</guimenu></menuchoice> and <menuchoice><guimenu>Password</guimenu></menuchoice> will store your login information. If you do not wish for Knights to remember your login information, just leave these blank and you will be prompted each time you connect.
				</para>
				<para>
					A <menuchoice><guimenu>Timeseal</guimenu></menuchoice> is a program that helps to reduce the effect of Internet lag on your clock. It can be quite unpleasant to lose a match because your Internet connection is slow. If you have a Timeseal program that you'd like to use, enter the full path and filename for it here.
				</para>
				<para>
					<menuchoice><guimenu>Log File</guimenu></menuchoice> can be used to keep a record of your session online. Be warned though: Knights does not maintain the size of your logfiles.
				</para>
				<para>
					When all is done you can click <menuchoice><guimenuitem>OK</guimenuitem></menuchoice> to add this chess server to the list of those Knights will connect with.
				</para>
			</sect2>
			<sect2 id="configure-servers-options">
				<title>Options</title>
				<para>
					The <menuchoice><guimenu>Profanity Filter</guimenu></menuchoice> can be used to garble undesirable words. It has six levels of filtration.
				</para>
				<para>
					<menuchoice><guimenu>Automatically Close Previous ICS Match</guimenu></menuchoice> does was it says. If you just played a match and you're starting a new one, Knights will go ahead and close the last one for you.
				</para>
				<para>
					<menuchoice><guimenu>Private Matches</guimenu></menuchoice> will tell your ICS that you don't want your match to be observable.
				</para>
				<para>
					The <menuchoice><guimenu>enable Premove</guimenu></menuchoice> option allows you to move your next chessman while it's still your opponent's turn. Knights will remember your selection and move the piece for you as soon as it's your turn again.
				</para>
				<para>
					The <menuchoice><guimenu>enable Kibitzes</guimenu></menuchoice> option will display Kibitz message on the console if enabled.
				</para>
				<para>
					<menuchoice><guimenu>enable Unregistered Tells</guimenu></menuchoice> will allow you to hear messages from unregistered users.
				</para>
				<para>
					<menuchoice><guimenu>enable Shouts</guimenu></menuchoice> will allow you to hear shouts.
				</para>
				<para>
					The <menuchoice><guimenu>enable Seeks</guimenu></menuchoice> option will display Sought Match messages.
				</para>
				<para>
					<menuchoice><guimenu>Seconds Between Seek Updates</guimenu></menuchoice> This tells Knights how often you want it to refresh it's Sought Games List. Valid numbers range between 3 seconds to 2 minutes ( 120 seconds ).
				</para>
			</sect2>
		</sect1>
	</chapter>

	<chapter id="key-bindings">
		<title>Command Reference</title>
		<itemizedlist>
			<listitem>
				<para>
					<keycombo action="simul"><keycap>UP</keycap></keycombo> - Pressing up will step backwards through the move list and show you the previous position.
				</para>
			</listitem>
			<listitem>
				<para>
					<keycombo action="simul"><keycap>DOWN</keycap></keycombo> - Pressing down will step forward through the move list and show you the next board position.
				</para>
			</listitem>
			<listitem>
				<para>
					<keycombo action="simul"><keycap>ENTER</keycap></keycombo> - Pressing Enter will always bring up the Console cursor so you can enter text. Pressing Enter again will remove it and send anything you typed in between.
				</para>
			</listitem>
			<listitem>
				<para>
					<keycombo action="simul"><keycap>PAGE UP</keycap></keycombo> and <keycombo action="simul"><keycap>PAGE DOWN</keycap></keycombo> - Pressing these keys will scroll the Console up and down.
				</para>
			</listitem>
			<listitem>
				<para>
					<keycombo action="simul"><keycap>SHIFT + UP</keycap></keycombo> and <keycombo action="simul"><keycap>SHIFT + DOWN</keycap></keycombo> - These will scroll through the history of what you've typed previously. Very handy for repeating commands.
				</para>
			</listitem>
			<listitem>
				<para>
					<keycombo action="simul"><keycap>ALT + C</keycap></keycombo> - This will begin a reply to the last channel who sent you a tell.
				</para>
			</listitem>
			<listitem>
				<para>
					<keycombo action="simul"><keycap>ALT + K</keycap></keycombo> - This will begin a kibitz, which can be heard by everyone observing a match, including the players.
				</para>
			</listitem>
			<listitem>
				<para>
					<keycombo action="simul"><keycap>ALT + R</keycap></keycombo> - This will begin a reply to the last person who sent you a private tell.
				</para>
			</listitem>
			<listitem>
				<para>
					<keycombo action="simul"><keycap>ALT + W</keycap></keycombo> - This will begin a whisper, which can be heard by everyone observing the current match, but not by the players of that match.
				</para>
			</listitem>
		</itemizedlist>
	</chapter>

	<chapter id="credits">
		<title>Credits and License</title>
		<para>
			Knights
		</para>
		<para>
			Program copyright 2001, 2002 Troy Corbin Jr. <email>tcorbin@users.sf.net</email>
		</para>
		<para>
			Documentation copyright 2001, 2002 Troy Corbin Jr. <email>tcorbin@users.sf.net</email>
		</para>
		<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
		&underFDL;
		&underGPL;
	</chapter>

	<appendix id="installation">
		<title>Installation</title>
		<sect1 id="installation-obtain-knights">
			<title>How to obtain Knights</title>
			<para>
				The Knights Project is located at <ulink url="http://knights.sourceforge.net/">http://knights.sourceforge.net</ulink>. It will usually contain the most up-to-date information on Knights available.
			</para>
			<note>
				<para>
					If you're using the <ulink url="http://www.opennic.org/">OpenNIC</ulink> root service, then you can reach the Knights Project at <ulink url="http://www.knights.oss/">http://www.knights.oss</ulink>.
				</para>
			</note>
		</sect1>
		<sect1 id="installation-requirements">
			<title>Requirements</title>
			<para>
				Before you can install Knights, you must have the Trinity Desktop Environment installed on your system. Knights also requires that you have <ulink url="http://www.gnu.org/directory/Software_development/Program_build_automation/autoconf.html">Autoconf</ulink> version 2.5 and <ulink url="http://www.gnu.org/directory/Software_development/Program_build_automation/automake.html">Automake</ulink> version 1.6.
			</para>
		</sect1>
		<sect1 id="installation-compilation">
			<title>Compilation and Installation</title>
			<para>
				Knights uses <application>autoconf</application> and <application>automake</application> to ensure that compiling is easy. If for some reason Knights won't compile for you, help is available at the Knights Project website located at <ulink url="http://knights.sourceforge.net/">http://knights.sourceforge.net</ulink>.
			</para>
			<para>
				You must have the TDEDIR environment variable defined before you begin the installation. Without this, Knights will not be able to access it's resources! To add the TDEDIR environment variable, you need to edit your /etc/profile ( or ~/.bash_profile ) and add the line:
			</para>
			<para>
				<userinput><command>export TDEDIR="/usr"</command></userinput>
			</para>
			<para>
				...where /usr is your KDE's base directory.
			</para>
			<para>
				Now, change the present working directory to the location where you unarchived Knights and type the following:
			</para>
<informalexample>
<screen width="40">
<prompt>%</prompt> <userinput><command>./configure</command></userinput>
<prompt>%</prompt> <userinput><command>make</command></userinput>
<prompt>%</prompt> <userinput><command>make</command> <option>install</option></userinput>
</screen>
</informalexample>
			<para>
				Knights should now be installed and ready to go. You can type <userinput><command>knights</command></userinput> in a terminal to start the game, or create an icon for it and select that.
			</para>
		</sect1>
	</appendix>

	<appendix id="command-line">
		<title>Command Line Options</title>
		<para>
			Knights is a graphical chess interface and tries to make full use of it. Most every option you'd ever want should be available from Knights' Settings menu and Configure window. However, there are rare cases where a command line option is an absolute must. Here are descriptions for those options.
		</para>
<screen width="40">
<prompt>%</prompt> <userinput><command>knights</command> <option>-d <replaceable>path</replaceable></option></userinput>
</screen>
		<para>
			The use of this command line option is depreciated. If Knights displays garbage rather than a chessboard, then you did not set the TDEDIR environment variable correctly before compiling Knights. Please see the Installation instructions for the proper compiling procedures.
		</para>
<screen width="40">
<prompt>%</prompt> <userinput><command>knights</command> <option><replaceable>filename</replaceable></option></userinput>
</screen>
		<para>
			By appending a filename to the command line, you can start Knights with a chess match already loaded for you.
		</para>
	</appendix>

	<appendix id="kml">
		<title>Knights Markup Language</title>
		<para>
			The Knights Markup Language is a variation on HTML with the specific purpose of formatting and displaying PGN data. The formatting is actually done using Qt's default rich-text commands. Since these are already explained at length on Trolltech's <ulink url="http://doc.trolltech.com/3.1/qstylesheet.html#details">website</ulink>, they will not be covered here.
		</para>
		<para>
			This appendix lists the macros used within KML to represent PGN data. These macros are case-sensitive.
		</para>
		<para>
			<command>%whiteimage%</command> - This will be replaced with an image showing the white player's picture, or a generic image if Knights can't find it.
		</para>
		<para>
			<command>%blackimage%</command> - This will be replaced with an image showing the black player's picture, or a generic image if Knights can't find it.
		</para>
		<para>
			<command>%moves%</command> - This represents the move data. Recursive annotations appear in italics, while comments appear in bold type.
		</para>
		<para>
			<command>%site%</command> - Represents the PGN tag: Site.
		</para>
		<para>
			<command>%date%</command> - Represents the PGN tag: Date.
		</para>
		<para>
			<command>%round%</command> - Represents the PGN tag: Round.
		</para>
		<para>
			<command>%result%</command> - Represents the PGN tag: Result.
		</para>
		<para>
			<command>%white%</command> - Represents the PGN tag: White.
		</para>
		<para>
			<command>%whitetitle%</command> - Represents the PGN tag: White Title.
		</para>
		<para>
			<command>%whiteelo%</command> - Represents the PGN tag: White ELO.
		</para>
		<para>
			<command>%whiteuscf%</command> - Represents the PGN tag: White USCF.
		</para>
		<para>
			<command>%whitena%</command> - Represents the PGN tag: White NA.
		</para>
		<para>
			<command>%whitetype%</command> - Represents the PGN tag: White Type.
		</para>
		<para>
			<command>%black%</command> - Represents the PGN tag: Black.
		</para>
		<para>
			<command>%blacktitle%</command> - Represents the PGN tag: Black Title.
		</para>
		<para>
			<command>%blackelo%</command> - Represents the PGN tag: Black ELO.
		</para>
		<para>
			<command>%blackuscf%</command> - Represents the PGN tag: Black USCF.
		</para>
		<para>
			<command>%blackna%</command> - Represents the PGN tag: Black NA.
		</para>
		<para>
			<command>%blacktype%</command> - Represents the PGN tag: Black Type.
		</para>
		<para>
			<command>%time%</command> - Represents the PGN tag: Time.
		</para>
		<para>
			<command>%utctime%</command> - Represents the PGN tag: UTC Time.
		</para>
		<para>
			<command>%utcdate%</command> - Represents the PGN tag: UTC Date.
		</para>
		<para>
			<command>%event%</command> - Represents the PGN tag: Event.
		</para>
		<para>
			<command>%eventdate%</command> - Represents the PGN tag: Event Date.
		</para>
		<para>
			<command>%eventsponsor%</command> - Represents the PGN tag: Event Sponsor.
		</para>
		<para>
			<command>%section%</command> - Represents the PGN tag: Section.
		</para>
		<para>
			<command>%stage%</command> - Represents the PGN tag: Stage.
		</para>
		<para>
			<command>%board%</command> - Represents the PGN tag: Board.
		</para>
		<para>
			<command>%opening%</command> - Represents the PGN tag: Opening.
		</para>
		<para>
			<command>%variation%</command> - Represents the PGN tag: Variation.
		</para>
		<para>
			<command>%subvariation%</command> - Represents the PGN tag: Subvariation.
		</para>
		<para>
			<command>%eco%</command> - Represents the PGN tag: ECO.
		</para>
		<para>
			<command>%nic%</command> - Represents the PGN tag: NIC.
		</para>
		<para>
			<command>%timecontrol%</command> - Represents the PGN tag: Time Control.
		</para>
		<para>
			<command>%termination%</command> - Represents the PGN tag: Termination.
		</para>
		<para>
			<command>%setup%</command> - Represents the PGN tag: Setup.
		</para>
		<para>
			<command>%fen%</command> - Represents the PGN tag: FEN.
		</para>
		<para>
			<command>%annotator%</command> - Represents the PGN tag: Annotator.
		</para>
		<para>
			<command>%mode%</command> - Represents the PGN tag: Mode.
		</para>
		<para>
			<command>%plycount%</command> - Represents the PGN tag: Plycount.
		</para>
	</appendix>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->