CP/M/CPM_CDROM.iso/enterprs/cpm/utils/f/replace.ark/REPLACE.DOC

Text File | 1987-01-20 | 8.0 KB | 197 lines

                                  REPLAC┼ V1.▒


             REPLAC┼ i≤ ß prograφ designeΣ t∩ cop∙ ß file¼ anΣ a≤ i⌠ doe≤ ì
        so¼á t∩ replacσ certaiε set≤ oµ character≤ (calleΣ KE┘ STRING╙ o≥ ì
        KEYS⌐ witΦ othe≥ sucΦ sets« Ke∙ string≤ ma∙ bσ specifieΣ froφ thσ ì
        compute≥ keyboard¼ o≥ froφ ß previousl∙ createΣ disδ file.

        OPERATION:

             Typσ REPLAC┼ anΣ hi⌠ ß carriagσ return« Yo⌡ wil∞ bσ askeΣ t∩ ì
        specif∙á thσ filσ iε whicΦ thσ replacement≤ arσ t∩ bσá madσá (thσ ì
        INPU╘á file)¼á anΣá thσ filσ t∩ receivσ thσ change≤á (thσá OUTPU╘ ì
        file)«á Yo⌡á wil∞á theεá bσ askeΣ ho≈ thσ key≤ arσ t∩á bσá input¼ ì
        eithe≥á froφá thσ keyboard¼á o≥ froφ ß file«á Iµ yo⌡á choosσá thσ ì
        keyboarΣá optioεá yo⌡ wil∞ bσ prompteΣ fo≥ key≤ t∩ bσá founΣá anΣ ì
        wha⌠á the∙ arσ t∩ bσ replaceΣ with«á Wheε yo⌡ wan⌠ t∩á star⌠á thσ ì
        replacemen⌠ process¼ jus⌠ hi⌠ ß carriagσ returε wheε prompteΣ fo≥ ì
        thσ nex⌠ ke∙ t∩ bσ found«á Iµ thσ filσ optioε i≤ chosen¼ yo⌡ wil∞ ì
        bσá askeΣá fo≥ thσ namσ oµ thσ filσ tha⌠ contain≤ thσ key≤ t∩á bσ ì
        founΣá anΣá replaceΣá (ho≈ t∩ preparσ sucΦ ßá filσá i≤á discusseΣ ì
        below)«á Thσ prograφ wil∞ theε reaΣ iε thσ keys¼á displa∙ theφ oε ì
        thσ screen¼ anΣ automaticall∙ star⌠ thσ replacemen⌠ process«

        SPECIFYIN╟ KEYS:

             Simplσ alpha-numeriπ key≤ arσ formeΣ b∙ simpl∙ typinτ iε thσ ì
        letter≤ o≥ number≤ yo⌡ wisΦ t∩ finΣ anΣ replace« Space≤ anΣ othe≥ ì
        character≤á tha⌠á appea≥ oε thσ keyboarΣ ma∙ als∩ bσá entereΣá iε ì
        thi≤ fashion¼ witΦ thσ exceptioε oµ thσ characte≥ ^.

             ▐ ma∙ bσ useΣ t∩ ente≥ character≤ tha⌠ d∩ no⌠ appea≥ oεá thσ ì
        keyboard¼á sucΦá a≤á contro∞ character≤ anΣ carriagσá returεá anΣ ì
        line-feeΣ characters« It≤ usσ ma∙ takσ fou≥ forms.

        The∙ are:

        1⌐ ^▐ - represent≤ ß singlσ ▐ iε thσ ke∙ string.

        2⌐áá ^┴á  - wherσá ┴á i≤á an∙á lette≥á A-Z«áá I⌠á represent≤á thσ ì
        correspondinτ control-characte≥ iε thσ ke∙ string.

        3⌐á ^(###⌐á - wherσá ##ú i≤ ß ▒ t∩ │á digi⌠á decima∞á number«á I⌠ ì
        represent≤ characte≥ numbe≥ ##ú oµ thσ ASCI╔ sequencσ iε thσá ke∙ ì
        string.

        4⌐á ^(##H⌐á - wherσ #ú i≤ ß ▒ o≥ ▓ digi⌠ hexadecima∞á number«á I⌠ ì
        represent≤ characte≥ numbe≥ ##╚ oµ thσ ASCI╔ sequencσ iε thσá ke∙ ì
        string.

        Usinτá thesσ form≤ al∞ ASCI╔ character≤ 0-25╡ ma∙ bσá representeΣ ì
        iε eithe≥ thσ FIN─ o≥ REPLAC┼ keys.

             Thσá forma⌠ oµ key≤ i≤ thσ same¼á regardles≤ oµ whethe≥ the∙ ì
        arσ entereΣ froφ thσ keyboarΣ o≥ froφ ß file.
è

                                        1









        PREPARIN╟ ┴ FIL┼ CONTAININ╟ KEYS

             ┴ filσ containinτ key≤ ma∙ bσ prepareΣ oε an∙ worΣ processo≥ ì
        o≥á edito≥ tha⌠ use≤ ASCI╔ file≤ (WordSta≥ shoulΣ bσ useΣ iεá thσ ì
        Non-Documen⌠ mode)«á Thσ filσ shoulΣ contaiε pair≤ oµá lines«á Oε ì
        thσá firs⌠ linσ shoulΣ bσ thσ strinτ yo⌡ wan⌠ t∩ FIN─ anΣ oεá thσ ì
        seconΣá linσá shoulΣ bσ thσ strinτ yo⌡ wan⌠ t∩ REPLAC┼á i⌠á with« ì
        Pair≤á oµ ke∙ string≤ shoulΣ bσ separateΣ b∙ onσ blanδ line«á Ke∙ ì
        string≤á ma∙á bσ u≡ t∩ 8░ iε lengtΦ anΣ therσ i≤ ßá limi⌠á oµá 3░ ì
        pair≤ allowed.

        USIN╟ OPTIONS

             Tw∩á option≤ arσ provideΣ t∩ aiΣ iε thσ usσ oµ thσá program« ì
        BotΦá appl∙á onl∙ t∩ thσ findinτ oµ matche≤ betweeε thσ finΣá ke∙ ì
        anΣ thσ sourcσ text« The∙ d∩ no⌠ appl∙ t∩ thσ replacσ key«

             Thσ firs⌠ optioε i≤ t∩ ignorσ thσ parity-bit≤ iε thσá sourcσ ì
        file« Somσ background║ therσ arσ eigh⌠ bit≤ useΣ t∩ describσ  thσ ì
        25╢ differen⌠ character≤ iε thσ ASCI╔ character-set«á Onl∙ ╖ bit≤ ì
        arσ needeΣ t∩ specif∙ al∞ oµ thσ character≤ oε thσ keyboard¼ plu≤ ì
        thσá contro∞ characters«á Thσ eightΦ bi⌠ (herσ calleΣ thσ parity-ì
        bit⌐á i≤á no⌠ normall∙á used«á However¼á somσá programs¼á notabl∙ ì
        WordStar¼á usσá thi≤á eightΦá bi⌠ t∩ marδ thσ enΣá oµá word≤á anΣ ì
        differentiatσá betweeε "softó anΣ "hardóá carriagσá returns«á Thσ ì
        defaul⌠á fo≥á thσá prograφá i≤ t∩ ignorσá thi≤á eightΦá bit«á Fo≥ ì
        instance¼á thσá lette≥á "Eóá wil∞ matcΦ u≡á witΦá botΦá characte≥ ì
        number≤ 6╣ anΣ 19╢ (=127+69⌐ (decimal⌐ iε thσ ASCI╔ sequence«á Iµ ì
        thi≤ optioε i≤ turneΣ off¼á "Eó woulΣ onl∙ matcΦ characte≥ numbe≥ ì
        69«á Thi≤ optioε doe≤ no⌠ affec⌠ matche≤ wherσ thσ eightΦ bi⌠ ha≤ ì
        beeε se⌠ iε thσ finΣ key«á ^(196⌐ matche≤ onl∙ characte≥ 196¼á n∩ ì
        matte≥ whicΦ optioε i≤ selected.

             Thσ seconΣ optioε direct≤ thσ prograφ t∩ ignorσá difference≤ ì
        iεá casσ wheε searchinτ fo≥ thσ occurrencσ oµ ß ke∙ iε thσ sourcσ ì
        file«á  Fo≥ instance¼á iµ thi≤ optioε i≤ selecteΣ "Eó wil∞á matcΦ ì
        botΦ "Eó anΣ "e"«á Iµ thi≤ optioε i≤ no⌠ selected¼á i⌠ wil∞ matcΦ ì
        onl∙ "E"« Thσ defaul⌠ settinτ fo≥ thσ prograφ i≤ t∩ pa∙ attentioε ì
        t∩ difference≤ iε case.

        LIMITATIONS:

        1⌐á Thσ prograφ ma∙ ruε ou⌠ oµ memor∙ spacσ iµ thσ ke∙ string≤ t∩ ì
        bσá replaceΣ arσ mucΦ large≥ thaε thσ key≤ t∩ bσ founΣ anΣá occu≥ ì
        frequently«á Iµ thi≤ occurs¼ thσ prograφ wil∞ terminatσ witΦ run-ì
        timσ erro≥ FF« T∩ ge⌠ arounΣ thi≤ problem¼ usσ fewe≥ set≤ oµ key≤ ì
        a⌠ onσ time¼ o≥ makσ thσ replacσ key≤ shorter.

        2⌐á Iµá therσ i≤ no⌠ rooφ oε thσ disδ fo≥ thσá outpu⌠á file¼á I/╧ ì
        error≤ F░ o≥ F▒ ma∙ occu≥ anΣ causσ prograφ termination«

        3⌐á Thσ onl∙ characte≥ tha⌠ wil∞ no⌠ worδ a≤ ß finΣ ke∙á iεá thi≤ ì
        prograφá i≤ ^┌ (control-Z¼á ASCI╔ 2╢ o≥ 1AH⌐ whicΦ i≤ useΣ a≤á aε ì
        end-of-filσ marker.
è

                                        2









        4⌐ Thσ prograφ i≤ designeΣ fo≥ mas≤ replacing«á I⌠ doe≤ no⌠ quer∙ ì
        t∩á bσá surσ tha⌠ i⌠ onl∙ replace≤ wha⌠ yo⌡ wan⌠á replaced«á Makσ ì
        surσá tha⌠ you≥ key≤ t∩ bσ founΣ anΣ replaceΣ arσá uniquσá enougΦ ì
        tha⌠ onl∙ thσ correc⌠ substitution≤ arσ made.

        EXAMPLE

        Iε Sourcσ filσ ║ Thi≤ i≤ aε exameplσ oµ somσ Tex

            FinΣ Ke∙ ▒ ║ Tex

         Replacσ Ke∙ ▒ ║ TEXT

            FinΣ Ke∙ ▓ ║ me

         Replacσ Ke∙ ▓ ║ φ

        Iε Outpu⌠ filσ ║ Thi≤ i≤ aε examplσ oµ soφ TEXT

        Notσá tha⌠ thσ los≤ oµ thσ lette≥ "eó froφ thσ worΣ "someóá woulΣ ì
        no⌠ havσ occurreΣ iµ wσ haΣ useΣ thσ finΣ ke∙ "ameó (witΦ replacσ ì
        ke∙ "amó insteaΣ oµ jus⌠ "m").

        5⌐ Replace≤ arσ donσ sequentially¼ iε thσ orde≥ iε whicΦ the∙ arσ ì
        entered«á Thi≤ mean≤ tha⌠ iµ  ß replacσ ke∙ (o≥ ß portioε of⌐á i≤ ì
        useΣá late≥ a≤ ß finΣ key¼á tha⌠ replacσ ke∙ (o≥ portioε of⌐ wil∞ ì
        bσ itselµ replaced.


        POTENTIA╠ USES

        1⌐á T∩á savσá keystroke≤á wheεá writing«á Usσá abbreviation≤á fo≥ ì
        frequentl∙ useΣ word≤ o≥ phrases«á  Se⌠ u≡ ß filσ containinτá thσ ì
        abbreviation≤á a≤á thσ finΣ key≤ anΣ thσ word≤ o≥ phrase≤ a≤á thσ ì
        replacσ keys.

        2⌐á T∩á rapidl∙ inser⌠ prin⌠ control≤ whilσá usinτá WordStar«á Iµ ì
        therσ i≤ ß worΣ o≥ phrasσ tha⌠ need≤ t∩ bσ alway≤ underlineΣ (fo≥ ì
        examplσ ║ e⌠ al.⌐ usσ thσ worΣ a≤ ß finΣ ke∙ (e⌠ al.⌐ anΣ fo≥ thσ ì
        replacσ key¼á usσ thσ worΣ plu≤ thσ requireΣ prin⌠ control≤ (^Se⌠ ì
        al^S.)«

        3⌐á T∩á conver⌠á file≤á froφ othe≥á word-processinτá program≤á t∩ ì
        WordStar«á FinΣ ^═ anΣ replacσ i⌠ witΦ ^(140⌐ t∩ conver⌠ al∞á thσ ì
        harΣ carriagσ return≤ t∩ sof⌠ ones.


        WordSta≥ i≤ ß trademarδ oµ MicroPr∩ Internationa∞ Corp.

        Thσ REPLAC┼ prograφ i≤ freσ fo≥ publiπ distribution¼á bu⌠ ma∙ no⌠ ì
        bσ solΣ withou⌠ thσ writteε authorizatioε oµ Johε Porter.

        Copyrigh⌠ (c⌐ 198╡ b∙ Johε Porter



                                        3