Navigation

← Previous Changeset
Next Changeset →

Changeset 90

Timestamp:

03/16/04 21:14:45 (5 years ago)

Author:

Message:

Updated tutorial

Files:

06/devel/doc/tutorial.html (modified) (70 diffs)

Legend:

: Unmodified
: Added
: Removed
: Modified
: Copied
: Moved

06/devel/doc/tutorial.html

r58	r90
19	19
20	20	<H1>Tutorial</H1>
21		<img src="logosmall.jpg" align=RIGHT>
22		This tutorial explains how to use Kombilo 0.5. If you are just looking
	21	<p><img src="logosmall.jpg" align=RIGHT>
	22	This tutorial explains how to use Kombilo 0.6. If you are just looking
23	23	for more information on this program before downloading it,
24		you should find it here too.<p>
	24	you should find it here too.</p>
25	25
26	26	<div style="border:none; padding:3px; width:600px;
27	27	background-color:#CCCCCC; z-index:1">
28		<font size="4"><b>Contents</b></font></div><p>
29
30		<a href="#newin05">New features in version 0.5</a><br>
	28	<font size="4"><b>Contents</b></font></div>
	29
	30	<p>
	31	<a href="#newin05">New features in version 0.6</a><br>
31	32	<a href="#gettingstarted">Getting started</a><br>
32	33	<a href="#firstsearch">The first search</a><br>
…	…
47	48	<a href="#tipsandtricks">Tips and tricks</a><br>
48	49	<a href="#searchalgorithm">The search algorithm</a><br>
	50	<a href="#automatic">Automatizing pattern searches</a><br>
49	51	<a href="#index">Index</a><br>
50		<p>
	52	</p>
51	53
52	54	<div style="border:none; padding:3px; width:600px;
53	55	background-color:#99CCCC; z-index:1">
54	56	<a name="newin05"><font size="4"><b>New features in
55		version 0.5</b></font></a></div><p>
56
57		<ul>
58
59		<li> Kombilo comes with a complete SGF editor: so you can add variations of
60		your own, comment the game, add labels etc. The SGF editor can also
61		handle collections, i.e. SGF files containing several games. The tree
62		structure of the current game is shown in a separate window. You can
63		rotate/mirror SGF files.
64
65		<li> Kombilo now comes with a built in list of references to commentaries
66		of games in the English go literature. (NB: Kombilo does not come with
67		the game records, but recognizes the games by the Dyer signature.) Those
68		games in your database which Kombilo finds in its list are marked in the
69		game list, and in the game info a reference to the journal/book which has
70		the commentary is given. Currently the list contains around 1200
71		references, and includes references to the game commentaries in 85 issues
72		of Go World and in most English go books with game comentaries.
73
74		Any <a href="#references">help with extending the list</a> is
75		appreciated.
76
77		<li> The previous search patterns are now shown on small boards in a
78		scrollable separate window. Thus you can switch back and forth between
79		different search patterns much more easily. This also works much better
80		now with different SGF files. In particular, you can load games from the
81		game list directly to the Kombilo main board, and then search for
82		patterns which arise in that game.
83
84		<li> You can sort the game list with respect to one of several criteria
85		(besides the default, sort by filename, you can now also sort by date,
86		white player or black player). You can also easily change the order of
87		the databases.
88
89		<li> You can refine pattern searches by filtering who moves next in the
90		search pattern.
91
92		<li> And, as always, several minor improvements, fixes and changes:
93		e.g. case-insensitive game info search; a "1-click mode" where every
94		click on the board triggers a new pattern search; exporting the current
95		position as an ASCII diagram; a "guess next move" mode.
96
97		<li> In order to install Kombilo, you can either use the installer (on Windows
98		systems), or install Python (version 2.1 or better) and Kombilo separately.
99		Since the user interface uses a few more fancy widgets, Kombilo now needs
100		the Python MegaWidgets (Pmw) library to be installed on your system. Of course,
101		Pmw comes with the Windows installer. But if you install(ed) Python separately,
102		you have to install Pmw, too. Similarly, if Kombilo finds the Python
103		Imaging Library (PIL) available, it will use (somewhat) more beautiful stones.
104		PIL comes with the Windows installer, but has to be installed separately
105		otherwise, if you want to use it. See the section on <a href="#installation">
106		installation</a> for more details.
107		</ul>
108		<p>
	57	version 0.6</b></font></a></div>
	58
	59	<p><ul>
	60	<li> Support of 9x9 and 13x13 boards
	61
	62	<li> Search for move sequences
	63
	64	<li> Much faster processing
	65
	66	<li> New search algorithm. ... thanks to Arend Bayer ...
	67
	68	<li> Black/empty and white/empty wildcards ... thanks to Arend Bayer
	69	...
	70
	71	<li> The whole source code of the program has been restructured. This
	72	will allow to add future changes much more easily. Furthermore, you can
	73	now easily write "scripts" to do <a href="automatic">pattern searches
	74	automatically</a>, for
	75	example to to research related to the development over time of certain
	76	patterns and their winning probabilities. There is one downside to
	77	all this: since there is so much new code, it is likely that there
	78	are also new bugs. Please help tracking them down, and report them
	79	in the <a href="http://www.u-go.net/kombilo/tracker">Kombilo bug
	80	tracker</a>.
	81	</ul></p>
109	82
110	83	<div style="border:none; padding:3px; width:600px;
111	84	background-color:#99CCCC; z-index:1">
112	85	<a name="gettingstarted"><font size=4><b>Getting started</b></font></a>
113		</div><p>
114
	86	</div>
	87
	88	<p>
