-
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.