Вы находитесь на странице: 1из 27

3/3/2015

Quarry Manual

QuarryManual
PaulPogonyshev
<pogonyshev@gmx.net>

Thismanualdescribesversion0.2ofQuarry.
Copyright2004,2005,2006PaulPogonyshev
Permissionisgrantedtocopy,distributeand/ormodifythisdocumentunderthetermsoftheGNUFreeDocumentationLicense,Version
1.2oranylaterversionpublishedbytheFreeSoftwareFoundationwithnoInvariantSections,noFrontCoverTexts,andnoBackCover
Texts.AcopyofthelicenseisincludedinthesectionentitledGNUFreeDocumentationLicenseorinthefile COPYING-DOCSdistributed
withthismanual.
DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED UNDER THE TERMS OF THE GNU FREE
DOCUMENTATIONLICENSEWITHTHEFURTHERUNDERSTANDINGTHAT:
1. DOCUMENT IS PROVIDED ON AN AS IS BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR
IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES THAT THE DOCUMENT OR MODIFIED VERSION OF
THE DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE OR NONINFRINGING.
THE ENTIRE RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE OF THE DOCUMENT OR MODIFIED
VERSIONOFTHEDOCUMENTISWITHYOU.SHOULDANYDOCUMENTORMODIFIEDVERSIONPROVEDEFECTIVE
IN ANY RESPECT, YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY CONTRIBUTOR) ASSUME THE COST OF ANY
NECESSARY SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER OF WARRANTY CONSTITUTES AN
ESSENTIAL PART OF THIS LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS
AUTHORIZEDHEREUNDEREXCEPTUNDERTHISDISCLAIMERAND
2. UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE),
CONTRACT, OR OTHERWISE, SHALL THE AUTHOR, INITIAL WRITER, ANY CONTRIBUTOR, OR ANY DISTRIBUTOR
OFTHEDOCUMENTORMODIFIEDVERSIONOFTHEDOCUMENT,ORANYSUPPLIEROFANYOFSUCHPARTIES,BE
LIABLETOANYPERSONFORANYDIRECT,INDIRECT,SPECIAL,INCIDENTAL,ORCONSEQUENTIALDAMAGESOF
ANY CHARACTER INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF GOODWILL, WORK STOPPAGE,
COMPUTER FAILURE OR MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR LOSSES ARISING OUT OF OR
RELATING TO USE OF THE DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT, EVEN IF SUCH PARTY
SHALLHAVEBEENINFORMEDOFTHEPOSSIBILITYOFSUCHDAMAGES.
Feedback
ToreportabugormakeasuggestionregardingtheQuarryapplicationorthismanual,eithersendamessageto<quarry-dev@gna.org>or
useQuarrybugtracker.

RevisionHistory
RevisionQuarryManualV0.2

November2006

PaulPogonyshev<pogonyshev@gmx.net>

TableofContents
Introduction
1.GettingStarted
ToStartQuarry
WhenYouStartQuarry
2.Usage
ToStartaNewGame
ToOpenaGameRecord
ToSaveaGameRecord
ToRegisteraGamePlayingProgram
http://download.gna.org/quarry/help/en/quarry.html

1/27

3/3/2015

Quarry Manual

ToAdjournaGame
ToResumeaGame
3.QuarryWindowsandMenus
NewGameDialog
Game&PlayersPage
GameRulesPage
NewGameRecordDialog
ResumingGameDialog
BoardWindows
TheBoard
BoardWindowInformationPane
GameTreeView
BoardWindowMenu
FindDialog
GameInformationDialog
4.Settings
GeneralInterface
GameTree
GTPEngines
GTPEngineInformationDialog
SavingGameRecords
GoBoardAppearance
AmazonsBoardAppearance
ReversiBoardAppearance
A.QuarryAuthors
B.GNUFreeDocumentationLicense

ListofFigures
1.1.QuarryControlCenter
3.1.QuarryBoardWindowshowingKogosJosekiDictionary
ListofTables
3.1.Boardkeyboardshortcuts
3.2.ValidGameresultvalues

Introduction
TheQuarryapplicationallowsyoutoplaytheboardgamesofGo,AmazonsandReversi.Youcanplaywithcomputerprogramsor
withanotherhuman,andsave,viewandeditgamerecords.
Quarryprovidesthefollowingfeatures:
SupportforGo,AmazonsandReversigames.
Niceresizableboard.
Playinggames:
GNUGo,GRhinooranyotherGTP(GameTextProtocol)enginecanbeyouropponent.
Computervs.computerandhumanvs.humangamesareanoptiontoo.
http://download.gna.org/quarry/help/en/quarry.html

2/27

3/3/2015

Quarry Manual

Goodsupportfortimecontrol.
Gamescanbeadjournedandlaterresumed.
Gamerecords:
AllgamescanbestoredinwidelysupportedSGFFF[4]fileformat.
FastandrobustparsercanreadSGFfilesofanyversion.
Inparticular,KogosJosekiDictionarycanbebrowsedwithQuarry.
GameTreeViewallowsforeasynavigationofgamerecords.
Textsearchincommentsisapowerfultoolifyouknowwhattosearchfor.
GoboardpositioncanbeexportedinaformatsuitableforinsertingintoSenseisLibrary.
SupportforvariousSGFlabelsandmarkup.
Note
QuarryitselfcanplayneitherGo,norAmazons,norReversi.Tohaveacomputeropponent,you needtofinda
program(e.g.GNUGomentionedabove)thatsupportsGTPandregisteritinQuarry.
Note
QuarrydoesnothaveanysupportforInternetgameserversanditwillnotbeaddedbeforeversions0.3.x.

Chapter1.GettingStarted
TableofContents
ToStartQuarry
WhenYouStartQuarry

ToStartQuarry
YoucanstartQuarryfromyourApplicationsmenu,itshouldtypicallybeavailableunderGamesBoardGames.However,this
maydependontheexactwayyouinstalledtheprogramandyouroperatingsystem.
Quarrycanalsobestartedfromthecommandline.SimplytypequarryinandpressReturn.
YoucanalsohaveQuarryopenoneormoregamerecordsimmediatlyafteryoustartit.Justtype
quarryfile1.sgf file2.sgf ...

inthecommandlineandpressReturn.Quarrywillstartwithspecifiedfile(s)open.
Note
Filenamesdonthavetoendin.sgf,butnamesofSGFfilestypicallydohavethissuffix.

WhenYouStartQuarry
WhenyoustartQuarry,ControlCenterwindowisdisplayed:
Figure1.1.QuarryControlCenter

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

3/27

3/3/2015

Quarry Manual

TheControlCenterwindowconsistsofthefollowingelements:
NewGamebutton
This button allows you to start a new game. ItwillpopuptheNewGamedialog where you can select the game (Go,
AmazonsorReversi),opponentsandgamespecificrules.
NewGameRecordbutton
Clickingthisbuttonsallowsyoutocreateagamerecordwithoutactuallyplayingagame.NewGameRecorddialogwillbe
shown,askingyouforbasicgamerecordparameters.
OpenGameRecordbutton
This button allows you to select a game record for viewing and/or editing. You will need to pick the file with the game
recordinthestandardOpenFiledialog.
ResumeGamebutton
Clickthisbuttontoresumeagameyouadjournedearlier.Actually,youcanresumeaboutanyunfinishedgame,evenone
youstartedinadifferentclient.AstandartOpenFiledialogwillbepoppedupforyoutoselectthefilecontainingthegame
recordyouwishtoresume.
Preferencesbutton
ThisbuttonopenstheQuarryPreferencesdialog.
Quitbutton
Closesallwindowsandquitstheprogram.However,ifthereareunsavedchangesinanyoftheopengamerecords,you
willbeaskedwhattodowiththemfirst.

Chapter2.Usage
TableofContents
ToStartaNewGame
ToOpenaGameRecord
ToSaveaGameRecord
ToRegisteraGamePlayingProgram
ToAdjournaGame
ToResumeaGame

ToStartaNewGame
http://download.gna.org/quarry/help/en/quarry.html

4/27

3/3/2015

Quarry Manual

Tostartanewgame,clicktheNewGamebuttonintheQuarryControlCenterwindoworchooseFileNewGamemenu
iteminanyofthealreadyopenBoardWindows.TheNewGamedialogwillappear,whereyoucanchoosethekindofgameyou
wantandtheopponents.
Ifyouwanttoplayagainstacomputerprogram,youneedtoregisteritinQuarryfirst(onceonly,ofcourse.)Todothis,clickthe
ManageEngineListbuttoninthedialog.
Formoreinformation,seethedetaileddescriptionofNewGamedialog.

