Quarry Manual

3/3/2015 Quarry Manual

http://download.gna.org/quarry/help/en/quarry.html 1/27

QuarryManualPaulPogonyshev

Thismanualdescribesversion0.2ofQuarry.

Copyright2004,2005,2006PaulPogonyshev

Permissionisgrantedtocopy,distributeand/ormodifythisdocumentunderthetermsoftheGNUFreeDocumentationLicense,Version1.2oranylaterversionpublishedbytheFreeSoftwareFoundationwithnoInvariantSections,noFrontCoverTexts,andnoBackCoverTexts.AcopyofthelicenseisincludedinthesectionentitledGNUFreeDocumentationLicenseorinthefileCOPYING-DOCSdistributedwiththismanual.

DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED UNDER THE TERMS OF THE GNU FREEDOCUMENTATIONLICENSEWITHTHEFURTHERUNDERSTANDINGTHAT:

1. DOCUMENT IS PROVIDED ON AN AS IS BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED ORIMPLIED, INCLUDING,WITHOUT LIMITATION,WARRANTIES THAT THE DOCUMENT ORMODIFIED VERSION OFTHEDOCUMENTISFREEOFDEFECTSMERCHANTABLE,FITFORAPARTICULARPURPOSEORNONINFRINGING.THE ENTIRE RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE OF THE DOCUMENT OR MODIFIEDVERSIONOFTHEDOCUMENTISWITHYOU.SHOULDANYDOCUMENTORMODIFIEDVERSIONPROVEDEFECTIVEINANYRESPECT,YOU(NOTTHEINITIALWRITER,AUTHORORANYCONTRIBUTOR)ASSUMETHECOSTOFANYNECESSARY SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER OF WARRANTY CONSTITUTES ANESSENTIALPARTOFTHISLICENSE.NOUSEOFANYDOCUMENTORMODIFIEDVERSIONOFTHEDOCUMENT ISAUTHORIZEDHEREUNDEREXCEPTUNDERTHISDISCLAIMERAND

2. UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE),CONTRACT,OROTHERWISE, SHALLTHEAUTHOR, INITIALWRITER,ANYCONTRIBUTOR,ORANYDISTRIBUTOROFTHEDOCUMENTORMODIFIEDVERSIONOFTHEDOCUMENT,ORANYSUPPLIEROFANYOFSUCHPARTIES,BELIABLETOANYPERSONFORANYDIRECT,INDIRECT,SPECIAL,INCIDENTAL,ORCONSEQUENTIALDAMAGESOFANYCHARACTER INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF GOODWILL, WORK STOPPAGE,COMPUTER FAILURE ORMALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR LOSSES ARISING OUT OF ORRELATING TO USE OF THE DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT, EVEN IF SUCH PARTYSHALLHAVEBEENINFORMEDOFTHEPOSSIBILITYOFSUCHDAMAGES.

Feedback

ToreportabugormakeasuggestionregardingtheQuarryapplicationorthismanual,eithersendamessagetooruseQuarrybugtracker.

RevisionHistoryRevisionQuarryManualV0.2 November2006

PaulPogonyshev

TableofContents

Introduction1.GettingStarted

ToStartQuarryWhenYouStartQuarry

2.Usage

ToStartaNewGameToOpenaGameRecordToSaveaGameRecordToRegisteraGamePlayingProgram



ToAdjournaGameToResumeaGame

3.QuarryWindowsandMenus

NewGameDialog

Game&PlayersPageGameRulesPage

NewGameRecordDialogResumingGameDialogBoardWindows

TheBoardBoardWindowInformationPaneGameTreeViewBoardWindowMenu

FindDialogGameInformationDialog

4.Settings

GeneralInterfaceGameTreeGTPEngines

GTPEngineInformationDialog

SavingGameRecordsGoBoardAppearanceAmazonsBoardAppearanceReversiBoardAppearance

A.QuarryAuthorsB.GNUFreeDocumentationLicense

ListofFigures

1.1.QuarryControlCenter3.1.QuarryBoardWindowshowingKogosJosekiDictionary

ListofTables

3.1.Boardkeyboardshortcuts3.2.ValidGameresultvalues

Introduction

TheQuarryapplicationallowsyoutoplaytheboardgamesofGo,AmazonsandReversi.Youcanplaywithcomputerprogramsorwithanotherhuman,andsave,viewandeditgamerecords.

Quarryprovidesthefollowingfeatures:

SupportforGo,AmazonsandReversigames.

Niceresizableboard.

Playinggames:

GNUGo,GRhinooranyotherGTP(GameTextProtocol)enginecanbeyouropponent.

Computervs.computerandhumanvs.humangamesareanoptiontoo.



Goodsupportfortimecontrol.

Gamescanbeadjournedandlaterresumed.

Gamerecords:

AllgamescanbestoredinwidelysupportedSGFFF[4]fileformat.

FastandrobustparsercanreadSGFfilesofanyversion.

Inparticular,KogosJosekiDictionarycanbebrowsedwithQuarry.

GameTreeViewallowsforeasynavigationofgamerecords.

Textsearchincommentsisapowerfultoolifyouknowwhattosearchfor.

GoboardpositioncanbeexportedinaformatsuitableforinsertingintoSenseisLibrary.

SupportforvariousSGFlabelsandmarkup.

Note

QuarryitselfcanplayneitherGo,norAmazons,norReversi.Tohaveacomputeropponent,youneed to findaprogram(e.g.GNUGomentionedabove)thatsupportsGTPandregisteritinQuarry.

Note

QuarrydoesnothaveanysupportforInternetgameserversanditwillnotbeaddedbeforeversions0.3.x.

Chapter1.GettingStarted

TableofContents

ToStartQuarryWhenYouStartQuarry

ToStartQuarry

YoucanstartQuarryfromyourApplicationsmenu,itshouldtypicallybeavailableunderGamesBoardGames.However,thismaydependontheexactwayyouinstalledtheprogramandyouroperatingsystem.

Quarrycanalsobestartedfromthecommandline.SimplytypequarryinandpressReturn.

YoucanalsohaveQuarryopenoneormoregamerecordsimmediatlyafteryoustartit.Justtype

quarryfile1.sgf file2.sgf ...

inthecommandlineandpressReturn.Quarrywillstartwithspecifiedfile(s)open.

Note

Filenamesdonthavetoendin.sgf,butnamesofSGFfilestypicallydohavethissuffix.

WhenYouStartQuarry

WhenyoustartQuarry,ControlCenterwindowisdisplayed:

Figure1.1.QuarryControlCenter



TheControlCenterwindowconsistsofthefollowingelements:

NewGamebutton

Thisbuttonallowsyou to start anewgame. Itwillpopup theNewGamedialogwhereyou can select thegame (Go,AmazonsorReversi),opponentsandgamespecificrules.

NewGameRecordbutton

Clickingthisbuttonsallowsyoutocreateagamerecordwithoutactuallyplayingagame.NewGameRecorddialogwillbeshown,askingyouforbasicgamerecordparameters.

OpenGameRecordbutton

Thisbuttonallowsyou to selectagame record forviewingand/orediting.Youwillneed topick the filewith thegamerecordinthestandardOpenFiledialog.

ResumeGamebutton

Clickthisbuttontoresumeagameyouadjournedearlier.Actually,youcanresumeaboutanyunfinishedgame,evenoneyoustartedinadifferentclient.AstandartOpenFiledialogwillbepoppedupforyoutoselectthefilecontainingthegamerecordyouwishtoresume.

Preferencesbutton

ThisbuttonopenstheQuarryPreferencesdialog.

Quitbutton

Closesallwindowsandquitstheprogram.However,ifthereareunsavedchangesinanyoftheopengamerecords,youwillbeaskedwhattodowiththemfirst.

Chapter2.Usage

TableofContents

ToStartaNewGameToOpenaGameRecordToSaveaGameRecordToRegisteraGamePlayingProgramToAdjournaGameToResumeaGame

ToStartaNewGame



Tostartanewgame,clicktheNewGamebuttonintheQuarryControlCenterwindoworchooseFileNewGamemenuiteminanyofthealreadyopenBoardWindows.TheNewGamedialogwillappear,whereyoucanchoosethekindofgameyouwantandtheopponents.

Ifyouwanttoplayagainstacomputerprogram,youneedtoregisteritinQuarryfirst(onceonly,ofcourse.)Todothis,clicktheManageEngineListbuttoninthedialog.

Formoreinformation,seethedetaileddescriptionofNewGamedialog.

ToOpenaGameRecord

Youcanopenagamerecordinoneofthreeways:

ClicktheOpenGameRecordbuttonintheControlCenterwindow.QuarrywilldisplaytheOpenSGFFiledialog.SelectthefilewiththegamerecordyouwanttoopenandclicktheOK.

