****************************************************************************
**  KONVERZE KDOVN ETINY  (verze DOS pkazov dka)                **
****************************************************************************

vod
----
Vtejte v uivatelskm manulu k programu KDOVN ETINY. Tento manul
usnadn seznmen s programem a umon jej optimln vyut. Jeho soust
je kompletn popis vech hlen programu.

Instalace
---------
Systmov poadavky programu

Ne uveden systmov poadavky jsou minimln, kter jsou pro chod
programu poteba. Proto jakkoliv vkonnj konfigurace Vaeho PC nem
vliv na funknost programu ale pouze na rychlost.

* Operan systm MS-DOS verze 3.3 nebo vy nebo MS-DOS 7.X jako soust
  Windows 9x/NT
* Procesor ady Intel 286 nebo vy
* Pam؜ RAM 1 MB
* Grafick karta 512 kB (pro textov md vyhovuje s dostatenou rezervou)
* Kompletn instalace vyaduje na pevnm disku cca 350 kB volnho msta

Vlastn instalace je velmi jednoduch a spov pouze ve zkoprovn vech
soubor na instalan disket (nap. pomoc Norton Commanderu, Manaeru
M602 nebo Windows Commanderu) do Vmi vybranho adrese na pevnm disku.

Co je novho ?
--------------
* ve verzi 1.14 - ze dne 15.06.2002 drobn zmny
* ve verzi 1.13 - ze dne 24.11.2001 drobn zmny v algoritmu pevodu kdovn
* ve verzi 1.13 - ze dne 31.03.2001 odstranna chyba dlen nulou
* ve verzi 1.13 - ze dne 17.03.2001 byly upraveny nov internetov odkazy
* ve verzi 1.13 - mal prava kdovac sti programu za elem zven
  rychlosti konverze
* ve verzi 1.12 - pidn 6. parametru, co je monost potlait dotaz na
  pepsn existujcho souboru
* ve verzi 1.11 - oprava koncovho lomtka u jmen adres - nyn funkn.
  Pi vzniku chyby program kon svoji innost.
* ve verzi 1.1 - pidny dal 4 normy kdovn: ISO 8859-1, ISO 8859-2,
  KOI-8 CS a Macintosh - norem celkem: 8. prava designu - vodn npovdy
  pi sputn programu.
* ve verzi 1.01 - opravena chyba pi spoutn na potai s procesorem
  Pentium II

Sputn programu
-----------------
Spout se souborem KOD_CZ.EXE, operan systm me bt samotn MS-DOS
nebo MS-DOS v prosted Windows 9x/NT. V obou prostedch je zaruena
100% funknost programu.

Popis programu
--------------
Program KDOVN ETINY slou k pevdn esk diakritiky v textovch
souborech. Tyto textov soubory se mohou nachzet i v podadresch,
program doke pevdt i cel adresov struktury. Ovld se pouze z
pkazovho dku, co jej umouje vyut nap. pi asto provdn
konverzi stejn struktury soubor a adres (v dvkovm souboru). Po
dokonen pevodu se vype informace o potu spn pevedench soubor z
celkovho potu soubor.

Konverzi je mon rozdlit na 3 typy:
* pevdn jedinho souboru (1.parametr je S)
* pevdn soubor v adresi bez podadres (1.parametr je A)
* pevdn soubor v adresi vetn podadres (1.parametr je AP)

Vyuit nalezne vude tam, kde se vykonvaj nap. tyto innosti:
* Pi programovn v systmu DOS, kdy je nap. poteba provst pevod
  zdrojovch soubor z jedn normy kdovn do druh.
* Pi programovn WWW strnek, konkrtn vytvme-li web v nkolika
  verzch vdy s rznmi kdovmi strnkami.
* Pi pevodu textovch soubor z DOSu (CP Latin 2, CP Kamenick) do
  Windows (CP Windows 1250) nebo obrcen z Windows do DOSu.
* Je-li poteba pevst jednoduch textov soubor do jin kdov strnky,
  nap. z Latin 2 do Kamenick.
* Pevdn diakritiky v souborech RTF

Program KDOVN ETINY je napsn v kdov strnce Latin 2 (CP 852), tedy
pi souasnm provozovn s Windows 9x/NT by nemly vzniknout problmy.

Program KDOVN ETINY me bt en jen pi dodren autorskch prv.

Parametry pkazov dky
-------------------------
Kompletn verze pro MS-DOS obsahuje jedin spustiteln soubor a to
KOD_CZ.EXE. Pi sputn samotnho programu bez dalch parametr na
pkazov dce se vype popis poadovanch parametr.

Tchto parametr je celkem 6 a prvn 4 z nich jsou povinn, a mus bt od
sebe oddleny mezerou tak, jak ukazuje zkladn syntaxe programu. Posledn
pt parametr je nepovinn a nemus bt na pkazov dce uveden. Poad
vech parametr na pkazov dce nelze zamnit ! Pi sputn programu
mus tedy bt na pkazov dce vdy 4 a 6 parametr.