ToOpenaGameRecord
Youcanopenagamerecordinoneofthreeways:
ClicktheOpenGameRecordbuttonintheControlCenterwindow.QuarrywilldisplaytheOpenSGFFiledialog.Select
thefilewiththegamerecordyouwanttoopenandclicktheOK.
ChooseFileOpenmenu item or simply press Ctrl+O in any opened Board window. Similarly to the previous case,
QuarrywilldisplaytheOpenSGFFiledialog.
WhenstartingQuarryfromthecommandline,specifythenameoffile(orseveralnamesatonce):
quarryfile1.sgf file2.sgf ...

Thespecifiedfile(s)willbeopenedautomatically.

ToSaveaGameRecord
Tosaveagamerecord,chooseFileSavemenuiteminitsBoardwindow(orsimplypressCtrl+S.)Ifthegamerecorddoes
notyethaveafilename,QuarrywilldisplaytheSaveAsdialog.Enterthenameforthefile,thenclicktheOK.
Ifyouwanttosaveagamerecordunderadifferentfilename,chooseFileSaveAsmenuitem.Enteranameforthefileinthe
SaveAsdialogandclickOK.

ToRegisteraGamePlayingProgram
ToregisteragameplayingprograminQuarry,firstopenthePreferencesdialogandselectGTPEnginescategoryinitsleftpane.
(You can also click the Manage Engine List button in the New Game dialog, which immediatly displays the GTP Engines
category.)
ThenclicktheAddbuttonand,intheappeareddialog,enterthecommandlinerequiredtolaunchtheprograminGTPmode.You
shouldconsulttheprogramsmanualtofindouthowthecommandlineshouldlooklike.Forinstance,commandlineforGNUGo
shouldbelikethis(notethedoublehyphens):
gnugo --mode gtp --quiet

Otherprogramsmayrequiredifferentoptionsornooptionsatall.

ToAdjournaGame
Toadjournagame,choosePlayAdjournGamemenuitem.Ifthegamehasneverbeensavedyet,youwillneedtoenterthe
nameofthefileyouwouldliketostoreitin.
Actually,adjourningdiffersfromsavingonlyinthatitclosesthegameswindow.

ToResumeaGame
Toresumeapreviouslyadjournedgame,clickResumeGamebuttonintheQuarryControlCenterwindoworselect Resume
GameitemfromtheFilemenu.Youwillbepromptedforthefilethatcontainsthegamerecord.
When you select the file, Resuming Game Dialog pops up, where you should specify the players. Quarry will try to guess the
opponentsbasedonthedatastoredinthegamerecord,butitcanmakeamistakeindeterminingwhetherthereareanycomputer
http://download.gna.org/quarry/help/en/quarry.html

5/27

3/3/2015

Quarry Manual

playersandwhichenginesshouldplay.Youwillalwayshavethefinalsay,though,andwillbeabletocorrectanymistakes.
Ifthegameyouselectisalreadyfinished,youwillbepromptedtoopenitforviewingand/oreditinginsteadofresuming.

Chapter3.QuarryWindowsandMenus
TableofContents
NewGameDialog
Game&PlayersPage
GameRulesPage
NewGameRecordDialog
ResumingGameDialog
BoardWindows
TheBoard
BoardWindowInformationPane
GameTreeView
BoardWindowMenu
FindDialog
GameInformationDialog

NewGameDialog
The New Game dialog consists of two pages, Game&PlayersandGame Rules. When you open the dialog, the first page
appears.WhenyouclickNextbutton,thesecondpageisdisplayed,whichisspecificforeachofthreegamesGo,Amazonsand
Reversi.