ChooseFileOpenmenu itemor simplypressCtrl+O in anyopenedBoardwindow.Similarly to theprevious case,QuarrywilldisplaytheOpenSGFFiledialog.

WhenstartingQuarryfromthecommandline,specifythenameoffile(orseveralnamesatonce):

quarryfile1.sgf file2.sgf ...

Thespecifiedfile(s)willbeopenedautomatically.

ToSaveaGameRecord

Tosaveagamerecord,chooseFileSavemenuiteminitsBoardwindow(orsimplypressCtrl+S.)Ifthegamerecorddoesnotyethaveafilename,QuarrywilldisplaytheSaveAsdialog.Enterthenameforthefile,thenclicktheOK.

Ifyouwanttosaveagamerecordunderadifferentfilename,chooseFileSaveAsmenuitem.EnteranameforthefileintheSaveAsdialogandclickOK.

ToRegisteraGamePlayingProgram

ToregisteragameplayingprograminQuarry,firstopenthePreferencesdialogandselectGTPEnginescategoryinitsleftpane.(You can also click theManageEngineList button in theNewGamedialog, which immediatly displays theGTP Enginescategory.)

ThenclicktheAddbuttonand,intheappeareddialog,enterthecommandlinerequiredtolaunchtheprograminGTPmode.Youshouldconsulttheprogramsmanualtofindouthowthecommandlineshouldlooklike.Forinstance,commandlineforGNUGoshouldbelikethis(notethedoublehyphens):

gnugo --mode gtp --quiet

Otherprogramsmayrequiredifferentoptionsornooptionsatall.

ToAdjournaGame

Toadjournagame,choosePlayAdjournGamemenuitem.Ifthegamehasneverbeensavedyet,youwillneedtoenterthenameofthefileyouwouldliketostoreitin.

Actually,adjourningdiffersfromsavingonlyinthatitclosesthegameswindow.

ToResumeaGame

Toresumeapreviouslyadjournedgame,clickResumeGamebuttonintheQuarryControlCenterwindoworselectResumeGameitemfromtheFilemenu.Youwillbepromptedforthefilethatcontainsthegamerecord.

Whenyou select the file,ResumingGameDialog pops up,where you should specify the players.Quarrywill try to guess theopponentsbasedonthedatastoredinthegamerecord,butitcanmakeamistakeindeterminingwhetherthereareanycomputer



playersandwhichenginesshouldplay.Youwillalwayshavethefinalsay,though,andwillbeabletocorrectanymistakes.

Ifthegameyouselectisalreadyfinished,youwillbepromptedtoopenitforviewingand/oreditinginsteadofresuming.

Chapter3.QuarryWindowsandMenus

TableofContents

NewGameDialog

Game&PlayersPageGameRulesPage

NewGameRecordDialogResumingGameDialogBoardWindows

TheBoardBoardWindowInformationPaneGameTreeViewBoardWindowMenu

FindDialogGameInformationDialog

NewGameDialog

TheNewGamedialogconsistsof twopages,Game&PlayersandGameRules.Whenyouopen thedialog, the first pageappears.WhenyouclickNextbutton,thesecondpageisdisplayed,whichisspecificforeachofthreegamesGo,AmazonsandReversi.

Game&PlayersPage

Onthispageyoucanselectoneof threeavailablegamesand theopponents.Youcanmake selections in arbitraryorderfirstchoosethegameandthentheopponentsortheotherwayround.Atanytime,allplayablecombinationsofgamesandcomputerplayersaremarkedwithYesicons,whileallunplayablecombinationsaremarkedwithNoicons.TheNextbuttonissensitiveonlywhenaplayablecombinationofgameandopponentsisselected.

Note