115	89	After <a href="#installation">installing</a> Kombilo, you should
116		execute the file 'kombilo.py' (~~or,~~ under Windows: 'kombilo.pyw'
117		(if you downloaded Python separately) ~~respectively 'kombilo.exe'~~,
	90	execute the file 'kombilo.py' (under Windows: 'kombilo.pyw'
	91	(if you downloaded Python separately) or 'kombilo.exe', respectively,
118	92	if you used the installer).
119	93
…	…
122	96	window with an (initially empty) game list, and some buttons for
123	97	the search function, and the data window which contains several lists and
124		buttons related to the SGF editor.<p>
	98	buttons related to the SGF editor.</p>
125	99
126	100	<IMG SRC="mainwindow.jpg">
127	101	<IMG SRC="gamelistwindow.jpg">
128		<IMG SRC="datawindow.jpg"><p>
129
	102	<IMG SRC="datawindow.jpg">
	103
	104	<p>
130	105	The first thing you have to do now is to add a database to the
131	106	database list; choose the 'Edit DB list' command in the File menu.<p>
…	…
133	108	files in that directory. Kombilo does not come with any games. You can
134	109	either
135		<a href="../go/index.html">download a game collection</a> from the net, or buy a commercial one.<p>
136		See also the section <a href="#requirements">requirements on SGF files</a>
	110	<a href="http://www.u-go.net/gamerecords/">download a game collection</a>
	111	from the net, or buy a commercial one.<p>
	112	See also the section about <a href="#requirements">requirements on SGF files</a>
137	113	in order to understand which kind of SGF files the program can handle;
138	114	basically, it handles simple game records, they may contain
139	115	variations, but the variations are ignored for the search.
140		<p>
141
142		<IMG SRC="editdblist.jpg">~~<p>~~
143
144		When you add a directory for the first time, the SGF files will
	116	</p>
	117
	118	<IMG SRC="editdblist.jpg">
	119
	120	<p>When you add a directory for the first time, the SGF files will
145	121	be 'translated' into a format that makes the search more efficient.
146	122	This processing takes quite some time; if you have thousands of games,
…	…
149	125	data will be written to several .db files in the same directory.
150	126	Look <a href="#editDBlist">here</a> for more information on the
151		buttons in this window.<p>
152
153		Of course the sgf files remain in the directory, and Kombilo will never
154		change them (unless you change the game info or edit the games~~, of course).~~
155		After the processing, the pattern search function actually
	127	buttons in this window.</p>
	128
	129	<p>Of course the sgf files remain in the directory, and Kombilo will never
	130	change them (unless you change the game info or edit the games yourself,
	131	of course). After the processing, the pattern search function actually
156	132	does not use them anymore, but they are needed for the game info search
157	133	and if you want to play through games with the SGF viewer.
158		<p>
159
160		<b><a name="oldTknote">Note:</a></b> (As far as I can tell, this is not an
	134	</p>
	135
	136	<p><b><a name="oldTknote">Note:</a></b> (As far as I can tell, this is not an
161	137	issue anymore with recent Python versions; in particular if you used the
162	138	Windows installer, you should be fine.) In some Python versions the widget
…	…
178	154	you have to copy any file to that directory first. Don't take
179	155	an sgf file because (probably) you don't want that sgf file to
180		show up in the database.)<p>
	156	show up in the database.)</p>
181	157
182	158	<div style="border:none; padding:3px; width:600px;
183	159	background-color:#99CCCC; z-index:1">
184	160	<a name="firstsearch"><font size="4"><b>The first search</b></font></a>
185		</div><p>
186
	161	</div>
	162
	163	<p>
187	164	<table border="0" width="100" cellpadding="6" align=RIGHT>
188	165	<tr><td><IMG SRC="expl_basic.jpg"></td></tr>
…	…
204	181	stones on the main board, on the other hand all games will be found which feature
205	182	the given pattern in the relevant region, no matter what else is on the board.
206		Of course, mirroring and rotating the board is automatically taken into account.<p>
207		<img src="onepixel.gif" width="600" height="20">
	183	Of course, mirroring and rotating the board is automatically taken into account.</p>
208	184
209	185	<table border="0" width="100" cellpadding="6" align=RIGHT>
…	…
213	189	</table>
214	190
215		When no region is selected, the whole board is relevant.<br>
	191	<p>When no region is selected, the whole board is relevant.<br>
216	192
217	193	After defining the pattern and the relevant region, just press the search button
…	…
220	196	given pattern occurs will be inserted again. In order to go back to the
221	197	complete game list, use the "reset game list" button in the first row of
222		the "Pattern search" window.<p>
223
224		If you click on a game in the game list, the game info (players, result, komi,
225		event, date etc.) is displayed below the game list.<p>
226		<IMG SRC="results.jpg">~~<p>~~
227		By double-clicking on a game in the game list, you load the game to the
	198	the "Pattern search" window.</p>
	199
	200	<p>If you click on a game in the game list, the game info (players, result, komi,
	201	event, date etc.) is displayed below the game list.</p>
	202	<IMG SRC="results.jpg">
	203	<p>By double-clicking on a game in the game list, you load the game to the