Game&PlayersPage
On this page you can select one of three available games and the opponents. Youcan make selections in arbitrary orderfirst
choosethegameandthentheopponentsortheotherwayround.Atanytime,allplayablecombinationsofgamesandcomputer
playersaremarkedwithYesicons,whileallunplayablecombinationsaremarkedwithNoicons.TheNextbuttonissensitive
onlywhenaplayablecombinationofgameandopponentsisselected.
Note
Beforeplayingagainstacomputerprogram(e.g.GNUGo, you need to register it in Quarry. See GTP Engines
sectionforhowtodothis.
Game&Playerspageconistsofthefollowingcontrols:
Gamesection
Hereyoucanselectthegameyouwanttoplay,eitherGo,AmazonsorReversi(alsoknownasOthello).Notethatmost
programscanplayonlyonegame.
WhitePlayerandBlackPlayersections
Thissetofcontrolsdeterminestheopponents.Eachopponentcanbeeitherahumanoracomputerprogram.Forahuman
playeryoucanspecifyhername(defaultstoyournameasreportedbythesystem.)Computeropponentshouldbeselected
fromthedropdownlist.Ifthelistdoesnotcontaintheprogramyouwanttoplayagainst,clicktheManageEngineList
attheendofthedialogtoregistertheprograminQuarry.
Whichplayeristomovefirstdependsonthegame.InGoandReversiblackmovesfirst,whileinAmazonswhitehasthe
firstturn.YoucanalwayschangesideswiththeSwapbuttontotheright.
Swapbutton
http://download.gna.org/quarry/help/en/quarry.html

6/27

3/3/2015

Quarry Manual

Thisbuttonallowsyoutoeasilyswapplayerssides.ItdoesnothingelsebutcopyingsettingsfromWhitePlayersectionto
BlackPlayersectionandviceversa.
ManageEngineListbutton
ThisbuttonopensQuarryPreferencesdialogattheGTPEnginespage.Aconvenientwaytoregisternewprogramand/or
modifyparametersofthealreadyregisteredonesjustbeforestartinganewgame.
Nextbutton
Whenyouaredonewiththispage,clicktheNextbuttontotweakgamespecificrulesonthenextpage.

GameRulesPage
Onthispageyoucanselecttherulesforthegame.Thepagehastwoparts.TheupperpartisdifferentforeachofGo,Amazons
andReversigamesandcontainsgamespecificrules.Thelowerpartcontainstimelimitsettingscontrolsandisthesameforallthree
games.Itisdescribedlast.
Whenyouhaveselectedtherulesyouwant,clickthePlaybuttontostartthegame.

GoRules
Gohasmanydifferentrulesetsthatdifferinscoringdetails,treatingofsomespecialpositionsetc.Currently,Quarrydoesntmake
anydifferencebetweenthem.However,existingrulecontrolsshouldbeenoughinmostcases.
BoardSizespinbutton
Choosethesizeofboardforthegamehere.Goistraditionallyplayedona1919board.99and1313boardsarealso
common.Quarrydoesntlimityoutothesechooseanysizebetween55and2525inclusive.
Traditionalboardsizebuttons
ThesebuttonsallowsyoutoquicklyselectoneofthreetraditionalGoboardsizeseither99,1313or1919.
Handicapcontrols
Whenoneoftheplayersisweaker,itiscommonpracticeinGotogivehimhandicapstones.Thisgivesherbetterchances
to win and makes the game more challenging (and thus more interesting) for the stronger player. The weaker player is
traditionallyplayingasblack.
Quarrysupportsbothfixed(alsoknownasJapanese)andfree(Chinese)handicaps.Inthefirstcase,handicapstonesare
placedfollowingatraditionalpattern,athoshipoints.Maximalfixedhandicapis9stones.Withfreehandicap,ontheother
hand,blackplayeractivelyplacesthehandicapstonesatanyintersectionsontheboard.Freehandicap is practically not
limited.
Note
Quarrytreatsfreehandicapasnonobligatory:itallowsblacktoplacefewerhandicapstonesthanspecified
ingamerules(butnotlessthantwo.)
Ifyouwantanevengame,simplysetthehandicaptozero.
Komispinbutton
Komiisthecompensationtothewhiteplayerforplayingsecond.Itisusuallynonintegertomakedrawsimpossible.The
currently suggested komi for even game on 1919 board is 6.5 points. Smaller (or even negative) komi gives some
advantagetoblackplayerandcanbeusedinadditiontoorinsteadofhandicap.
Seealsotimelimitsettingsdescription.

AmazonsRules
Atpresent,AmazonsrulesinQuarryarelimitedtoboardsizeandcommontimelimitsettings.StandardboardsizeforAmazonsis
1010(whichisalsoselectablewiththesmallbuttontotheright),butyoucanchooseanythingfrom55to2525inclusive.
http://download.gna.org/quarry/help/en/quarry.html

7/27

3/3/2015

Quarry Manual

ReversiRules
ReversirulesinQuarryarelimitedtoboardsizeandtimelimitsettingsdescribedjustbelowthissection.Standardboardsizefor
Reversiis88,though1010boardsarenotuncommoneither.Thisisreflectedbythechoiceoftraditionalboardsizeswiththe
buttonstotheright.However,inQuarryyoucanselectanyevenboardsizefrom66to2424inclusive.

TimeLimitSettings
Quarryallowstoplaygameswithlimitedtimeforbothplayers.Thisalsoappliestocomputerprogramplayerstheyhavetohonor
theallotedtimeorlose.Ofcoursetheprogramsareproperlynotifiedaboutthetimelimitsettingsandtheremainingtime.
Note
Computer opponents use CPU time to generate moves. This means that they usually need less time on faster
machines and more on slower machines. Also, if you run a computationally intensive task while playing, your
computeropponentsmaybecomeslower.Finally,certaincomputerprogramsmayalsothinkonopponentstime.
Quarryhasfourtypesoftimecontrol:
Nolimit
Bothopponentscantakeasmuchtimeastheylikeoneachmove,therearenolimits.InthismodeyoucanselecttheKeep
trackoftotaltimeoption.ThenQuarrywilldisplaythetotaltimespentonmoveponderingbyeachplayer.Thisispurely
foryourinformationandservesnootherpurpose.
Limitedtimeforentiregame
Eachplayerhaslimitedtimetoplaythewholegame.Ifaplayerfailstofinishthegameintheallotedtime,sheloses.Note
thattimelimitdoesntdependonthenumberofmovesinthegame.
Limitedtimepermove
Eachmovehastobeplayedinfixedtime.Time not used is not stored and not added to available time on next moves.
Whenusingthismode,keepinmindthatinmostgamestherearedifficultpositionsthatrequiremoreponderingtime.
Canadianovertime(alsoknownasCanadianbyoyomi)
This time control is often used in Go, but has nothing Gospecific, so it can be used in any other movebased game.
Canadian overtime has the advantage of imposing certain speed of play, but, at the same time, allowing to occasionally
spendmoretimeonimportantmoves.
Canadian overtime has three parameters: main time, overtime period length and moves per overtime. Both players
begingameintheirmaintime.Duringmaintimetheycanplayanynumberofmovesatanyspeed.Whenmaintimefora
playerisup,firstovertimeperiodbegins.Duringeachovertimeperiodaplayerhastoplaythespecifiednumberofmoves
(movesperovertime.)Ifshefailstodoso,shelosesontime.Otherwise,nextovertime(oftheverysamelength)begins
andtheplayerhastoplaythesamenumberofmovesthisbeforethetimeisupagain.Thenumberofovertimesisunlimited
andtheyarecompletelyequaltoeachother:timenotusedinoneovertimeperiodisnot storedandnotaddedtoother
overtimeperiods.

NewGameRecordDialog
TheNewGameRecorddialogallowsyoutostartanewgamerecordwithoutactuallyplayingagame.Whenyouaredoneentering
gamerecordinformation,presstheCreatebutton.OrpresstheCancelbuttontocancelgamerecordcreation.
Thedialogconsistsofthefollowingcontrolsbesidesthementionedbuttons:
Gameselectors
HereyouchoosethegameyouwanttocreatearecordofGo,AmazonsorReversi.AllthegamessupportedbyQuarry
arelisted.
Rulessection
Thissectioncontainsvariouscontrolsforbasicgamerules.TheyaredescribedinmoredetailsintheNew Game dialog
http://download.gna.org/quarry/help/en/quarry.html

8/27

3/3/2015

Quarry Manual

section.
OneimportantchangeisthePlacestonescheckbuttontotherightofhandicapspinbutton.ItdetermineswhetherQuarry
shouldplacethehandicapstonesforyou,ornot.Stonesareplacedasifthehandicapisfixed,butyoucanalwayschange
stonessetuplaterifneeded.
ShortGameInformation
Here you can enter the names of white and black player and the name of the game. You can change or expand this
informationlater,usingtheGameInformationdialog.

ResumingGameDialog
TheResumingGameDialogallowsyoutospecifyorcorrectgameplayerswhenresumingagame.Italsoshowssomeinformation
aboutthegame,mostofwhichisnoteditable.
Youcanspecifybothgameplayersandfixtheirnames,ifneeded.Therearetworadiobuttonsandacomboboxforeachplayer.
Radiobuttonscontrolwhetheraplayerisahumanoracomputer(someGTPengine.)Ifyouselecttoletcomputercontrolaplayer,
youcanchooseanyavailableGTPenginefromthelistforit.
Quarrytriestoguessplayersbasedontheirnames,asstoredinthegamerecord.Normally,ifthegamewasadjournedinQuarry
andyoudontaltercomputerplayernames,itshouldguesscorrectly.However,youcanalwaysoverrideandcorrectitsdecision.

BoardWindows
BoardwindowsarethemainpartofQuarry.Theyareusedtoplaygamesandviewandeditgamerecords.Totheleftinawindow
isthegameboarditself.Theexactappearanceoftheboarddependsonthecurrentgame(Go,AmazonsorReversi)andcanbe
configured.Ontherightsideofthewindowthereisinformationpane,includingthecommentwindow.Therecanalsobethegame
treeviewtothebottomoftherightpane.
Figure3.1.QuarryBoardWindowshowingKogosJosekiDictionary

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

9/27

3/3/2015

Quarry Manual

TheBoard
Boarddisplayscurrentgameposition,includingpieces,markup,labelsandvariationsofthecurrentnode. Coordinate labels are
shownontheedgesoftheboard.Theydependonthecurrentgame.Inthetopleftcornerasmallrectangleisdrawniftheboard
hasfocus.
Thelastmovemadeismarked.Dependingonthemarkuptheme,thiscanbeacrossorabullet.Onthescreenshotabove,last
placedstoneatP15ismarkedwithacross.
Note
Thissectioncanbeimproved.

Variations
Quarry treats variations as siblings of the current node. This is like Jago does and unlike CGoban. You always see the current
variationanditisnotapotentialforthenextnode/move.
Ontheboard,noncurrentvariationsthatcontainamoveareshownassmallghostlypieces.Variationsthatdontcontainamoveor
containapassmove(inGo)canbeseenonlyintheGameTreeView.ScreenshotaboveshowstwovariationsatQ18andQ19
ofthewhitemoveontheboard.
Youcanactivate(switchto)aparticularvariationbyrightclickingontheghoststoneontheboard.Forinstance,rightclickingon
Q18 in the window shown in the screen shot would make White Q18 the current move. In rare cases when there are multiple
variationswiththesamemove,rightclickingandshiftrightclickingscrollsthroughthelistofsuchvariations.Alternativeways of
switchingtodifferentvariationsincludeusingtheGameTreeViewandusingmenuitems,toolbarbuttonsorkeyboardshortcuts.

KeyboardNavigation
http://download.gna.org/quarry/help/en/quarry.html

10/27

3/3/2015

Quarry Manual

Boardhasseveralkeyboardshortcutstoeasegamerecordnavigation.Remember,thattheseshortcutsareactiveonlyiftheboard
has focus, as indicated with a small rectangle in the topleft corner. Otherwise, you should type them with Alt modifier: more
complicatedshortcutsworkeverywhereinBoardWindows.
Table3.1.Boardkeyboardshortcuts
Shortcut
Left
arrow
Right
arrow
PageUp
Page
Down
Home
End
Uparrow
Down
arrow

Action
Gotothepreviousnode(currentnodesparent.)
Gotothenextnode(currentnodeschild.)Bydefault,nextnodeisthefirstchild,butitisrememberedifyouswitch
toadifferentchild.
Gotennodesbackward.Iftherearelessthantennodes,stopattherootofthegametree.
Gotennodesforward.Iftherearelessthantennodes,stopatthebranchend.
Gotothegametreeroot.
Gotothelastnodeinthecurrentbranch(variation.)
Gotothepreviousvariationofthecurrentnode.I.e.gotothepreviouschildoftheparentofthecurrentnode.
Gotothenextvariationofthecurrentnode.I.e.gotothenextchildoftheparentofthecurrentnode.

BoardWindowInformationPane
GameInformationPaneshowsinformationaboutthegameingeneral,aboutthelastmovemadeandaboutthecurrentnode.Some
ofitscomponentsareoptionalandcanbehiddenintheViewmenu.
PlayerInformation
Atthetopofthepaneistheplayerinformationforbothplayers.Itshowsplayername,teamandrank(firstline),plusgame
specific information (second line.) If name is missing, string [unknown] is shown in its place. If team or rank is not
specified,theyaresimplynotshown.
GamespecificinformationincludesnumberofcapturesmadebyaplayerpluswhiteplayerskomiforGoandnumberof
disksontheboardforReversi.
PlayerClocks
Closetoplayerinformationaretheclocks.Whenagameisplayed,theydisplaythetimeleftforaplayer.Additionally,they
candisplaynumberofpiecesleftinthecurrentCanadianovertimeperiodinsmallerdigitstotheright.Whenagamerecord
isviewed,clocksdisplaytimeleftaftermoveinthecurrentnodehasbeenplayed.Clockscanbeemptyifagameisplayed
withouttimelimits.
MoveInformation
Belowplayerinformationandclocksasinglelinedisplaysmoveinformation.It shows last move (usually, current nodes
move)numberandthemoveitself.Afterwards,playertomoveisspecified.Thiscansometimesseeminglycontradictwith
thelastmove,butitisallowedtooverrideplayertomoveingamerecords(seeEditPlayertoMovesubmenu.)This
featureisoftenusedinproblemcollections.
GameResult
Belowmoveinformationgameresultisshown,butonlyattheverylastnodeofthegame.Thisisdoneinordertoprevent
spoilingofwatchingofunknowngames.Also,ifthegamelacksanyresultorisunfinishedthereisnothingtoshowatall.
GameActionButtons
Yetbelowtherearegameactionbuttons.TheseincludePass(forGo)andResign.Becausefunctionalityofthisbuttonsis
quiterarelyusedandtheytakeupspace,youcanhidethemusingViewGameActionButtonsmenuitem.Theyare
shownbydefaultmainlyasareminderoftheoptionsyouhave.
CommentWindow
Mostoftherightsideistakenbycommentwindow.Itdisplaysanycommentarythecurrentnodehas.Commentcanbe
edited and you dont need to take any actions to save your edits. Edits are also saved in the undo history and can be
http://download.gna.org/quarry/help/en/quarry.html

11/27

3/3/2015

Quarry Manual

undoneandredonefreely.
Ifthecurrentnodehasaname,itisshownabovecommentinboldunderlinedfont.Itcanbeeditedjustlikecommentand
you dont need any special steps to edit node name. However, to create a name for a node that lacks one, use
EditEditNodeNamemenuitem.Itwillinsertaplaceholderfornodenameinthewindow,whichyoucanthenreplace
withactualname.Todeleteaname,simplydeleteallitstext.Quarrywillnoticeitandremovenodelinefromthewindow.
GameTreeView
Finally, there can be the Game Tree View, described in detail in the next section. Its visibility is controlled by
ViewGameTreemenuitemandpreferences.

GameTreeView
Game Tree View shows game record as a tree in a style used byCGoban1.Generally, it is of interest only if the game record
containsvariations.For instance, a debut/joseki dictionary or a wellannotated game with alternate branches. Visibility of Game
TreeViewiscontrolledwithGameTreeiteminViewmenuandwithpreferences.
Nodewithamoveofaspecificplayer,includingpassmoveinGo,areshownaspiecesofplayerscolor.Othernodes,including
positionsetup,atpresentlackanyicon.Nodesthatbelongtoasamebranch(variation)areconnectedwithalineandthecurrent
branchishighlighted.Currentnodeisshownwithinablackrectangle.Ifitisnotvisible,youcanbringitonscreenusingRecenter
onCurrentNodecommandfromtheViewmenu.
Subtrees can be collapsed/expanded by rightclicking on subtree root. This is useful to hide nodes you are not interested in
currently.Rootsofcollapsednodeshaveacrossonthem.
Ifamouseisheldoveranode,atooltipwithinformationaboutthenodeisshown.Itincludesmovenumber,moveitself,nodename
andcomment.Ofcourse,someofthesecanbeabsentfromthetooltip,iftheyarenotpresentinthenodetobeginwith.If node
commentistoolong,onlyfirstpartofitisshown.Tooltipscanbedisabledinpreferencesiftheylooktoodistractingtoyou.

BoardWindowMenu
Filemenu
NewGame
ShowNewGameDialogtostartanewgame.
NewGameRecord
ShowNewGameRecordDialogtocreateanewgamerecordwithoutactuallyplayingagame.
Open
Openagamerecord.Recordmayaswellhavebeensavedinadifferentapplication.
ResumeGame
OpenagamerecordandshowResumeGameDialogtoresumethegame.Gamesadjournedindifferentapplicationscan
beresumedtoo.
Export
ASCIIDiagram
ExportcurrentboardpositionasafreeformatASCIIdiagramtotheclipboard.Usefule.g.tomailgamepositionif
youdontneedafullblownSGF.Onlyboardpositionwithoutanymarkupisstored.
SenseisLibraryDiagram
ExportcurrentboardpositionasaSenseisLibrarydiagramtotheclipboard.Pieces,circleandsquaremarkupand
labelsareexported.Result,ofcourse,canbeimportedintotheSenseisLibrary.OnlyavailableforGogames.
Note
http://download.gna.org/quarry/help/en/quarry.html

12/27

3/3/2015

Quarry Manual

Itiscurrenlyimpossibletoexportonlypartoftheboard.Youneedtomanuallydeleteunneeded
informationinsuchcases.
Save
Savethegamerecordunderitsfilename.Ifthegamerecordisnew,askforfilenamefirst.Thiscommandisdisabledifthe
gamerecordisnotmodified.
Saveas
Savethegamerecordunderadifferentfilename.
Close
Closetheboardwindow.Ifthegamerecordismodified,askwhethertosaveitfirst.
Quit
QuitQuarry.Promptstosaveanyunsavedgamerecordsfirst.

Editmenu
Undo
Undothelastchangemadeinthecurrentgamerecord.
Redo
Redothelastundonechangemadeinthecurrentgamerecord.
Cut
Cutsubtreehavingthecurrentnodeasitsrootintoclipboard.
Copy
Copysubtreehavingthecurrentnodeasitsrootintoclipboard.
Paste
Pastesubtreecontainedinclipboardaslastchildofthecurrentnode.Thiscommandmayfailife.g.thesubtreewascopied
fromadifferentkindofgame.
Note
Itiscurrentlyimpossibletodetermineiftheclipboardcontainsanything,thereforethismenuitemissensitive
evenifthereisnosubtreetopaste.
DeleteNode
Deletethecurrentnodetogetherwithitschildrenfromthegamerecord.
Tools
Toolsareveryimportantastheyarethemostused(togetherwithcommentediting)wayofmodifyinggamerecords.Active
toolcanalsobechangedusingtheeditingtoolbaroffromkeyboard.
MoveTool
Activatetoolwhichisusedtoplaynewmovesinthecurrentgamerecord.
SetupTool
Activatetoolwhichisusedtoaddandremovepiecesfromthecurrentnode.
CrossMarkup
http://download.gna.org/quarry/help/en/quarry.html

13/27

3/3/2015

Quarry Manual

Activatetoolwhichaddscrossmarkuptothecurrentposition.
CircleMarkup
Activatetoolwhichaddscirclemarkuptothecurrentposition.
CrossMarkup
Activatetoolwhichaddscrossmarkuptothecurrentposition.
SquareMarkup
Activatetoolwhichaddssqiaremarkuptothecurrentposition.
TriangleMarkup
Activatetoolwhichaddstrianglemarkuptothecurrentposition.
SelectedMarkup
Activatetoolwhichaddsselectedmarkuptothecurrentposition.
Note
It is not recommended to use this type of markup, as it has no standard appearance and may
confuseotherusers.
LabelTool
Activatetoolwhichplacessingleletterandarbitrarytextlabelsontheboard.
NumberTool
Activatetoolwhichplacesnumberlabelsontheboard.
ScoringTool
Activatetoolwhichscoresthecurrentposition.ThistoolisvalidonlyforGogames.
AddEmptyNode
Addanemptychildrentothecurrentnode.Standardwayofaddingchildrenisbyplayingmoves,butthiscommandallows
youtoaddnodewithoutanymove.
MoveBranchUp
Movecurrentbranchupi.e.swapitwiththepreviousbranch.Usefultorearrangebranchesinthegamerecord.
MoveBranchDown
Movecurrentbranchdowni.e.swapitwiththenextbranch.Usefultorearrangebranchesinthegamerecord.
EditNodeName
Editthenameofthecurrentnode.Ifthenodehasnoname,itisinserted.Otherwise,youcaneditnodejustbydirectly
modifyingitinthecommentwindowandthiscommandsimplyselectsthename.
SetMoveNumber
Setthenumberofthecurrentmove.Normally,movenumberisincrementedbyoneaftereachmove,buttherearecases
whenthismustbeoverridden,forinstance,ifgamerecordstartsnotatthegamebeginning.
PlayertoMove
Sometimesitisneededtoexplicitlysetwhoistomovenext,forinstance,inaproblemcollection.
White
http://download.gna.org/quarry/help/en/quarry.html

14/27

3/3/2015

Quarry Manual

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.)Theyhavequiterarelyusedfunctionalityandtake
preciousspaceontheright.
GameTree
ShoworhideGameTreeViewinthiswindow.Itsvisibilitycanalsobegloballychangedinthepreferences.
RecenteronCurrentNode
RecenterGameTreeViewonthecurrentnode.Ofcourse,theviewshouldbeshowntobeginwith.
ControlCenter
ShowQuarryControlCenter.

