home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Amiga Shareware Floppies / ma40.dms / ma40.adf / FileComparer / FileComparer.doc < prev    next >
Text File  |  1995-08-02  |  7KB  |  120 lines
  1.  
  2.                              File Comparer v. 1.0
  3.  
  4.                          Bartosz Îepecki, lipiec 1995
  5.                           Wszelkie prawa zastrzeûone
  6.  
  7.                                   SHAREWARE
  8.  
  9.                               Instrukcja obsîugi
  10.  
  11.  
  12. KILKA SÎÓW O SHAREWARE
  13.  
  14.     Ten  program jest rozprowadzany jako shareware.  Oznacza to, ûe masz prawo
  15. nieodpîatnego  uûywania  go przez okres tygodnia, choê jest na tyle prosty, ûe
  16. bëdziesz  wiedziaî  o  nim  wszystko  juû  pierwszego  dnia.   Moûesz go takûe
  17. rozpowszechniaê,   ale   tylko   wtedy,  gdy  zaîâczysz  do   niego  niniejszâ
  18. dokumentacjë. Po  upîywie  tygodnia  musisz  zdecydowaê, czy Ci on odpowiada i
  19. bëdziesz  z  niego  korzystaî.   Jeôli tak, wyôlij proszë 5 nowych zî lub 3 DM
  20. jako wynagrodzenie dla autora na adres:
  21.  
  22.              Bartosz Îepecki
  23.              ul.Piaskowa 2/45
  24.              21-500 Biaîa Podlaska
  25.              tel. 44-19-04
  26.     Jeôli  jednak uznasz, ûe nie speînia on Twoich oczekiwaï lub nie jest wart
  27. swej  ceny,  powinieneô go niezwîocznie skasowaê.  Pamiëtaj, ûe idea shareware
  28. udostëpnia Ci  ten program po to, byô mógî sië z nim zapoznaê i liczy na Twojâ
  29. uczciwoôê.   Oczywiôcie nie sposób sprawowaê nad tym kontroli, dlatego jedynym
  30. kontrolerem  bëdzie  Twoja  uczciwoôê  i sumienie.  Poza tym ta niewielka suma
  31. pieniëdzy bëdzie wyrazem tego, ûe doceniasz trud programisty, oraz bodúcem dla
  32. autora do tworzenia nowych, lepszych programów.
  33.  
  34.  
  35. INFORMACJA O PROGRAMIE
  36.  
  37.     File  Comparer  powstaî  w  jëzyku Amos Professional na komputerze A1200 z
  38. twardym  dyskiem.  Ma bardzo prostâ oprawë graficznâ, co naturalnie nie wpîywa
  39. negatywnie  na jego dziaîanie.  Wymaga biblioteki amos.library.  Jeôli jej nie
  40. posiadasz, skorzystaj z zaîâczonej wersji 1.1, która jej nie wymaga (i dlatego
  41. jest  dwa  razy  dîuûsza).   Program  by  oczywiôcie  testowany,  jednak jeôli
  42. znajdziesz  w  nim  jakiô  bîâd  lub  masz  inne uwagi, napisz na adres podany
  43. powyûej.   Jeôli  oczekujesz  odpowiedzi,  nie  zapomnij  o opîaconej kopercie
  44. zwrotnej.
  45.  
  46.  
  47.  
  48.  
  49. OPIS DZIAÎANIA
  50.  
  51.     Gîównym  zadaniem  programu  File  Comparer jest porównanie dwóch plików o
  52. jednakowej  dîugoôci.   Jeûeli  oba pliki sâ takie same, program poinformuje o
  53. tym  uûytkownika, w przeciwnym razie wygeneruje raport, zawierajâcy informacje
  54. o  wszystkich  róûnicach.   Zadaniem uûytkownika jest wybranie dwóch plików do
  55. porównania  i trzeciego do zapisu raportu.Ten ostatni jest ustawiony domyôlnie
  56. na  RAM:raport.   Dane  sâ  do  niego sukcesywnie zapisywane, a po zakoïczeniu
  57. operacji  porównania  plik  jest  wyôwietlany  na  ekranie za pomocâ Amos Text
  58. Readera.   Moûliwa  jest zmiana nazwy i ôcieûki dostëpu pliku z raportem, lecz
  59. najlepiej,  by  byî  on  zapisany  do  RAM-u z uwagi na przewagë szybkoôci tej
  60. pamiëci nad innymi rodzajami pamiëci masowej.
  61.    Sama  operacja  porównania  odbywa  sië  z  wykorzystaniem póîkilobajtowego
  62. bufora.   Stopieï  zaawansowania  procesu  ilustruje poziomy, niebieski pasek,
  63. stopniowo wydîuûajâcy sië w prawo.  Dziaîanie programu moûna przerwa wciskajâc
  64. Control i  C.Naleûy  wspomnieê, ûe porównywane pliki nie powinny znajdowaê sië
  65. na  róûnych  dyskietkach, poniewaû  dane sâ  z  nich czytane na zmianë (po póî
  66. kilobajta).  Dla wiëkszej wygody jeden z nich lub oba moûna przegraê do RAM-u,
  67. co  przyspieszy  operacjë. Jeôli  zachodzi  koniecznoôê  porównania plików tak
  68. dîugich, ûe  nie  jest  moûliwe  umieszczenie  ich  na  jednej  dyskietce bâdú
  69. przeniesienie jednego  z nich do Ram Dysku, pozostaje skorzystaê z uprzejmoôci
  70. kolegi,  posiadajâcego dysk  twardy.  File Comparer w zamyôle autora ma sîuûyê
  71. do  uîatwienia  ûycia  wîamywaczom do gier, które zapisujâ stan gry w systemie
  72. DOS  w postaci plików o zawsze takiej samej dîugoôci (np.  Ishar 3).  Wîamanie
  73. do takiej  gry  polega  na  zapisaniu stanu gry, dokonaniu jakiejô zmiany (np.
  74. zakupu  lub straty energii) i ponownemu zapisaniu stanu gry do drugiego pliku.
  75. Wówczas  pozostaje tylko porównanie zawartoôci obu zapisów, by dowiedzieê sië,
  76. w  którym  miejscu sâ zapisane interesujâce nas wartoôci, takie jak wspomniana
  77. energia  czy  stan funduszy.  Nikomu nie ûyczë porównywania kilkukilobajtowych
  78. plików "na piechotë".  Ze wzglëdu na przeznaczenie program przerywa pracë, gdy
  79. liczba bajtów róûniâcych oba pliki przekroczy tysiâc.
  80.     File  Comparer  zapisuje  swój  raport  w  postaci  tabelki,  moûliwej  do
  81. odczytania przy pomocy dowolnego edytora tekstu.  Kaûda linia tabelki to jeden
  82. znak-róûnica,  opisany  na kilka sposobów w poszczególnych kolumnach.  Kolejne
  83. kolumny  tabelki  to:   liczba  porzâdkowa,  informujâca nas o liczbie znaków,
  84. róûniâcych  badane  pliki,  offset,  czyli przesuniëcie znaku, którego dotyczy
  85. linia,  wzglëdem poczâtku pliku, oraz sam bajt w obu plikach, przedstawiony na
  86. trzy  sposoby:  jako kod ASCII szesnastkowo (HEX), kod ASCII dziesiëtnie (DEC)
  87. i  jako znak na ekranie (TXT).  Jeôli znaku o tym kodzie nie da sië pokazaê na
  88. ekranie,  zamiast  niego  wyôwietlana  jest kropka.  Na szczycie pliku, oprócz
  89. symbolicznych  nazw  kolumn tabeli, znajdujâ sië takûe nazwy i ôcieûki dostëpu
  90. porównywanych  plików  i przyporzâdkowane im kody literowe (A i B), co pozwala
  91. na odrobinë lepszâ orientacjë w tabeli. Przesuw w pionie umoûliwia widoczny po
  92. prawej stronie czerwony suwak.
  93.     Program  obsîuguje teû niektóre bîëdy, jakie mogâ sië pojawiê podczas jego
  94. pracy.   W  przypadku  wystâpienia  bîëdu  odczytu, zîej walidacji dysku (dysk
  95. nieuaktualniony),   zabezpieczenia   pliku  przed  odczytem  lub  zapisem  czy
  96. skasowaniem  (plik  z  raportem) zostanie wyôwietlona odpowiednia informacja i
  97. program poprosi o wybór nowych plików (jednego - w dwóch ostatnich przypadkach
  98. lub  wszystkich).   Jeôli  skoïczy  sië  miejsce w urzâdzeniu, na które bëdzie
  99. zapisywany raport, uûytkownik zostanie poproszony o wybranie nowej lokacji, do
  100. której  plik z raportem zostanie przeniesiony.  Stary plik zostanie skasowany,
  101. a  operacja  bëdzie  kontynuowana. Jeôli plik jest zabezpieczony przed zapisem
  102. lub  odczytem,  moûna  przejôê  do  Workbencha poprzez naciôniëcie Control-A i
  103. wykorzystujâc  multitasking  zmieniê  bity protekcji w danym pliku przy pomocy
  104. opcji  Informacje  z  menu  Ikony  Workbencha  lub posîuûyê sië programem typu
  105. DiskMaster,  FileMaster  czy  DirectoryOpus,  po  czym  powróciê  do  programu
  106. (równieû Control-A).
  107.     Mimo,  iû  File  Comparer  zostaî  przeznaczony  do  porównania  plików  o
  108. jednakowej  dîugoôci,  speînienie  tego  warunku  nie  jest konieczne dla jego
  109. poprawnego  dziaîania.   Jeôli  badane  pliki bëdâ róûniîy sië dîugoôciâ, przy
  110. porównaniu  program  weúmie  pod  uwagë tylko të czëôê dîuûszego pliku, której
  111. dîugoôê  jest równa dîugoôci krótszego pliku.  Innymi sîowy, program porównuje
  112. pliki  dotâd,  aû  któryô  z  nich  sië  nie  skoïczy.
  113.  
  114.  
  115. Ûyczë przyjemnej pracy i wielu udanych "wîamów"
  116.  
  117.                         - Bartosz Îepecki
  118.  
  119.  
  120.