228	204	SGF editor and you can look at that game. You can also start the viewer by
229	205	selecting a game (by a single click) and pressing the return key.
230	206	If you prefer to open the game in a new window, use Shift-Click instead of
231	207	double-clicking; cf. the <a href="#externalviewer">Open game in external viewer</a>
232		option.
233		~~(If you like, you can use your customary SGF editor instead of~~ the simple SGF viewer coming with Kombilo;
	208	option. (If you like, you can use your customary SGF editor instead of
	209	the simple SGF viewer coming with Kombilo;
234	210	use the 'Alternative SGF viewer' command in the Options menu.
235		(Linux/Windows only,I think)) <p>
	211	(Linux/Windows only,I think)) </p>
	212
	213	<p>
236	214	By clicking on a game with the right mouse key, a window will pop up
237		where the complete game info is displayed, and can be edited.<p>
238
	215	where the complete game info is displayed, and can be edited.</p>
	216
	217	<p>
239	218	Furthermore, below the game list some statistics will be shown about the
240	219	continuations in the given position.
…	…
263	242	not given, but of course (neglecting jigos etc.) it will be
264	243	100% - black winning percentage.<br>
265
	244	</p>
	245
	246	<p>
266	247	You can disable the 'show tenuki' feature by setting the colors
267	248	used for it to white resp. black in the Options menu (Advanced -
…	…
273	254	labels present in the search pattern: in that case Kombilo will use those
274	255	labels to refer to the same intersections, and thus will not sort by
275		frequency.)<p>
276
277		<IMG SRC="joseki_dict.jpg" align="right"><p>
	256	frequency.)</p>
	257
	258	<IMG SRC="joseki_dict.jpg" align="right">
	259
	260	<p>
278	261	If you have a sufficient number of games in your databases,
279	262	this lets you create fuseki and joseki
…	…
282	265	The color of the label indicates whether black or white (or both,
283	266	depending on the game, in case of the gray labels) played on this point.
	267	</p>
	268
284	269	<p>
285
286
287	270	After a search, you can clear the board with the 'start' button above the board.
288	271	You can reset the game list (such that it contains all the games again) with the
289	272	"reset game list" button in the pattern search window (left of the statistics
290	273	display). In the file menu, you can also choose to do a "complete reset" - that will
291		reset Kombilo to the state right after it started up.
	274	reset Kombilo to the state right after it started up.</p>
292	275
293	276
…	…
295	278	background-color:#99CCCC; z-index:1"><a name="moresearchpatterns">
296	279	<font size="4"><b>More complicated search patterns</b>
297		</font></a></div>~~<p>~~
298
299		There are several buttons to customize the search in the game list
	280	</font></a></div>
	281
	282	<p>There are several buttons to customize the search in the game list
300	283	window:
301	284	<img src="searchoptions.jpg" align="left" vspace=10 hspace=10>
…	…
310	293	Furthermore, for a pattern on the edge or in the middle of the board,
311	294	the program also looks for translations; this can be disabled
312		by the 'fixed anchor' option.<p>
313
314		With the "black/white", "black" and "white" buttons in the line below
	295	by the 'fixed anchor' option.</p>
	296
	297	<p>With the "black/white", "black" and "white" buttons in the line below
315	298	you can limit the search to patterns where black plays next or
316	299	white plays next. This is sometimes useful, in particular for joseki
…	…
319	302
320	303	Finally, you can impose a move limit, such that only games
321		are found where the pattern occurs before the given limit.<p>
322
	304	are found where the pattern occurs before the given limit.</p>
	305
	306	<p>
323	307	You can also add wildcards to the search pattern, by shift-clicking on
324	308	some point. These will be marked by small green circles, and mean that
325	309	in the search these points may be either empty or contain a stone of
326		either color.<p>
327
328		~~For example, the following pattern finds all kos (that are not on the edge):<~~p>
329
330		<~~IMG SRC="search_patt_ko.jpg"><~~p>
	310	either color.</p>
	311
	312	<p>For example, the following pattern finds all kos (that are not on the edge):</p>
	313
	314	<p><IMG SRC="search_patt_ko.jpg"></p>
331	315
332	316	<div style="border:none; padding:3px; width:600px;
333	317	background-color:#99CCCC; z-index:1">
334	318	<a name="sgfeditor"><font size="4"><b>The SGF editor</b></font>
335		</a></div>~~<p>~~
336
337		You place stones by clicking (with the left mouse key) on an
	319	</a></div>
	320
	321	<p>You place stones by clicking (with the left mouse key) on an
338	322	intersection. The four left-most buttons above the board control if you
339	323	play black/white (resp. white/black) stones alternatingly, or if you place
340		black (resp. white) stones, in order to set up a position.<p>
341
342		In order to delete stones or to place labels, you have to select the
	324	black (resp. white) stones, in order to set up a position.</p>
	325
	326	<p>In order to delete stones or to place labels, you have to select the
343	327	appropriate tool among the 'edit tools' in the data window. Then you can
344	328	perform the corresponding operation by holding down the Control key and
345		clicking on an intersection.<p>
346
347		With Shift + right-click you can go to the node where some move was/will
348		be played.<p>
349
350		Kombilo's main board has two more features which are related to the pattern
	329	clicking on an intersection.</p>
	330
	331	<p>With Shift + right-click you can go to the node where some move was/will
	332	be played.</p>
	333
	334	<p>Kombilo's main board has two more features which are related to the pattern
351	335	search: You can place wildcards on the board (resp. delete them) by
352	336	shift+click, and you can select the relevant area for the pattern search by
353		clicking the right mouse key, and dragging.<p>
354
355		The navigation keys above the board let you move around in the current game
	337	clicking the right mouse key, and dragging.</p>
	338
	339	<p>The navigation keys above the board let you move around in the current game