Playmenu
Pass
Playapassmove.(OnlyvalidinGo.)
http://download.gna.org/quarry/help/en/quarry.html

15/27

3/3/2015

Quarry Manual

Resign
Resigncurrentgame.Opponentisdeclaredawinner.
AdjournGame
Adjourncurrentgameandsavegamerecord,soitcanbelaterresumed.

Gomenu
Note
ThismenustitleisEnglishverbgo,notgamename.
PreviousNode
Gotothepreviousnode(currentnodesparent.)
NextNode
Gotothenextnode(currentnodeschild.)Bydefault,nextnodeisthefirstchild,butitisrememberedifyouswitchtoa
differentchild.
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 thereiscompletionon
nodenames.

Helpmenu
Contents
Showthishelp.
About
ShowshortinformationaboutQuarryanditsversion.

FindDialog
FindDialogallowsyoutosearchfortextinnodenamesand/orcomments.Itisinvaluableforlargegamerecords,especiallythose
http://download.gna.org/quarry/help/en/quarry.html

16/27

3/3/2015

Quarry Manual

containingmultiplebranches,likedebut/josekidictionaries.
Whenanodewithmatchingtextisfound,boardwindowswitchestoit,ifneeded.Matchingtextisselectedininformation pane.
SearchcanberepeatedlaterwithoutopeningthisdialogusingEditmenuitemsorfromkeyboard.
Dialogcontainsseveralcontrols:
Searchforfield
Enterthetexttosearchforhere.Fieldalsohasahistorywithupto10mostrecentlyfoundstrings.
Optons
Thereafewoptionsthatcontrolthesearch.Itcanbecasesensitiveorcaseinsensitive.Itcanberestrictedtowholewords
or include any match. Search can be wrapped around when the end or beginning of search domain is reached, or stop
there.
YoucanalsoselectAutoclosethisdialogbutton.Inthiscase,thedialogwillbehiddenafteranysuccessfulsearch.You
canrepeatsearchafterwardsusingFindNextandFindPreviousitemsofEditmenuorusingCtrl+GandShift+Ctrl+G
keycombinations.
Searchscope
Search domain can include the whole game record tree or the current node only. The latter option is only interesting if
currentnodescommentisverylong.
Searchcanalsobeperformedinnodenames,commentsorboth.Typically,youwillwanttosearchinbothofthem,butcan
sometimeswishtorestrictsearchtodecreasenumberofmatchesyouarenotinterestedin.
NextandPreviousbuttons
Whensearchparametersareentered,clickoneofthisbuttons,dependingondirectionyouwishsearchtobeperformed.
Buttonscanbepressedrepeatedlytorepeatsearch.However,ifAutoclosethisdialogoptionisselected,dialogwillbe
closedonfirstsuccessfulsearch.
These buttons can be disabled if a search in certain direction certainly wont hit any matches. However, they are many
cases when this cannot be determined in advance (quickly), so activating one of these buttons is not guaranteed to find
anything.
Closebutton
Closethedialogwithoutperforminganyfurthersearch.Useitwhenyouvefinishedsearchingorchangedyourmind.

