7/30/2019 Readme Antconc3.2.4
1/21
AntConc(Windows,MacintoshOSX,andLinux)
Build3.2.4LaurenceAnthony,Ph.D.
Centerfor
English
Language
Education
in
Science
and
Engineering,
School
of
Science
and
Engineering,WasedaUniversity,341Okubo,Shinjukuku,Tokyo1698555,Japan
November10,2011
IntroductionAntConcisafreeware,multiplatformtoolforcarryingoutcorpuslinguisticsresearchanddatadrivenlearning.
It runs on any computer running Microsoft Windows (tested on Win 98/Me/2000/NT, XP, Vista, Win 7),
MacintoshOSX(testedon10.4.x,10.5.x,10.6.x),andLinux(testedonUbuntu10).ItisdevelopedinPerlusing
ActiveState'sPerlAppcompilertogenerateexecutablesforthedifferentoperatingsystems.
Installation
Windows
OnWindowssystems,simplydoubleclicktheAntConciconandthiswilllaunchtheprogram.Noinstallationis
necessary.
MacintoshOSX
OnMacintosh systems, first install and launch X11. X11 is a graphical toolkit that is availableon the disks
includedwiththecomputerorviatheApplewebsite.Next,doubleclickdoubleclicktheAntConciconandthis
willlaunchtheprogram.Noinstallationisnecessary.
Linux
OnLinuxsystems,changethepermissionstoallowAntConctoberunasanexecutablefile.Next,doubleclick
doubleclick
the
AntConcicon
and
this
will
launch
the
program.
No
installation
is
necessary.
OverviewofToolsAntConccontainsseventoolsthatcanbeaccessedeitherbyclickingontheir'tabs'inthetoolwindow,orusing
thefunctionkeysF1toF7.
ConcordanceTool:
Thistoolshowssearchresultsina'KWIC'(KeyWordInContext)format.Thisallowsyoutoseehowwordsand
phrasesarecommonlyusedinacorpusoftexts.
ConcordancePlotTool
This
tool
shows
search
results
plotted
as
a
'barcode'
format.
This
allows
you
to
see
the
position
where
search
resultsappearintargettexts.
FileViewTool
Thistoolshowsthetextofindividualfiles.Thisallowsyoutoinvestigateinmoredetailtheresultsgeneratedin
othertoolsofAntConc.
Clusters(NGrams):
ThisClustersToolshowsclustersbasedonthesearchcondition.Ineffectitsummarizestheresultsgenerated
in theConcordanceToolorConcordancePlotTool.TheNGramsTool,on theotherhand, scans theentire
corpusfor'N'(e.g.1word,2words,)lengthclusters.Thisallowsyoutofindcommonexpressionsinacorpus.
7/30/2019 Readme Antconc3.2.4
2/21
Collocates:
This tool shows the collocates of a search term. This allows you to investigate nonsequential patterns in
language.
WordList:
Thistoolcountsallthewordsinthecorpusandpresentstheminanorderedlist.Thisallowsyoutoquicklyfind
whichwordsarethemostfrequentinacorpus.
KeywordList:
Thistoolshowsthewhichwordsareunusuallyfrequent(or infrequent) inthecorpus incomparisonwiththe
wordsinareferencecorpus.Thisallowsyoutoidentifycharacteristicwordsinthecorpus,forexample,aspart
ofagenreorESPstudy.
ConcordanceTool
Thistool
shows
search
results
in
a'KWIC'
(KeyWord
In
Context)
format.
This
allows
you
to
see
how
words
and
phrasesarecommonlyusedinacorpusoftexts.
Toproduceasetofconcordancelinesoftext,youneedtoperformthefollowingactions:
1) Selectoneormorefilesforprocessingfromusingthe'OpenFile(s)...'or'OpenDir...'optionsinthe'File'
menu.Thelistofselectedfilesisshownintheleftframeofthemainwindow.
2) Enterasearchtermonwhichtobuildconcordancelinesintheentryboxontheleftofthebuttonbar.
3) Choose the number of text characters to be outputtedon either side of the search term, using the
increase anddecreasebuttonson the rightof thebuttonbarunder the "SearchWindow Size" title.
(defaultvalueis50characters)
4) Clickonthe'Start'buttontostarttheconcordancelinesresultsgeneration.Theconcordancegeneration
canbe
halted
at
any
time
by
clicking
on
the
'Stop'
button.
5) Selectatargetwordonwhichtorearrangetheconcordance lines,usingthebuttonstotherightofthe
buttonbar.0isthesearchword,1L,2L...arewordstotheleftofthetargetword,1R,2R..arewordsto
therightofthetargetword.Notethatthreelevelsofsortarepossible,withthesecondandthirdlevels
notactivatedwhenthesoftwareisfirstlaunched.
6) Clickonthe'Sort'buttontostartthesortingprocess.
7) Movethecursoroverthehighlightedsearchterminoneoftheconcordancelines.Thecursorwillchange
toasmallhandicon.Clickingonthehighlightedsearchterm,willallowtheusertoviewthesearchterm
hitasitappearsintheoriginalfileviatheFileViewTool(seebelow).
Notethatthetotalnumberofconcordancelinesgenerated(hits)isshowninthemiddleoftheAntConcbutton
window.Thisnumberwillflashwiththeword"FINISHED"whenprocessinghasbeencompleted,andwillflash
withtheword"NOHITS", ifnothitsaregeneratedforaparticularsearchterm.Inthiscase,theconcordance
linesviewwillnotbeupdated,andtheprevioussetofconcordancelineswillremainvisible.
Searchtermscanbespecifiedasbeing"words"(default)or"wordfragments"bychoosingthe"Word"search
termoption.Also,searchescanbeeithercase sensitiveorcase insensitive (default)bychoosing the"Case"
searchtermoption.Searchescanalsobemadeusingfullregularexpressionsbychoosingthe"Regex"option.
Fordetailsonhowtouseregularexpressions,consultoneof themany textson thesubject.E.g.,Mastering
RegularExpressions(O'Reilly&AssociatesPress)ortype"regularexpressions"inawebsearchenginetofind
manysitesonthesubject.
Informationaboutregularexpressionscanbefoundat:http://www.regularexpressions.info/quickstart.html
7/30/2019 Readme Antconc3.2.4
3/21
By clickingon the "Advanced Search"button,more complex searchesbecomepossible. The first advanced
searchoption istodefineasetofsearchterms,eitherbytypingthemoneper line,orby loading ina listof
searchtermsfromafile.Notethateachlinewillbetreatedasaseparatesearchterm.Thefeatureallowsthe
usertousealargesetofsearchtermswithouthavingtoretypethemeachtime.Thesecondadvancedsearch
optionis
to
define
context
words
and
acontext
window
within
which
the
search
term(s)
must
appear.
For
example, to search for "student" where it appears at least three words to the left or right of the word
"university,"set thesearch termas"student," thecontextwordas"university,"and thecontextwindowas
'From'3L'To'3R.
Anumberofmenupreferencesareavailablewiththistool.(Seebelow).
ConcordancePlotTool
Thistoolshowssearchresultsplottedasa'barcode'format.Thisallowsyoutoseethepositionwheresearch
resultsappearintargettexts.
GeneratingconcordanceplotscanbeachievedusingthesameactionsaswhenusingtheConcordanceTool.
However,theConcordancePlotTooloffersanalternativeviewofconcordancelines.Here,allthehitsforeach
fileareplotted inthe formofa 'barcode' indicating theposition inthe filewhere thehitoccurred.Theplot
providesaneasywaytoseewhichfilesincludethetargetsearchterm,andcanalsobeusedtoidentifywhere
the search term hits cluster together. An example of the use of the plot is in determining where specific
contentwordsappearinatechnicalpaper,orwhenacharacterappearsduringthecourseofanovelorplay.
Thenumberofhitsandlengthofeachtextisshowntotherightofthebarcodeplot,andtheplotitselfcanbe
enlargedorreducedinsizeusingthezoombuttons
If
you
move
the
cursor
over
the
highlighted
search
term
in
one
of
the
concordance
lines,
the
cursor
will
change
toasmallhandicon.Clickingonthehighlightedsearchterm,willallowtheusertoviewthesearchtermhitas
itappearsintheoriginalfilevia.SeetheFileViewTool(seebelow).
FileViewTool
Thistoolshowsthetextofindividualfiles.Thisallowsyoutoinvestigateinmoredetailtheresultsgeneratedin
othertoolsofAntConc.
Toproduceaviewoftheoriginalfile,youneedtoperformthefollowingactions:
1) Selectafiletoviewinthefilelistframetotheleftofthemainwindow.
2) Ifasearchtermhasbeenspecified,thesearchtermhitswillbehighlightedthroughoutthetext.Search
optionsarethesameasfortheConcordanceToolandConcordancePlotTool.3) Usethe"HitLocation"buttonstojumptotheappropriatehitinthefile.
4) Changethesearchtermandclickonthe'Start'buttontoviewotherhitsinthefile.
5) ClickingonthehighlightedtextwillgenerateasetofKWIClinesusingthehighlightedtextasthesearch
term.
BelowisalistofShortcutsuniquetotheFileViewTool.
1)CTRLClick=Jumpstothenearesthitinthewindow
7/30/2019 Readme Antconc3.2.4
4/21
ClustersTool
TheClustersToolshowsclustersbasedonthesearchcondition.Ineffectitsummarizestheresultsgeneratedin
theConcordanceToolorConcordancePlotTool.
Theclusterscanbeorderedeitherbyfrequencyorthestartorendoftheword.Theycanalsobeorderedby
theprobabilityof the firstword in theclusterpreceding the remainingwords.All listorderingscanalsobe
inverted.Also,ausercanselecttheminimumandmaximumlength(numberofwords)ineachcluster,andthe
minimumfrequencyofclustersdisplayed.Itisalsopossibletoselectifthesearchtermalwaysappearsonthe
leftorrightofthecluster.(Note:Inthecurrentversion,ifmorethanonewordisspecifiedasthesearchterm,
onlythefirstwordwillappearontheright,ifthe"SearchTermonRight"optionisselected.)
Toproduceaclusterlist,youneedtoperformthefollowingactions:
1) Choosetheappropriateorderingoptions.
2) Press the 'Start'button.Atany time, thegenerationof theclusters list canbehaltedusing the 'Stop'
button.
3) ClickingontheclusterwillgenerateasetofKWIClinesusingthetextasthesearchterm.
Anumberofmenupreferencesareavailablewiththistool.(Seebelow).
NGramsTool(partoftheClustersTool)
TheNGramsToolscanstheentirecorpusfor 'N'(e.g.1word,2words,)lengthclusters.Thisallowsyouto
findcommonexpressionsinacorpus.Forexample,ngramsofsize2forthesentence"thisisapen",are'this
is','isa'and'apen'.
AswiththeClustersTool,thengramscanbeorderedeitherbyfrequencyorthestartorendoftheword.They
canalsobeorderedbytheprobabilityofthefirstword intheclusterprecedingtheremainingwords.All list
orderingscanalsobe inverted.Also,ausercanselecttheminimumandmaximumsize(numberofwords) in
eachngram,andtheminimumfrequencyofngramsdisplayed.
ToproduceanNgramlist,youneedtoperformthefollowingactions:
1) Clickonthe"NGrams"optionabovethesearchentrybox.
2) Choosetheappropriateorderingoptions.
3) Press the 'Start'button.Atany time, thegenerationof thengrams listcanbehaltedusing the 'Stop'
button.
4) ClickingonthelexicalbundlewillgenerateasetofKWIClinesusingthetextasthesearchterm.
Anumberofmenupreferencesareavailablewiththistool.(Seebelow).
CollocatesTool
This tool shows the collocates of a search term. This allows you to investigate nonsequential patterns in
language.
Thecollocatescanbeorderedeitherby frequency, frequencyon the leftorrightofthesearch term,orthe
startorendoftheword.Theycanalsobeorderedbythevalueofastatisticalmeasurebetweenthesearch
term and the collocate. The value measures how 'related' the search term and the collocate are. Current
7/30/2019 Readme Antconc3.2.4
5/21
possiblestatisticalmeasuresarelistedbelow.Alllistorderingscanalsobeinverted.Also,ausercanselectthe
spanofwordstotheleftandrightofthesearchterminwhichtofindcollocates,andtheminimumfrequency
ofcollocatesdisplayed.Ifonlyaonewordspanisrequired,forexample,toseewhichwordsappeardirectlyon
therightofthesearchterm,checkthe"Same"box,tokeeptheminimumandmaximumspansizethesame.
StatisticalMeasures:
(MI)MutualInformation:UsingequationsdescribedinM.Stubbs,CollocationsandSemanticProfiles,Functions
ofLanguage2,1(1995)
(TScore) TScore:Usingequationsdescribed inM. Stubbs,Collocations and Semantic Profiles, Functionsof
Language2,1(1995)
Toproduceacollocatelist,youneedtoperformthefollowingactions:
1) Choosetheappropriateorderingoptions.
2) Pressthe'Start'button.Atanytime,thegenerationofthecollocates listcanbehaltedusingthe 'Stop'
button.
3) ClickingonthecollocateswillgenerateasetofKWIClinesusingthetextasthesearchterm.
Anumberofmenupreferencesareavailablewiththistool.(Seebelow).
WordListTool
Thistoolcountsallthewordsinthecorpusandpresentstheminanorderedlist.Thisallowsyoutoquicklyfind
whichwordsarethemostfrequentinacorpus.
Thewordscanbeorderedeitherbyfrequencyorthestartorendoftheword,andthelistcanbeinverted.The
word
list
can
also
be
generated
in
case
insensitive
mode,
where
words
in
upper
and
lower
case
are
treated
the
same(default)orcasesensitive,wherewordsinupperandlowercasearetreatedseparately.
Toproduceawordlist,auserneedstoperformthefollowingactions:
1) Choosetheappropriateorderingoptions.
2) Pressthe'Start'button.Atanytime,thegenerationofthewordlistcanbehaltedusingthe'Stop'button.
3) ClickingonthewordwillgenerateasetofKWIClinesusingthetextasthesearchterm.
Anumberofmenupreferencesareavailablewiththistool.(Seebelow).
KeywordList
Thistoolshowsthewhichwordsareunusuallyfrequent(or infrequent) inthecorpus incomparisonwiththe
wordsinareferencecorpus.Thisallowsyoutoidentifycharacteristicwordsinthecorpus,forexample,aspart
ofagenreorESPstudy.
Toproduceakeywordlist,youneedtoperformthefollowingactions:
1) Selectasetoftargetfiles.
2) Gotothe'Preferences'menuandchosethe'KeywordPreferences'option.
3) Chooseastatisticalmeasuretoassessthe 'keyness'ofthetargetfilewords.ThedefaultsettingofLog
Likelihoodisrecommended.
4) Chooseathresholdforthenumberofkeywordstobedisplayed.
7/30/2019 Readme Antconc3.2.4
6/21
5) Choosewhetherornottoview 'NegativeKeywords'(targetfilewordswithanunusually lowfrequency
comparedwiththefrequencyinthereferencecorpus)
6) Chooseoneofthereferencecorpusoptions.Select"Userawfile(s)"whenyouwilluserawtext(.txt)files
toserveasthereferencecorpus.Select"Usewordlist(s)"whenyouwilluseoneofmorewordliststhat
aregenerated
from
areference
corpus.
The
"Use
word
list(s)"
option
allows
you
to
generate
keywords
evenwhentheoriginalreferencecorpusisnotavailable.Theformatforawordlistis:
RANK FREQUENCY WORD(separatedbyanytypeofwhitespace,includingspacesandtabs).
e.g.: 1 12838 the
2 11289 a
3 8583 of
...
7) Loadthereferencecorpusoftext(.txt)files,inthesamewaythatthetargetfilesarechosen.
8) Thereferencecorpusdirectorywillbeshown(ifappropriate),andthe listofreferencecorpusfileswill
appearatthebottomoftheKeywordPreferencesoptionmenu.
9) Click'OK'intheKeywordPreferencesmenu,andreturntothemainKeywordswindow.
10)
Choose
suitable
options
for
displaying
the
list
of
generated
Keywords
(in
a
similar
manner
to
the
options
forgeneratingaWordList).
11) Pressthe 'Start'button.Atanytime,thegenerationof thekeyword listcanbehaltedusing the 'Stop'
button.
12) ClickingonthekeywordwillgenerateasetofKWIClinesusingthetextasthesearchterm.
Anumberofmenupreferencesareavailablewiththistool.(Seebelow).
MENUOPTIONS
Menu options are divided into three groups, "File", "Global Settings" and "Tool Preferences". The options
available
in
each
group
will
be
described
below.
Optionshererelatetoreadingfiles intoAntConcandwriting filestotheharddiskcontainingdataofvarious
types.Therearealsooptionstoexportallcurrentsettingstoafile,andimportusersettingsfromafile.Ifauser
settings file becomes corrupted for any reason, simply restart the program or use the "Restore Default
Settings"optiontoreturntheprogramtoitsoriginalstate.
CategoriesherewillhaveaneffectonmultipletoolsinAntConc:
Inthe
File
Settings
category,
the
user
can
choose
to
display
the
full
path
of
afile
or
just
the
name.
The
usercanalsochoosetoshoworhideanytagsinthefile.Thetagboundariescanbespecified.
IntheTagSettingscategory,theusercanchoosetodisplayorhideanytagsthatarecontained inthe
corpusfiles.Iftagsaretobehidden,theopeningandclosingtagmarkersmustbespecified.Thedefault
is.
IntheWildcardSettingscategory,userscaneditthedefaultwildcardcharacterssothattheydonotclash
with a search entry. For example, the "or" wildcard default character (a 'pipe' character | ) can be
changedto
abackslash
/here.
7/30/2019 Readme Antconc3.2.4
7/21
IntheToken(Word)Definitioncategory,theusercanchoosewhichcharacters,numbersandsoonwill
definea"word".Forexample,insomecasesonlyletterswillbeconsideredwords,butatothertimes,in
mightbe
desirable
to
include
numbers,
dashed
and
so
on
in
the
word
definition.
AntConc
is
fully
Unicode
compliant,meaningthatitcanhandledatainanylanguage,includingallEuropeanlanguagesandAsian
languages.Forthisreason,thedefaultoptionstalkoflettersinthebroadestsense.Letters,forexample,
includeallJapanesecharacters,ifthatlanguageencodingisbeingused(seebelow).Itisalsopossiblefor
ausertodefinehisorherown"word"definition.
FormoreinformationontheUnicodestandardssee:
http://www.cs.tut.fi/~jkorpela/unicode/guide.html
http://www.unicode.org/
http://www.unicode.org/Public/5.0.0/ucd/UCD.html
http://www.unicode.org/Public/UNIDATA/PropList.txt
http://www.unicode.org/charts/
IntheColorSettingscategory,theusercaneditthecolorsusedtodisplayresultsandotherinformation.
IntheFontSettingscategory,theusercaneditthe fonttypes,sizes,andstylesusedtodisplayresults
andotherinformation.
AntConc is fully Unicode compliant, meaning that it can handle data in any language, including all
European languagesandAsian languages.The language (encoding)of thedatatobe readbyAntConc
shouldbe
specified
here.
For
example,
if
you
are
working
with
data
saved
in
aWestern
language,
it
will
usuallybeencoded in iso88591 (default).On theotherhand, Japanese textsareusuallyencoded in
SHIFTJIS.Byspecifyingthecorrectencoding,datafromalllanguagescanbeprocessedcorrectlywithin
AntConc.
Eachtool(withtheexceptionofConcordancePlotToolandFileViewTool)hasapreferencescategory,where
settingscanbefinetuned.Alltoolpreferencecategoriesallowtheusertoshoworhidethedifferentframesin
whichtheresultsaredisplayed.Forexample,theusecanchoosetohidetheframeshowingfilenamesinthe
ConcordanceTooldisplaywindow.Also,alltoolshavetheoptiontotreatalldataas lowercaseandusecase
whensorting. Ifresultsaredisplayedcasesensitively,words includingcapital letterswillappearhigherup in
thedisplay.
Inadditiontotheabove,thefollowingsettingscanbemade:
Insteadofarrangingresultsbywordstotheleftorrightofthesearchterm,itispossibletoarrangethe
resultsbyLETTERS to the leftor rightof the first letterof the search term.Thismakes itpossible to
search for spelling differences. The search term can also be chosen to be hidden in the KWIC lines,
allowinginstructorstoquizstudentsonpossiblewordstofitthegap.Anotheroptionistoaddtabspaces
aroundthehitintheKWICdisplay.Thismakesiteasiertoseethehitandalsoeaseslaterprocessingof
thedatainaspreadsheetsoftwareprogram.
7/30/2019 Readme Antconc3.2.4
8/21
Forthistooltherearenoadditionalsettingsthatcanbesetotherthanthosedescribedabove.
Inaddition
to
the
above
the
settings,
the
choice
of
statistical
measure
can
be
chosen
here.
Currently,
twostatisticalmeasurescanbeused:MutualInformation(MI)andTScore.Seeabove.
Inadditiontotheabovethefollowingsettingscanbemade:
A 'lemma list'canbe loadedfromafile,whichcanthenbeusedtogeneratea lemma list insteadofa
wordlist.Whenthelemmalistfunctionisused,the'lemmawordform(s)'columnwillshowthewordsin
thecorpusassociatedwitheachlemma.
A lemma list canbe createdby specifying the 'lemma entry' followby '>' followedbyoneormore
'words'thatshouldbeassignedtothe lemmaseparatedbyoneofmorenontokens.Seetheexample
below:
be
>is,
are
play>play,plays,playing,played
Notethatintheexampleabove,commasandspacesareassumedtobeNOTdefinedastokens.Forthis
reason, ifthe lemma listavailableontheAntConcwebpage isused,a 'dash'needstobeaddedtothe
token(word)definitionforthelemmalisttobeprocessedcorrectlyasthehyphenatedwordsareusedto
therightofthelemmadefinition.
Thewordlistcanbegeneratedusingallwords,ora specific setofwords,or ignoringa certain setof
words(astoplist).Thisistermedthe"WordlistRange".Therangeofwordstobeused(orignored)can
beentereddirectlybytheuser,orcanbestoredinfileswhicharethenreadbyAntConcbypressingthe
'Open'button.Acombinationofwordsinafileandwordsdirectlyenteredbytheusercanalsobeused.
Inadditiontotheabovethefollowingsettingscanbemade:
Asdescribed in the sectionon theKeyword List Tool, to generate a keyword list, theuserneeds to
specifyareferencecorpus,andastatisticalmeasureof 'keyness'.Although,thedefaultoptionsforthe
'keyness' measure and threshold values are recommended, changes can be made in this menu. By
choosing the "ShowNegativeKeywords"option,words that areunusually INFREQUENT in the target
corpus comparedwith the reference corpuswillbedisplayed.Also,here you can choose touse raw
referencecorpusfile(s),orwordlist(s)thatcorrespondtoareferencecorpus.Inaddition,youcanswap
themainandreferencecorpora.
SHORTCUTS
HereisalistofShortcutsthatapplytoalltoolsusingwindowpanesforresults.
CTRLC=Copiesthecurrentlyselectedtext
CTRLA=Selectsalltextinthewindowpane
ALTA=Selectsalltextinallwindowpanesshowing
Doubleclick=Selectsthecurrentword
Tripleclick=Selectsthecurrentlineinthewindowpane
SHIFTclick=Selectscontinuouslinesacrossallwindowpanesshowing
CTRLclick
=Selects
discontinuous
lines
across
all
window
panes
showing
7/30/2019 Readme Antconc3.2.4
9/21
DELETE=Thisdeletesanyselectedlinesthatspanacrossallwindowpanes
INSERT=Thiskeepsanyselectedlinesthatspanacrossallwindowpanes,anddeletesallothers
Forany
'spinbox'
widgets
(e.g.
the
search
term
entry
box)
the
'UP'
and
'DOWN'
arrow
keys
on
the
keyboard
can
beusedtoactivatetheupanddownbuttons.
NOTES
SavingResults
Results can be either saved to the clipboard, saved to a text file (..txt) or saved to a new window using
keyboardcommands,theappropriateoptioninthe'FileMenu',orbyclickingonthe"SaveWindow"buttonin
eachtool,respectively.Also,itispossibletolaunchmultipleclonesofAntConcbydoubleclickingonthe.exe
file.
Comments/Suggestions/BugFixes
Allneweditionsandbug fixesare listed in the revisionhistorybelow.However, ifauser findsabug in the
program,orhasanysuggestionsfor improvingtheprogram,please letmeknowandIwilltrytoaddressthe
issuesinafutureversion.Indeed,therevisionsthathavebeenmadearelargelyduetothecommentsofusers
aroundtheworld,forwhichIamverygrateful.
This software isavailableas 'freeware' (seeLegalMatterbelow),but it is important formy funding tohear
aboutanysuccessesthatpeoplehavewiththesoftware.Therefore,ifyoufindthesoftwareuseful,pleasesend
meanemailbrieflydescribinghowitisbeingused.
ACKNOWLEDGEMENTS
IwouldliketosaythankyoutotheusersofAntConcwhohavetakenthetroubletoemailmewithfeedback
onthesoftwareandsuggestionsforimprovementsand/orchanges.
ThedevelopmentofAntConcissupportedbyaGrantinaidforScientificResearchbytheJapanSocietyforthe
PromotionofEducation,Science,SportsandCulture,Japan(No.16700573),andbyaWasedaUniversityGrant
forSpecialResearchProjects,Japan(No.2004B861).
LEGALMATTER
AntConc3.1.302canbeused freelyfor individualusefornonprofitresearchpurposes,andfreelydistributed
ontheconditionthatthisreadmefileisattachedinanunalteredstate.Ifthesoftwareisplannedtobeusedin
agroup
environment,
you
are
required
to
inform
me
how
the
software
is
to
be
used,
and
Iwill
then
determine
if you canhavepermission touse it.The software comesonan 'as is'basis,and theauthorwillacceptno
liabilityforanydamagethatmayresultfromusingthesoftware.
KNOWNISSUES
1.FileOpening:OnLinuxsystems,withthe"OpenFile(s)"option,thereappearstobeamaximumnumberof
filesthatcanbeopenedatasingletime.Ifmorethanthisnumberisselected,nonewillbereadintoAntConc.
Onmycomputer,themaximumnumberappearstobearound950.Togetaroundthisproblem, Iadvisethe
user toeitherselect files in twoorthreebatches,orusethe"OpenDirectory"option, forwhich there isno
maximumlimit.OnWINDOWS,adifferentfileopenmethodisused,butthiscreatesghostdialogboxesifthe
main
File
Open
Dialog
box
is
moved.
This
is
another
strange
bug
that
I
cannot
fix.
7/30/2019 Readme Antconc3.2.4
10/21
2.Scrollbar:Whena largenumberofconcordance linesaregenerated(orwordsorkeywords),thescrollbar
becomessensitivetowhereonthebartheuserclicksanddragstoview lowerdownentries.Sometimesthis
resultsinausernotbeingabletoviewthelastlinesunlessthecursorisrepositionedonthescrollbars.Thisis
anannoying
bug
in
the
scroll
bar
subroutine
(not
mine!)
and
Iam
waiting
for
someone
to
fix
this.
3. IntheWordClustersTool, ifmore thanoneword isspecifiedasthesearchterm,onlythe firstwordwill
appearontheright,ifthe"SearchTermonRight"optionisselected.
4.There isastrangebutseriousbugthatcausestheprogramtosometimescrash ifthe 'hidetagsoption' is
activated,andthentheFileViewtoolisusedbeforeusinganyothertool.Idonotunderstandthecauseofthe
crash,buta solution isbeing investigatednow.Also, thebug seems toonlyappearoncertainmachinesat
certaintimes.PossiblythisisaproblemrelatedtousingtheprogramwithfilesstoredontheDesktopundera
JapaneseversionofWindows.Therefore,IadvisethatusersdonotstorefilesundernonLatin1(Western)path
names,forexample,the'Desktop'onAsiansystems.
5.Relatedtopoint4,therearemany issueswith languageencodingsonnonWesternsystems.Forexample,
many users have found it difficult to view Chinese characters correctly until I have suggested the correct
encoding fortheirsystems. Iadvisethatyou loadthecorpus filesand thentryeach fontencodinguntilone
showscharacterscorrectly.
6.Thereisareportthatwhenthe"WordEnd"sortoptionischosenintheWordListtool,theprogramcrashes
insomespecialcases.
7. I have heard reports that AntConc on Macintosh OS X sometimes does not correctly display rare font
charactersassociatedwithsomenonEnglish languages.Thisappears tobeaproblemwithX11 (thegraphic
engineused todisplay theAntConcwindows) rather thanAntConc itself. I recommend installing the latest
versionof
X11
before
using
the
software.
8.OnsomeWindowssystems,ifcorpusfilesareplacedonthedesktopandopenedtwice,onthesecondtime,
ifthefilenameappearsinthesystemhelppopup,AntConcmaysuddenlycrash.Thisis*not*abuginAntConc.
ItisaMicrosoftWindowsbug.ThesameeffectcanbereplicatedinasoftwareprogramlikeMicrosoftNotepad.
Theworkaroundistonotsavefilesonthedesktop,orjustselectthemquicklybeforethepopupappears.
REVISIONHISTORY3.2.4
Thisisaminorupgradefixingtwoproblems(oneonlyapplicabletoOSX).Nonewfeatureshavebeenadded.
Bugfixes:
1) ModifiedtheOSXversionsothatlemmalistfileswillloadcorrectlyregardlessoftheOSversion.Thebugwasmoregeneralandpossiblycausederrorswhenusinganysinglefileopenfiledialogbox,e.g.,
importingsettingsfiles,searchlistfiles,andwordlistfiles.Ionlyheardoneortworeportsofproblems
onOSX,soperhapstheproblemwasintroducedwithupgradestorecentversionsofOSX.Itisdifficult
totell.
2) Fixedabugthatcausedthetotalnumberoflemmaentriestonotbedisplayedproperly.3.2.3
Thisisamajorupgradeintroducingseveralnewfeaturesandaddressingbugsthatappearedinversion3.2.2.1.
NewFeatures:
3) Massively simplified theengineused for sorting anddisplaying results.Thiswill allow for improvedperformance
later.
7/30/2019 Readme Antconc3.2.4
11/21
4) IntroducedaConcordancepreferencesettingallowingtabspacestobeaddedaroundthesearchhitintheKWICconcordanceview.Introducingthismeansthatthetoggleshortcutkeyxtoshow/hidethe
KWIC search termhashad tobe removed.This function cannowbeaccessedvia the (fixed)menu
option.Ialsohopetoreintroducethistoggleshortcutkeylater.
5) Introducedtheoptiontousewordlist(s)ofreferencecorpusfilesinsteadofdirectlyprocessingtherawfiles. This allows fast generationof keywords and also allowsusers to generate keyword lists even
whenthereferencecorpusisnotavailable(butawordlistis).SeetheKeywordListsectionforfurther
details.
6) Introducedfeaturetooutputthecountsoftypesandtokensforeachtoolwhensavingresultsasatextfile.
7) Changedsomeofthedefaultsettingsinresponsetouserfeedback:8) ConcordanceToolsortlevelsaresetas1R,2R,3R.
TheCollocatesToolStatsmeasureisnowdisplayedandcalculated.
Bugfixes:
1)The
splash
screen
that
appeared
when
a
user
settings
file
was
added
has
been
removed.
Now,
the
wordsUserSettingsappearsnexttothetitleofthesoftwareatthetopofmainwindow,whenevera
usersettingsfileisused.
9) Thelayoutofthemainwindowhasbeenimprovedsothatthemainworkareaismaximizedforallsizesofmainwindow.
10)UnicodeMarkscannowbeadded/removedin thetokendefinitionsettings11)Occasionally,the lastbaroftheprogressbarremainedblankattheendofprocessing.Thishasnow
beenfixed.
12)Undertagsettings,theHideHeaderTagsoptionwillnowworkforheadersthanspanacrossmultiplelines.
13)Themainwindowandallpopupwindowsnowappearcenteredinthedisplay.14)Whenviewingtheglobalsettingspreferences,itwaspossibletoaccidentallyactivatethemainwindow
byclicking
on
it.
This
has
been
fixed.
15)Thelistoffilesintheleftpanewasoftentoonarrowtovieweasily.Thishasbeenfixedbyintroducingatwopaneapproach,withthe leftpaneshowingthe files,andtherightpaneshowingtheresultsand
controls.Thewidthofbothpanescanbeadjustedwiththedefaultsizebeingtheminimumsize.
16)Itwaspossibletoadjustthemainwindowtobesmallerthanthedefaultsizeof800pxby600px.Thiscausedthepositioningofsomewidgetstobecomemisaligned.Now,800pxby600pxhasbeensetas
theminimumsizeofthemainwindow.
17)Variousproblemsexperiencedwhen cutting, copying, andpasting text to/from the Searchboxes ineach tool have been addressed by removing the Spinbox widget type and replacing this with a
standard Entry widget. The history of previous searches can be now accessed using the Up
(previous)andDown(next)arrowkeys.
18)AftermovingthecursoroverthecorpusfileslistwhileusingtheFileViewTool,itshouldchangeintoaPointingFingercursor.However,thiscursorshapewasreturnedincorrectlybacktoastandardEdit
cursorwhenoneofthefileswasselected. Thishasnowbeenfixed.
19)Changed foreground towhitewhenAntConc reports that theKWIC analysishas finishedorhasnoresults.Thisshouldbeeasiertoread.
20)FixedabugthatcausedtheConcordancepreferenceoptionHidesearchterminKWICdisplaytoonlyshowthehit.(Theoppositeofthestatedfunction!).Thisisnowfixed.
21)FixedsometyposinthisReadMedocument.22)FixedamajorbugthatcausedawarningtoalwaysappearwhenusingtheTScorestatisticalmeasure
withtheCollocatesTool.Notethatthewarningcouldbeignoredastheresultswouldalwaysbecorrect.
3.2.2.1
7/30/2019 Readme Antconc3.2.4
12/21
Thisisaminorupgradeaddressingbugsthatappearedinversion3.2.2.
Bugfixes:
1) ThelegacycharacterencodingsforJapanese,Chinese,Taiwanese,andKoreanwere inadvertently leftout
of
the
compiled
executable
for
version
3.2.2
meaning
that
files
encoded
in
these
languages
would
notopencorrectlyinAntConc.Thesehavenowbeenadded.
2) IntheMacOSXversion,thecompiledversiondidnotincludeseveralimportantcomponentswhichareessentialfortheX11graphicaltoolkittoruncorrectly.Thesehavebeenadded.
3.2.2
Thisisaminorupgradeaddressingseveralminorbugsthatappearedinversion3.2.1.Itisalsothefirstversion
ofAntConctobecompliedwithPerl5.10.
Bugfixes:
3)Fixed
a
bug
that
caused
back
references
to
not
work
correctly
when
the
'Regex'
search
option
was
selected.Thisnowworkscorrectly.However,notethatthefirstbackreferenceshouldbe2andnot1
(duetoanimplicitbackreference1thatholdstheentiresearchresult.
4) FixederrormessagewhenthesortbyStatoptionwasselected.3.2.1
This isaminorupgradeaddressingseveralbugsthatappeared inversion3.2.0,aswellas introducinga few
newfeaturesrequestedbyusers.
NewFeatures:
1) Betterdisplayoflonglistsoffontsandfontsizesintheglobaloptions/fontmenu.Nowthelistsappearasaneasytonavigatelistwithattachedscrollbar.
2) Whenresultswindowsaresaved,theclonedwindowsnowdisplaysummaryresultsinformation.3) Wordrangelistscannowbeusedaslemmarangelists.4) New feature allowing tagged data to be searched while remaining hidden. See the tag settings
preferences.PressingCONTROLandtheSTARTbutton(ortheENTERbuttonifthesearchentryboxhas
the focus) temporarilydisables thenew feature,allowing theuser to switcheasilybetweena 'non
tagged'or'tagged'display.
5) Newoptionsinthetagsettingspreferencesthatallowembeddedandnonembeddedtagstobeshown,ignored,orhidden.Thisenablesdataof the formof theBROWNandBNC corpora tobeprocessed
easily.
6) Improvedtheupdatingoftheprogressbardisplay,whichmayalsoimprovethespeedofprocessinginsomecases.
7) Improvedtheimagesusedforiconswithintheprogram.Bugfixes:
1) Fixedbugthatcauseduserdefinedtokendefinitionscontainingspecialregularexpressioncharactersfromnotworkingproperly
2) Fixedbugthatcaused"Treatalldataaslowercase"optiontoignorethewordlistrangeandlemmalists3) Fixedbugthatcausedthelemmalist"Load"buttontonotignorethecurrentlyopenedfileifanewfile
dialogwasopenedandthen"Cancel"waspressed
4) Fixedbugthatcausedfilesearchestonotworkifthesearchentryboxwasblank.
3.2.0
7/30/2019 Readme Antconc3.2.4
13/21
This isamajorupgradewithacompletely redesigned interface,severalnew features,andseveralbug fixes.
Thenewinterfacefollowsthebasicdesignusedinpreviousversions,althoughusersshouldfindit'cleaner'and
moreintuitive.Inparticular,allglobalandtoolmenusettingshavebeencombinedintotwogroups,whereall
therelatedsettingscanbeaccessedandadjustedwithinthesamewindow.Thisshoulddramatically improve
theusability.
All
tools
now
have
access
to
the
search
engine
(including
the
Word
List
Tool
and
Keyword
List
Tool)and there isalsoanewadvancedsearchwindow thatcanbeused toperform list (file)searches,and
searcheswithinaparticularcontext.Duetothenatureofthechanges,thisversionwillnotbecompatiblewith
thesettings files forpreviousversions.Anotherhugechange is that thisversionwill runonMacintoshOSX
systems.
NewFeatures:
1) Completelyredesignedinterface2) Addedsearchandadvancedsearchfeaturestoalltools(includingtheWordListToolandKeywordList
Tool).
3) Creatednewlist(file)searchavailableinalltools.4)
Created
new
context
search
option
in
all
tools
except
the
Word
List
Tool
and
Keyword
List
Tool
where
ithasnomeaning.
5) Busycursorsareusedto indicatewhenvery longsortingoperationsarebeingcarriedout(e.g.whensortinglargeNgramlistresults).
6) Caseoptions affectingwhetherornotdata is converted to lower case arenowmore intuitive. Forexample,the'Case'optioninthemainwindownowonlyaffectstheoperationofthesearchitselfand
hasnoimpactonthedataunderobservation.Datacanbetreatedaslowercase(forexampleinWord
list tool) by choosing the 'Treat all data as lowercase' under the appropriate category in the 'Tool
Preferences'menu.
7) Thenumberofcorpusfiles(andreferencecorpusfiles)beinganalyzedisnowdisplayed.8) Correctsomemistakesinthisreadmefile9) Mynamehasbeenremovedfromthetopofthemainwindow!However,pleaserememberthatmy
nameis
Laurence
with
aU
ifyou
are
ever
citing
me
in
your
research
papers!!
10)NowworkswithMacintoshOSXBugfixes:
1) The program no longer crashes when the 'All Values' option is chosen as the threshold value inKeywords.
2) Negative keywords are now highlighted correctly when the 'Show Negative Keywords' option isselected.
3) TheKWIClinesarenowalignedcorrectlyevenwhenthehitappearsneartheverystartorendofafile.4) Collocatesfrequencyvaluesarenowcorrectlycalculatedevenwhenthespanextendsfurtherleftthan
thestartofthefile
5) Theactionofthe'onewordonly'wildcardisnowmoreintuitive.6) Someoperations (e.g.creatingaword list)nowdonotcrashafter restoringthedefaultsettingsand
thenperforminganoperation.
Bugfixes(sincebeta1version):
1) Theprogramnow(correctly)onlyshowsfilesthatgeneratehitsintheConcordancePlottool.2) The sort function in the Keywords Tool now works correctly. In previous versions, even when the
'Frequency'optionwas selected, the sortwouldbebasedonKeyness.Also, in some cases inverted
sortingdidnotwork.
Bugfixes(sincebeta2version):
7/30/2019 Readme Antconc3.2.4
14/21
1) The program now (correctly) hides the various Concordance Tool panes depending on the chosenDisplayOptions.Intheearlierbetaversions,theoptionswereignored.
2) Thedefaultfiletypetousewhenopeningdirectoriesnowworkscorrectly.Inpreviousbetaversions,afterhittingtheapplybutton,thedefaultfiletyperevertedbacktothe .txttype.
3) FixedabugthatpreventedthengramsoptionintheClustersToolfromworkingwhenthesearchtermentryboxwasempty.
Bugfixes(sincebeta3version):
1) FixedbugthatcausedtheprogramtonotbeabletoopenfileswithnonEnglishnamescorrectlyifthefullpathnameoptionwasselected.TherearepotentiallymanyproblemswithnonEnglish filenames,
so I recommend thatusersuseEnglish filenames for their corpus files,andalso save themundera
pathnamewhichonlycontainsEnglishcharacters.
2) Fixedbug that caused the 'OR'wildcard tonotwork correctly ifa characterother that '|'wasuserdefined.
New
Features
(since
beta4
version):
1) MadesomesmallchangessothattheprogramcouldbemoreeasilyportedtoMacintoshandLinuxplatforms.
3.1.303
Thisisaveryminorupgradewithjustonechange:
Bugfixes:
1) CorrectedproblemthatcausedtheNo.ofHitstonotbe indicatedcorrectly intheConcordancePlotTooldisplaywhenmorethanonecorpusfilewasbeingused.
3.1.302
Thisisaveryminorupgradewiththefollowingchanges:
Bugfixes:
1) Correctedproblemwhichcausedtheprogramtonot launchwhenthepathofthedefaulttemporaryfolderonthesystemcontainednonEnglishcharacters.
2) (Linuxonly):CorrectedproblemthatcausedtheOpenDirmenuoptiontonotworkcorrectly.3) (Linuxonly):Correctedproblemthatcausedfontselectionstonotworkcorrectly.
NewFeatures:Improvedspeedandmemoryhandlingwhencalculatingcollocates.Over10timesfasterthanin
previousversions(includingversion3.1.3).
3.1.3
This isaminorupgradecontainingan importantbug fix thatprevented fileswithnonASCII filenamesbeing
used.There
are
also
some
major
performance
improvements.
For
example,
ngrams
will
now
be
processed
over10 times fasteronsmallcorporaandmanymore times fasteron largercorpora.A listofall important
changesisbelow:
NewFeatures:
Thehistoryfeatureforsearchtermentrieshasbeenchanged.Ihaveheardtworeportsofthe3.1.2versionnot
startingoncomputers.Hopefully,thischangewillallowtheprogramtostartcorrectlyonallmachines.
TheperformanceoftoolssuchasCollocates,ClustersandNgrams,hasbeensignificantlyimproved.(Over10
timesfasteronsmallcorporaandmanymoretimesfasteronlargercorpora.)
TheOpenDiroptionnowopenfilesinallsubdirectoriestoo.
The program will automatically look for a user defined settings file named "antconc_settings.ant" in the
directorywheretheprogram issaved. Ifthisfile isfound,thissettingsfilewillbeused insteadofthedefault
7/30/2019 Readme Antconc3.2.4
15/21
settings.Alsoasplashwindowwillbedisplayedwhenausersettingsfileisfound.Ifnofileisfound,thedefault
settingswillbeused. Inthiscase,nosplash filewillbeshown.Thisfeatureallowsuserstosavetheirsetting
preferencesandusethemagainwithouthavingtoloadthepreferenceseachtime.
BugFixes:
1) FileswithnonASCIIfilenameswereincorrectlyprocessedpreventingthembeingused.Introducedinversion3.1.2.Fixed.
2) IntheNgramstool,nonwordunits(e.g.spaces)atthebeginningsoflinesweretreatedaswords.Thiscausedsomengramsofn1sizetoalsoappearintheresultslist.Fixed
3) When"ALL"wasselectedasthefiletypeoptioninOpenDir,subdirectorieswerealsodisplayedeventhoughthesecouldnotbeopenedorprocessed.Fixed
4) In some tools, nonASCII filenames were sometimes displayed incorrectly, even after the correctencodingwaschosen.Fixed.
5) If'Exit'waschosenfromtheFilemenuoptions,theprogramexitedwithoutawarning.Fixed.6) The"Add"buttonforthe 'AddWord'optionwasaccidentallydeletedfromtheWordListPreferences
menu.
This
meant
that
words
could
only
be
added
by
hitting
the
return
button.
Fixed.
Changes:
1) ThedefaultfiletypeforOpenDirhasbeenchangedto.txt2) The 'Directory'displays inboth themainwindowandkeywords listpreferenceswindowhavebeen
deleted.Asdirectoriesandsubdirectoriescannowbeused,this featurehasbecomeredundantand
perhapsconfusing.
3.1.2
This is a semimajor upgrade containing a new Lemma List tool, and numerous bug fixes and interface
improvements.Alistofallmajorchangesisbelow:
1) Bindingtoplotcanvaslinestoallowjumpingtohitinfile(sameasinconcordanceview).2) Bindingtofile listallowingtheusertosimplyclickonthefilenamewhenusingtheFileViewtoolto
viewthe
file
3) Historyfeatureforallentries(useupanddownarrowsonkeyboard)4) Muchfasterconcordancerprocessing(especiallysorting...upto10timesfaster)5) Abilitytoclearcontentoftools(ClearTool,ClearAllTools,ClearAllToolsandFiles)6) Abilitytosavelistofallloadedfilesinsettingsfile7) Redesigned "one or more words" and "any one word" wildcards to act more sensibly. Now, the
wildcards incorporate any nontokens between possible words. Therefore, use "is#dog" and
"is@@dog"etc.tosearchforthehit"isadog"inthesentence"Thisisadog."
8) NewLemmatoolallowingalllemmasofawordlistwordtobedisplayed.Note:Alemmalistisrequired.9) AddedbindingstoWordlistRangelisttoallowwordstobedeleted(button)orkept(
button)aswithothertools.
10)Swapbuttontoswitchthemainandreferencecorporawhendoingkeywordanalyses.(AccessiblefromtheKeywordpreferencesMenu).
11)Fixed serious bug that caused the program to freeze or crash when an incorrectly formed regularexpressionwasusedasasearchterm.
12)Fixedseriousbugthatcausedsomeword,keywordandfontencodingstonotbeloadedcorrectlyfromtheusersettingsfiles
13)Fixedbugthatcausedthe'Reset'buttonstonotworkcorrectly.14)Fixedbugthatcaused'userdefinedtokendefinitions'tonotbeloadedcorrectly.
3.1.1
7/30/2019 Readme Antconc3.2.4
16/21
This is a minor upgrade although it contains a new TScore stats feature, and has a new editing feature,
allowingyoutoselectandthendelete,orkeepcertainresultslines.Alistofallmajorchangesisbelow:
1) AddedTScoretostatsmeasureintheCollocatesTool.2) ChangestheCollocatesToolmenutoallowoneaseveralstatisticalmeasuretobechosen.3) Adding a feature so that any selected results lines canbe eitherdeletedor kept (afterdeleting all
others).
4) ThetagsettingsoptionsintheFileSettingsmenuhavenowbeenmovedtoaseparatemenu.5) Labelsinthesoftware(inparticularthoserelatedtolanguageencodings)havebeenslightlyalteredto
makethemclearer.
6) ImprovedthewarningsgivenwhentheCollocatesTool isnot insyncwiththeWordListTool,duringthecalculationofcollocatesignificance.
7) Changed the internalworkings toallowLINUXandWINDOWSportsofAntConc tobeeasilycreatedfromthesamesourcecode.Thisshouldallowfutureversionstobereleasedatthesametimeforboth
operatingsystems.
8) Fixedabug thatcaused theTransitionprobabilitiescalculation tonot initializecorrectly.Thismeantthat
although
the
first
calculation
was
correct,
all
later
calculations
would
be
give
false
measurements.
3.1
AntConc3.1isamajor,majorupgrade.IwasverytemptedtonamethisAntConc4.0,butintheendchoseto
keepitinthe3s.Tolisttheimprovementsandchangeswilltakeupmanypages,soonlythemajordifferences
arelistedhereinnoparticularorder.Ofcourse,withsomanychanges,therewillinevitablybenewbugsthat
havecrept intotheprogram.However,Ihopeyouwillfindthatthisreleaseisanimprovementoverprevious
releases.
1) ImplementationofnewCollocatesTool.2) Totalreworkingoftheprogrammingunderneathalltoolsforperformanceenhancements.3) Addingof"sort"featurestomanytools,enablingquickandefficientreorderingofresultsinformation.4) Sensibletreatmentofwordcase inalltools.Nowsearchesaretrulycasesensitiveor insensitive,and
resultscan
be
displayed
according
the
1) casesetting.5) Allsettingscannowbeimportedorexportedtoafile.Thisallowsuserstoeasilyuploadtheirpreferred
settings,avoidingtheneedtoconstantlymakechangestothedefaults.ThisisaHUGEimprovement(I
think!).
6) The"OpenDir"optionhasbeenrestored.FiletypesthatwillbereadintoAntConcviathe"OpenDir"optioncannowbespecifiedinthe"FileSettings"menu.
7) AntConc isnowFULLYUnicodecompliant. Itshouldworkwithany language in theworld. IamveryinterestedtohearhowAntConcworks indifferent languages.Please letmeknow.Tokendefinitions
can bemade using all Unicode character classes, or a user defined token definition can bemade.
However, Iwouldadviseagainstusing theuserdefined tokendefinition,as it issoeasy tooverlook
possiblecharacters
that
might
need
to
be
processed.
8) AsAntConc isnow fullyUnicodecompliant,allpossibleencodingsofcharactersare listedunder theEncodingsmenuoption.ForEnglishandallotherWestern Language, thedefaultoption, iso88591
shouldworkfine.NotethatmanyWindowssystemsactuallysavefilesinthecp1252encodingwhich
resembles iso88591but is a littledifferent,just to confusepeople!Userswith Japanese textswill
probablyfindshiftstobethebestoption.
9) Someusershavesaidtheycouldnotopenthefontselectionwindows.Thisproblemhasbeenfixed.10)Manyneworderingoptionshavebeenadded,forexample,fromwordends.11)Theoveralldesignof the interfacehasbeen improved,allowing fornewoptions tobeeasilyadded
without cluttering the display.Also mostmenu options now use simple checkboxes instead of the
confusing"yes","no"radioboxesusedinpreviousversions.
7/30/2019 Readme Antconc3.2.4
17/21
12)Someofthetoolnameshavebeenchanged.Inparticular"lexicalbundles"arenowcalled"NGrams",whichisamorefamiliarterm.
13)TheWordStemsfeaturehasbeenremoved.ThisonlyworkedwithEnglishtexts,andtheresultswereofquestionablevalue.Ifauserwouldliketoseethefeatureinafutureversion,pleaseletmeknow.
14)Thesizeoftheprogramhas increasedbyaround1MB.This issothatallthefontsandencodingsfortrueinternationalizationofAntConccanbeincluded.
15)Thisreadmefilehasbeenlargelyrewritten.Ihopetherearefewerspellingmistakesthistime!16)Many,many smallbugshavebeen fixed,mainly related to theway the interface responded touser
actions.
3.0.1
A fewbugs in3.0havebeen corrected.Also, theViewFiles toolhasbeen redesigned toworkmuch,much
faster.Todothis,theprogramnowdoesnoprocessingattheendoflines.Therefore,ambiguouslineendings
willstayambiguous!
1) ImprovedperformanceofViewFilestool2)
Corrected
bug
which
caused
the
first
file
in
Keywords
to
appear
even
after
the
list
of
files
is
deleted
fromthesystem.
3) Addedfeaturetoallowfilestobeaddedtothesystemfromdifferentfolders.Now,ifafileisopenedinto thesystem itwillbeadded to thecurrent listwithoutdeleting theprevious list files.Thesame
appliedtofilesaddedintheKeywordsListpreferencemenu.
3.0
Therehavebeensomanychangesthatitisalmostimpossibletolistthem.Herearesomeofthemoreobvious
differencesbetweenAntConc3.0andpreviousversions.
1) Wildcardimplementation2) Wordstemimplementation3) Savecurrentwindowfeatureaddedtoalltools(except'ConcordanceSearchTermPlot')4) Threelevelsofsortimplemented5) Completeredesignandimplementationofthe'ViewFiles'tool,makingitgenerateresultsmuchfaster.
(Butitisstilltooslow).
6) Hyperlinksaddedtotheresultsofalltools.7) Rearrangementofthemenuoptions8) Redesignofthefilelistwindow,allowingoneormorefilestobeclosed.9) Redesignofthemainresultswindows,placinginformationindifferentwindow'panes'.Eachpanecan
beresized,orhidden.
10)Redesignofthedataselectionmethods.Theselectionmethodsnowcomplywithmostothersoftwareproducts.
11)Completeredesignofmanysubroutinesenablingquickerprocessing.12)Many,manybugsfoundandcorrected.PleasetellmeifyoufindabugbecauseIWILLcorrectit.
2.6.0
1) Corrected a bug (introduced in version 2.5.3) which caused cluster lists to be not be displayedalphabetically.
2) Correctedabug(introducedinversion2.5.3)thatpreventedthe2ndsortcolortobeproperlyupdatedfromthesettingsmenu.Thankstoauserforpointingthisouttome.
3) Correctedabug (introduced inversion2.5.3) thatprevented filesona Japanese system tobeopencorrectly.Thisbug is related to thenew implementationof thePerlprogramming language.Please
pointoutanybugsduetothenewversionofPerl,astheyareverydifficultforonepersontodiscover.
4) Addedanoption toeither showor ignore tagsembedded in files (which isusefulwhenprocessingHTMLorXMLfiles).
7/30/2019 Readme Antconc3.2.4
18/21
5) Addeda'lexicalbundles'optiontotheWordClusterstoolthatgenerates"wordngrams".6) Deletedthe"OpenDirectory"option,asitpreventedfilesotherthan.txtfrombeinguploaded.7) Addedmenusettingoptionstoallowthefontforsearchesandresultstobechanged.8) AddedmenusettingoptionstoshowJapanesefonts(inSHIFTJISencoding)tobedisplayedproperly.9) Reducedtheoverallsizeoftheprogrambyapprox.1MB.10)Anumberofsmallbugswerecorrected.
2.5.4
1) Correctedabug(introduced inversion2.5.3)whichcausedword listsandkeyword liststobenotbedisplayedalphabetically.
2.5.3
1) Adjusted the positioning and size of application widgets so that the application will be displayedproperlyonan800x600orhigherresolutionmonitor.
2) Correctedseveralspellingerrorsinthisreadmefile.3)
Adjusted
the
parameter
settings
for
the
Word
Clusters
tool.
4) Relabeledseveralbuttonssothattheydisplayproperlyonlowresolutionmonitors.2.5.2
1) Enabledanew'Clusters'tool,forgeneratingwordclusterscenteredonatargetsearchterm.2) ReorderedOpen File andOpenDiroptions in the FileMenu. I think filenavigation combinedwith
'selectallfiles'iseasierthandirectorynavigation,
3) Fixedacoupleofsmall,insignificantbugs.4) Fixedsomespellingerrorsinthisreadmefile.
2.5.1
1) Enabledanew feature,wherebyclickingon the search termhit inany concordance line,allows theuser
to
view
the
hit
in
the
original
file
via
the
View
Files
tool.
2) FixedasmallbugintheViewFilestool,whichcausedthesearchestoignorethe'Case'setting.3) ImprovedtheperformancewhengeneratingViewFilesbycachingalreadyprocessedfiles
2.5.0
Afairlymajorupgradesince2.4.1
Hereisalistofchangesthathavebeenmade
1) Bugfix.Whenviewingfiles,andlocatingthenextorprevioushit,ifthetargetfilewaschangedandthehitnumberdidnotexistinthenewfile,theprogramwouldcrash.Thisproblemhasbeenfixed.
2) Extension: In the view filewindow, hitswouldonly appear if theyoccurred on a single line in theoriginalfile.Thiswouldresultindifferentnumbersofhitsdependingonifthesearchwasmadeinthe
concordancewindow
or
the
view
files
window.
The
view
file
processing
has
been
completely
revised
enabling view file searching to correspond exactly with that used in the concordance window.
Unfortunately,thishasresultedinasmalllossinperformancewhengeneratingthehighlightinginthe
viewfile.Also,clickingintheViewFilewindownowallowstheusertoimmediatelyjumptothenearest
hit.
3) Theabilitytoshowornotshowfullpathnamestofileshasbeenaddedasasystempreference4) Theabilitytoshowornotshow filenames in theconcordancewindowhasbeenaddedasasystem
preference.
5) Theabilitytosetawordlist'range'hasbeenaddedasasystempreference.6) HighlightingintheViewFilestoolhasbeenchangedtomakethehitseasiertosee.
7/30/2019 Readme Antconc3.2.4
19/21
7) Popupwindowsthatshowedhowmanyconcordancehitsweregenerated,andthatreportedwhennohitswere found have been removed. Instead, the status of the concordance hit processing is now
showninthetoprightofthemainwindow.
8) Manysmallbugs relating tohow thevarious tooldisplaysareupdatedafterpreferencechangesaremade
have
been
corrected.
9) Processingthatblocksuserevents(suchasmouseclicksetc.)havebeenreduced.10)Theinternalworkingsoftheprogramhavebeenrewrittensothatproblemsandfutureadditionscan
beeasilyhandled.
11)ThegenerallayoutoftheREADMEfilehasberedesigned.
7/30/2019 Readme Antconc3.2.4
20/21
2.4.1
NewsinceAntConc2.4.1istheabilitytochoosewhetherornottoview'NegativeKeywords'.Thesearewords
inthetargetfilethathaveanunusually 'low'frequency.InpreviousversionsofAntConc,NegativeKeywords
werenotdistinguishedfromKeywords.However,nowtheyaretreatedseparately,and iftheuserchoosesto
displaythem,
they
appear
after
the
Keywords,
with
ahighlight
color.
2.4.0
Amajorupgradesince2.3.0
1) First,progressindicatorswereaddedto'pages'ofAntConc.2) Second,anewfileviewfeaturewasaddedtoviewtargetfilesintheiroriginalstate.3) Third,akeywordgenerationfeaturehasbeenaddedusingloglikelihoodandchisquaredmethods.4) Finallyseveralbugswerefound, inparticular,bugscenteredonthewordlistgeneration feature.This
featureofthesoftwareshouldworkmuchquickernow.Also,theusercaninterrupttheprocessingof
filesinany'page'ofthesoftware.
2.3.0
Amajorupgradesince2.2.3
1) First,theabilitytoviewconcordancesearchresultsasabarcodeplotgraphandafeaturetoproducewordlistaccordingtodifferentcriteriawereadded.
2) Numerousbugscenteredonthewaythesoftwareentereda'Busy'modewerecorrected.3) Themaincoreofthesoftwarewasalsoupdatedresultinginaquicker,'cleaner'processingofthedata.4) Performanceimprovementsshouldbenoticedasaresult.
2.2.3
1) UpdatedfileanddirectoryselectiondialogboxestorunsmoothlyinaWindowsenvironment.2) Also,changedthedefaultcolorsforsorthighlighting,andsearchwindowframesize.3) Anumberofsmallbugswerealsocorrected
2.2.2
1) Corrected critical fault with compiler than caused program to expire when evaluation version ofActiveStatePerlDevelopmentKitexpired.Sorryfolks!!Ididn'trealizethiswouldhappen!!
2.2.1
1) Correctedbugwhichpreventednewconcordancelinesbeinggeneratedifthesearchtermwasleftthesameandthennewfileswereselected.PorttoLinuxalsocompleted.
2.2
1) Designed new subroutines for selecting directories and files to solve rendering of dialog windowsproblems.
This
also
enables
an
easier
port
to
Linux.
2.1
1) Addedasecondlevelofsort.2) Addedabilitytorestrictsearchestofullwordsonly,casesensitive.3) AddedabilitytosearchusingfullPerlimplementedregularexpressions.4) Addedabilitytosaveresultseithertoafileortheclipboard
2.0
1) Addednewsortfeature,forrearrangingconcordancelines.2) Tidieduptheinterface.Madethesystemmorerobustfornoviceusers.(Nowbadinputwillnotcause
thesystemtocrashsoeasily).
7/30/2019 Readme Antconc3.2.4
21/21
1.1
1) Addedbindingtoallowreturnkeytolaunchconcordancesearch.2) Also,recompiledsoftwaresothatnoconsoleisrequired.
1.0
Firstversion
Copyright:LaurenceAnthony