356	340	record: one move back, one move forward, 10 moves back, 10 moves forward,
357	341	to the beginning resp. to the end of the current game. All these can also
358		be done by <b>using keys</b>: left, right, up, down, home, end.<p>
359
360		~~In order to <b>clear the board</b>, use the "start" button.<~~p>
361
362		If the current SGF file contains variations, you can switch between the
363		alternatives for the current move with the PageUp and PageDown keys.<p>
	342	be done by <b>using keys</b>: left, right, up, down, home, end.</p>
	343
	344	<p>In order to <b>clear the board</b>, use the "start" button.</p>
	345
	346	<p>If the current SGF file contains variations, you can switch between the
	347	alternatives for the current move with the PageUp and PageDown keys.</p>
364	348
365	349	<IMG SRC="boardbuttons.jpg" ALIGN=RIGHT>
366	350
367		~~Pass: Insert a pass move.<~~p>
368
369		Game info: View/edit the game information which is stored in the root node
	351	<p>Pass: Insert a pass move.</p>
	352
	353	<p>Game info: View/edit the game information which is stored in the root node
370	354	of the current game (black/white players, ranks, result, komi, date, rules,
371		etc.)<p>
372
373		~~DATA: Open/withdraw the data window.<~~p>
	355	etc.)</p>
	356
	357	<p>DATA: Open/withdraw the data window.</p>
374	358
375	359
376	360	<h3><a name="datawindow">The data window</a></h3>
377	361
378		In the toolbar at the top you can choose which of the following frames you
	362	<p>In the toolbar at the top you can choose which of the following frames you
379	363	actually want to see. For example, if your SGF files all contain only one
380	364	game each, you will not need the game list. Thus you can save some space on
381		your screen by hiding some of the components of the data window.<p>
382
383		<~~b>File list</b><~~p>
384
385		<~~IMG SRC="filelist.jpg" ALIGN~~=RIGHT>
	365	your screen by hiding some of the components of the data window.</p>
	366
	367	<p><b>File list</b></p>
	368
	369	<p><img src="filelist.jpg" align=RIGHT>
386	370	This is a list of all SGF files that have been loaded during the current
387	371	session. The currently active file is highlighted; you can change that by
…	…
392	376	split an SGF file which contains several games into many files with one
393	377	game each. You will be asked for a filename, and the files will then be
394		saved under the names filename0.sgf, filename1.sgf, filename2.sgf, etc.<p>
395
396		If changes have been made to a file after it has been saved, the file name
	378	saved under the names filename0.sgf, filename1.sgf, filename2.sgf, etc.</p>
	379
	380	<p>If changes have been made to a file after it has been saved, the file name
397	381	is preceded by a *. Kombilo will never ask you if you want to save the
398	382	changes, so you have to pay attention to the *, and save the files
399		yourself, if you want to keep the changes!<p>
400
401		<~~b>Game list</b><~~p>
402
403		<~~IMG SRC~~="gamelist.jpg" align=RIGHT>
	383	yourself, if you want to keep the changes!</p>
	384
	385	<p><b>Game list</b></p>
	386
	387	<p><img src="gamelist.jpg" align=RIGHT>
404	388	This is a list of game records in the current SGF file. You can select
405	389	games by clicking on them, and change the order by drag and drop.
406	390	The buttons on the right let you create new games and delete games from the
407		list.<p>
408
409		<~~b>Game info</b><~~p>
410
411		This shows part of the game information (names of players, result, date,
	391	list.</p>
	392
	393	<p><b>Game info</b></p>
	394
	395	<p>This shows part of the game information (names of players, result, date,
412	396	etc.) of the current game. In order to see the full game information, or to
413		edit it, use the "i" button above the go board.<p>
414
415		<b>Game tree</b><p>
416		<IMG SRC="gametree.jpg" ALIGN=RIGHT>
	397	edit it, use the "i" button above the go board.</p>
	398
	399	<p><b>Game tree</b></p>
	400
	401	<p><img src="gametree.jpg" align=RIGHT>
417	402	Here the tree structure of the current game is shown. Nodes with a
418	403	black/white move are shown black resp. white; others are red. Nodes with a
…	…
422	407	currently shown on the main board).<br>
423	408
424		By clicking on a node, you can go to the corresponding move.<p>
425
426		<~~b>Edit tools:</b><~~p>
427
428		The first few buttons in this frame control the behavior of Ctrl-click on
	409	By clicking on a node, you can go to the corresponding move.</p>
	410
	411	<p><b>Edit tools:</b></p>
	412
	413	<p>The first few buttons in this frame control the behavior of Ctrl-click on
429	414	<IMG SRC="edittools.jpg" ALIGN=RIGHT>
430	415	the board: you can either delete a stone or place/remove one of several types
…	…
432	417	nodes following it, and there are three buttons to mirror/rotate the current
433	418	SGF file. Finally there is the button to enter/leave the
434		<a href="#guessmode">guess mode</a>.
435		<p>
436
437		<b>Comments</b><p>
438		In this window the comments which the SGF file contains for the current node are
439		displayed.<p>
440
441		<~~b>Kombilo: Search history</b><~~p>
442
443		This frame contains a list of previous search patterns.
	419	<a href="#guessmode">guess mode</a>.</p>
	420
	421	<p><b>Comments</b></p>
	422
	423	<p>In this window the comments which the SGF file contains for the current node are
	424	displayed.</p>
	425
	426	<p><b>Kombilo: Search history</b></p>
	427
	428	<p>This frame contains a list of previous search patterns.
