DataMuseum.dk

top - download

    Length: 8064 (0x1f80)
    Types: TextFile
    Names: »COMPARE.DOC«

└─⟦b412bceaa⟧ Bits:30010501 DVBS1.SW2103.rel.1.14-1 SW2103 Release 1.14 RTP3502 Dos Compiler DANOSI PN:798 66072 MASTER BB 930614
    └─⟦this⟧ »COMPARE.DOC« 
└─⟦e2123b2a1⟧ Bits:30010498 DVBS1.SW2103.src.1.8-1 Pascal TOOLS JTAS 1989-04-26 LEIF NIELSEN E.d.
    └─⟦this⟧ »COMPARE.DOC« 

TextFile

.oj off\r
.fo 1989-04-26           COMPARE users guide          Page #\r
\r
\r
\r
\r
\r
\r
\r
\r
\r
\r
\r
\r
\r
\r
\r
                          ├ ¤ ═ л ┴ м E\r
\r
                    \r
\r
                       TexЗ comparisoЬ tooВ \r
\r
                              \r
\r
          \r
                           Userз Guide\r
                               by\r
                          LeiТ Nielsen\r
                          Jydsв Telefon\r
                       Erhvervsafdelingen\r
                        Datanetsektionen\r
\r
.pa\rі1« Introduction\r
\r
COMPAR┼ wilВ examiЬ tw№ texЗ fileз anС sт iТ theщ containз thт Ї
samт information.\r
IТ notг thт differenceз wilВ bт printed.\r
\r
IТ tw№ lineз contaiЬ thт samт "realб informationг buЗ onт oТ thт Ї
lineз havт extrр spaceз addedг theЬ COMPAR┼ wilВ normalщ supresз Ї
thaЗ differenceг unless it iз instructeС otherwise.\r
\r
COMPAR┼ maщ als№ bт instructeС t№ poinЗ ouЗ differencesг bщ placinу Ї
р pointer undeЫ each character whicУ doeз noЗ match« Thiз optioЬ Ї
iз onlщ usefullг iТ thт fileз arт nearlщ alike.\r
\r
COMPAR┼ trieз t№ regaiЬ syncronisationг iТ oЬ oТ thт fileз Ї
contaiЬ somт linesг whicУ arт noЗ pressenЗ oЬ thт otheЫ file« Onт Ї
oТ thт parameterз t№ COMPAR┼ iз thт numbeЫ oТ lineз whicУ musЗ Ї
matchг beforт syncronisatioЬ iз reestablished.\r
  \r
\r
2« Parameters\r
\r
▶02◀COMPARE▶02◀ is called as follows:\r
\r
  COMPARE <text file 1> <text file 2> [<option> ... ]\r
\r
\r
where\r
\r
<text file 1>:   Is the name of the file containing the first\r
                 file to be compared.\r
\r
<text file 2>:   Is the name of the file containing the second\r
                 file to be compared.\r
\r
\r
\r
<Option>:        Is one of the following:  /l: /m: /t: /x:\r
 \r
\r
/▶02◀L▶02◀ines:<integer> \r
                Determins the number of lines which must match\r                before the files are considdered to be like\r                again, after a missmatch has occcured.\r
                Default /l:6\r
               \r
/▶02◀M▶02◀ark:{ on | off }\r
                Mark Unequal Columns, by writing pointers to the \r
                differences in two lines. Only usefull if the files \r
                are almost identical.\r
                Default /m:off\r
               \r
/▶02◀T▶02◀railing:{ on | off }\r
                Ignore trailing blanks.  Trailing blanks are \r                ignored, if this option is set.\r
                Default /t:on    \r
\r
/▶02◀X▶02◀ray:{ on | off }\r
                Produce small test output.\r
                Default /m:off\r
                 \r