Zkladn syntaxe programu je:

   KOD_CZ.EXE 1.parametr 2.parametr ............... 5.parametr 6.parametr

Jde o nsledujc parametry:

 1) Typ konverze - specifikuje, jak objekt se bude pevdt, zda soubor
    i adres
    * S   soubor
    * A   adres
    * AP  adres i s podadresi

 2) Vstupn/vstupn formt kdovn - lze vybrat z 8 norem kdovn:
    ASCII - ISO 8859-1 - ISO 8859-2 - Kamenick - KOI-8 CS - Latin 2 -
    Macintosh - Windows.
    Pevod z ASCII do jin normy nem smysl, nebo neobsahuje diakritiku a
    nen mon ji ani "vytvoit". Vechny dal monosti jsou tedy reln.
    Kad norma kdovn etiny m zkratku odvozenou ze svho prvnho
    psmena. Spojenm tohoto prvnho psmena u vstupn a vstupn normy bez
    mezery doshneme sestaven 2. parametru. Nap. pi pevodu diakritiky
    z normy Latin 2 do KOI-8 CS bude 2. parametr L8. Dal informace lze
    nalzt v poloce Pklady pouit. 
    * A - ASCII 
    * 1 - ISO 8859-1 (ECMA-94) 
    * 2 - ISO 8859-2 (ECMA-94) 
    * K - Kamenick (CP 895) 
    * 8 - KOI-8 CS 
    * L - Latin 2 (CP 852) 
    * M - Macintosh 
    * W - Windows (CP 1250) 

 3) Jmno zdrojovho souboru/adrese - nap. README.TXT. Tento zdrojov
    soubor/adres mus nutn existovat, jinak nelze provst konverzi.
 4) Jmno clovho souboru/adrese (mon i neexistujcho) - nap.
    README.INF. Clov soubor nebo adres nemus nutn existovat, v
    ppad poteby jej program vytvo sm. Existuje-li ji clov soubor
    bude vypsn dotaz na jeho pepsn.
 5) Vpis jmen konvertovanch soubor - pepna -vypis, vypisuje jmna
    vech konvertovanch soubor pi bhu programu. Implicitn se jmna
    konvertovanch soubor nevypisuj. Pozor ! Rozliuj se mal a velk
    psmena, tj. uvedete-li nap. -VYPIS, pak nebude mt tento parametr
    sprvnou syntaxi a program se bude chovat jako kdyby na pkazov dce
    nebyl (nevype nic).
 6) Zobrazen dotazu na pepis pi existenci clovho souboru - nen-li
    tento parametr uveden, vdy pi existenci clovho souboru bude vypsn
    dotaz na jeho pepsn. Zabrnit lze vpisu dotazu uvedenm parametru
    -prepis na pkazovou dku.

Co program KDOVN ETINY neum
---------------------------------
* Pi konverzi nelze pouvat dlouh jmna soubor (jako ve Windows
  9x/NT). Tento nedostatek vak e verze pro Windows 9x/NT.

Program nelze pout pi:
-------------------------
* Pevodu kdovn u soubor typu Microsoft Word nebo Excel a u vech
  dalch typ, kter ukldaj dokument ve svm vlastnm formtu, tedy
  nikoliv jako ist iteln text.
* Pevodu kdovn u sestavenho libovolnho programu (EXE souboru) v
  domnn, e nap. njak program pouv etinu ve formtu Kamenick,
  nm to nevyhovuje a potebujeme ho pevst nap. do Latin 2. Tento ppad
  nelze eit pouitm programu KDOVN ETINY.

Hlen programu
----------------
V programu se rozliuj celkem 3 druhy hlen. Jsou to chybov, varovn a
informan. Kad z nich se zobrazuje uritou barvu. Vechna chybov
hlen programu jsou zabarvena svtle ervenou barvou, varovn hlen
jsou vypsna barvou svtle zelenou. Informan hlen pak implicitn
svtle edou barvou. Tak lze velmi snadno poznat nap. v jakm stavu se
program ukonil.

Pehled chybovch hlen (erven)

Chybov hlen se objevuj pouze pi zadanch parametrech programu a zna,
e jeden nebo vce z nich mus bt pozmnny pro sprvnou innost programu.

* 1.parametr (typ pevodu) byl chybn zadn !
  Pi zadvn typu pevodu je mon vybrat pouze ze 3 monost: S, A nebo
  AP. Upravte tento parametr na pkazov dce.
* 2.parametr (vstupn/vstupn kdovn) byl chybn zadn !
  Kdovn mus bt kombinac prvnch psmen nzv ASCII, Kamenick,
  Latin 2 nebo Windows. Piem nelze zanat psmenem A, nebo pevdt z
  ASCII do jin normy nem smysl.
* Clov soubor byl specifikovn chybnm jmnem.
  Jmno clovho souboru je przdn, tj. "".
* Vstupn soubor "JMNO" nelze otevt !
  Byl zadn soubor, ke ktermu nemte prva na ten jeho obsahu, nap. na
  sti.