444	429	Click on one of the small boards to go back to the corresponding pattern
445	430	search (i.e. the pattern and the game list are restored to what they have
446		been right after the search).<p>
447
448		<~~IMG SRC="searchhistory.jpg" ALIGN~~=LEFT>
	431	been right after the search).</p>
	432
	433	<p><img src="searchhistory.jpg" align=LEFT>
449	434	A right-click on one of the board brings up a small menu, which lets you
450	435	delete that entry, put the entry on hold resp. release it. Since storing
…	…
454	439	<a href="#maxnumsearches">maximum number of searches which are remembered</a>.
455	440	Entries on hold will not be affected by this automatical deletion. These
456		entries are marked by a blue frame.<p>
	441	entries are marked by a blue frame.</p>
457	442
458	443	<div style="border:none; padding:3px; width:600px;
459	444	background-color:#99CCCC; z-index:1">
460	445	<a name="exportresults"><font size="4"><b>Export search results/current position/SGF</b></font>
461		</a></div>~~<p>~~
462
463		If you want to save some information on a pattern search, you
	446	</a></div>
	447
	448	<p>If you want to save some information on a pattern search, you
464	449	can use the 'Export search results' function in the File menu.
465	450	This will open a new window with a very simple text editor.
…	…
479	464	'Wiki' instead.
480	465	You can also choose if all continuations,
481		or if only ten of them should be displayed. <p>
482
483		The text editor has a button which lets you include the complete
	466	or if only ten of them should be displayed. </p>
	467
	468	<p>The text editor has a button which lets you include the complete
484	469	current game list (names of players, etc.).
485	470
…	…
490	475
491	476	Finally, you can also export the SGF source of the current game, in a text
492		editor.
	477	editor.</p>
493	478
494	479	<div style="border:none; padding:3px; width:600px;
…	…
496	481	<a name="gamelistwindow"><font size="4"><b>The game list
497	482	window</b></font></a>
498		</div>~~<p>~~
499
500		At the top, the game list window shows the number of games currently in the
	483	</div>
	484
	485	<p>At the top, the game list window shows the number of games currently in the
501	486	list, and the B/W winning percentages (the two numbers will often not
502	487	add up to 100% since there might be Jigo's, unfinished games etc.)
…	…
507	492
508	493	Below that, there is a "notebook" with one sheet each for the pattern
509		search and the game info search.
510
511		In the pattern search window, there are several buttons and switches. <br>
	494	search and the game info search.</p>
	495
	496	<p>In the pattern search window, there are several buttons and switches. <br>
512	497	<table border="0" width="100" cellpadding="6" align=RIGHT>
513	498	<tr><td><IMG SRC="backreset.jpg"></td></tr>
…	…
519	504
520	505	The 'reset' button serves to reset the game list, i.e. to put all
521		the games from the currently active databases in it, again.<p>
522
523		With the ABC button, you can display the labels showing the continuations
	506	the games from the currently active databases in it, again.</p>
	507
	508	<p>With the ABC button, you can display the labels showing the continuations
524	509	in the current search pattern (resp. remove them again).
525	510
…	…
536	521
537	522	Last but not least, in the game list window there is the
538		button to start a pattern search.
539
540		In the game info search window, you see entry fields for the search
	523	button to start a pattern search.</p>
	524
	525	<p>In the game info search window, you see entry fields for the search
541	526	criteria: white/black player, player, event, etc.
542	527
…	…
566	551
567	552	Finally there is the button to start a <a href="#sigsearch">signature
568		search</a>.<p>
569
570		<~~b><a name="references">References to commentaries</a></b><~~p>
571
572		Kombilo has built in a list of references to game commentaries in the
	553	search</a>.</p>
	554
	555	<p><b><a name="references">References to commentaries</a></b></p>
	556
	557	<p>Kombilo has built in a list of references to game commentaries in the
573	558	english go literature. The games are referenced by the Dyer signature (a
574	559	signature assigned to the game which encodes the positions of move 20, 40,
…	…
583	568	Currently, the list contains around 1200 references; in particular all but
584	569	10 issues of Go World, and most English books with game commentaries that I
585		know of.<p>
586
587		The references are stored in the file "references" in the main Kombilo
	570	know of.</p>
	571
	572	<p>The references are stored in the file "references" in the main Kombilo
588	573	directory. This file consists of two parts: first, a list of journals and
589	574	books for which references should be shown. The second list contains the
590		actual references, in the form 'signature journal/book issue'.<p>
591
592		If you want only references to sources which you own to be shown, you can
	575	actual references, in the form 'signature journal/book issue'.</p>
	576
	577	<p>If you want only references to sources which you own to be shown, you can
593	578	delete those books/journals which you don't own from the
594	579	first list, without changing the second list, and then the corresponding
…	…
596	581	different issues of a journal is more complicated: in that case you have to
597	582	edit the second list, and delete all references to those issues which you
598		don't have.<p>
599
600		Of course, additions to the list of references are very welcome. For one
601		thing, there are a few issues of Go World which I don't own myself (no. 25,
602		and 33-41), and which are therefore missing; furthermore, I think it would
603		in principle be sensible to add references to other journals, like the
	583	don't have.</p>
	584
	585	<p>Of course, additions to the list of references are very welcome.
	586	I think it would make sense to add references to other journals, like the
604	587	American Go Journal, the British Go Journal, the Deutsche Go-Zeitung,
605	588	the Revue Francaise de Go, etc. I will probably start adding more
…	…
607	590	would be appreciated. If you are interested, please contact me, so that we
608	591	can agree in which format you could send me the references, and to avoid
609		that any references are collected twice.<p>
	592	that any references are collected twice.
	593	(Thanks to Uwe Richter for indexing 10 issues of Go World!)
	594	</p>
610	595
611	596	<div style="border:none; padding:3px; width:600px;
612	597	background-color:#99CCCC; z-index:1">
613	598	<a name="analyzing"><font size="4"><b>Analyzing a game</b></font></a>
614		</div>~~<p>~~
615
616		If you want to analyze a game of your own, just load it into the main board with
	599	</div>
	600
	601	<p>If you want to analyze a game of your own, just load it into the main board with
617	602	the 'Open' command in the file menu (or use the 'Open' button next to
618	603	the file list in the data window). Use the navigation buttons to
…	…
621	606	to see up to which point the fuseki
622	607	you played also occurs in professional games, and afterwards you have
623		to select an appropriate relevant region.<p>
624
625		You can also load a fuseki or joseki dictionary
	608	to select an appropriate relevant region.</p>
	609
	610	<p>You can also load a fuseki or joseki dictionary
626	611	For example, Kombilo works quite well with Kogo's joseki dictionary.
627	612	To navigate all the variations, you should enable the 'Show next move'
628		option.<p>
	613	option.</p>
629	614
630	615	<div style="border:none; padding:3px; width:600px;
631	616	background-color:#99CCCC; z-index:1">
632	617	<a name="gameinfosearch"><font size="4"><b>Game Info search</b></font></a>
633		</div>~~<p>~~
634
635		If you are looking for games by a particular player, from a particular
	618	</div>
	619
	620	<p>If you are looking for games by a particular player, from a particular
636	621	event or from a certain time period, you can use the
637		game info search. This is basically a text search in the SGF game records.<p>
638
639		<img src="isearch.jpg" align=RIGHT>
	622	game info search. This is basically a text search in the SGF game records.</p>
	623
	624	<p><img src="isearch.jpg" align=RIGHT>
640	625	The games have to match all the requirements (Black Player, Event, ...)
641	626	simultaneously. The corresponding string does not have to occur at the
…	…
645	630	The 'Anywhere' entry is simply a text search in the SGF file. This allows
646	631	you to search for the result (use 'RE[W' or 'RE[B'), for games which
647		have a game comment (use 'GC['), etc.<br>
648
649		<p>
	632	have a game comment (use 'GC['), etc.</p>
650	633
651	634	<div style="border:none; padding:3px; width:600px;
652	635	background-color:#99CCCC; z-index:1">
653	636	<a name="signaturesearch"><font size="4"><b>Signature search</b></font></a>
654		</div>~~<p>~~
655
656		<img src="ssearch.jpg" align=RIGHT>
	637	</div>
	638
	639	<p><img src="ssearch.jpg" align=RIGHT>
657	640	In order to check for duplicates in the database, Kombilo
658	641	computes a modified
…	…
681	664	the places where moves 20, 40, ... were played. You can also omit
682	665	some of them (in most cases, two or three of the moves will
683		be enough to characterize a game uniquely).<p>
	666	be enough to characterize a game uniquely).</p>