GameInformationDialog
TheGameInformationDialogallowsyoutosetvaluesthatdescribegametreeasawholeandarenotspecifictoaparticularmove
orpositioninthegame.Ithasalotoffieldswhicharesplittedinthreepages.Allfieldsareoptionalandcanbeempty(notset),but
definingthemgivesadditionaldescriptiontothegame.
Fields on the first page (General) describe the game opponents, rules of the game and nonspoiling game details. Field on the
secondpage(Description&Result)aregenerallyspoilingandcanevendisclosegameoutcome.Thethirdpage(GameRecord)
describetherecorditself.
WhitePlayerandBlackPlayer
Thisgroupoffieldsallowsyoutodescribetheopponentsinthegame.TheNamefields shouldbeobvious. The Team
fieldsareusedwhenthegameisapartofamatchbetweentwoteams,forinstancenationalteams.Usually,theyareleft
empty.TheRankoftheopponentscanbeenteredintheappropriatefields.Thisisusuallytherankasappliestothegame
inquestion.Forinstance,thiscanbetherankawardedbythefederationguidingthetournamentoritcanbetherankofan
Internetserverwherethegametookplace.
Valuesofthesefieldsarealsodisplayedintherightcolumnofboardwindows.
GameName
Thenameofthegame.Thisfieldcanbeemptyifthegameisnotspecialanddoesnthaveadistinguishedname.
http://download.gna.org/quarry/help/en/quarry.html

17/27

3/3/2015

Quarry Manual

Place
Theplacethegametookplaceat.ThiscanbeageographicallocationorthenameofanInternetserver.
Date
Thedatethegametookplaceon.ItshouldbeintheinternationalformatofYYYYMMDD.Forinstance20060723
means23July2006.
Event
Theeventthisgameispartof.Forinstance,thiscanbethenameofatournament.Thisfieldisoftenempty.
Round
Theroundthisgameispartof.Forinstance1stroundorSemifinal.Thisfieldisoftenempty,especiallyifEventis.
Ruleset
Descriptive name of the rules this game was played in accordance with. For instance, for Go this can be Japanese,
Chineseetc.
Handicap
ForGoonly:numberofstonestheblackwasallowedtoplaceonhisfirstmove.This field is either 0 or not set for the
gameswithnohandicap.
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/600CanadianmeansCanadianovertimewith10
minutes(600seconds)forevery25moves.
Gameresult
TheresultofthegameinSGFformat.
Table3.2.ValidGameresultvalues
Value
Void
0orDraw
W+scoreorB+score
W+orB+

Meaning
Thereisnoresultyet(thegameisnotfinished)ortherecanbenoresultatall(e.g.for
problems.)
Thegameisdraw,i.e.isfinished,buttheresnowinner.
Aplayerhaswonbythespecifiedscore.Forinstance,W+6.5meansthatwhitehas
wonby6.5points.
Aplayerhaswon.Usedmainlyforthegameswithoutanotionforscore,e.g.
Amazons.

W+ResignorB+ResignorW+R
Aplayerhaswonbyresignation.
orB+R
W+TimeorB+TimeorW+T
Aplayerhaswonontime.I.e.hisopponentexceededhistimelimit.
orB+T
W+ForfeitorB+ForfeitorW+F
Aplayerhaswonbyforfeit,e.g.hisopponentmadeanillegalmove.
orB+F
http://download.gna.org/quarry/help/en/quarry.html

18/27

3/3/2015

Quarry Manual

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
GeneralInterface
GameTree
GTPEngines
GTPEngineInformationDialog
SavingGameRecords
GoBoardAppearance
AmazonsBoardAppearance
ReversiBoardAppearance

ToconfigureQuarry either click the Preferences button in the ControlCenterwindow or choose Edit Preferences menu
item.
ThePreferencesdialogisdisplayed.Itconsistsofthefollowingcategories:
General
Interface
Editing&Viewing
GameTree
GTP
GTPEngines
GameRecords(SGF)
Saving
BoardAppearance
http://download.gna.org/quarry/help/en/quarry.html

19/27

3/3/2015

Quarry Manual

GoBoardAppearance
AmazonsBoardAppearance
ReversiBoardAppearance

GeneralInterface
GeneralinterfaceofQuarrycanbeconfiguredatthispage.Itisnotreallyrelatedtothefunctionalityoftheapplication.
FileChooserDialogStyle
Youcanuseeitherthenewfilechooserortheoldone,whichwasthedefaultonpre2.4GTK+.
Note
This option will be removed in Quarry ver. 0.3. It was added when the new file chooser was in early
developmentstagesandhadsignificantusabilityproblems.Nowadaysithaslittlesensetokeepsupporting
theoldone.
ToolbarStyles
By default, Quarry uses desktop settings for all its toolbars. However, you can choose specific style for each of three
toolbarkinds.Youcanalsoreturntoolbarstousingdesktopdefaultshere.

