readme antconc3.2.4

Upload: vanilza-maria-da-silva

Post on 14-Apr-2018

258 views

Category:

Documents


1 download

TRANSCRIPT

  • 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