684	667
685	668	<div style="border:none; padding:3px; width:600px;
686	669	background-color:#99CCCC; z-index:1">
687	670	<a name="editDBlist"><font size="4"><b>The database list</b></font></a>
688		</div>~~<p>~~
689
690		For Kombilo, a database is just a directory with SGF files in it.
	671	</div>
	672
	673	<p>For Kombilo, a database is just a directory with SGF files in it.
691	674	The database list is thus a list of directories. These contain
692	675	the SGF files in which Kombilo will search for a given pattern.<br>
…	…
696	679	files are). This is done in the 'Edit DB list' window
697	680	(available via the File menu). In this window, the list of
698		databases is shown, and you can<p>
699
700		<b>Add databases</b> This lets you choose a directory of SGF files
	681	databases is shown, and you can</p>
	682
	683	<p><b>Add databases</b> This lets you choose a directory of SGF files
701	684	which is then added to Kombilo's database list. Because the SGF files
702	685	have to be translated into a format which is more suitable for
…	…
712	695	If you have a lot of memory, you can experiment with larger databases,
713	696	but the performance gains are usually not that big.
714		<p>
715
716		<b>Toggle normal/disabled</b>
	697	</p>
	698
	699	<p><b>Toggle normal/disabled</b>
717	700	If you want to temporarily exclude a database from some searches,
718	701	select it and use this button to set its status to 'disabled'.
…	…
723	706	available, and if you toggle the status back to 'normal',
724	707	you can use that database again without processing it again.
725		<p>
726
727		<b>Remove a database</b>
	708	</p>
	709
	710	<p><b>Remove a database</b>
728	711	If you want to remove a database from Kombilo's list completely,
729	712	select it and press this button. The database files Kombilo
…	…
733	716	If you want to add this database again later, it will
734	717	have to be processed again.
735		<p>
736
737		<b>Reprocess a database</b>
	718	</p>
	719
	720	<p><b>Reprocess a database</b>
738	721	If you made any changes to the SGF files in one of the
739	722	database directories (or added/deleted SGF files in there),
…	…
741	724	really uses the information corresponding to the current
742	725	version of the SGF files.
743		<p>
744
745		<b>Stop processing</b>
	726	</p>
	727
	728	<p><b>Stop processing</b>