Beforeplayingagainstacomputerprogram(e.g.GNUGo,youneed to register it inQuarry.SeeGTPEnginessectionforhowtodothis.

Game&Playerspageconistsofthefollowingcontrols:

Gamesection

Hereyoucanselectthegameyouwanttoplay,eitherGo,AmazonsorReversi(alsoknownasOthello).Notethatmostprogramscanplayonlyonegame.

WhitePlayerandBlackPlayersections

Thissetofcontrolsdeterminestheopponents.Eachopponentcanbeeitherahumanoracomputerprogram.Forahumanplayeryoucanspecifyhername(defaultstoyournameasreportedbythesystem.)Computeropponentshouldbeselectedfromthedropdownlist.Ifthelistdoesnotcontaintheprogramyouwanttoplayagainst,clicktheManageEngineListattheendofthedialogtoregistertheprograminQuarry.

Whichplayeristomovefirstdependsonthegame.InGoandReversiblackmovesfirst,whileinAmazonswhitehasthefirstturn.YoucanalwayschangesideswiththeSwapbuttontotheright.

Swapbutton



Thisbuttonallowsyoutoeasilyswapplayerssides.ItdoesnothingelsebutcopyingsettingsfromWhitePlayersectiontoBlackPlayersectionandviceversa.

ManageEngineListbutton

ThisbuttonopensQuarryPreferencesdialogattheGTPEnginespage.Aconvenientwaytoregisternewprogramand/ormodifyparametersofthealreadyregisteredonesjustbeforestartinganewgame.

Nextbutton

Whenyouaredonewiththispage,clicktheNextbuttontotweakgamespecificrulesonthenextpage.

GameRulesPage

Onthispageyoucanselecttherulesforthegame.Thepagehastwoparts.TheupperpartisdifferentforeachofGo,AmazonsandReversigamesandcontainsgamespecificrules.Thelowerpartcontainstimelimitsettingscontrolsandisthesameforallthreegames.Itisdescribedlast.

Whenyouhaveselectedtherulesyouwant,clickthePlaybuttontostartthegame.

GoRules

Gohasmanydifferentrulesetsthatdifferinscoringdetails,treatingofsomespecialpositionsetc.Currently,Quarrydoesntmakeanydifferencebetweenthem.However,existingrulecontrolsshouldbeenoughinmostcases.

BoardSizespinbutton

Choosethesizeofboardforthegamehere.Goistraditionallyplayedona1919board.99and1313boardsarealsocommon.Quarrydoesntlimityoutothesechooseanysizebetween55and2525inclusive.

Traditionalboardsizebuttons

ThesebuttonsallowsyoutoquicklyselectoneofthreetraditionalGoboardsizeseither99,1313or1919.

Handicapcontrols

Whenoneoftheplayersisweaker,itiscommonpracticeinGotogivehimhandicapstones.Thisgivesherbetterchancestowin andmakes the gamemore challenging (and thusmore interesting) for the stronger player.Theweaker player istraditionallyplayingasblack.

Quarrysupportsbothfixed(alsoknownasJapanese)andfree(Chinese)handicaps.Inthefirstcase,handicapstonesareplacedfollowingatraditionalpattern,athoshipoints.Maximalfixedhandicapis9stones.Withfreehandicap,ontheotherhand,blackplayeractivelyplacesthehandicapstonesatanyintersectionsontheboard.Freehandicap ispracticallynotlimited.

Note

Quarrytreatsfreehandicapasnonobligatory:itallowsblacktoplacefewerhandicapstonesthanspecifiedingamerules(butnotlessthantwo.)

Ifyouwantanevengame,simplysetthehandicaptozero.

Komispinbutton

Komiisthecompensationtothewhiteplayerforplayingsecond.Itisusuallynonintegertomakedrawsimpossible.Thecurrently suggested komi for even game on 1919 board is 6.5 points. Smaller (or even negative) komi gives someadvantagetoblackplayerandcanbeusedinadditiontoorinsteadofhandicap.

Seealsotimelimitsettingsdescription.

AmazonsRules

Atpresent,AmazonsrulesinQuarryarelimitedtoboardsizeandcommontimelimitsettings.StandardboardsizeforAmazonsis1010(whichisalsoselectablewiththesmallbuttontotheright),butyoucanchooseanythingfrom55to2525inclusive.



ReversiRules

ReversirulesinQuarryarelimitedtoboardsizeandtimelimitsettingsdescribedjustbelowthissection.StandardboardsizeforReversiis88,though1010boardsarenotuncommoneither.Thisisreflectedbythechoiceoftraditionalboardsizeswiththebuttonstotheright.However,inQuarryyoucanselectanyevenboardsizefrom66to2424inclusive.

TimeLimitSettings

Quarryallowstoplaygameswithlimitedtimeforbothplayers.Thisalsoappliestocomputerprogramplayerstheyhavetohonortheallotedtimeorlose.Ofcoursetheprogramsareproperlynotifiedaboutthetimelimitsettingsandtheremainingtime.

Note

Computer opponents use CPU time to generatemoves. This means that they usually need less time on fastermachines and more on slower machines. Also, if you run a computationally intensive task while playing, yourcomputeropponentsmaybecomeslower.Finally,certaincomputerprogramsmayalsothinkonopponentstime.

Quarryhasfourtypesoftimecontrol:

Nolimit

Bothopponentscantakeasmuchtimeastheylikeoneachmove,therearenolimits.InthismodeyoucanselecttheKeeptrackoftotaltimeoption.ThenQuarrywilldisplaythetotaltimespentonmoveponderingbyeachplayer.Thisispurelyforyourinformationandservesnootherpurpose.

Limitedtimeforentiregame

Eachplayerhaslimitedtimetoplaythewholegame.Ifaplayerfailstofinishthegameintheallotedtime,sheloses.Notethattimelimitdoesntdependonthenumberofmovesinthegame.

Limitedtimepermove

Eachmovehas tobeplayed infixed time.Timenotused isnotstoredandnotadded toavailable timeonnextmoves.Whenusingthismode,keepinmindthatinmostgamestherearedifficultpositionsthatrequiremoreponderingtime.

Canadianovertime(alsoknownasCanadianbyoyomi)

This time control is often used inGo, but has nothingGospecific, so it can be used in any othermovebased game.Canadianovertimehas theadvantageof imposingcertain speedofplay,but, at the same time, allowing to occasionallyspendmoretimeonimportantmoves.

Canadian overtime has three parameters:main time,overtimeperiod length andmoves per overtime.Both playersbegingameintheirmaintime.Duringmaintimetheycanplayanynumberofmovesatanyspeed.Whenmaintimeforaplayerisup,firstovertimeperiodbegins.Duringeachovertimeperiodaplayerhastoplaythespecifiednumberofmoves(movesperovertime.)Ifshefailstodoso,shelosesontime.Otherwise,nextovertime(oftheverysamelength)beginsandtheplayerhastoplaythesamenumberofmovesthisbeforethetimeisupagain.Thenumberofovertimesisunlimitedandtheyarecompletelyequal toeachother: timenotusedinoneovertimeperiod isnotstoredandnotadded tootherovertimeperiods.

NewGameRecordDialog

TheNewGameRecorddialogallowsyoutostartanewgamerecordwithoutactuallyplayingagame.Whenyouaredoneenteringgamerecordinformation,presstheCreatebutton.OrpresstheCancelbuttontocancelgamerecordcreation.

Thedialogconsistsofthefollowingcontrolsbesidesthementionedbuttons:

Gameselectors

HereyouchoosethegameyouwanttocreatearecordofGo,AmazonsorReversi.AllthegamessupportedbyQuarryarelisted.

Rulessection

Thissectioncontainsvariouscontrols forbasicgamerules.Theyaredescribedinmoredetails in theNewGamedialog



section.

OneimportantchangeisthePlacestonescheckbuttontotherightofhandicapspinbutton.ItdetermineswhetherQuarryshouldplacethehandicapstonesforyou,ornot.Stonesareplacedasifthehandicapisfixed,butyoucanalwayschangestonessetuplaterifneeded.

ShortGameInformation

Here you can enter the names of white and black player and the name of the game.You can change or expand thisinformationlater,usingtheGameInformationdialog.

ResumingGameDialog

TheResumingGameDialogallowsyoutospecifyorcorrectgameplayerswhenresumingagame.Italsoshowssomeinformationaboutthegame,mostofwhichisnoteditable.

Youcanspecifybothgameplayersandfixtheirnames,ifneeded.Therearetworadiobuttonsandacomboboxforeachplayer.Radiobuttonscontrolwhetheraplayerisahumanoracomputer(someGTPengine.)Ifyouselecttoletcomputercontrolaplayer,youcanchooseanyavailableGTPenginefromthelistforit.

Quarrytriestoguessplayersbasedontheirnames,asstoredinthegamerecord.Normally,ifthegamewasadjournedinQuarryandyoudontaltercomputerplayernames,itshouldguesscorrectly.However,youcanalwaysoverrideandcorrectitsdecision.

BoardWindows

BoardwindowsarethemainpartofQuarry.Theyareusedtoplaygamesandviewandeditgamerecords.Totheleftinawindowisthegameboarditself.Theexactappearanceoftheboarddependsonthecurrentgame(Go,AmazonsorReversi)andcanbeconfigured.Ontherightsideofthewindowthereisinformationpane,includingthecommentwindow.Therecanalsobethegametreeviewtothebottomoftherightpane.

Figure3.1.QuarryBoardWindowshowingKogosJosekiDictionary



TheBoard

Boarddisplayscurrentgameposition, includingpieces,markup, labelsandvariationsof thecurrentnode.Coordinate labels areshownontheedgesoftheboard.Theydependonthecurrentgame.Inthetopleftcornerasmallrectangleisdrawniftheboardhasfocus.

Thelastmovemadeismarked.Dependingonthemarkuptheme,thiscanbeacrossorabullet.Onthescreenshotabove, lastplacedstoneatP15ismarkedwithacross.

Note

Thissectioncanbeimproved.

Variations

Quarry treatsvariationsas siblingsof thecurrentnode.This is like Jagodoes andunlikeCGoban.You always see the currentvariationanditisnotapotentialforthenextnode/move.

Ontheboard,noncurrentvariationsthatcontainamoveareshownassmallghostlypieces.Variationsthatdontcontainamoveorcontainapassmove(inGo)canbeseenonlyintheGameTreeView.ScreenshotaboveshowstwovariationsatQ18andQ19ofthewhitemoveontheboard.

Youcanactivate(switchto)aparticularvariationbyrightclickingontheghoststoneontheboard.Forinstance,rightclickingonQ18 in thewindowshown in the screen shotwouldmakeWhiteQ18 thecurrentmove. In rarecaseswhen there aremultiplevariationswiththesamemove,rightclickingandshiftrightclickingscrollsthroughthelistofsuchvariations.AlternativewaysofswitchingtodifferentvariationsincludeusingtheGameTreeViewandusingmenuitems,toolbarbuttonsorkeyboardshortcuts.

KeyboardNavigation



Boardhasseveralkeyboardshortcutstoeasegamerecordnavigation.Remember,thattheseshortcutsareactiveonlyiftheboardhas focus, as indicatedwith a small rectangle in the topleft corner.Otherwise, you should type themwithAlt modifier:morecomplicatedshortcutsworkeverywhereinBoardWindows.

Table3.1.Boardkeyboardshortcuts

Shortcut ActionLeftarrow Gotothepreviousnode(currentnodesparent.)

Rightarrow

Gotothenextnode(currentnodeschild.)Bydefault,nextnodeisthefirstchild,butitisrememberedifyouswitchtoadifferentchild.

PageUp Gotennodesbackward.Iftherearelessthantennodes,stopattherootofthegametree.PageDown Gotennodesforward.Iftherearelessthantennodes,stopatthebranchend.

Home Gotothegametreeroot.End Gotothelastnodeinthecurrentbranch(variation.)Uparrow Gotothepreviousvariationofthecurrentnode.I.e.gotothepreviouschildoftheparentofthecurrentnode.Downarrow Gotothenextvariationofthecurrentnode.I.e.gotothenextchildoftheparentofthecurrentnode.

BoardWindowInformationPane

GameInformationPaneshowsinformationaboutthegameingeneral,aboutthelastmovemadeandaboutthecurrentnode.SomeofitscomponentsareoptionalandcanbehiddenintheViewmenu.

PlayerInformation

Atthetopofthepaneistheplayerinformationforbothplayers.Itshowsplayername,teamandrank(firstline),plusgamespecific information (second line.) If name is missing, string [unknown] is shown in its place. If team or rank is notspecified,theyaresimplynotshown.

GamespecificinformationincludesnumberofcapturesmadebyaplayerpluswhiteplayerskomiforGoandnumberofdisksontheboardforReversi.

PlayerClocks

Closetoplayerinformationaretheclocks.Whenagameisplayed,theydisplaythetimeleftforaplayer.Additionally,theycandisplaynumberofpiecesleftinthecurrentCanadianovertimeperiodinsmallerdigitstotheright.Whenagamerecordisviewed,clocksdisplaytimeleftaftermoveinthecurrentnodehasbeenplayed.Clockscanbeemptyifagameisplayedwithouttimelimits.

MoveInformation

Belowplayer informationandclocksasingle linedisplaysmoveinformation.It shows lastmove(usually,currentnodesmove)numberandthemoveitself.Afterwards,playertomoveisspecified.Thiscansometimesseeminglycontradictwiththelastmove,butitisallowedtooverrideplayertomoveingamerecords(seeEditPlayertoMovesubmenu.)Thisfeatureisoftenusedinproblemcollections.

GameResult

Belowmoveinformationgameresultisshown,butonlyattheverylastnodeofthegame.Thisisdoneinordertopreventspoilingofwatchingofunknowngames.Also,ifthegamelacksanyresultorisunfinishedthereisnothingtoshowatall.

GameActionButtons

Yetbelowtherearegameactionbuttons.TheseincludePass(forGo)andResign.Becausefunctionalityofthisbuttonsisquiterarelyusedandtheytakeupspace,youcanhidethemusingViewGameActionButtonsmenuitem.Theyareshownbydefaultmainlyasareminderoftheoptionsyouhave.

CommentWindow

Mostoftherightsideistakenbycommentwindow.Itdisplaysanycommentarythecurrentnodehas.Commentcanbeeditedandyoudontneed to take any actions to saveyour edits.Edits are also saved in theundohistory and canbe



undoneandredonefreely.

Ifthecurrentnodehasaname,itisshownabovecommentinboldunderlinedfont.Itcanbeeditedjustlikecommentandyou dont need any special steps to edit node name. However, to create a name for a node that lacks one, useEditEditNodeNamemenuitem.Itwillinsertaplaceholderfornodenameinthewindow,whichyoucanthenreplacewithactualname.Todeleteaname,simplydeleteallitstext.Quarrywillnoticeitandremovenodelinefromthewindow.

GameTreeView

Finally, there can be the Game Tree View, described in detail in the next section. Its visibility is controlled byViewGameTreemenuitemandpreferences.

GameTreeView

GameTreeViewshowsgamerecordasa tree inastyleusedbyCGoban1.Generally, it isof interestonly if thegame recordcontainsvariations.For instance,adebut/josekidictionaryorawellannotatedgamewithalternatebranches.Visibility ofGameTreeViewiscontrolledwithGameTreeiteminViewmenuandwithpreferences.

Nodewithamoveofaspecificplayer,includingpassmoveinGo,areshownaspiecesofplayerscolor.Othernodes,includingpositionsetup,atpresentlackanyicon.Nodesthatbelongtoasamebranch(variation)areconnectedwithalineandthecurrentbranchishighlighted.Currentnodeisshownwithinablackrectangle.Ifitisnotvisible,youcanbringitonscreenusingRecenteronCurrentNodecommandfromtheViewmenu.

Subtrees can be collapsed/expanded by rightclicking on subtree root. This is useful to hide nodes you are not interested incurrently.Rootsofcollapsednodeshaveacrossonthem.

Ifamouseisheldoveranode,atooltipwithinformationaboutthenodeisshown.Itincludesmovenumber,moveitself,nodenameandcomment.Ofcourse,someofthesecanbeabsentfromthetooltip,iftheyarenotpresentinthenodetobeginwith.If nodecommentistoolong,onlyfirstpartofitisshown.Tooltipscanbedisabledinpreferencesiftheylooktoodistractingtoyou.

BoardWindowMenu

Filemenu

NewGame

ShowNewGameDialogtostartanewgame.

NewGameRecord

ShowNewGameRecordDialogtocreateanewgamerecordwithoutactuallyplayingagame.

Open

Openagamerecord.Recordmayaswellhavebeensavedinadifferentapplication.

ResumeGame

OpenagamerecordandshowResumeGameDialogtoresumethegame.Gamesadjournedindifferentapplicationscanberesumedtoo.

Export

ASCIIDiagram

ExportcurrentboardpositionasafreeformatASCIIdiagramtotheclipboard.Usefule.g.tomailgamepositionifyoudontneedafullblownSGF.Onlyboardpositionwithoutanymarkupisstored.

SenseisLibraryDiagram

ExportcurrentboardpositionasaSenseisLibrarydiagramtotheclipboard.Pieces,circleandsquaremarkupandlabelsareexported.Result,ofcourse,canbeimportedintotheSenseisLibrary.OnlyavailableforGogames.

Note



It iscurrenlyimpossibletoexportonlypartoftheboard.Youneedtomanuallydeleteunneededinformationinsuchcases.

Save

Savethegamerecordunderitsfilename.Ifthegamerecordisnew,askforfilenamefirst.Thiscommandisdisabledifthegamerecordisnotmodified.

Saveas

Savethegamerecordunderadifferentfilename.

Close

Closetheboardwindow.Ifthegamerecordismodified,askwhethertosaveitfirst.

Quit

QuitQuarry.Promptstosaveanyunsavedgamerecordsfirst.

Editmenu

Undo

Undothelastchangemadeinthecurrentgamerecord.

Redo

Redothelastundonechangemadeinthecurrentgamerecord.

Cut

Cutsubtreehavingthecurrentnodeasitsrootintoclipboard.

Copy

Copysubtreehavingthecurrentnodeasitsrootintoclipboard.

Paste

Pastesubtreecontainedinclipboardaslastchildofthecurrentnode.Thiscommandmayfailife.g.thesubtreewascopiedfromadifferentkindofgame.

Note

Itiscurrentlyimpossibletodetermineiftheclipboardcontainsanything,thereforethismenuitemissensitiveevenifthereisnosubtreetopaste.

DeleteNode

Deletethecurrentnodetogetherwithitschildrenfromthegamerecord.

Tools

Toolsareveryimportantastheyarethemostused(togetherwithcommentediting)wayofmodifyinggamerecords.Activetoolcanalsobechangedusingtheeditingtoolbaroffromkeyboard.

MoveTool

Activatetoolwhichisusedtoplaynewmovesinthecurrentgamerecord.

SetupTool

Activatetoolwhichisusedtoaddandremovepiecesfromthecurrentnode.

CrossMarkup



Activatetoolwhichaddscrossmarkuptothecurrentposition.

CircleMarkup

Activatetoolwhichaddscirclemarkuptothecurrentposition.

CrossMarkup

Activatetoolwhichaddscrossmarkuptothecurrentposition.

SquareMarkup

Activatetoolwhichaddssqiaremarkuptothecurrentposition.

TriangleMarkup

Activatetoolwhichaddstrianglemarkuptothecurrentposition.

SelectedMarkup

Activatetoolwhichaddsselectedmarkuptothecurrentposition.

Note

It is not recommended to use this type ofmarkup, as it has no standard appearance and mayconfuseotherusers.

LabelTool

Activatetoolwhichplacessingleletterandarbitrarytextlabelsontheboard.

NumberTool

Activatetoolwhichplacesnumberlabelsontheboard.

ScoringTool

Activatetoolwhichscoresthecurrentposition.ThistoolisvalidonlyforGogames.

AddEmptyNode

Addanemptychildrentothecurrentnode.Standardwayofaddingchildrenisbyplayingmoves,butthiscommandallowsyoutoaddnodewithoutanymove.

MoveBranchUp

Movecurrentbranchupi.e.swapitwiththepreviousbranch.Usefultorearrangebranchesinthegamerecord.

MoveBranchDown

Movecurrentbranchdowni.e.swapitwiththenextbranch.Usefultorearrangebranchesinthegamerecord.

EditNodeName

Edit thenameofthecurrentnode.If thenodehasnoname, it is inserted.Otherwise,youcaneditnode justbydirectlymodifyingitinthecommentwindowandthiscommandsimplyselectsthename.

SetMoveNumber

Setthenumberofthecurrentmove.Normally,movenumberisincrementedbyoneaftereachmove,buttherearecaseswhenthismustbeoverridden,forinstance,ifgamerecordstartsnotatthegamebeginning.

PlayertoMove

Sometimesitisneededtoexplicitlysetwhoistomovenext,forinstance,inaproblemcollection.

White



SetplayertomovetoWhite,regardlessofwhatgamerulessay.

Black

SetplayertomovetoBlack,regardlessofwhatgamerulessay.

ByGameRules

Letgamerulesdeterminewhoistomovenext(thisisthedefault.)

Find

ShowtheFindDialogtofindastringinnodecommentsand/ornames.

FindNext

Repeatthelastsearchinforwarddirection.Iftherewerenolastsearch,actsjustasFindmenuitem.

FindPrevious

Repeatthelastsearchinbackwarddirection.Iftherewerenolastsearch,actsjustasFindmenuitem.

GameInformation

ShowtheGameInformationDialogtoviewand/orgeditgameinformation.

Preferences

ShowthePreferencesDialogtochangeQuarrysettings.

Viewmenu

MainToolbar

Showorhidemaintoolbarinthiswindow.

EditingToolbar

Showorhideeditingtoolbarinthiswindow.

NavigationToolbar

Showorhidenavigationtoolbarinthiswindow.

GameActionButtons

ShoworhideGameActionButtons(PassforGogameandResign.)Theyhavequiterarelyusedfunctionalityandtakepreciousspaceontheright.

GameTree

ShoworhideGameTreeViewinthiswindow.Itsvisibilitycanalsobegloballychangedinthepreferences.

RecenteronCurrentNode

RecenterGameTreeViewonthecurrentnode.Ofcourse,theviewshouldbeshowntobeginwith.

ControlCenter

ShowQuarryControlCenter.

Playmenu

Pass

Playapassmove.(OnlyvalidinGo.)



Resign

Resigncurrentgame.Opponentisdeclaredawinner.

AdjournGame

Adjourncurrentgameandsavegamerecord,soitcanbelaterresumed.

Gomenu

Note

ThismenustitleisEnglishverbgo,notgamename.

PreviousNode

Gotothepreviousnode(currentnodesparent.)

NextNode

Gotothenextnode(currentnodeschild.)Bydefault,nextnodeisthefirstchild,butitisrememberedifyouswitchtoadifferentchild.

TenNodesBackward

Gotennodesbackward.Iftherearelessthantennodes,stopattherootofthegametree.

TenNodesForward

Gotennodesforward.Iftherearelessthantennodes,stopatthebranchend.

RootNode

Gotothegametreeroot.

VariationLastNode

Gotothelastnodeinthecurrentbranch(variation.)

PreviousVariation

Gotothepreviousvariationofthecurrentnode.I.e.gotothepreviouschildoftheparentofthecurrentnode.

NextNode

Gotothenextvariationofthecurrentnode.I.e.gotothenextchildoftheparentofthecurrentnode.

GotoNamedNode

Gotoanamednodegivenitsname.YoucanalsouseFindDialogforthispurpose,butthisway there iscompletiononnodenames.

Helpmenu

Contents

Showthishelp.

About

ShowshortinformationaboutQuarryanditsversion.

FindDialog

FindDialogallowsyoutosearchfortextinnodenamesand/orcomments.Itisinvaluableforlargegamerecords,especiallythose



containingmultiplebranches,likedebut/josekidictionaries.

Whenanodewithmatchingtextisfound,boardwindowswitchestoit, ifneeded.Matchingtextisselectedininformationpane.SearchcanberepeatedlaterwithoutopeningthisdialogusingEditmenuitemsorfromkeyboard.

Dialogcontainsseveralcontrols:

Searchforfield

Enterthetexttosearchforhere.Fieldalsohasahistorywithupto10mostrecentlyfoundstrings.

Optons

Thereafewoptionsthatcontrolthesearch.Itcanbecasesensitiveorcaseinsensitive.Itcanberestrictedtowholewordsor includeanymatch.Searchcanbewrappedaroundwhen theendorbeginningof searchdomain is reached, or stopthere.

YoucanalsoselectAutoclosethisdialogbutton.Inthiscase,thedialogwillbehiddenafteranysuccessfulsearch.YoucanrepeatsearchafterwardsusingFindNextandFindPreviousitemsofEditmenuorusingCtrl+GandShift+Ctrl+Gkeycombinations.

Searchscope

Searchdomain can include thewholegame record tree or the current nodeonly.The latter option is only interesting ifcurrentnodescommentisverylong.

Searchcanalsobeperformedinnodenames,commentsorboth.Typically,youwillwanttosearchinbothofthem,butcansometimeswishtorestrictsearchtodecreasenumberofmatchesyouarenotinterestedin.

NextandPreviousbuttons

Whensearchparametersareentered,clickoneofthisbuttons,dependingondirectionyouwishsearchtobeperformed.Buttonscanbepressedrepeatedlytorepeatsearch.However,ifAutoclosethisdialogoptionisselected,dialogwillbeclosedonfirstsuccessfulsearch.

Thesebuttonscanbedisabled if a search incertaindirectioncertainlywont hit anymatches.However, they aremanycaseswhen thiscannotbedetermined inadvance (quickly), soactivatingoneof thesebuttons isnotguaranteed to findanything.

Closebutton

Closethedialogwithoutperforminganyfurthersearch.Useitwhenyouvefinishedsearchingorchangedyourmind.

GameInformationDialog

TheGameInformationDialogallowsyoutosetvaluesthatdescribegametreeasawholeandarenotspecifictoaparticularmoveorpositioninthegame.Ithasalotoffieldswhicharesplittedinthreepages.Allfieldsareoptionalandcanbeempty(notset),butdefiningthemgivesadditionaldescriptiontothegame.

Fieldson the firstpage (General)describe thegameopponents, rulesof thegameandnonspoilinggamedetails.Fieldon thesecondpage(Description&Result)aregenerallyspoilingandcanevendisclosegameoutcome.Thethirdpage(GameRecord)describetherecorditself.

WhitePlayerandBlackPlayer

Thisgroupoffieldsallowsyoutodescribe theopponents in thegame.TheName fieldsshouldbeobvious.TheTeamfieldsareusedwhenthegameisapartofamatchbetweentwoteams,forinstancenationalteams.Usually,theyareleftempty.TheRankoftheopponentscanbeenteredintheappropriatefields.Thisisusuallytherankasappliestothegameinquestion.Forinstance,thiscanbetherankawardedbythefederationguidingthetournamentoritcanbetherankofanInternetserverwherethegametookplace.

Valuesofthesefieldsarealsodisplayedintherightcolumnofboardwindows.

GameName

Thenameofthegame.Thisfieldcanbeemptyifthegameisnotspecialanddoesnthaveadistinguishedname.



Place

Theplacethegametookplaceat.ThiscanbeageographicallocationorthenameofanInternetserver.

Date

Thedatethegametookplaceon.ItshouldbeintheinternationalformatofYYYYMMDD.For instance20060723means23July2006.

Event

Theeventthisgameispartof.Forinstance,thiscanbethenameofatournament.Thisfieldisoftenempty.

Round

Theroundthisgameispartof.Forinstance1stroundorSemifinal.Thisfieldisoftenempty,especiallyifEventis.

Ruleset

Descriptive name of the rules this gamewas played in accordancewith. For instance, for Go this can be Japanese,Chineseetc.

Handicap

ForGoonly:numberofstonestheblackwasallowedtoplaceonhisfirstmove.This field iseither0ornotset for thegameswithnohandicap.

Note

Valueofthisfieldisonlyinformational.Itdoesntimplyanyparticularsettingoftheblackstones.

Komi

For Go only: the compensation, in points, the white receives for having the second turn. Can be negative or not set.However,itshouldalwaysbesetforgameswithnonzerokomi,asotherwiseproperscoringisimpossible.

Maintime

Maintimeeachplayerhas.Shouldnotbesetifthegameisplayedwithnotimelimit.

Overtime

Descriptionoftheovertimerulesusedforthisgame.Forinstance,25/600CanadianmeansCanadianovertimewith10minutes(600seconds)forevery25moves.

Gameresult

TheresultofthegameinSGFformat.

Table3.2.ValidGameresultvalues

Value Meaning

Void Thereisnoresultyet(thegameisnotfinished)ortherecanbenoresultatall(e.g.forproblems.)0orDraw Thegameisdraw,i.e.isfinished,buttheresnowinner.

W+scoreorB+score Aplayerhaswonbythespecifiedscore.Forinstance,W+6.5meansthatwhitehaswonby6.5points.

W+orB+ Aplayerhaswon.Usedmainlyforthegameswithoutanotionforscore,e.g.Amazons.W+ResignorB+ResignorW+RorB+R Aplayerhaswonbyresignation.

W+TimeorB+TimeorW+TorB+T Aplayerhaswonontime.I.e.hisopponentexceededhistimelimit.

W+ForfeitorB+ForfeitorW+ForB+F Aplayerhaswonbyforfeit,e.g.hisopponentmadeanillegalmove.



? Gameresultisunknown.

Openingplayed

Descriptionoftheopeningplayedinthegame.Thisfieldisoftenempty.

Comment/description

Descriptionfortheentiregame.Itcanbesomebackgroundinformationand/orthesummaryofthegame.

Copyrightstring

Shortcopyrightinformationforthegamerecord.

Annotator

Thenameofthepersonwhoprovidedcomments(annotation)forthegame.

Source

Thesourceofthegamerecord(book,journaletc.)Oftenisemptyifthegamerecordwasinelectronicformtobeginwith.

Enteredby

Nameofthepersonwhoenteredthegamerecord.Usuallyemptyforautomaticallycreatedrecords.

Chapter4.Settings

TableofContents

GeneralInterfaceGameTreeGTPEngines


SavingGameRecordsGoBoardAppearanceAmazonsBoardAppearanceReversiBoardAppearance

ToconfigureQuarryeitherclick thePreferencesbutton in theControlCenterwindowor chooseEditPreferencesmenuitem.

ThePreferencesdialogisdisplayed.Itconsistsofthefollowingcategories:

General

Interface

Editing&Viewing

GameTree

GTP

GTPEngines

GameRecords(SGF)

Saving

BoardAppearance



GoBoardAppearance

AmazonsBoardAppearance

ReversiBoardAppearance

GeneralInterface

GeneralinterfaceofQuarrycanbeconfiguredatthispage.Itisnotreallyrelatedtothefunctionalityoftheapplication.

FileChooserDialogStyle

Youcanuseeitherthenewfilechooserortheoldone,whichwasthedefaultonpre2.4GTK+.

Note

This optionwill be removed inQuarry ver. 0.3. Itwas addedwhen the new file chooser was in earlydevelopmentstagesandhadsignificantusabilityproblems.Nowadaysithaslittlesensetokeepsupportingtheoldone.

ToolbarStyles

Bydefault,Quarry uses desktop settings for all its toolbars.However, you can choose specific style for each of threetoolbarkinds.Youcanalsoreturntoolbarstousingdesktopdefaultshere.

GameTree

HereyoucancustomizeappearanceandbehavioroftheGameTreeView.

ShowGameTree

You can choosewhether theGameTreeView is shown inBoardWindows by default. If you chooseAutomaticallyoption,itwillbeshownifgamerecordhasanythinginadditiontothemainbranch.Inanycase,youcanshoworhidetheview manually, using View Game Tree menu item. In this case, automatic showing will be disabled, even ifcorrespondingoptionisselected.

TrackTreesCurrentNode

Youcanchoosewhethertheviewshouldtrackthecurrentnode,i.e.repositionitselftoshowit.Inautomaticmodeitonlytracksthecurrentnodeifitwasshowingitbefore.Thismodepreventstheviewfromscrollingifyouintentionallyscrolledittosomepartofthetreenotcontainingthecurrentnode.YoucanalwaysforcetheviewtodisplaythecurrentnodebyusingViewRecenteronCurrentNodemenuitem.

Youcanalsochoosewhether theviewwill scrollminimalpossibledistancewhile tracking (i.e. the current nodewill besomewherenearanedge),orifitwillalwaysrecenteronthecurrentnodeifneeded.Theseoptionsdontmakesense iftrackingisdisabled,sotheyaredisabledthentoo.

Showtooltips

ChoosewhetherGameTreeViewshouldshowtooltipsovernodes.Seeviewdescription fordetails.Youmaywant todisabletooltipsiftheylooktoodistracting.

GTPEngines

Atthispage,allgameplayingprogramsregisteredinQuarryareshown.Youcanregisternewprogramsandmodifyinformationinexistingentries.

AllregisteredprogramsareshowninthelistlabeledListofGTPengines.Whenyouselectoneofthem,someinformationaboutitis shown in the lowerpart of thedialog.This inlcudesprogramname,version, supportedgame(s) andcommand line.Thecommandlineisexactlywhatyouspecifiedwhileregisteringtheprogram,whiletherestofinformationisreportedbytheprogramitself.

ProgramsfromthelistarealsoshownintheNewGameandResumingGamedialogsasavailablecomputeropponents.However,youcanhidesomeofthembyremovingthemarkbesidetheprogramnameintheShowcolumn.Thismaybebetterthanremoving



aprogramrecordaltogetherincaseyoulaterregainyourinterestinit.Also,someGTPenginesmaybelistedinQuarry systemwidesettingsthosecannotberemoved,onlyhidden.

Therearealsofivebuttonsonthispage:

AddandModifybuttons

These two buttons allow you to register another program, or modify information about an already registered one,correspondingly.TheybothpopuptheGTPEngineInformationdialog.

Removebutton

Thisbuttonremovesagameplayingprogramfromthelistofregisteredprograms.TheunregisteredprogramwillnotappearintheNewGamedialogasanavailableopponent.Ofcourse,theprogramitselfisnottouchedandyoucanreregisteritinQuarrylater.

MoveUpandMoveDownbuttons

Usingthesetwobuttonsyoucanrearrangeregisteredprograms.ComputeropponentsintheNewGamedialogarelistedinexactlythesameorderasonthispage,soyoumaywanttoplacemorefrequentlyusedprogramsonthetop.AnotherwaytoreorderGTPprogramsistodraganddroptheirnamesinthelist.


Thisdialog is shownwheneveryouwant to register agameplayingprogram inQuarryormodify information about an alreadyregisteredone.Dependingonthesituation,itcanbetitledeitherNewGTPEngineorModifyGTPEngineInformation.Afteryou fill in the dialog, press theAdd orOK button.Quarry will launch the program to check if it works and ask it for someinformation.

Note

IfthemessageQueryingenginesname,versionandknowncommandsappearsandpersistsfortoolong(morethanafewseconds), thismost likely indicates that thecommandlineyouspecifystarts theprograminnonGTPmodeorstartsawrongprogramtobeginwith.Ifyoudontexpecttheprogramtobeveryslowoninitialization,thenclicktheCancelbuttonandfixthecommandline.

Thedialoghastwotextentryfields:

Commandline

Thecommandlinetostarttheprogramshouldbeenteredhere.YoucanusetheBrowsebuttontoselecttheprogram,butnormallyjustspecifyingprogramfilenameisenough.(Moreexactly,itisenoughiftheprogramisinstalledinadirectorythatisinyour$PATHenvironmentvariable.)Inanycase,youshouldenterprogramspecificoptionsafteritsfilename.To findoutwhichoptionsshouldbeused,seethemanualoftheprograminquestion.

ForGNUGo,thecommandlineshouldlooklikethis(notethedoublehyphens):

gnugo --mode gtp --quiet

Youmayalsowanttospecifyadditionaloptions.SeeGNUGodocumentationformoreinformation.

Screenname

InthisfieldyoucanspecifythewayQuarrywilldisplaythenameoftheprogram.Youcanenterthefullnameorusespecialsymbols%nand%v.Theywillbereplacedwiththenameandversionoftheprogramasitreportsthemitself.Inmostcasesthedefaultvalueof%n%viswhatyouwant,butsometimesitmakessensetoalterit.Forinstance,youcanspecify%n%vlevel5hereifyoufixedprogramslevelinthecommandline.If,forsomereason,youneedthepercentsigninthename,typeitinas%%(thepercentsignisusedasescapesymbolinthisfield.)

SavingGameRecords

Currently,youcanonlyspecifywhether tosavegamerecords inUTF8or topreserveoriginalencoding.The formeroption isrecommendedbecauseUTF8canencodeanycharacterandbecauseQuarryloadsUTF8encodedgamerecordsfasterthanwithanyotherencoding.However,youmaywanttopreserveoriginalencodingif,forinstance,youuseotherSGFeditor/viewerwithpoorsupportforUTF8orthisisrequiredforsomereasonfordistribution.



GoBoardAppearance

Sorry,notdocumentedyet

AmazonsBoardAppearance


ReversiBoardAppearance


AppendixA.QuarryAuthors

Programming

PaulPogonyshev

Mainauthor,programming,design.

MartinHolters

Programming.

Translation

JrmieKnuesel

Frenchtranslation.

PaulPogonyshev

BritishEnglishandRussiantranslations.

RobertStefaniuk

Polishtranslation.

AppendixB.GNUFreeDocumentationLicense

Version1.2,November2002

Copyright2000,2001,2002FreeSoftwareFoundation,Inc.

FreeSoftwareFoundation,Inc.51FranklinStreet,FifthFloor,Boston,MA021101301USA

Everyoneispermittedtocopyanddistributeverbatimcopiesofthislicensedocument,butchangingitisnotallowed.

Version1.2,November2002



Copyright2000,2001,2002FreeSoftwareFoundation, Inc.51FranklinSt,FifthFloor,Boston,MA021101301USA

Everyoneispermittedtocopyanddistributeverbatimcopiesofthislicensedocument,butchangingitisnotallowed.

0.PREAMBLE

ThepurposeofthisLicenseistomakeamanual,textbook,orotherfunctionalandusefuldocumentfreeinthesenseoffreedom:to assure everyone the effective freedom to copy and redistribute it, with or without modifying it, either commercially ornoncommercially.Secondarily,thisLicensepreservesfortheauthorandpublisherawaytogetcreditfortheirwork,whilenotbeingconsideredresponsibleformodificationsmadebyothers.

ThisLicenseisakindofcopyleft,whichmeansthatderivativeworksofthedocumentmustthemselvesbefreeinthesamesense.ItcomplementstheGNUGeneralPublicLicense,whichisacopyleftlicensedesignedforfreesoftware.

WehavedesignedthisLicenseinordertouseitformanualsforfreesoftware,becausefreesoftwareneedsfreedocumentation:afreeprogramshouldcomewithmanuals providing the same freedoms that the softwaredoes.But thisLicense is not limited tosoftwaremanualsitcanbeusedforanytextualwork,regardlessofsubjectmatterorwhetheritispublishedasaprintedbook.WerecommendthisLicenseprincipallyforworkswhosepurposeisinstructionorreference.

1.APPLICABILITYANDDEFINITIONS

ThisLicenseappliestoanymanualorotherwork,inanymedium,thatcontainsanoticeplacedbythecopyrightholdersayingitcanbedistributedunderthetermsofthisLicense.Suchanoticegrantsaworldwide,royaltyfreelicense,unlimitedinduration,tousethatworkunder theconditionsstatedherein.TheDocument,below, refers to any suchmanualorwork.Anymemberof thepublicisalicensee,andisaddressedasyou.Youacceptthelicenseifyoucopy,modifyordistributetheworkinawayrequiringpermissionundercopyrightlaw.

AModifiedVersionoftheDocumentmeansanyworkcontainingtheDocumentoraportionofit,eithercopiedverbatim,orwithmodificationsand/ortranslatedintoanotherlanguage.

ASecondarySectionisanamedappendixorafrontmattersectionoftheDocumentthatdealsexclusivelywiththerelationshipofthepublishersorauthorsoftheDocumenttotheDocument'soverallsubject(ortorelatedmatters)andcontainsnothingthatcouldfalldirectlywithinthatoverallsubject.(Thus,iftheDocumentisinpartatextbookofmathematics,aSecondarySectionmaynotexplainanymathematics.)Therelationshipcouldbeamatterofhistoricalconnectionwiththesubjectorwithrelatedmatters,oroflegal,commercial,philosophical,ethicalorpoliticalpositionregardingthem.

TheInvariantSectionsarecertainSecondarySectionswhose titlesaredesignated,asbeing thoseof InvariantSections, in thenoticethatsaysthattheDocumentisreleasedunderthisLicense.IfasectiondoesnotfittheabovedefinitionofSecondarythenitisnotallowedtobedesignatedasInvariant.TheDocumentmaycontainzeroInvariantSections.IftheDocumentdoesnotidentifyanyInvariantSectionsthentherearenone.

TheCoverTextsarecertainshortpassagesoftextthatarelisted,asFrontCoverTextsorBackCoverTexts,inthenoticethatsaysthattheDocumentisreleasedunderthisLicense.AFrontCoverTextmaybeatmost5words,andaBackCoverTextmaybeatmost25words.

ATransparentcopyoftheDocumentmeansamachinereadablecopy,representedinaformatwhosespecificationisavailabletothegeneralpublic,thatissuitableforrevisingthedocumentstraightforwardlywithgenerictexteditorsor(forimagescomposedofpixels) generic paint programs or (for drawings) some widely available drawing editor, and that is suitable for input to textformattersorforautomatic translation toavarietyof formatssuitable for input to text formatters.Acopymade inanotherwiseTransparentfileformatwhosemarkup,orabsenceofmarkup,hasbeenarrangedtothwartordiscouragesubsequentmodificationbyreadersisnotTransparent.Animageformat isnotTransparent ifusedforanysubstantialamountoftext.Acopy that isnotTransparentiscalledOpaque.

Examples of suitable formats for Transparent copies include plain ASCII without markup, Texinfo input format, LaTeX inputformat,SGMLorXMLusingapubliclyavailableDTD,andstandardconformingsimpleHTML,PostScriptorPDFdesignedforhumanmodification.Examples of transparent image formats include PNG,XCF and JPG.Opaque formats include proprietaryformatsthatcanbereadandeditedonlybyproprietarywordprocessors,SGMLorXMLforwhichtheDTDand/orprocessingtoolsarenotgenerallyavailable,andthemachinegeneratedHTML,PostScriptorPDFproducedbysomewordprocessorsforoutputpurposesonly.

The TitlePagemeans, for a printed book, the title page itself, plus such following pages as are needed to hold, legibly, thematerialthisLicenserequirestoappearinthetitlepage.Forworksinformatswhichdonothaveanytitlepageassuch,TitlePagemeansthetextnearthemostprominentappearanceofthework'stitle,precedingthebeginningofthebodyofthetext.



A section Entitled XYZ means a named subunit of the Document whose title either is precisely XYZ or contains XYZ inparenthesesfollowingtextthattranslatesXYZinanotherlanguage.(HereXYZstandsforaspecificsectionnamementionedbelow,suchasAcknowledgements,Dedications,Endorsements,orHistory.)ToPreservetheTitleofsuchasectionwhenyoumodifytheDocumentmeansthatitremainsasectionEntitledXYZaccordingtothisdefinition.

TheDocumentmayincludeWarrantyDisclaimersnexttothenoticewhichstatesthatthisLicenseappliestotheDocument.TheseWarrantyDisclaimersareconsideredtobeincludedbyreferenceinthisLicense,butonlyasregardsdisclaimingwarranties: anyotherimplicationthattheseWarrantyDisclaimersmayhaveisvoidandhasnoeffectonthemeaningofthisLicense.

2.VERBATIMCOPYING

YoumaycopyanddistributetheDocumentinanymedium,eithercommerciallyornoncommercially,providedthatthisLicense,thecopyrightnotices,andthelicensenoticesayingthisLicenseappliestotheDocumentarereproducedinallcopies,andthatyouaddnootherconditionswhatsoevertothoseofthisLicense.Youmaynotusetechnicalmeasurestoobstructorcontrolthereadingorfurther copying of the copies youmake or distribute.However, youmay accept compensation in exchange for copies. If youdistributealargeenoughnumberofcopiesyoumustalsofollowtheconditionsinsection3.

Youmayalsolendcopies,underthesameconditionsstatedabove,andyoumaypubliclydisplaycopies.

3.COPYINGINQUANTITY

Ifyoupublishprintedcopies(orcopiesinmediathatcommonlyhaveprintedcovers)oftheDocument,numberingmorethan100,andtheDocument'slicensenoticerequiresCoverTexts,youmustenclosethecopiesincoversthatcarry,clearlyandlegibly,alltheseCoverTexts:FrontCoverTextsonthefrontcover,andBackCoverTextsonthebackcover.Bothcoversmustalsoclearlyandlegiblyidentifyyouasthepublisherofthesecopies.Thefrontcovermustpresentthefulltitlewithallwordsofthetitleequallyprominentandvisible.Youmayaddothermaterialonthecoversinaddition.Copyingwithchangeslimitedtothecovers,aslongastheypreservethetitleoftheDocumentandsatisfytheseconditions,canbetreatedasverbatimcopyinginotherrespects.

Iftherequiredtextsforeithercoveraretoovoluminoustofitlegibly,youshouldputthefirstoneslisted(asmanyasfitreasonably)ontheactualcover,andcontinuetherestontoadjacentpages.

IfyoupublishordistributeOpaquecopiesoftheDocumentnumberingmorethan100,youmusteitherincludeamachinereadableTransparentcopyalongwitheachOpaquecopy,orstateinorwitheachOpaquecopyacomputernetworklocationfromwhichthegeneralnetworkusingpublichasaccesstodownloadusingpublicstandardnetworkprotocolsacompleteTransparentcopyoftheDocument, free of addedmaterial. If you use the latter option, you must take reasonably prudent steps, when you begindistributionofOpaquecopiesinquantity,toensurethatthisTransparentcopywillremainthusaccessibleatthestatedlocationuntilatleastoneyearafterthelasttimeyoudistributeanOpaquecopy(directlyorthroughyouragentsorretailers)ofthateditiontothepublic.

Itisrequested,butnotrequired,thatyoucontacttheauthorsoftheDocumentwellbeforeredistributinganylargenumberofcopies,togivethemachancetoprovideyouwithanupdatedversionoftheDocument.

4.MODIFICATIONS

YoumaycopyanddistributeaModifiedVersionoftheDocumentundertheconditionsofsections2and3above,providedthatyou release theModifiedVersionunder precisely thisLicense,with theModifiedVersion filling the role of theDocument, thuslicensingdistributionandmodificationoftheModifiedVersiontowhoeverpossessesacopyofit.Inaddition,youmustdothesethingsintheModifiedVersion:

A. Use in theTitlePage (and on the covers, if any) a title distinct from that of theDocument, and from those of previousversions(whichshould,iftherewereany,belistedintheHistorysectionoftheDocument).Youmayusethesametitleasapreviousversioniftheoriginalpublisherofthatversiongivespermission.

B. List on theTitle Page, as authors, one ormore persons or entities responsible for authorship of themodifications in theModifiedVersion, togetherwithat least fiveof theprincipalauthorsof theDocument (allof itsprincipalauthors, if ithasfewerthanfive),unlesstheyreleaseyoufromthisrequirement.

C. StateontheTitlepagethenameofthepublisheroftheModifiedVersion,asthepublisher.

D. PreserveallthecopyrightnoticesoftheDocument.

E. Addanappropriatecopyrightnoticeforyourmodificationsadjacenttotheothercopyrightnotices.

F. Include, immediatelyafter thecopyrightnotices,a licensenoticegiving thepublicpermission touse theModifiedVersion



underthetermsofthisLicense,intheformshownintheAddendumbelow.

G. Preserveinthat licensenoticethefull listsofInvariantSectionsandrequiredCoverTextsgiven in theDocument's licensenotice.

H. IncludeanunalteredcopyofthisLicense.

I. PreservethesectionEntitledHistory,PreserveitsTitle,andaddtoitanitemstatingatleastthetitle,year,newauthors,andpublisheroftheModifiedVersionasgivenontheTitlePage.IfthereisnosectionEntitledHistoryintheDocument,createonestatingthetitle,year,authors,andpublisheroftheDocumentasgivenonitsTitlePage,thenaddanitemdescribingtheModifiedVersionasstatedintheprevioussentence.

J. Preservethenetworklocation,ifany,givenintheDocumentforpublicaccesstoaTransparentcopyoftheDocument,andlikewise thenetwork locationsgiven in theDocument forpreviousversions itwasbasedon.Thesemaybeplaced in theHistorysection.YoumayomitanetworklocationforaworkthatwaspublishedatleastfouryearsbeforetheDocumentitself,oriftheoriginalpublisheroftheversionitreferstogivespermission.

K. ForanysectionEntitledAcknowledgementsorDedications,PreservetheTitleofthesection,andpreserveinthesectionallthesubstanceandtoneofeachofthecontributoracknowledgementsand/ordedicationsgiventherein.

L. Preserve all the Invariant Sections of the Document, unaltered in their text and in their titles. Section numbers or theequivalentarenotconsideredpartofthesectiontitles.

M. DeleteanysectionEntitledEndorsements.SuchasectionmaynotbeincludedintheModifiedVersion.

N. DonotretitleanyexistingsectiontobeEntitledEndorsementsortoconflictintitlewithanyInvariantSection.

O. PreserveanyWarrantyDisclaimers.

If theModified Version includes new frontmatter sections or appendices that qualify as Secondary Sections and contain nomaterialcopiedfromtheDocument,youmayatyouroptiondesignatesomeorallofthesesectionsasinvariant.Todothis, addtheir titles to the list of Invariant Sections in theModifiedVersion's licensenotice.These titlesmust be distinct from any othersectiontitles.

Youmay add a section Entitled Endorsements, provided it contains nothing but endorsements of yourModified Version byvariouspartiesforexample,statementsofpeerrevieworthatthetexthasbeenapprovedbyanorganizationastheauthoritativedefinitionofastandard.

YoumayaddapassageofuptofivewordsasaFrontCoverText,andapassageofupto25wordsasaBackCoverText,totheendofthelistofCoverTextsintheModifiedVersion.OnlyonepassageofFrontCoverTextandoneofBackCoverTextmaybeaddedby(orthrougharrangementsmadeby)anyoneentity.IftheDocumentalreadyincludesacovertextforthesamecover,previouslyaddedbyyouorbyarrangementmadebythesameentityyouareactingonbehalfof,youmaynotaddanotherbutyoumayreplacetheoldone,onexplicitpermissionfromthepreviouspublisherthataddedtheoldone.

Theauthor(s)andpublisher(s)oftheDocumentdonotbythisLicensegivepermission touse theirnamesforpublicityforor toassertorimplyendorsementofanyModifiedVersion.

5.COMBININGDOCUMENTS

YoumaycombinetheDocumentwithotherdocumentsreleasedunderthisLicense,underthetermsdefinedinsection4aboveformodifiedversions, provided that you include in the combination all of the Invariant Sections of all of the original documents,unmodified, and list them all as Invariant Sections of your combinedwork in its license notice, and that you preserve all theirWarrantyDisclaimers.

ThecombinedworkneedonlycontainonecopyofthisLicense,andmultipleidenticalInvariantSectionsmaybereplacedwithasinglecopy.IftherearemultipleInvariantSectionswiththesamenamebutdifferentcontents,makethetitleofeachsuch sectionuniquebyaddingat theendof it, inparentheses, thenameof theoriginalauthororpublisherof thatsection ifknown,orelseauniquenumber.MakethesameadjustmenttothesectiontitlesinthelistofInvariantSectionsinthelicensenoticeofthecombinedwork.

Inthecombination,youmustcombineanysectionsEntitledHistoryinthevariousoriginaldocuments,formingonesectionEntitledHistorylikewisecombineanysectionsEntitledAcknowledgements,andanysectionsEntitledDedications.YoumustdeleteallsectionsEntitledEndorsements.

6.COLLECTIONSOFDOCUMENTS



YoumaymakeacollectionconsistingoftheDocumentandotherdocumentsreleasedunderthisLicense,andreplacetheindividualcopiesofthisLicenseinthevariousdocumentswithasinglecopythat is includedinthecollection,providedthatyoufollowtherulesofthisLicenseforverbatimcopyingofeachofthedocumentsinallotherrespects.

Youmayextractasingledocumentfromsuchacollection,anddistributeitindividuallyunderthisLicense,providedyouinsertacopyofthisLicenseintotheextracteddocument,andfollowthisLicenseinallotherrespectsregardingverbatimcopyingof thatdocument.

7.AGGREGATIONWITHINDEPENDENTWORKS

AcompilationoftheDocumentoritsderivativeswithotherseparateandindependentdocumentsorworks,inoronavolumeofastorageordistributionmedium,iscalledanaggregateifthecopyrightresultingfromthecompilationisnotusedtolimitthelegalrightsof thecompilation'susersbeyondwhat the individualworkspermit.When theDocument is included in an aggregate, thisLicensedoesnotapplytotheotherworksintheaggregatewhicharenotthemselvesderivativeworksoftheDocument.

IftheCoverTextrequirementofsection3isapplicabletothesecopiesoftheDocument,theniftheDocumentislessthanonehalfoftheentireaggregate,theDocument'sCoverTextsmaybeplacedoncoversthatbrackettheDocumentwithintheaggregate,ortheelectronicequivalentofcoversiftheDocumentisinelectronicform.Otherwisetheymustappearonprintedcoversthatbracketthewholeaggregate.

8.TRANSLATION

Translationisconsideredakindofmodification,soyoumaydistributetranslationsoftheDocumentunderthetermsofsection4.Replacing Invariant Sections with translations requires special permission from their copyright holders, but you may includetranslationsof someor all InvariantSections in addition to theoriginal versionsof these InvariantSections.Youmay include atranslationofthisLicense,andallthelicensenoticesintheDocument,andanyWarrantyDisclaimers,providedthatyoualsoincludetheoriginalEnglishversionof thisLicense and theoriginalversionsof thosenotices anddisclaimers. In caseof a disagreementbetweenthetranslationandtheoriginalversionofthisLicenseoranoticeordisclaimer,theoriginalversionwillprevail.

IfasectionintheDocumentisEntitledAcknowledgements,Dedications,orHistory,therequirement(section4)toPreserveitsTitle(section1)willtypicallyrequirechangingtheactualtitle.

9.TERMINATION

Youmaynotcopy,modify,sublicense,ordistributetheDocumentexceptasexpresslyprovidedforunderthisLicense.Anyotherattempt to copy,modify, sublicense or distribute theDocument is void, and will automatically terminate your rights under thisLicense.However,partieswhohavereceivedcopies,orrights,fromyouunderthisLicensewillnothavetheirlicensesterminatedsolongassuchpartiesremaininfullcompliance.

10.FUTUREREVISIONSOFTHISLICENSE

TheFreeSoftwareFoundationmaypublishnew, revisedversionsof theGNUFreeDocumentationLicense from time to time.Suchnewversionswillbesimilarinspirittothepresentversion,butmaydifferindetailtoaddressnewproblemsorconcerns.Seehttp://www.gnu.org/copyleft/.

EachversionoftheLicenseisgivenadistinguishingversionnumber.IftheDocumentspecifiesthataparticularnumberedversionofthisLicenseoranylaterversionappliestoit,youhavetheoptionoffollowingthetermsandconditionseitherof thatspecifiedversionorofanylaterversionthathasbeenpublished(notasadraft)bytheFreeSoftwareFoundation.IftheDocumentdoesnotspecify a version number of this License, youmay choose any version ever published (not as a draft) by the Free SoftwareFoundation.

ADDENDUM:HowtousethisLicenseforyourdocuments

TousethisLicenseinadocumentyouhavewritten,includeacopyoftheLicenseinthedocumentandputthefollowingcopyrightandlicensenoticesjustafterthetitlepage:

CopyrightYEARYOURNAME.

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU FreeDocumentation License, Version 1.2 or any later version published by the Free Software Foundation with noInvariantSections,noFrontCoverTexts,andnoBackCoverTexts.AcopyofthelicenseisincludedinthesectionentitledGNUFreeDocumentationLicense.



IfyouhaveInvariantSections,FrontCoverTextsandBackCoverTexts,replacethewith...Texts.linewiththis:

withtheInvariantSectionsbeingLISTTHEIRTITLES,withtheFrontCoverTextsbeingLIST,andwiththeBackCoverTextsbeingLIST.

IfyouhaveInvariantSectionswithoutCoverTexts,orsomeothercombinationofthethree,mergethosetwoalternativestosuitthesituation.

Ifyourdocumentcontainsnontrivialexamplesofprogramcode,werecommendreleasing theseexamples inparallelunderyourchoiceoffreesoftwarelicense,suchastheGNUGeneralPublicLicense,topermittheiruseinfreesoftware.