------------------------------------------------------------------------------

  GEGӣKA 5.51.3 (wersja chyba stabilna...) dla Windows 32

      Gegka (c) 1997-2004 by Piotr Sawicki.
      Wszelkie prawa zastrzeone.

  http://www.gzegzolka.com/

------------------------------------------------------------------------------


SPIS TRECI
-----------

   1] INFORMACJE O GEGӣCE
   2] BEZPATNA REJESTRACJA
   3] SPOSB UYCIA
   4] FAQ - POMOC, PORADY
   5] DODAWANIE NOWYCH STANDARDW

   A] HISTERIA
   B] CREDITS
   C] AKTUALIZACJE



1] INFORMACJE O GEGӣCE
-------------------------

   Gegka jest konwerterem standardw kodowania polskich znakw. Standard
   wykrywa automatycznie, nastpnie konwertuje plik na jeden z 22 standardw.
   Rejestracja jest bezpatna.

   MOLIWOCI GEGӣKI:

     * 22 standardw kodowania polskich znakw, w tym Windows-1250,
       IBM 852 (MS-DOS), ISO-8859-2, Macintosh, UTF-8 i Unicode Entities.
       Proste dopisywanie nowych standardw. Obsuga wszystkich (take
       dopisanych przez uytkownika) standardw w autodetekcji.

     * Inteligentna autodetekcja standardu, oparta na wynikach analizy
       statystycznej duej iloci tekstu. Pobieranie standardu ze znacznikw
       <meta> w przypadku plikw HTML.

     * Konwersja / wstawianie / usuwanie znacznikw <meta> w plikach HTML.
       Konwersja opisu strony kodowej w plikach XML. Konwersja formatu kocw
       linii (EOL), obsugiwane: CRLF (DOS/Win), LF (Unix), CR (Macintosh).

     * Konwersja dowolnej liczby plikw za jednym razem. Obsuga tzw.
       wildcards (np. *.txt, *.htm?). Wyszukiwanie plikw z uwzgldnieniem
       podkatalogw. Pomijanie plikw o okrelonych rozszerzeniach.

     * Pliki "rozkazw", automatyzujce dziaanie programu. Po dwukrotnym
       klikniciu na ikon pliku rozkazw zostan wykonane czynnoci
       opisane w pliku.

     * Bardzo rozbudowane moliwoci konfiguracyjne, umoliwiajce pene
       dostosowanie programu do wasnych potrzeb. Wszystkie ustawienia
       dostpne z menu konfiguracyjnego jak i linii polece.

     * Obsuga dugich nazw plikw, 32 bity, praca pod Windows 9x/NT/2000,
       integracja z menu Eksploratora Windows.



2] BEZPATNA REJESTRACJA
------------------------

   Rejestracja Gegki jest bezpatna. Dziki niej zostanie wyczony
   irytator.

   UMOWA REJESTRACYJNA

     * Pamitaj, e uywasz Gegki na wasn odpowiedzialno.
       Za adne szkody i straty poniesione przez stosowanie programu nie
       odpowiadam.

   JAK ZAREJESTROWA

     * uyj pliku keygen.exe



3] SPOSB UYCIA
----------------

   Gegka jest programem konsolowym - co oznacza, e wywoywana jest
   z linii polece. Parametry wywoania opisane s w pliku cvhelp.txt.
   Dla wygody warto uruchamia Gegk w 32 bitowym managerze plikw
   z lin polece, polecam szczeglnie FAR i Windows Commander (oraz
   16 bitowy DOS Navigator :).

   Gegka jest zintegrowana z Windows. Jeeli klikniesz prawym
   przyciskiem myszy (w Eksploratorze Windows) na plik tekstowy lub HTML,
   pojawi si opcja konwersji (Gegka!).

   Mona take tworzy pliki "rozkazw". Plik rozkazw to zwyky plik
   tekstowy z parametrami programu. Po jego wczeniu Gegka wykona
   wszystkie polecenia w nim zawarte.

   Moesz take doda Gegk do menu "Wylij do". W tym celu naley
   utwrzy skrt do Gegki w katalogu "C:\Windows\SendTo".
   Identycznie dziaa przeciganie plikw na skrt do Gegki.