746	729	If you chose to add a lot of subdirectories of some directory
747	730	at the same time (with the 'add subdir's recursively' option),
748	731	and see that the processing takes too long, you can interrupt
749	732	it with this button. The currently processed database will
750		be finished, and then the processing will stop.<p>
751
752		<b>Save messages</b>
	733	be finished, and then the processing will stop.</p>
	734
	735	<p><b>Save messages</b>
753	736	If there are errors in the SGF files, or if Kombilo
754	737	finds duplicates, a message is issued. The 'save messages'
…	…
756	739	such that you can look at them later again in order to
757	740	correct the errors. (After correcting any errors,
758		you should reprocess the corresponding databases.)<p>
759
760		With Ctrl-click and Shift-click you <b>can select several databases</b> in the
	741	you should reprocess the corresponding databases.)</p>
	742
	743	<p>With Ctrl-click and Shift-click you <b>can select several databases</b> in the
761	744	list simultaneously. The "Toggle normal/disabled", "Remove" and "Reprocess"
762		buttons will then apply to all the selected databases.<p>
763
764		<b>Changing the order of the databases:</b>
	745	buttons will then apply to all the selected databases.</p>
	746
	747	<p><b>Changing the order of the databases:</b>
765	748	You can use "drag and drop" for the items in the database list and thus
766	749	change the order of the databases. If you sort the game list per database,
767		the order of the databases will be reflected in the game list.<p>
768
769
770		<b>Processing options</b>
	750	the order of the databases will be reflected in the game list.</p>
	751
	752	<p><b>Processing options</b>
771	753	You can choose to add all files with file names anding in .sgf, or files with
772	754	filenames ending in .mgt or .sgf, or to add all files in the concerning
…	…
776	758	The default is to write them to the same directory as the SGF files they
777	759	are associated to. (This choice has to be made before adding the database; it's not
778		possible to change it, later.)
	760	possible to change it, later.)</p>
779	761
780	762	<div style="border:none; padding:3px; width:600px;
781	763	background-color:#99CCCC; z-index:1">
782	764	<a name="custommenus"><font size="4"><b>The custom menus</b></font></a>
783		</div>~~<p>~~
784
785		The custom menus can be used to add your own menu entries.
	765	</div>
	766
	767	<p>The custom menus can be used to add your own menu entries.
786	768	Upon selecting a menu entry, Kombilo can do a pattern search for some
787	769	pre-defined pattern and/or a game info search and/or open a html file in
788	770	your web browser. For example, you could create entries for fuseki or
789		joseki patterns, for players, or for titles.<p>
790		<img src="custommenus.jpg" align=RIGHT>
791
	771	joseki patterns, for players, or for titles.</p>
	772
	773
	774	<p><img src="custommenus.jpg" align=RIGHT>
792	775	To edit the custom menus, select the corresponding entry in the Options
793	776	menu. You see a list of the currently existing menus, submenus and
794	777	entries. The first line with a * represents the Kombilo main menu. You can
795		add submenus or entries to the menus, or delete them.<p>
796
797		When an entry is selected, you can
	778	add submenus or entries to the menus, or delete them.</p>
	779
	780	<p>When an entry is selected, you can
798	781
799	782	<ul>
…	…
808	791	<li> Add a HTML file by entering the file name in the corresponding field, or
809	792	by browsing for a file.
810		</ul><p>
	793	</ul></p>
811	794
812	795
…	…
814	797	background-color:#99CCCC; z-index:1">
815	798	<a name="guessmode"><font size="4"><b>Guess next move mode</b></font></a>
816		</div>~~<p>~~
817
818		<~~IMG SRC~~="guesswrong.jpg" hspace=10 vspace=10 align=LEFT>
	799	</div>
	800
	801	<p><img src="guesswrong.jpg" hspace=10 vspace=10 align=LEFT>
819	802	One fun way to study go is to replay professional games by guessing the
820	803	next move. If you click on the corresponding button in the SGF edit toolbar
…	…
822	805	on the board will be interpreted as guesses - if it coincides with the next
823	806	move in the current SGF file, that move is played; otherwise no stone is
824		placed on the board.<p>
825
826		When you switch to the 'guess next move' mode, a small frame appears next
	807	placed on the board.</p>
	808
	809	<p>When you switch to the 'guess next move' mode, a small frame appears next