GameTree
HereyoucancustomizeappearanceandbehavioroftheGameTreeView.
ShowGameTree
You can choose whether the Game Tree View is shown in Board Windows by default. If you choose Automatically
option,itwillbeshownifgamerecordhasanythinginadditiontothemainbranch.Inanycase,youcanshoworhidethe
view manually, using View Game Tree menu item. In this case, automatic showing will be disabled, even if
correspondingoptionisselected.
TrackTreesCurrentNode
Youcanchoosewhethertheviewshouldtrackthecurrentnode,i.e.repositionitselftoshowit.Inautomaticmodeitonly
tracksthecurrentnodeifitwasshowingitbefore.Thismodepreventstheviewfromscrollingifyouintentionallyscrolledit
tosomepartofthetreenotcontainingthecurrentnode.Youcanalwaysforcetheviewtodisplaythecurrentnodebyusing
ViewRecenteronCurrentNodemenuitem.
You can also choose whether the view will scroll minimal possible distance while tracking (i.e. the current node will be
somewherenearanedge),orifitwillalwaysrecenteronthecurrentnodeifneeded.Theseoptionsdontmakesenseif
trackingisdisabled,sotheyaredisabledthentoo.
Showtooltips
Choosewhether GameTreeViewshould showtooltipsover nodes.Seeviewdescription for details. You may want to
disabletooltipsiftheylooktoodistracting.

GTPEngines
Atthispage,allgameplayingprogramsregisteredinQuarryareshown.Youcanregisternewprogramsandmodifyinformationin
existingentries.
AllregisteredprogramsareshowninthelistlabeledListofGTPengines.Whenyouselectoneofthem,someinformationaboutit
is shown in the lower part of the dialog. This inlcudes program name, version, supported game(s) and command line. The
commandlineisexactlywhatyouspecifiedwhileregisteringtheprogram,whiletherestofinformationisreportedbytheprogram
itself.
ProgramsfromthelistarealsoshownintheNewGameandResumingGamedialogsasavailablecomputeropponents.However,
youcanhidesomeofthembyremovingthemarkbesidetheprogramnameintheShowcolumn.Thismaybebetterthanremoving
http://download.gna.org/quarry/help/en/quarry.html

20/27

3/3/2015

Quarry Manual

aprogramrecordaltogetherincaseyoulaterregainyourinterestinit.Also,someGTPenginesmaybelistedinQuarry system
widesettingsthosecannotberemoved,onlyhidden.
Therearealsofivebuttonsonthispage:
AddandModifybuttons
These two buttons allow you to register another program, or modify information about an already registered one,
correspondingly.TheybothpopuptheGTPEngineInformationdialog.
Removebutton
Thisbuttonremovesagameplayingprogramfromthelistofregisteredprograms.Theunregisteredprogramwillnotappear
intheNewGamedialogasanavailableopponent.Ofcourse,theprogramitselfisnottouchedandyoucanreregisteritin
Quarrylater.
MoveUpandMoveDownbuttons
Usingthesetwobuttonsyoucanrearrangeregisteredprograms.ComputeropponentsintheNewGamedialogarelistedin
exactlythesameorderasonthispage,soyoumaywanttoplacemorefrequentlyusedprogramsonthetop.Anotherway
toreorderGTPprogramsistodraganddroptheirnamesinthelist.

GTPEngineInformationDialog
This dialog is shown whenever you want to register a gameplaying program in Quarry or modify information about an already
registeredone.Dependingonthesituation,itcanbetitledeitherNewGTPEngineorModifyGTPEngineInformation.After
you fill in the dialog, press the Add or OK button. Quarry will launch the program to check if it works and ask it for some
information.
Note
IfthemessageQueryingenginesname,versionandknowncommandsappearsandpersistsfortoolong(more
thanafewseconds),thismostlikelyindicatesthatthecommandlineyouspecifystartstheprograminnonGTP
modeorstartsawrongprogramtobeginwith.Ifyoudontexpecttheprogramtobeveryslowoninitialization,
thenclicktheCancelbuttonandfixthecommandline.
Thedialoghastwotextentryfields:
Commandline
Thecommandlinetostarttheprogramshouldbeenteredhere.YoucanusetheBrowsebuttontoselecttheprogram,but
normallyjustspecifyingprogramfilenameisenough.(Moreexactly,itisenoughiftheprogramisinstalledinadirectorythat
isinyour $PATHenvironmentvariable.)Inanycase,youshouldenterprogramspecificoptionsafteritsfilename.To find
outwhichoptionsshouldbeused,seethemanualoftheprograminquestion.
ForGNUGo,thecommandlineshouldlooklikethis(notethedoublehyphens):
gnugo --mode gtp --quiet

Youmayalsowanttospecifyadditionaloptions.SeeGNUGodocumentationformoreinformation.
Screenname
InthisfieldyoucanspecifythewayQuarrywilldisplaythenameoftheprogram.Youcanenterthefullnameorusespecial
symbols%nand%v.Theywillbereplacedwiththenameandversionoftheprogramasitreportsthemitself.Inmost
casesthedefaultvalueof%n%viswhatyouwant,butsometimesitmakessensetoalterit.Forinstance,youcanspecify
%n%vlevel5hereifyoufixedprogramslevelinthecommandline.If,forsomereason,youneedthepercentsigninthe
name,typeitinas%%(thepercentsignisusedasescapesymbolinthisfield.)

SavingGameRecords
Currently, you can only specify whether to save game records in UTF8 or to preserve original encoding. The former option is
recommendedbecauseUTF8canencodeanycharacterandbecauseQuarryloadsUTF8encodedgamerecordsfasterthanwith
anyotherencoding.However,youmaywanttopreserveoriginalencodingif,forinstance,youuseotherSGFeditor/viewerwith
poorsupportforUTF8orthisisrequiredforsomereasonfordistribution.
http://download.gna.org/quarry/help/en/quarry.html

21/27

3/3/2015

Quarry Manual

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,MA
021101301
USA
Everyoneispermittedtocopyanddistributeverbatimcopiesofthislicensedocument,butchangingitisnotallowed.

Version1.2,November2002
http://download.gna.org/quarry/help/en/quarry.html

22/27

3/3/2015

Quarry Manual

Copyright 2000, 2001, 2002 Free Software Foundation, Inc. 51 Franklin St, Fifth Floor, Boston, MA 02110
1301USA
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 or
noncommercially.Secondarily,thisLicensepreservesfortheauthorandpublisherawaytogetcreditfortheirwork,whilenotbeing
consideredresponsibleformodificationsmadebyothers.
ThisLicenseisakindofcopyleft,whichmeansthatderivativeworksofthedocumentmustthemselvesbefreeinthesamesense.
ItcomplementstheGNUGeneralPublicLicense,whichisacopyleftlicensedesignedforfreesoftware.
WehavedesignedthisLicenseinordertouseitformanualsforfreesoftware,becausefreesoftwareneedsfreedocumentation:a
free program should come with manuals providing the same freedoms that the software does. But this License is not limited to
softwaremanualsitcanbeusedforanytextualwork,regardlessofsubjectmatterorwhetheritispublishedasaprintedbook.We
recommendthisLicenseprincipallyforworkswhosepurposeisinstructionorreference.