4] FAQ - POMOC, PORADY
----------------------

   KONFIGURACJA - SETUP, PLIKI ROZKAZW, LINIA POLECE...

       Ze wzgldu na to, e opcje Gegki s ustawiane w Setupie,
       pobierane z plikw rozkazw (*.cv) i przekazywane w linii polece,
       mog by niejasnoci.

       Program ustala parametry pracy w kolejnoci:

       0. Ustawienie konfiguracji standardowej.
       1. Pobranie konfiguracji z setupu.
       2. Wczytanie konfiguracji z plikw rozkazw (*.cv).
       3. Pobranie konfiguracji z linii polece.

       W kadym kolejnym kroku wczeniejsze ustawienia s nadpisywane nowymi.

   NIEPRAWIDOWY PARAMETR - STANDARD KODOWANIA

       Jeeli uyjesz parametru okrelajcego standard wejciowy/docelowy,
       podczas gdy standard ten nie jest wczony
       (patrz cv.ini -> [Standardy] -> Stosuj standardy)
       parametr zostanie uznany za nieprawidowy.

   KONWERSJA <META> W PLIKACH HTML

     * Tag <meta> zostanie przekonwertowany lub wstawiony do pliku HTML
       tylko wtedy, gdy docelowy standard moe by opisany tagiem <meta>.
       Jeeli docelowy standard nie moe by opisany znacznikiem <meta>,
       znacznik <meta> zostanie z pliku usunity.

     * Gegka decyduje czy pobiera standard ze znacznika <meta>
       oraz czy konwertowa znacznik <meta> na podstawie
       cv.ini -> [Typy plikw] -> HTML.
       Typy plikw spoza listy s traktowane jak pliki tekstowe.

   STANDARD KODOWANIA ZOSTA WYKRYTY NIEPRAWIDOWO

     * Jeeli plik jest bardzo niewielki, autodetekcja moe si nie powie.

     * Dla plikw HTML - by moe znacznik <meta> zawiera nieprawdziwe dane
       o standardzie PL. Wycz pobieranie standardu ze znacznikw <meta>
       (parametr -html-det-off), zostanie wtedy uyta autodetekcja.

     * Sprawd, czy standard znajduje si na licie uywanych standardw.
       (patrz CV.INI -> [Standardy] -> Stosuj standardy). Jeeli nie,
       dopisz do listy stosowny numer.

   MAM TYLKO 5 STANDARDW (A NIE NP. 22)

     * Domylnie (wiksza szybko pracy) uywane jest 5 najpopularniejszych
       standardw. Aby zwikszy ich liczb, wejd do pliku cv.ini i dopisz
       odpowiednie numery w kluczu "Stosuj standardy".

     * Jeeli chcesz doda nowy standard, patrz punkt 5.

   BRAK DOSTPU DO PLIKU WEJCIOWEGO / DOCELOWEGO / KOPII ZAPASOWEJ

     * Sprawd, czy plik nie jest otwarty przez inny program.

     * Usu atrybuty "tylko do odczytu", "plik systemowy", pamitaj - pliki
       przegrane z CD-ROM maj atrybut "tylko do odczytu".

     * Sprawd, czy masz odpowiednie uprawnienia by zmieni plik (Win NT).

   NIE MONA PRZEKONWERTOWA PLIKU

     * Jeeli nazwa pliku zawiera sekwencje znakw ".new" lub ".bak",
       wtedy Gegka traktuje go jako plik kopii zapasowej i ignoruje.

     * Sprawd, czy rozszerzenie pliku nie znajduje si na licie
       do pominicia (Patrz CV.INI -> [Typy plikw] -> "Ignoruj".

   KOPOTY Z DUGIMI NAZWAMI PLIKW

       Jeeli konwertujesz pliki posiadajce dugie nazwy ze spacjami,
       we je w cudzysw, np.:
       cv "C:\Moje dokumenty\*.txt"

       Gdyby pomin cudzysw w przykadzie powyej, Gegka uznaby,
       e ma przekonwertowa dwa pliki: "C:\Moje" i "dokumenty\*.html".

   POMIJANIE WYBRANYCH TYPW PLIKW

       Zajrzyj do pliku CV.INI -> [Typy plikw] -> "Ignoruj".
       Jeeli chcesz aby pliki o jakim rozszerzeniu byy pomijane - dopisz
       stosowne rozszerzenie do listy.
       NIE s obsugiwane wildcards - htm*, tx? itp.

   GEGӣKA DZIAA WOLNO

     * Jeeli Gegka pracuje w tle, ustaw jej priorytet na wysoki
       parametrem "-prio-high" lub zrb to w Konfiguracji Gegki.

     * Jeeli wczye uwzgldnianie podkatalogw w wyszukiwaniu,
       Gegka szuka kadego pliku, jaki wymienisz, w caym drzewie
       podkatalogw. To moe trwa dugo przy pracy np. w katalogu gwnym.

     * Zmniejsz liczb standardw w pliku CV.INI. Autodetekcja przypieszy,
       jeeli usuniesz nieuywane standardy.

   GEGӣKA NIE DZIAA

     * Sprawd czy dysk z Gegk nie jest dyskiem tylko do odczytu;
       jeeli tak, przenie program na dysk zapisywalny.

     * Przywr ustawienia standardowe - uruchom "cv -setup-default".
       Nie modyfikuj rcznie ustawie rejestru.

     * Moe by to win wirusa, uyj programu antywirusowego.

   WYJCIE Z GEGӣKI "NA SI"

       Aby wyj z Gegki w dowolnym momencie, wcinij CTRL + BREAK.

   NIE DZIAA INTEGRACJA Z EKSPLORATOREM (WINDOWS NT/2000)

       Musisz posiada prawa administratora, pozwalajce na modyfikacj
       klucza HKEY_CLASSES_ROOT.

   KLUCZ REJESTRACYJNY NIE DZIAA
     
       Jeeli pojawia si komunikat, e program nie jest zarejestrowany,
       pomimo e przekopiowae klucz do katalogu z Gegk, sprawd czy
       nie masz kopii programu w innym katalogu. By moe systemowi znana
       jest wanie ta druga lokacja - dlatego najlepiej przekopiowa klucz
       do kadego katalogu z Gegk.

   DEINSTALACJA

       Aby usun Gegk z systemu, naley uruchomi program cvunin.exe.
       Deinstalator usuwa tylko odpowiednie klucze z rejestru. Pliki naley
       skasowa samodzielnie.



5] DODAWANIE NOWYCH STANDARDW
------------------------------

   Dopisz w pliku "cv.ini" w sekcji [Standardy] klucze:

   Nazwa-n=Nazwa dopisywanego standardu
   Tablica-n=tablica znakw
   Eol-n=sposb konwersji kocw linii

   "N" jest numerem dopisywanego standardu. Powinien by on rny
   od numerw ju znajdujcych si w pliku "cv.ini".

   Klucz "Tablica-n" s to kody ASCII znakw dopisywanego standardu,
   w kolejnoci , , , , , , , , , , , , , , , , , .

   Klucz "Eol-n" okrela, jak maj by konwertowane koce linii.
   Moe przyjmowa wartoci "crlf", "cr", "lf" oraz "default".