\rі\r
3« Restrictions\r
\r
COMPAR┼ useз internaВ linт buffersг anС musЗ seЗ р limiЗ oЬ linт Ї
lengths« IТ р longeЫ linт iз readг р warninу iз givenг buЗ onlщ Ї
thт firsЗ parЗ oТ thт linт iз matched.\r
Currentlщ thт linт lengtУ iз 14░ characters.\r
\r
Aз COMPAR┼ useз thт hea▶f0◀ t№ storт lineз wheЬ syncronizingг therт Ї
iз р chancт thaЗ COMPAR┼ wilВ ruЬ ouЗ oТ storage« IТ thiз Ї
happensг р warninу iз printgedг anС thт prograь iз terminateС aЗ Ї
thaЗ point.\r
\r
\r
4« History\r
\r
Thiз prograь firsЗ appeareС iЬ\r
     PascaВ Newз Б 12г Junт 1978г pagт 2░ ff«\r
Thт authoЫ includeС thт folowinу informationг reprinteС froь thт Ї
letteЫ attacheС t№ thт prograь listning:\r
\r
----------------------------------------------------------------\r
COMPAR┼ Г Comparт tw№ texЗ files anС reporЗ theiЫ differences«\r
\r
CopyrighЗ (CЕ 1977г 197И\r
James F« Miner\r
SociaВ ScienceаResearcУ facilitieз CenteЫ\r
Universitщ oТ аMinnesota\r
\r
GeneraВ permissioЬ t№ makт faiЫ usт iЬ noЬ-profiЗ activitieз oТ Ї
alВ oЫ parЗ oТ thiз materiaВ iз granteС provideС thaЗ thiз noticт Ї
iз given« T№ obtaiЬ permissioЬ foЫ otheЫ useз and/oЫ machinт Ї
readablт copieз writт to:\r
\r
аааааааааThт DirectoЫ\r
аааааааааSociaВ Sciencт ResearcУ Facilities CenteЫ\r
ааааааааа2х BlegeЬ HalВ а                \r
ааааааааа26╣ l9tУ Ave« So.\r
аааааааааUniversitщ oТ Minnesotр\r
аааааааааMinneapolisг Minnesotр а5545х\r
         U S ┴\r
\r
Comparт iз useС t№ displaщ oЬ "Outputб thт differenceзЇ
betweeЬ tw№ similaЫ texts ("Fileaб anС "Fileb")« Notable\r
characteristicз are║\r
\r
Г Comparт is linт oriented« The smallesЗ uniЗ oТ comparisoЬЇ
ааiз thт texЗ line (ignorinу trailinу blanks)« аThт presenЗЇ
ааimplementatioЬ haз р fixeС maximuь line length«\r
\r
Г Bщ manipulatinу р program parameterг thт useЫ caЬ affecЗЇ
ааCompare'з sensitivitщ t№ thт "localityб oТ differences«Ї
ааNorт specificallщ thiз parameterг "Minlinesformatch"«Ї
ааspecifieз thт numbeЫ oТ consecutive lines oЬ each filтЇ
ааwhicУ musЗ matcУ iЬ ordeЫ thaЗ theщ bт considereС asЇ
ааterminatinу thт prioЫ mismatch« аа┴ largт value ofЇ
аа"Minlinesformatchб tendз to producт fever buЗ largeЫЇ
ааmismatcheз thaЬ doeз р smalВ value«  Thт valuт siЭ appearsЇ
ааt№ givт gooС results oЬ pascaВ sourcт files buЗ may bтЇіааinappropriatт foЫ otheЫ applications«\r
\r
ааIТ comparт is t№ bт аuseС aз a generaВ utilitщ programгЇ
аа"Minlinesformatchб shoulС be treateС as a programЇ
ааparameteЫ аoТ somт sort« аIЗ is declareС as a constanЗ hereЇ
ааfoЫ аportability's sake«\r
\r
аГ Comparт employs a simplт backtrackinу searcУ algorithm t№Ї
аааisolatт mismatches from theiЫ surroundig matches« ThisЇ
аааrequires (heapЕ storage roughlщ proportionaВ to thт sizтЇ
аааoТ thт largesЗ mismatchг anС timт roughlщ proportionaВ t№Ї
аааthт squarт oТ thт size oТ thт mismatch foЫ eacУ mismatch«Ї
аааFoЫ this reason iЗ maщ noЗ bт feasiblт t№ usт Comparт oЬЇ
аааfiles vitУ verщ long mismatches«\r
\r
аГ T№ thт besЗ oТ thт author's knowledgeг Comparт utilizeзЇ
аааonlщ features oТ standarС pascal«Ї
----------------------------------------------------------------\r
\r
\r
AnotheЫ authorг WilletЗ KemptoЬ froь Universitщ oТ Californiaг Ї
BeЫkeleyг U.S.A«  publisheС aЬ extensioЬ t№ thт programг iЬ \r
PascaВ Newз #1х SeptembeЫ 197╣ p« 2И ff.\r
Hт includeС thт letteЫ reprinteС here:\r
\r
----------------------------------------------------------------\r
аааDear Jimг\r
\r
YouЫ comparт prograь replaceС р morт primitivт onт writteЬ herт Ї
anС haз beeЬ very helpful« IЗ raЬ withouЗ modificatioЬ oЬ botУ Ї
ouЫ PDл 1▒ (UNIXЕ anС CD├ 640░ systemsг anС witУ minoЫ Ї
modificationз now runз oЬ ouЫ DG ECLIPS┼ AOМ (P4 PascalЕ system.\r
\r
╔ enclosт tw№ mods whicУ ╔ believт arт wortУ makinу t№ thт Ї
distributioЬ version; thesт 1Е pluу р holeг anС 2) makт iЗ morт Ї
usefuВ foЫ datр files« Morт specifically:\r
\r
\r
1Е IТ thт originaВ versioЬ sayз "N№ differences"г yoш cannoЗ Ї
count oЬ thт fileз beinу thт same« They maщ contaiЬ lineз longeЫ Ї
thaЬ Linelength, anС lines arт not checkeС pasЗ thaЗ point« ┴ Ї
checв anС warninу arт addeС in thт encloseС version.\r
\r
\r
2Е Thт originaВ outpuЗ displaщ waз finт foЫ prograь sourcт files« Ї
buЗ verщ pooЫ foЫ fixeС formaЗ datр fileз (whicУ presumablщ Ї
abounС iЬ р SociaВ Sciencт ResearcУ Facilitieз Center)« Thт Ї
modifieС versioЬ pairз mismatcheС lineз anС pointз ouЗ Ї
differenceз witУ aЬ arrowг IЗ Onlщ doeз thiз iТ thт mismatchinу Ї
sectionз arт thт samт numbeЫ oТ lineз (usuallщ oneЕ oЬ eacУ file« Ї
Thт outpuЗ waз als№ madт р littlт morт compactг despitт thт facЗ Ї
thaЗ iЗ noэ containз morт information« Thiз maщ seeь like a frilВ Ї
if yoш haven'З haС t№ worв witУ lonу datр files, buЗ iЗ saveз Ї
considerable timт anС keepз ouЫ coderз froь going blind« IЗ doeз Ї
noЗ seem particularlщ usefuВ foЫ sourcт prograь files, anС caЬ bт Ї
turneС ofТ bщ seteinу р constanЗ FALSE.\r
\r
T№ facilitatт inspectioЬ oТ thesт modsг I enclosт ouЫ completт Ї
modifieС versionг anС outpuЗ COMPAREinу thт versioЬ publisheС iЬ ЇіPASCA╠ NEWS (filт aЕ vitУ ouЫ versioЬ (filт bЕ« T№ seт itз usт Ї
oЬ datр files, ╔ als№ enclosт outpuЗ froь onт oТ ouЫ Ї
applicationз« Together, these modз increasт thт lengtУ oТ the Ї
source program abouЗ 15%г anС seem t№ havт n№ appreciablт effecЗ Ї
oЬ executioЬ time.\r
\r
Thank yoш foЫ makinу thiз softwarт available t№ the pascaВ useЫ Ї
community« ╔ hopт yoш finС thт encloseС material oТ use.\r
----------------------------------------------------------------\r
\r
\r
Hanз J▶1b◀Џ▶1c◀rgeЬ JakobseЬ е JTAМ Е retypedт thт prograь (includinу thт Ї
addition)г anС modifyeС thт prograь t№ usт BorlanС TURB¤ Pascal« Ї
Hт als№ includeС р betteЫ parameteЫ processingг whicУ waз finalщ Ї
improveС bщ LeiТ Nielsenг JTAS.\r
\r
«eof»