1.APPLICABILITYANDDEFINITIONS
ThisLicenseappliestoanymanualorotherwork,inanymedium,thatcontainsanoticeplacedbythecopyrightholdersayingitcan
bedistributedunderthetermsofthisLicense.Suchanoticegrantsaworldwide,royaltyfreelicense,unlimitedinduration,touse
that work under the conditions stated herein. TheDocument, below, refers to any such manual or work. Any member of the
publicisalicensee,andisaddressedasyou.Youacceptthelicenseifyoucopy,modifyordistributetheworkinawayrequiring
permissionundercopyrightlaw.
AModifiedVersionoftheDocumentmeansanyworkcontainingtheDocumentoraportionofit,eithercopiedverbatim,orwith
modificationsand/ortranslatedintoanotherlanguage.
ASecondarySectionisanamedappendixorafrontmattersectionoftheDocumentthatdealsexclusivelywiththerelationshipof
thepublishersorauthorsoftheDocumenttotheDocument'soverallsubject(ortorelatedmatters)andcontainsnothingthatcould
falldirectlywithinthatoverallsubject.(Thus,iftheDocumentisinpartatextbookofmathematics,aSecondarySectionmaynot
explainanymathematics.)Therelationshipcouldbeamatterofhistoricalconnectionwiththesubjectorwithrelatedmatters,orof
legal,commercial,philosophical,ethicalorpoliticalpositionregardingthem.
TheInvariantSectionsarecertainSecondarySectionswhosetitlesare designated, as being those of Invariant Sections, in the
noticethatsaysthattheDocumentisreleasedunderthisLicense.IfasectiondoesnotfittheabovedefinitionofSecondarythenitis
notallowedtobedesignatedasInvariant.TheDocumentmaycontainzeroInvariantSections.IftheDocumentdoesnotidentify
anyInvariantSectionsthentherearenone.
TheCoverTextsarecertainshortpassagesoftextthatarelisted,asFrontCoverTextsorBackCoverTexts,inthenoticethat
saysthattheDocumentisreleasedunderthisLicense.AFrontCoverTextmaybeatmost5words,andaBackCoverTextmay
beatmost25words.
ATransparentcopyoftheDocumentmeansamachinereadablecopy,representedinaformatwhosespecificationisavailableto
thegeneralpublic,thatissuitableforrevisingthedocumentstraightforwardlywithgenerictexteditorsor(forimagescomposedof
pixels) generic paint programs or (for drawings) some widely available drawing editor, and that is suitable for input to text
formattersorforautomatic translation to a variety of formats suitable for input to text formatters. A copy made in an otherwise
Transparentfileformatwhosemarkup,orabsenceofmarkup,hasbeenarrangedtothwartordiscouragesubsequentmodification
byreadersisnotTransparent.AnimageformatisnotTransparentifusedforanysubstantialamountoftext.A copy that is not
TransparentiscalledOpaque.
Examples of suitable formats for Transparent copies include plain ASCII without markup, Texinfo input format, LaTeX input
format,SGMLorXMLusingapubliclyavailableDTD,andstandardconformingsimpleHTML,PostScriptorPDFdesignedfor
human modification. Examples of transparent image formats include PNG, XCF and JPG. Opaque formats include proprietary
formatsthatcanbereadandeditedonlybyproprietarywordprocessors,SGMLorXMLforwhichtheDTDand/orprocessing
toolsarenotgenerallyavailable,andthemachinegeneratedHTML,PostScriptorPDFproducedbysomewordprocessorsfor
outputpurposesonly.
The Title Page means, for a printed book, the title page itself, plus such following pages as are needed to hold, legibly, the
materialthisLicenserequirestoappearinthetitlepage.Forworksinformatswhichdonothaveanytitlepageassuch,TitlePage
meansthetextnearthemostprominentappearanceofthework'stitle,precedingthebeginningofthebodyofthetext.
http://download.gna.org/quarry/help/en/quarry.html

23/27

3/3/2015

Quarry Manual

A section Entitled XYZ means a named subunit of the Document whose title either is precisely XYZ or contains XYZ in
parenthesesfollowingtextthattranslatesXYZinanotherlanguage.(HereXYZstandsforaspecificsectionnamementionedbelow,
suchasAcknowledgements,Dedications,Endorsements,orHistory.)ToPreservetheTitleofsuchasectionwhen you
modifytheDocumentmeansthatitremainsasectionEntitledXYZaccordingtothisdefinition.
TheDocumentmayincludeWarrantyDisclaimersnexttothenoticewhichstatesthatthisLicenseappliestotheDocument.These
WarrantyDisclaimersareconsideredtobeincludedbyreferenceinthisLicense,butonlyasregardsdisclaimingwarranties: any
otherimplicationthattheseWarrantyDisclaimersmayhaveisvoidandhasnoeffectonthemeaningofthisLicense.

2.VERBATIMCOPYING
YoumaycopyanddistributetheDocumentinanymedium,eithercommerciallyornoncommercially,providedthatthisLicense,the
copyrightnotices,andthelicensenoticesayingthisLicenseappliestotheDocumentarereproducedinallcopies,andthatyouadd
nootherconditionswhatsoevertothoseofthisLicense.Youmaynotusetechnicalmeasurestoobstructorcontrolthereadingor
further copying of the copies you make or distribute. However, you may accept compensation in exchange for copies. If you
distributealargeenoughnumberofcopiesyoumustalsofollowtheconditionsinsection3.
Youmayalsolendcopies,underthesameconditionsstatedabove,andyoumaypubliclydisplaycopies.

3.COPYINGINQUANTITY
Ifyoupublishprintedcopies(orcopiesinmediathatcommonlyhaveprintedcovers)oftheDocument,numberingmorethan100,
andtheDocument'slicensenoticerequiresCoverTexts,youmustenclosethecopiesincoversthatcarry,clearlyandlegibly,all
theseCoverTexts:FrontCoverTextsonthefrontcover,andBackCoverTextsonthebackcover.Bothcoversmustalsoclearly
andlegiblyidentifyyouasthepublisherofthesecopies.Thefrontcovermustpresentthefulltitlewithallwordsofthetitleequally
prominentandvisible.Youmayaddothermaterialonthecoversinaddition.Copyingwithchangeslimitedtothecovers,aslongas
theypreservethetitleoftheDocumentandsatisfytheseconditions,canbetreatedasverbatimcopyinginotherrespects.
Iftherequiredtextsforeithercoveraretoovoluminoustofitlegibly,youshouldputthefirstoneslisted(asmanyasfitreasonably)
ontheactualcover,andcontinuetherestontoadjacentpages.
IfyoupublishordistributeOpaquecopiesoftheDocumentnumberingmorethan100,youmusteitherincludeamachinereadable
TransparentcopyalongwitheachOpaquecopy,orstateinorwitheachOpaquecopyacomputernetworklocationfromwhich
thegeneralnetworkusingpublichasaccesstodownloadusingpublicstandardnetworkprotocolsacompleteTransparentcopyof
the Document, free of added material. If you use the latter option, you must take reasonably prudent steps, when you begin
distributionofOpaquecopiesinquantity,toensurethatthisTransparentcopywillremainthusaccessibleatthestatedlocationuntil
atleastoneyearafterthelasttimeyoudistributeanOpaquecopy(directlyorthroughyouragentsorretailers)ofthateditiontothe
public.
Itisrequested,butnotrequired,thatyoucontacttheauthorsoftheDocumentwellbeforeredistributinganylargenumberofcopies,
togivethemachancetoprovideyouwithanupdatedversionoftheDocument.

4.MODIFICATIONS
YoumaycopyanddistributeaModifiedVersionoftheDocumentundertheconditionsofsections2and3above,providedthat
you release the Modified Version under precisely this License, with the Modified Version filling the role of the Document, thus
licensingdistributionandmodificationoftheModifiedVersiontowhoeverpossessesacopyofit.Inaddition,youmustdothese
thingsintheModifiedVersion:
A. Use in the Title Page (and on the covers, if any) a title distinct from that of the Document, and from those of previous
versions(whichshould,iftherewereany,belistedintheHistorysectionoftheDocument).Youmayusethesametitleasa
previousversioniftheoriginalpublisherofthatversiongivespermission.
B. List on the Title Page, as authors, one or more persons or entities responsible for authorship of the modifications in the
ModifiedVersion, togetherwithatleast five of the principal authors of the Document (all of its principal authors, if it has
fewerthanfive),unlesstheyreleaseyoufromthisrequirement.
C. StateontheTitlepagethenameofthepublisheroftheModifiedVersion,asthepublisher.
D. PreserveallthecopyrightnoticesoftheDocument.
E. Addanappropriatecopyrightnoticeforyourmodificationsadjacenttotheothercopyrightnotices.
F. Include, immediately after the copyright notices, a license notice giving the public permission to use the Modified Version
http://download.gna.org/quarry/help/en/quarry.html

24/27

3/3/2015

Quarry Manual