827	810	to the game tree, which gives you some feedback on your guesses. If your
828	811	guess is right, it displays a green square (and the move is played on the
…	…
833	816	guess was, the smaller is that rectangle. Furthermore the number of correct
834	817	guesses and the number of all guesses, as well as the success percentage
835		are given.<p>
836
837		Of course, if you just can't find the next move, you can always use the
838		'Next move' button above the board.<p>
	818	are given.</p>
	819
	820	<p>Of course, if you just can't find the next move, you can always use the
	821	'Next move' button above the board.</p>
839	822
840	823	<div style="border:none; padding:3px; width:600px;
841	824	background-color:#99CCCC; z-index:1">
842	825	<a name="configure"><font size="4"><b>Configuring Kombilo</b></font></a>
843		</div><p>
844
845		You can configure Kombilo by changing the options in the
846		options menu.<p>
847
848		<b>Edit custom menus</b>
849		See <a href="#custommenus">above</a>.<p>
850
851
852		<b>Fuzzy stone placement</b>
	826	</div>
	827
	828	<p>You can configure Kombilo by changing the options in the
	829	options menu.</p>
	830
	831	<p><b>Edit custom menus</b>
	832	See <a href="#custommenus">above</a>.</p>
	833
	834	<p><b>Fuzzy stone placement</b>
853	835	Place the stones on the main board slightly off the exact
854	836	point, in a random direction, to make the position
855	837	look more natural. (Well, some people might think that it
856	838	is just ugly, so you can switch it off here).
857		<p>
858
859		<b>Shaded stone mouse pointer</b>
	839	</p>
	840
	841	<p><b>Shaded stone mouse pointer</b>
860	842	(Don't) Show the current position of the mouse pointer on
861	843	the board and the color of the next stone to be played
862	844	by a shaded stone.
863		<p>
864
865		<b>Show next move</b>
	845	</p>
	846
	847	<p><b>Use 3d stones</b>
	848	By default, Kombilo uses the realistic looking stone pictures provided by
	849	Patrice Fontaine (thanks!). You can switch this off; then Kombilo will use
	850	"flat" stones, i.e. just black and white circles.
	851	</p>
	852
	853	<p><b>Show next move</b>
866	854	In case a SGF file has been loaded, show the position of the
867		next move with a circle.<p>
868
869		<b>Show Coordinates</b>
870		Show coordinates around the board.<p>
871
872		<b>The 'Game list' submenu:</b><p>
873
874		---Sorting the game list<p>
	855	next move with a circle.</p>
	856
	857	<p><b>Show last move</b>
	858	This marks the most recent move with a small circle. Thanks to Bernd Schmidt
	859	who provideda a patch for this. (The SGF file is not changed.)</p>
	860
	861	<p><b>Show Coordinates</b>
	862	Show coordinates around the board.</p>
	863
	864	<p><b>The 'Game list' submenu:</b></p>
	865
	866	<p>---Sorting the game list</p>
875	867
876	868	First of all, in the 'Game list' submenu of the Options menu,
…	…
892	884	names of your SGF files and the databases reflect the date, as is the case
893	885	with GoGoD, for example, you should 'sort per database' and 'sort by
894		filename' and 'reverte order', since that's faster).<p>
895
896		~~---Show date/show filename<~~p>
897
898		Depending on where your SGF files come from, it might be interesting to
	886	filename' and 'reverte order', since that's faster).</p>
	887
	888	<p>---Show date/show filename</p>
	889
	890	<p>Depending on where your SGF files come from, it might be interesting to
899	891	include the filename in the game list (as was done automatically in
900	892	previous Kombilo versions), or to omit it. Similarly, it might be
901	893	interesting to include the date (if it cannot be read off from the file
902	894	name, say, or to omit it). These two options allow you to control this.
903		Changing one of these options will reset the game list.<p>
904
905		<b>Invert selection</b>
	895	Changing one of these options will reset the game list.</p>
	896
	897	<p><b>Invert selection</b>
906	898	By default, when the relevant region for a pattern search is selected, the rest
907	899	of the board is grayed out. If you prefer to have the relevant region itself
908		grayed out (as was the case in previous versions), you can use this option.<p>
909
910		<b>Uppercase labels</b>
	900	grayed out (as was the case in previous versions), you can use this option.</p>
	901
	902	<p><b>Uppercase labels</b>
911	903	If you want to use the 'Export search results' function to
912	904	produce output for Sensei's Library, it is useful to use
…	…
914	906	letters are automatically understood by Sensei's Library.
915	907	If you do not want to do that, and find that uppercase
916		labels look better, you can use this option.<p>
917
918		<b>Jump to match</b>
	908	labels look better, you can use this option.</p>
	909
	910	<p><b>Ask before discarding unsaved changes</b>
	911	If this option is enabled, Kombilo will ask for confirmation before
	912	discarding unsaved changes in an SGF file (i.e. before deleting the
	913	game from the game list, and before exiting Kombilo).</p>
	914
	915	<p><b>Jump to match</b>
919	916	This controls the behaviour of the SGF viewer when you open
920	917	a game from the game lis tafter a pattern search.
921	918	If this option is checked, the viewer will jump directly to the position
922	919	where the pattern you searched for was found in that game.
923		<p>
924
925		<b>Smart fixed color</b>
	920	</p>
	921
	922	<p><b>Smart fixed color</b>
926	923	If this option is enabled, the 'fixed color' option will be automatically
927	924	enabled when you select the whole board as search-relevant region,
…	…
934	931	white stone on the upper left resp. upper right hoshi, do
935	932	a whole board search without 'fixed color', and look at the
936		continuations).<p>
937
938
939
940		<b>Show color swap</b>
	933	continuations).</p>
	934
	935	<p><b>Show color swap</b>
941	936	If this is active, in the list of results for a pattern search
942	937	hits for the pattern with reversed colors will have a minus sign.
943		<p>
944
945		<b>Advanced:</b> This is a submenu with options that
946		are seldom changed.<p>
947
948		<b><a name="maxnumsearches">Number of previous searches remembered</a></b>
	938	</p>
	939
	940	<p><b>Advanced:</b> This is a submenu with options that
	941	are seldom changed.</p>
	942
	943	<p><b><a name="maxnumsearches">Number of previous searches remembered</a></b>
949	944	As we have seen, with the 'back' button you can jump back to the previous
950	945	search. This option controls the number of previous searches that are remembered.
…	…
955	950	to set it to a higher number, or even to 0, which means 'no limit': all
956	951	searches are remembered, as long as there is enough memory.
957		<p>
958
959		<b><a name="externalviewer">Open game in external SGF viewer</a></b>:
	952	</p>
	953