A] HISTERIA
-----------

   + = nowa funkcja
   - = usunity bd
   * = zmiana


  snapshot

        + obsuga plikw XML
        * poprawione operacje na znacznikach <meta>
        + parametry: -*txt -*html -*xml (konwersja wybranych typw plikw)
        + tryb "szybkiej" pracy menu (nie potrzebne potwierdzenie wybranej
          pozycji enterem)
        + pomijanie pliku - nacinij ESC
        * mae zmiany parametrw linii polece (stare p. te s obsugiwane)
        - bd w przypadku skasowania z cv.ini klucza z typami HTML
        * setup, deinstalator - informacje w przyp. braku uprawnie (Win NT)
        * koniec z uywaniem msvcrt.dll; duo mniejsze zuycie pamici


   5.50 + obsuga plikw *.cv (pliki z rozkazami dla Gegki);
          czyli maa rewolucja w sposobie obsugi Gegki
        + dwa nowe standardy - UTF-8 i Unicode Entities (ju 22 standardy :)
        * najwaniejsze standardy zostay "wbudowane" w program
        + wstawianie do plikw HTML znacznikw <meta> opisujcych standard
        + usuwanie z plikw HTML znacznikw <meta> z nieaktualnym opisem
        + ustalanie konwersji kocw linii dla kadego ze standardw osobno
        * teraz Unicode Entities s traktowane jak pozostae standardy
        * tylko jedna, inteligentna (bardzo) detekcja standardu (po co wicej)
        * dane z pliku cv.def (domylne ust. cv.ini) przeniesione do cv.exe
        + deinstalator dziaa prawidowo take w Windows NT
        * jeeli wciniesz CTRL+BREAK w trakcie konwersji, program zakoczy
          si dopiero po zakoczeniu operacji na plikach
        + nowe ikony programu
        + deinstalator kasuje teraz take pliki programu
        * przekroczona magiczna bariera 5000 linii kodu :)

   5.08 + okrelanie w pliku cv.ini typw plikw, dla jakich pobiera
          standard ze znacznika <meta>
        + okrelanie w pliku cv.ini typw plikw, w ktrych mona konwertowa
          unicode character entities
        - bd: dziwne zachowanie setupu w "opcjach plikw HTML"
        - bd: konwersja <meta> wg ustawie pobierania standardu z <meta>

   5.06 - bdy w pracy pod Windows NT (pierwszy raz testowano w WinNT :)

   5.04 + nowy help, pokazujcy biece ustawienia
        + HTML: obsuga konwersji <meta> dla MS-DOS (IBM 852)
        + nowe, dugie i atwe do zapamitania parametry
        * drobne udogodnienia w menu wyboru standardu
        * poprawiona konwersja "character entities"
        + zamykanie okna programu po 15 sekundach (start z Eksploratora)
        * wielkie zmiany "wewntrznej" budowy programu
        - niemoliwe odtworzenie konfiguracji standardowej, gdy bd w cv.ini
        - bd zapisywania standardw wejciowego i docelowego w setup'ie

   5.02 + HTML: konwersja polskich znakw na "character entities" i na odwrt
        * zmiana nazwy "CONVERT" -> "GEGӣKA"
        * autodetekcja z menu dziaa troch wygodniej
        * optymalizacje, zmiany, poprawki, gigantyczne przerbki kodu
        - bd: brak konwersji EOL w trybie konwersji tylko EOL (co za wstyd)
        - bd: zy odczyt cv.key, jeli w nazwisku byy polskie znaki
        - bd: niedozwolona operacja, gdy wczone > ni 32 standardy
        - bd: zjadanie jednego znaku przy konwersji znacznika <meta> (wstyd)

   5.01 + HTML: pobieranie standardu PL ze znacznika <meta>
        + HTML: konwersja <meta> z opisem standardu PL moe by wyczona
        + nowe parametry do obsugi powyszych
        * reorganizacja setup'u
        - bd w menu wyboru standardu uniemoliwiajcy pominicie pliku
        - bd - gdy standard wybrany w setupie zostaje wyczony w CV.INI
        - bdy operacji na plikach trybie konwersji tylko kocw linii
        - wywalalnie si programu przy konwersji EOL Unix -> WIN/DOS
        - bd: przy konwersji tylko kocw linii w plikach HTML
          znacznik <meta> by konwertowany do standardu ISO

   5.00 + program napisany cakowicie od nowa w C++ (Win32 API)
        + cakowicie nowy, ultraszybki i cholernie inteligentny algorytm
          autodetekcji standardu Gegka (tm) 2.0
        + cakowicie nowy enigine konwersji, konwertujcy znaki koca linii
          (EOL) i znaczniki <meta> w plikach HTML
        + integracja z systemem Windows, ustalanie priorytetu pracy,
          konfiguracja zapisywana w Rejestrze Windows
        * konwersja nielimitowanej iloci plikw za jednym razem
        * bardzo zmniejszone wymagania pamiciowe, bardzo przyspieszone
          dziaanie programu (w stosunku do 4.x)
        * usunite wskaniki zaawansowania konwersji i autodetekcji
          (po co pisa od razu 100% ;-)
        * usunity tryb pracy - konwersja wg tych samych ustawie
          (inteligentne menu i moliwo wyboru standardu z linii polece
           zdezaktualizoway sens tego trybu)
        * nowy sposb zapisywania danych o standardach w cv.ini
        * masa drobnych zmian, usprawnie, nowe parametry linii polece,
          nowe moliwoci itd...



B] CREDITS
----------

   PODZIKOWANIA

     Marcin Krl AKA Martin King, Bartomiej Kucharczyk,
     fenrir AKA Fenrir Lupus, Wojciech Eysymontt AKA Voytec, Krzysztof Nych,
     Jakub Loster, Stanisaw Szpara, Andrzej P. Woniak, Mariusz Jasiski,
     Maciej Haudek



C] AKTUALIZACJE
---------------

   http://www.gzegzolka.com/



That's all folks