underthetermsofthisLicense,intheformshownintheAddendumbelow.
G. PreserveinthatlicensenoticethefulllistsofInvariantSectionsandrequiredCoverTextsgiven in the Document's license
notice.
H. IncludeanunalteredcopyofthisLicense.
I. PreservethesectionEntitledHistory,PreserveitsTitle,andaddtoitanitemstatingatleastthetitle,year,newauthors,and
publisheroftheModifiedVersionasgivenontheTitlePage.IfthereisnosectionEntitledHistoryintheDocument,create
onestatingthetitle,year,authors,andpublisheroftheDocumentasgivenonitsTitlePage,thenaddanitemdescribingthe
ModifiedVersionasstatedintheprevioussentence.
J. Preservethenetworklocation,ifany,givenintheDocumentforpublicaccesstoaTransparentcopyoftheDocument,and
likewise the network locations given in the Document for previous versions itwasbasedon.These may be placed in the
Historysection.YoumayomitanetworklocationforaworkthatwaspublishedatleastfouryearsbeforetheDocument
itself,oriftheoriginalpublisheroftheversionitreferstogivespermission.
K. ForanysectionEntitledAcknowledgementsorDedications,PreservetheTitleofthesection,andpreserveinthesection
allthesubstanceandtoneofeachofthecontributoracknowledgementsand/ordedicationsgiventherein.
L. Preserve all the Invariant Sections of the Document, unaltered in their text and in their titles. Section numbers or the
equivalentarenotconsideredpartofthesectiontitles.
M. DeleteanysectionEntitledEndorsements.SuchasectionmaynotbeincludedintheModifiedVersion.
N. DonotretitleanyexistingsectiontobeEntitledEndorsementsortoconflictintitlewithanyInvariantSection.
O. PreserveanyWarrantyDisclaimers.
If the Modified Version includes new frontmatter sections or appendices that qualify as Secondary Sections and contain no
materialcopiedfromtheDocument,youmayatyouroptiondesignatesomeorallofthesesectionsasinvariant.Todothis, add
their titles to the list of Invariant Sections in the Modified Version's license notice. These titles must be distinct from any other
sectiontitles.
You may add a section Entitled Endorsements, provided it contains nothing but endorsements of your Modified Version by
variouspartiesforexample,statementsofpeerrevieworthatthetexthasbeenapprovedbyanorganizationastheauthoritative
definitionofastandard.
YoumayaddapassageofuptofivewordsasaFrontCoverText,andapassageofupto25wordsasaBackCoverText,tothe
endofthelistofCoverTextsintheModifiedVersion.OnlyonepassageofFrontCoverTextandoneofBackCoverTextmay
beaddedby(orthrougharrangementsmadeby)anyoneentity.IftheDocumentalreadyincludesacovertextforthesamecover,
previouslyaddedbyyouorbyarrangementmadebythesameentityyouareactingonbehalfof,youmaynotaddanotherbutyou
mayreplacetheoldone,onexplicitpermissionfromthepreviouspublisherthataddedtheoldone.
Theauthor(s)andpublisher(s)oftheDocumentdonotbythisLicensegivepermissiontousetheirnamesforpublicityfororto
assertorimplyendorsementofanyModifiedVersion.

5.COMBININGDOCUMENTS
YoumaycombinetheDocumentwithotherdocumentsreleasedunderthisLicense,underthetermsdefinedinsection4abovefor
modified versions, 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 combined work in its license notice, and that you preserve all their
WarrantyDisclaimers.
ThecombinedworkneedonlycontainonecopyofthisLicense,andmultipleidenticalInvariantSectionsmaybereplacedwitha
singlecopy.IftherearemultipleInvariantSectionswiththesamenamebutdifferentcontents,makethetitleofeachsuch section
uniquebyaddingattheendofit,inparentheses,thenameoftheoriginalauthororpublisherofthatsectionifknown,orelsea
uniquenumber.MakethesameadjustmenttothesectiontitlesinthelistofInvariantSectionsinthelicensenoticeofthecombined
work.
Inthecombination,youmustcombineanysectionsEntitledHistoryinthevariousoriginaldocuments,formingonesectionEntitled
HistorylikewisecombineanysectionsEntitledAcknowledgements,andanysectionsEntitledDedications.Youmustdelete
allsectionsEntitledEndorsements.

6.COLLECTIONSOFDOCUMENTS
http://download.gna.org/quarry/help/en/quarry.html

25/27

3/3/2015

Quarry Manual

YoumaymakeacollectionconsistingoftheDocumentandotherdocumentsreleasedunderthisLicense,andreplacetheindividual
copiesofthisLicenseinthevariousdocumentswithasinglecopythatisincludedinthecollection,providedthatyoufollowthe
rulesofthisLicenseforverbatimcopyingofeachofthedocumentsinallotherrespects.
Youmayextractasingledocumentfromsuchacollection,anddistributeitindividuallyunderthisLicense,providedyouinserta
copyofthisLicenseintotheextracteddocument,andfollowthisLicenseinallotherrespectsregardingverbatimcopyingofthat
document.

7.AGGREGATIONWITHINDEPENDENTWORKS
AcompilationoftheDocumentoritsderivativeswithotherseparateandindependentdocumentsorworks,inoronavolumeofa
storageordistributionmedium,iscalledanaggregateifthecopyrightresultingfromthecompilationisnotusedtolimitthelegal
rightsofthe compilation's users beyond what the individual works permit. When the Document is included in an aggregate, this
LicensedoesnotapplytotheotherworksintheaggregatewhicharenotthemselvesderivativeworksoftheDocument.
IftheCoverTextrequirementofsection3isapplicabletothesecopiesoftheDocument,theniftheDocumentislessthanonehalf
oftheentireaggregate,theDocument'sCoverTextsmaybeplacedoncoversthatbrackettheDocumentwithintheaggregate,or
theelectronicequivalentofcoversiftheDocumentisinelectronicform.Otherwisetheymustappearonprintedcoversthatbracket
thewholeaggregate.

8.TRANSLATION
Translationisconsideredakindofmodification,soyoumaydistributetranslationsoftheDocumentunderthetermsofsection 4.
Replacing Invariant Sections with translations requires special permission from their copyright holders, but you may include
translations of some or all Invariant Sections in addition to the original versions of these Invariant Sections. You may include a
translationofthisLicense,andallthelicensenoticesintheDocument,andanyWarrantyDisclaimers,providedthatyoualsoinclude
the original English version of this License and the original versions of those notices and disclaimers. In case of a disagreement
betweenthetranslationandtheoriginalversionofthisLicenseoranoticeordisclaimer,theoriginalversionwillprevail.
IfasectionintheDocumentisEntitledAcknowledgements,Dedications,orHistory,therequirement(section4)toPreserve
itsTitle(section1)willtypicallyrequirechangingtheactualtitle.

9.TERMINATION
Youmaynotcopy,modify,sublicense,ordistributetheDocumentexceptasexpresslyprovidedforunderthisLicense.Anyother
attempt to copy, modify, sublicense or distribute the Document is void, and will automatically terminate your rights under this
License.However,partieswhohavereceivedcopies,orrights,fromyouunderthisLicensewillnothavetheirlicensesterminated
solongassuchpartiesremaininfullcompliance.

10.FUTUREREVISIONSOFTHISLICENSE
TheFreeSoftwareFoundationmay publish new, revised versions of the GNU Free Documentation License from time to time.
Suchnewversionswillbesimilarinspirittothepresentversion,butmaydifferindetailtoaddressnewproblemsorconcerns.See
http://www.gnu.org/copyleft/.
EachversionoftheLicenseisgivenadistinguishingversionnumber.IftheDocumentspecifiesthataparticularnumberedversionof
thisLicenseoranylaterversionappliestoit,youhavetheoptionoffollowingthetermsandconditionseitherofthatspecified
versionorofanylaterversionthathasbeenpublished(notasadraft)bytheFreeSoftwareFoundation.IftheDocumentdoesnot
specify a version number of this License, you may choose any version ever published (not as a draft) by the Free Software
Foundation.

ADDENDUM:HowtousethisLicenseforyourdocuments
TousethisLicenseinadocumentyouhavewritten,includeacopyoftheLicenseinthedocumentandputthefollowingcopyright
andlicensenoticesjustafterthetitlepage:
CopyrightYEARYOURNAME.
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free
Documentation License, Version 1.2 or any later version published by the Free Software Foundation with no
InvariantSections,noFrontCoverTexts,andnoBackCoverTexts.Acopyofthelicenseisincludedinthesection
entitledGNUFreeDocumentationLicense.
http://download.gna.org/quarry/help/en/quarry.html

26/27

3/3/2015

Quarry Manual

IfyouhaveInvariantSections,FrontCoverTextsandBackCoverTexts,replacethewith...Texts.linewiththis:
withtheInvariantSectionsbeingLISTTHEIRTITLES,withtheFrontCoverTextsbeingLIST,andwiththeBack
CoverTextsbeingLIST.
IfyouhaveInvariantSectionswithoutCoverTexts,orsomeothercombinationofthethree,mergethosetwoalternativestosuitthe
situation.
If your document contains nontrivial examples of program code, we recommend releasing these examples in parallel under your
choiceoffreesoftwarelicense,suchastheGNUGeneralPublicLicense,topermittheiruseinfreesoftware.

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

27/27

Вам также может понравиться