WIZDEX (tm), Text File Index Generator (C) 1982, by Wizard of OsZ (tm) WIZDEØ ió á utility¬ useä witè WordStar¬ thaô generateó aî alphabeticallù sorteä indeø foò á texô file® Thå wordó anä phraseó thaô arå tï bå indexeä arå markeä witè controì characters® WIZDEØ sortó theså wordó anä phrases¬ forminç aî indeø thaô ió attacheä tï thå enä oæ thå texô file® Iæ á filå ió lateò edited¬ thå useò caî re-invokå WIZDEØ tï removå thå olä index¬ producå á ne÷ one¬ anä adä iô bacë tï thå enä oæ thå texô file. Althougè designeä foò uså witè WordStar¬ WIZDEØ may bå useä witè anù texô editoò thaô caî inserô controì characteró intï thå text® Thå filå musô bå terminateä bù á Control-Ú characteò (thå correcô way© oò bù aî enä-oæ-file® Nï otheò assumptionó arå madå abouô thå contentó oæ thå file. Iî ordeò tï maintaiî thå propeò pagå numbers¬ WIZDEØ scanó thå texô filå foò certaiî WordStaò "doô commands"¬ sucè aó pagå breaks¬ ".pa"¬ etc® Iæ nï pagå "dot¢ commandó arå found¬ aó witè otheò editors¬ pageó arå counteä internally. - WIZDEX Files - WIZDEØ ió provideä tï yoõ oî thió diskette¬ in thå followinç fouò files: WIZDEX.COM <-- WIZDEX program command file. WIZDEX.TXT <-- WIZDEX text file prior to indexing (sample text). WIZDEX.DOC <-- WIZDEX documentation file after indexing. WIZDEX.PRN <-- WIZDEX print file after printing with WordStar. .pa Š - Preparing Text Files for WIZDEX Indexing - Therå arå twï differenô kindó oæ indeø entrieó - WORDÓ anä PHRASES® WORDÓ arå groupó oæ characters¬ seperateä bù spaces¬ commas¬ carriagå returnó oò linefeeds® PHRASEÓ arå groupó oæ words¬ includinç thå spaceó thaô seperatå thå words® WIZDEØ needó just singlå markeò tï identifù words® Tï marë á worä foò thå index¬ jusô preceeä iô witè á Control-Ë character® Tï dï thió iî Wordstar¬ positioî thå cursoò oî thå firsô letteò oæ thå worä thaô yoõ wanô tï mark¬ presó Control-P¬ theî Control- K® Á ^Ë wilì appeaò iî fronô oæ thå markeä word. Tï marë aî entirå phrase¬ preceed¬ anä concludå thå phraså witè á Control-Ð character® Iî WordStar¬ positioî thå cursoò oî thå firsô letteò oæ thå firsô worä iî thå phraså anä presó Control-Ð twice® Then¬ movå thå cursoò tï thå enä oæ thå phrase¬ afteò thå lasô letter¬ anä presó Control-Ð twice® Now¬ á ^Ð appearó aô thå beginninç anä at the enä oæ thå markeä phrase. Aó aî example¬ thå nexô paragrapè haó markeä wordó anä phrases® Normally¬ wheî á filå ió listeä oò typed¬ thå controì characteró arå suppressed® However¬ wheî á filå ió vieweä witè WordStar¬ thå controì characteró appeaò embeddeä iî thå text® ( ª Note¬ iô ió assumeä thaô yoõ arå readinç thió documenô aó á listing® Iæ yoõ arå usinç WordStaò tï vie÷ thió file¬ yoõ wilì seå whaô appearó tï bå ^P^Ð anä ^K^K...actuallù onlù onå 'real§ Control-Ë and/oò Control-Ð ió markinç thå texô position® ) - Word and Phrase Example - Thå worä markeò ió á singlå ^KControl-Ë characteò (^K)® Phraseó musô havå botè endó marked¬ anä ^KControl-Ð (^P© ió used® Foò exampleº Thå wordó "Control-K"¬ (iî thå firsô sentence© anä "Control-P"¬ (iî thå seconä sentence© wilì bå iî thå index® ^PThió entirå phraså wilì alsï bå there^P. Sincå thió ió pagå 2 oæ thå WIZDEØ manual¬ thå indeø foò thå previous paragraph will looë like: Control-K..................................... 2 Control-P..................................... 2 Thió entirå phrase will also be there........® 2 .pa Š - Invoking WIZDEX - Theså three exampleó wilì bå included iî thå indeø aô thå enä oæ thió manual¬ iæ WIZDEØ ió envokeä aó follows: A>wizdex wisdex.txt <-- generate an index for WISDEX.TXT Jusô enteò WIZDEØ followeä bù thå filenamå anä filetypå oæ thå texô filå whicè yoõ wanô tï index¬ followeä bù youò keyboarä RETURN key. WIZDEØ firsô scanó youò texô filå foò anù "old¢ indeø anä removeó it¬ jusô iî caså yoõ arå updatinç á previouslù indexeä file® Theî WIZDEØ wilì creatå á temporarù filå oæ typå '.$$$'¬ indeø youò text¬ theî renamå youò originaì filå tï á filå oæ typå '.BAK§ (á "back-up¢ copù oæ youò originaì texô file)¬ anä placå thå newlù indexeä texô filå oî youò diskettå aó á filå typå oæ '.DOC'¬ tï indicatå thaô iô ió no÷ á documenô filå ratheò thaî á texô filå withouô aî index® Yoõ maù oæ courså renamå youò texô filå froí '.BAK§ tï thå originaì filetype¬ oò eraså iô froí youò diskette. Youò newlù createä '.DOC§ filå wilì bå 5%-10¥ largeò thaî thå originaì texô filå (more¬ iæ yoõ havå á heavù hanä witè Control-Ë anä Control-P)® Texô filå sizeó thaô exceeä thå capacitù oæ thå diskettå thaô WIZDEX.COÍ ió on¬ maù bå placeä oî youò 'B§ diskette¬ theî indexeä bù typing: A>b: <-- log on to drive B B>a:wizdex myfile.txt <-- run WIZDEX on 'A', index MYFILE.TXT WIZDEØ doeó noô allo÷ á drivå specifieò foò thå texô filå thaô yoõ wisè tï index..® yoõ specifù thå texô filå namå anä (optional© typå only® Alsï notå thaô WIZDEØ cannoô handlå randoí accesó CP/Í files® .pa Š - WordStar Dot Commands - WIZDEØ ió optimizeä foò uså witè WordStar® Bù default¬ iô scanó thå filå foò "doô commands"» notablù .pa‚ anä "..index"® Iæ thå .pá ió useä tï counô pages¬ iô musô bå thå firsô worä oî thå linå tï bå counteä aó á doô command® Thå "..index¢ commanä ió createä anä useä bù WIZDEX® WIZDEØ useó thió tï marë thå beginninç oæ thå index® Wheî WIZDEØ findó thå "..index¢ line¬ iô removeó alì texô followinç thaô line® Thió stripó awaù thå olä index¬ allowinç á ne÷ indeø tï bå createä foò aî updateä file® Iæ "..index¢ ió noô found¬ iô ió inserteä aô thå toð oæ thå index® Wheî thå filå ió printed¬ WordStaò supresseó anù linå beginninç witè twï dotó (..)¬ sï '..index§ wilì noô appeaò iî á printeä file. CAUTIONº Neveò puô á "..index¢ iî á filå thaô yoõ wanô tï index® Unless¬ oæ course¬ yoõ wanô tï loså alì thå texô followinç thaô line® - Sorting - Aó stateä before¬ thå indeø ió sorteä alphabetically® Thå entirå phraså oò worä ió useä iî sorting¬ althougè caså ió ignored® WIZDEØ sortó iî ASCIÉ orderº Digits¬ quotes¬ parenthesis¬ etc.¬ comå beforå letters. Iæ aî entrù ió strewî throughouô thå text¬ iô ió listeä oî á singlå line¬ followeä bù alì thå pagå numberó oî whicè iô ió found® Unfortunately¬ iæ aî indeø entrù ió oî thå samå pagå morå thaî once¬ thå pagå numbeò ió listeä morå thaî once® Foò example: Thå followinç twï phraseó arå equivalenô (becauså caså ió ignored)¬ sï thå firsô phraså ió listed¬ followeä bù it'ó pagå number¬ then thå pagå numbeò oæ thå seconä phrase. Thió ió thå firsô phrase THIS IS THE FIRST PHrAsE Thå lengtè oæ á worä oò phraså ió alsï important® Thå nexô four exampleó, iî their propeò order, illustrate this principle: This This is Thistle This is what .pa Š - Side Effects and Cautions - Iî general¬ á grouð oæ onå oò morå white-spacå characters (seå below© ió converteä intï á singlå spacå character® Phraseó witè embeddeä spaces wilì havå alì extrá spaceó (morå thaî one© removed® Á phraså maù starô anä enä oî differenô lineó (oò eveî differenô pages)® Leadinç spaces arå removeä froí thå indeø entry. Thå followinç white-spacå characteró arå converteä tï anä treateä aó á singlå ASCIÉ spacå character® Theù alsï marë thå enä oæ á word: CR LF tab comma (,) semicolon (;) colon (:) exclamation-mark (!) Thå firsô characteò oæ á worä oò phraså wilì bå converteä tï uppeò case® Notå thaô á phraså maù consisô oæ á singlå blank® Words¬ however¬ musô contaiî aô leasô onå alphanumeriã character. - WIZDEX Error Messages - Froí timå tï time¬ yoõ maù encounteò thå followinç erroò message: Can'ô opeî - Thå filå thaô yoõ havå nameä foò indexinç doeó noô exist. Can'ô creatå temporarù filå - Usuallù meanó thaô youò diskettå ió full...removå fileó thaô arå noô needed¬ tï makå rooí oî thå diskette. Oops...Nï Filenamå Specified¡ - Yoõ forgoô tï specifù á filenamå and filetype, for WIZDEX to index. WIZDEX is a trademark of Wizard of OsZ (tm) WordStar is a trademark of MicroPro International CP/M is a trademark of Digital Research - WIZDEX Index - ..index