Transcript
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
3/3/2015 Quarry Manual
http://download.gna.org/quarry/help/en/quarry.html 2/27
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.
3/3/2015 Quarry Manual
http://download.gna.org/quarry/help/en/quarry.html 3/27
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
3/3/2015 Quarry Manual
http://download.gna.org/quarry/help/en/quarry.html 4/27
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
3/3/2015 Quarry Manual
http://download.gna.org/quarry/help/en/quarry.html 5/27
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
3/3/2015 Quarry Manual
http://download.gna.org/quarry/help/en/quarry.html 6/27
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
3/3/2015 Quarry Manual
http://download.gna.org/quarry/help/en/quarry.html 7/27
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.
3/3/2015 Quarry Manual
http://download.gna.org/quarry/help/en/quarry.html 8/27
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
3/3/2015 Quarry Manual
http://download.gna.org/quarry/help/en/quarry.html 9/27
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
3/3/2015 Quarry Manual
http://download.gna.org/quarry/help/en/quarry.html 10/27
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
3/3/2015 Quarry Manual
http://download.gna.org/quarry/help/en/quarry.html 11/27
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
3/3/2015 Quarry Manual
http://download.gna.org/quarry/help/en/quarry.html 12/27
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
3/3/2015 Quarry Manual
http://download.gna.org/quarry/help/en/quarry.html 13/27
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
3/3/2015 Quarry Manual
http://download.gna.org/quarry/help/en/quarry.html 14/27
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
3/3/2015 Quarry Manual
http://download.gna.org/quarry/help/en/quarry.html 15/27
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.)
3/3/2015 Quarry Manual
http://download.gna.org/quarry/help/en/quarry.html 16/27
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
3/3/2015 Quarry Manual
http://download.gna.org/quarry/help/en/quarry.html 17/27
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.
3/3/2015 Quarry Manual
http://download.gna.org/quarry/help/en/quarry.html 18/27
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.
3/3/2015 Quarry Manual
http://download.gna.org/quarry/help/en/quarry.html 19/27
? 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
GTPEngineInformationDialog
SavingGameRecordsGoBoardAppearanceAmazonsBoardAppearanceReversiBoardAppearance
ToconfigureQuarryeitherclick thePreferencesbutton in theControlCenterwindowor chooseEditPreferencesmenuitem.
ThePreferencesdialogisdisplayed.Itconsistsofthefollowingcategories:
General
Interface
Editing&Viewing
GameTree
GTP
GTPEngines
GameRecords(SGF)
Saving
BoardAppearance
3/3/2015 Quarry Manual
http://download.gna.org/quarry/help/en/quarry.html 20/27
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
3/3/2015 Quarry Manual
http://download.gna.org/quarry/help/en/quarry.html 21/27
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.
GTPEngineInformationDialog
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.
3/3/2015 Quarry Manual
http://download.gna.org/quarry/help/en/quarry.html 22/27
GoBoardAppearance
Sorry,notdocumentedyet
AmazonsBoardAppearance
Sorry,notdocumentedyet
ReversiBoardAppearance
Sorry,notdocumentedyet
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
3/3/2015 Quarry Manual
http://download.gna.org/quarry/help/en/quarry.html 23/27
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.
3/3/2015 Quarry Manual
http://download.gna.org/quarry/help/en/quarry.html 24/27
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
3/3/2015 Quarry Manual
http://download.gna.org/quarry/help/en/quarry.html 25/27
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
3/3/2015 Quarry Manual
http://download.gna.org/quarry/help/en/quarry.html 26/27
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.
3/3/2015 Quarry Manual
http://download.gna.org/quarry/help/en/quarry.html 27/27
IfyouhaveInvariantSections,FrontCoverTextsandBackCoverTexts,replacethewith...Texts.linewiththis:
withtheInvariantSectionsbeingLISTTHEIRTITLES,withtheFrontCoverTextsbeingLIST,andwiththeBackCoverTextsbeingLIST.
IfyouhaveInvariantSectionswithoutCoverTexts,orsomeothercombinationofthethree,mergethosetwoalternativestosuitthesituation.
Ifyourdocumentcontainsnontrivialexamplesofprogramcode,werecommendreleasing theseexamples inparallelunderyourchoiceoffreesoftwarelicense,suchastheGNUGeneralPublicLicense,topermittheiruseinfreesoftware.
top related