* Zdrojov a clov soubor neme bt shodn.
  Jmna obou soubor mus bt rzn, upravte je !
* Nelze vytvoit soubor "JMNO" !
  Byl zadn soubor, ke ktermu nemte prva na zpis, nap. na sti, nebo
  na disket(disku) chrnn(m) proti zpisu.
* Zdrojov a clov adres neme bt shodn.
  Jmna obou adres mus bt rzn, upravte je !
* Clov adres "JMNO" nelze vytvoit !
  Nelze vytvoit clov adres. Zkontrolujte, zda mte k disku pstup,
  nap. na sti.
* Zdrojov adres "JMNO" neexistuje !
  Byl zadn chybn zdrojov adres. Zadejte existujc zdrojov adres.
* Soubor "JMNO" nelze otevt !
  Souboru byl odepen pstup, nap. na sti nebo bylo zadno przdn jmno.
* Vstupn soubor "JMNO" nelze vytvoit !
  Souboru byl odepen pstup, nap. na sti. Zkontrolujte Vae pstupov
  prva.
* Nelze vytvoit poadovanou stromovou strukturu adres !
  ("JMNO ADRESE")
  Pi vytven adresov struktury nebylo mon dokonit operaci.
  Zkontrolujte pstupov prva, nap. na sti nebo zda nzev vytvenho
  adrese neobsahuje nepovolen znaky (nap. apostrof, rku, dvojteku,
  mezeru, rovntko apod.). Dlouh nzvy jako ve Windows 9x/NT nelze
  pout !
* Chyba pi zpisu souboru "JMNO" !
  Pi zpisu clovho souboru (do Vmi vybranho adrese) nastala chyba.
  Jednou z monch pin me bt nap. nedostatek msta na disku nebo
  disketa chrnn proti zpisu.

Pehled varovnch hlen (zelen)

Varovn hlen upozoruj pouze na stav, kdy soubor uritho jmna ji
existuje a nabz monosti een takovto situace.

* Clov soubor "JMNO" ji existuje ! Pepsat ?
  Tento dotaz se objev pouze u konverze 1 souboru. Vstupn (clov)
  soubor ji existuje, odpovzte klvesou A m-li se soubor pepsat. M-li
  soubor zstat beze zmny, stisknte N.
* Clov soubor "JMNO" ji existuje ! Pepsat ? [A/N/V] :
  Tento dotaz se objev pouze u konverze adrese. Chcete-li pepsat
  existujc soubor, stisknte klvesu A (od slova ano) nebo Enter.
  Chcete-li existujc soubor ponechat beze zmn, stisknte klvesu N (od
  slova ne) nebo Esc. Pokud poadujete pepsn vech dalch existujcch
  soubor vyberet klvesu V (od slova vechny).

Pehled informanch hlen (svtle ed)

Informan hlen sdluj s jakm vsledkem konverze probhla.

* Konverze neprobhla v podku ! Vyskytly se chyby !
  Toto hlen se zobraz tehdy, pokud nebyla splnna podmnka nkterho
  chybovch hlen, kter se tkaj vstupnho nebo vstupnho
  souboru/adrese.
* Pi konverzi se nevyskytly dn chyby. OK !
  Nenastala-li bhem pevodu njak chyba, ukon se program s tmto
  informanm hlenm. Signalizuje se tak spn ukonen konverze
  kdovn.

Pklady pouit
----------------
Pevod kdovn ze souboru SOUBOR.TXT (v norm Windows) do souboru
SOUBOR2.TXT (v norm Latin 2), kter neexistuje.
KOD_CZ S WL SOUBOR.TXT SOUBOR2.TXT

Pevod kdovn u soubor (z normy Latin 2 do normy ASCII) v adresi
C:\POKUS do adrese C:\NOVE, kter neexistuje. Soubory v podadresch
nebudou pevdny (2.parametr je A).
KOD_CZ A LA C:\POKUS C:\NOVE

Pevod kdovn u soubor (z normy Kamenick do normy Windows) v adresi
C:\TEST do adrese C:\PREVOD, kter neexistuje. Soubory v podadresch
budou tak pevedeny (2.parametr je AP).
KOD_CZ AP KW C:\TEST C:\PREVOD 

Pevod kdovn u soubor (z normy Kamenick do normy Windows) v adresi
C:\TEST do adrese C:\PREVOD, kter existuje. Soubory v podadresch
budou tak pevedeny (2.parametr je AP). Budou vypsna jmna pevdnch
soubor.
KOD_CZ AP KW C:\TEST C:\PREVOD -vypis

Jak zskat nejnovj verzi ?
-----------------------------
Nejnovj verzi programu KDOVN ETINY (DOS i Windows) lze nalzt na
internetov adrese:

   http://www.slezak.name

Jakkoliv dotazy, pipomnky a npady na vylepen programu lze poslat na
potovn adresu zskanou na ve uveden strnce.

Manul (c) 1998-2001 Pavel Slezk
