home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Amiga Shareware Floppies / ma36.dms / ma36.adf / PCC / PCC1.2.doc < prev    next >
Text File  |  1995-05-17  |  8KB  |  272 lines
  1.                         ____     ______   ______
  2.                        / __ \   / ____/\ / ____/\
  3.                       / /_/ /\ / /\___\// /\___\/
  4.                      / ____/ // / /    / / /
  5.                     / /\___\// /_/_   / /_/_
  6.                    /_/ /    /_____/\ /_____/\
  7.                    \_\/     \_____\/ \_____\/
  8.  
  9.                 Polish Characters Converter v1.1
  10.                     Konwerter polskich znaków
  11.  
  12.  
  13.                   (c)1994-VI-2 by Rafaî Mantiuk
  14.  
  15.                           Public Domain
  16.  
  17.  
  18.  
  19.                               Menu
  20.  
  21.         1.  Rozpowszechnianie
  22.         2.  Zastosowanie
  23.         3.  Uruchomienie
  24.         4.  Obsîuga
  25.         5.  Menu
  26.         6.  Preferencje
  27.         7.  Okno informacyjne
  28.         8.  Arexx
  29.         9.  PolCharsSets
  30.         10. AppWindow
  31.         11. Kontakt
  32.         12. Wersja
  33.  
  34.  
  35. 1.  Rozpowszechnianie
  36.     ~~~~~~~~~~~~~~~~~
  37.  
  38. Program  jest  Public  Domain.  Moûna go rozprowadzaê bez ûadnych
  39. przeszkód,  lecz  tylko  w  peînej  wersji,  wraz z nastëpujâcymi
  40. zbiorami:
  41.  
  42.             PCC
  43.             PCC.info
  44.             PolCharsSets
  45.             PolCharsSets.info
  46.             PCC.doc
  47.             PCC.doc.info
  48.  
  49.  
  50. 2.  Zastosowanie
  51.     ~~~~~~~~~~~~
  52.  
  53. Program  sîuûy  do  zmiany  standardu  polskich znaków w zbiorach
  54. tesktowych.  Podstawowe jego zalety to:
  55.  
  56. -  moûliwoôê swobodnej rozbudowy programu o nowe standardy
  57. polskich znaków
  58. -  samoczynne rozpoznawanie standardu polskich znaków pliku
  59. wejôciowego
  60. -  AREXX
  61. -  clipboard (schowek)
  62. -  moûliwoôê odczytu zbiorów komresowanych PowerPacker'em lub XPK
  63. -  moûliwoôê zapisu zbiorów komresowanych PowerPacker'em lub XPK
  64. -  AppWindow
  65. -  tworzenie ikon
  66. -  moûliwoôê konwertowania kilku zbiorów jednoczeônie (v1.1)
  67.  
  68.  
  69.  
  70. 3.  Uruchomienie
  71.     ~~~~~~~~~~~~
  72.  
  73. Program  moûna  uruchomiê  zarówno  z CLI jak i WorkBench'a.  Aby
  74. program  mógî  sië  uruchomiê  niezbëdne sâ nastëpujâce zbiory (w
  75. nawiasach podane w jakim katalogu powinny sië znajdowaê) :
  76.  
  77. kickstart 1.3        Asl13.library        (LIBS:)
  78. kickstart 1.3        GadTools13.library    (LIBS:)
  79. kickstart 2.0 +        Asl.library        (LIBS:)
  80.             PolCharsSets        (S: lub w
  81.                         katalogu w którym
  82.                         znajduje sië PCC)
  83.             PolCharsSets.info    jak wyûej
  84.  
  85. Obecnoôê poniûszych zbiorów nie jest konieczna, lecz jest zalecana.
  86.  
  87.             XpkMaster.library    (LIBS:)
  88.             Compressors/#?        (LIBS:)
  89.             powerpacker.library    (LIBS:)
  90.             clipboard.device    (DEVS:)
  91.             rexxsyslib.library    (LIBS:)
  92.             RexxMast
  93.  
  94.  
  95. 4.  Obsîuga
  96.     ~~~~~~~
  97.  
  98. Przed przystâpieniem do konwersji naleûy wybraê standard docelowy.
  99. Nastëpnie wczytaê zbiór (przenoszâc jego ikonë do okna programu
  100. (ks2.0>), lub przy pomocy gadûetu/menu "Wczytaj"). Jednoczeônie
  101. moûna wczytaê kilka zbiorów (zaznaczajâc je z naciôniëtym klawiszem
  102. SHIFT). Trzeba przy tym zaznaczyê katalog w którym zbiory zostanâ
  103. zapisane. Jeûeli zaznaczyliômy jeden zbiór to musimy go samemu
  104. zapisaê (gadûet/menu "Zapisz").
  105.  
  106.  
  107.  
  108. 5.  Menu
  109.     ~~~~
  110.  
  111. W  menu  programu  znajdujâ  sië  podstawowe  opcje,  spotykane w
  112. wiëkszoôci programów.
  113.  
  114. Konwersja (Project)
  115.   Zwolnij bufor (Clear) - zwalnia pamiëê przydzielonâ na tekst
  116.   Wczytaj (Open) - wczytaj zbiór
  117.   Zapisz (Save) - zapisz pod tâ samâ nazwâ
  118.   Zapisz jako (Save as) - zapisz pod nowâ nazwâ
  119.   Preferencje (Preferences) - preferencje programu
  120.   O programie (About) - Informacja o programie
  121.   Wyjôcie (Quit) - ...
  122.  
  123. Schowek (Clipboard | Edit)
  124.   Wytnij (Cut) - przenieô dane wyjôciowe do schowka (clipboard'u)
  125.                  i zwolnij bufor
  126.   Wytnij (Copy) - przenieô dane wyjôciowe do schowka (clipboard'u)
  127.   Wstaw (Paste) - wstaw zawartoôê schowka (clipboard'u)
  128.  
  129.  
  130.  
  131.  
  132.  
  133. 6.  Preferencje
  134.     ~~~~~~~~~~~
  135.  
  136. W preferencjach programu dostëpne mamy dwie opcje:
  137.  
  138. - Kompresja przy zapisie:
  139.     - brak - zbiory nie bëdâ kompresowane
  140.     - bez zmian - zbiór zostanie skompresowany lub nie w
  141.     zaleûnoôci czy byî on skompresowany przed odczytem
  142.     - XPK - kompresja XPK
  143.     - PP - kompresja powerpacker
  144.  
  145. - Ikona:
  146.     - brak - zbiory bëdâ zapisywane bez ikony
  147.     - kopiuj - kopiuj ikonë z pliku wejôciowego
  148.     - utwórz - jeôli brak ikony w pliku wejôciowym, to jâ
  149.     utwórz
  150.  
  151. Zapisz (Save) - zapisuje preferencje do zbioru S:PCC.prefs
  152. Ustaw (Use) - ustawia preferencje, nie zapisuje
  153. Przywróê (Cancel) - przywraca poprzednie ustawienia
  154.  
  155. W oknie gîównym dostëpna jest równieû opcja usuï CR. Powoduje ona
  156. usuniëcie podwójnych znaków koïca linii (stosowanych na PC).
  157.  
  158.  
  159. 7.  Okno informacyjne
  160.     ~~~~~~~~~~~~~~~~~
  161.        ______________________
  162. Zbiór |______________________|   - nazwa zbioru
  163.  ___________      ___________
  164. |___________| => |___________|   - standard wejôciowy => wyjôciowy
  165.  
  166. Dîugoôê tekstu  x    EOL y       - x - dîugoôê tekstu po
  167.                                    zdekompresowaniu
  168.                                    y - liczba wierszy
  169.  
  170. Polskich liter x     CR y        - x - iloôê polskich liter
  171.                                    y - iloôc znaków CR (kod 13)
  172.  
  173. Znaków ASCII x       y %         - x - iloôê znaków ASCII (0-127) +
  174.                                    + iloôê polskich liter
  175.                                  - y jak wyûej w % caîego tekstu
  176.                       _______
  177. Zdaï x     Kompresja |_______|   - x - iloôê znaków ".", "!", "?",
  178.                                    kompresja zbioru wejôciowego
  179.  
  180.  
  181.  
  182.  
  183. 8.  Arexx
  184.     ~~~~~
  185.  
  186. Port arexx'a dla programu ma nazwë "PCC". Dostëpne funkcje:
  187.  
  188. TEXT <tekst> - wyôwietlenie tekstu <tekst> w oknie informacyjnym
  189.     programu
  190.  
  191. FLASHTEXT <tekst> - wyôwietlenie przez kilka sekund komunikatu
  192.  
  193. LOAD |<nazwa zbioru>| - wczytanie zbioru o podanej nazwie, lub
  194.     jeûeli brak nazwy otwarcie okna wyboru zbiorów
  195.  
  196. SAVE |<nazwa zbioru>| - zapis zbioru o podanej nazwie, lub
  197.     jeûeli brak nazwy otwarcie okna wyboru zbiorów
  198.  
  199. GET - pobranie wyjôciowego tekstu do zmiennej RESULT
  200.  
  201. PUT <tekst> - przeniesienie tekstu <tekst> do PCC
  202.  
  203. SETIN <nazwa standardu> - ustaw standard wejôciowy
  204.  
  205. SETOUT <nazwa standardu> - ustaw standard wyjôciowy
  206.  
  207. CLEAR - zwolnij bufor
  208.  
  209. CUT - przenieô tekst wyjôciowy do Clipboard i zwolnij bufor
  210.  
  211. COPY - przenieô tekst wyjôciowy do Clipboard
  212.  
  213. PASTE - wstaw tekst z Clipboard
  214.  
  215. QUIT - wyjdú z programu
  216.  
  217.  
  218.  
  219.  
  220. 9.  PolCharsSets
  221.     ~~~~~~~~~~~~
  222.  
  223. W  zbiorze "PolCharsSets" znajdujâ sië kody wszystkich standardów
  224. polskich  znaków  rozpoznawanych przez PCC.  Zapis standardu jest
  225. nastëpujâcy:
  226.  
  227. |*|<nazwa standardu> - Â/â,Ê/ê,Ë/ë,Î/î,Ï/ï,Ó/ó,Ô/ô,Û/û,Ú/ú
  228.  
  229. W  miejsce  liter  naleûy wpisaê kod dla znaku w hex, poprzedzony
  230. "$", np.  "$c2/$e2".  Liczba hex musi skîadaê sië z dwóch znaków.
  231. Caîoôê  musi  mieôciê  sië  w jednej linii, i byê zakoïczona EOL.
  232. Znak  "*"  przed  nazwâ  oznacza  ûe  standard  nie  wystëpuje  w
  233. zbiorach;  nie  moûe  byê  standardem wejôciowym.  Kody muszâ byê
  234. wpisane w powyûszej kolejnoôci.
  235.  
  236. Standard  "*Charless"  sîuûy  do  konwersji  polskich  znaków  na
  237. podobne do nich litery z alfabetu angielskiego, np "ó" => "o".
  238.  
  239. Zbiór  "PolCharsSets.info"  jest  ikonâ, która bëdzie dodawana do
  240. zbiorów  nie  posiadajâcych  ikony,  jeûeli  preferencje  zostanâ
  241. ustawione  na  tworzenie  ikon.   Nie naleûy uûywaê dla tej ikony
  242. opcji  "Snapshot"  z  Workbench'a.
  243.  
  244.  
  245.  
  246.  
  247. 10. AppWindow
  248.     ~~~~~~~~~
  249.  
  250. Kaûdâ  ikonë  zbioru  tekstowego  moûna  przeciâgnâê do okna PCC,
  251. podobie   jak   przy   kopiowaniu  pomiëdzy  oknami  Workbench'a.
  252. Wymagany jest przy tym system 2.0 lub wyûszy.
  253.  
  254.  
  255.  
  256.  
  257. 11. Kontakt
  258.     ~~~~~~~
  259.  
  260. Uwagi, pytania proszë kierowaê na adres:
  261.  
  262.                           Rafaî Mantiuk
  263.                           ul.Róûowa 4/9
  264.                          70-781 Szczecin
  265.  
  266. 11. Wersja
  267.     ~~~~~~
  268.  
  269. v1.0 - pierwsza wersja
  270. v1.1 - dodano moûliwoôê konwersji kilku zbiorów naraz
  271. v1.2 - poprawiono drobne bîëdy allokacji
  272.