                             Kormoran 1.2
                             ------------
                          autor: K.A.Ziembik
                           (c)ROHAR 1995-97
                           program Freeware



1. Co to jest?
   -----------

     Kormoran  to  prosty  konwerter,  ktry  potrafi  zamieni  tekst 
napisany  w  standarcie ATASCII (stosowanym na Atari XL/XE)  na  ASCII 
(uywane  na Atari ST/STE) i oczywicie  odwrotnie.  Program  dokonuje 
przy tym konwersji polskich znakw, co pozytywnie odrnia go od wielu 
zachodnich programw tego typu.  Wymagania programu to ST/STE z 0.5 MB 
pamici RAM.
     Kormoran  jest  programem FREEWARE - mona  kopiowa  go  dowoln 
ilo razy,  przekazywa kademu,  rozpowszechnia wszdzie, gdzie si 
da,  a  take  uywa  jak  i kiedy  si  chce,  ale  zabroniona  jest 
jakakolwiek interwencja w kod programu i dokumentacj bez zgody  grupy 
ROHAR.



2. Z czego si skada?
   -------------------

     W wersji 1.2 program Kormoran skada si z dwch plikw zawartych 
w kartotece KORMORAN.1_2:

     KORMORAN.PRG - uruchamialny program, 
     KORMORAN.TXT - dokument, ktry czytasz.

     Do  prawidowego dziaania programu potrzebna jest  te  nakadka 
udostpniajca  polskie  znaki  narodowe w standarcie  Klubu  ST  (np. 
MacroFont,  Mikoaj Rej,  PRO Polonica,  Polonus,  Polskie  znaki).  W 
ostatecznoci mona si bez niej oby, ale opcje i komunikaty programu 
mog si sta nieczytelne.



3. Opis programu
   -------------

     Kormoran  nie  jest skomplikowany w  uyciu,  poniewa  wszystkie 
opcje programu dostpne s z rozwijanego menu:

Atari
-----
     Kormoran  - najwaniejsze informacje o programie.

Plik
----
     Odczyt    - odczyt tekstu w wybranym formacie,  a nastpnie  jego 
                 automatyczna konwersja,  sygnalizowana paskami na ek- 
                 ranie. Tekst moe mie najwyej  64 kilobajtw (ogra- 
                 niczylimy  bufor do takiej  pojemnoci  ze  wzgldw 
                 praktycznych).
     Zapis     - zapis tekstu w wybranym formacie.  Opcja jest  nieak- 
                 tywna jeli w pamici nie ma tekstu.
    Informacje - informacje o tekcie znajdujcym si w pamici,  po- 
                 dana jest dugo w formacie ATASCII (dla XL/XE) oraz 
                 ASCII (dla ST/STE).
     Wolne  KB - pokazuje  ilo wolnej pamici RAM i wolnego  miejsca 
                 na aktualnie uywanym dysku.
     Dugo   - pokazanie dugoci wybranego pliku w bajtach.
     Kasowanie - kasowanie wybranego pliku.
     Wyjcie   - wyjcie z programu.

Parametry
---------
-Rodzaj pliku-
     Tekst XL/XE    \ wybr formatu pliku dla 
     Tekst ST/STE   / operacji odczytu i zapisu.
-Maska-
     Przezroczysta  \ wybr rodzaju maski dla 
     Ostatnio uyta / operacji dyskowych.

     Aby wszystko byo do koca jasne,  krtki algorytm,  jak postpo- 
wa, eby przekonwertowa tekst w jednym formacie (np. XL/XE) na drugi 
(w tym przypadku ST/STE):
     - ustawi "Tekst XL/XE" w "Parametry",
     - wczyta wybrany plik opcj "Odczyt",
     - ustawi opcj "Tekst ST/STE" w "Format",
     - zapisa tekst pod wybran nazw opcj "Zapis".
Analogicznie naley postpowa w przypadku zamiany w drug stron.
     Uwaga techniczna do Kormorana jest jedna:  nie prbuj konwertowa 
plikw  nie  bdcych tekstem,  poniewa z niewyjanionych  jak  dotd 
powodw,  program w takiej sytacji reaguje "bombami".  Kolejna wersja, 
miejmy nadziej, bdzie pozbawiona tej wady.
     Na   koniec  opisu  programu  kilka  sw  naley  powiedzie   o 
zastosowanej  konwersji.  Bez adnych zmian przenoszone s  podstawowe 
kody  z  zakresu  32-95  (due litery  alfabetu  aciskiego  i  znaki 
matematyczne) oraz 97-122 (mae litery), a take kod 27 i 124, wsplne 
dla ATASCII i ASCII ST. Polskie znaki dla ST/STE s w standarcie Klubu 
ST,  a  wic w kodach 193-201 (due litery) i 209-217  (mae),  a  dla 
XL/XE     w    kodach    17,22,18,123,13,16,4,9,24     (due)     oraz 
1,3,5,12,14,15,19,11,26 (mae).  Ze znakw specjalnych, majcych wpyw 
na wydruk,  konwertowany jest:  Return,  kursor w gr,  kursor w d, 
kursor w lewo,  kursor w prawo,  kasowanie ekranu,  kasowanie wiersza, 
wstawianie wiersza.



4. Podzikowania
   -------------

     Do powstania Kormorana przyczyniy si nastpujce osoby,  ktrym 
grupa ROHAR chciaaby podzikowa:
     - Mr.Q i ZBX Virus z grupy  Pentagram  (kilka niezbdnych  infor- 
       macji o maym Atari),
     - Marcin Bielenin (naprawa twardziela),
     - Witek Warczak (wymiana stacji dyskw).



5. Korespondencja
   --------------

     Wszelk  korespondencj  dotyczc  naszych  programw,   pytania 
dotyczce ich dziaania, informacje o wykrytych bdach, sugestie, jak 
je ulepszy oraz pytania o najnowsz ofert ROHAR-u naley kierowa na 
jeden z poniszych adresw:

     KAZ
     ---
     ul. Wojrowicka 46/26
     54-436 Wrocaw
     e-mail: kziembik@wroc.net

     Zyga
     ----
     Doboszowice 52
     57-241 Doboszowice
     woj. wabrzyskie
     e-mail: bak@mvax.pwr.wroc.pl

     Pamitaj  jednak  o tym,  by do listu  doczy  zaadresowan  do 
siebie  kopert  i  wany  znaczek.  Tylko  wtedy  moemy  gwarantowa 
odpowied.  Jeli  chcesz otrzyma najnowsz wersj jakiego  programu 
musisz do koperty i znaczka doda dyskietk (3.5 cala jeli ma to  by 
dla ST/STE, a 5.25 cala gdy dla XL/XE).

     Miego korzystania z programu.

     Ostatnia zmiana w dokumencie: roda, 3 wrzenia 1997 r.
