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

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 funkc programu, tipy a doporuen, vzorov
pklady pouit.

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 700 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 4.14 - ze dne 24.11.2001 opravena chyba, kter zpsobovala pevod
  pouze prvnch 64 kB souboru

Sputn programu
-----------------
Spout se souborem KOD_DOS.EXE, operan systm me bt samotn MS-DOS
nebo MS-DOS v prosted Windows 9x/NT. V obou prostedch je zaruena
100% funknost programu. Bli informace o poadavcch programu jsou v
sekci Instalace/Systmov poadavky 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. Bhem pevodu se v
okn zobrazuj jmna soubor kter jsou prv konvertovna. Po dokonen
pevodu se vype informace o potu spn pevedench soubor z celkovho
potu soubor a o tom, zda konverze souboru() probhla v podku i
nikoliv.

Konverzi je mon rozdlit na 3 typy (jsou popsny v sekci Podrobn popis
funkc):
* pevdn jedinho souboru
* pevdn soubor v adresi bez podadres
* pevdn soubor v adresi vetn podadres

Vyuit nalezne vude tam, kde se provdj 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 um zpracovvat tyto normy kdovn etiny:
ASCII, ISO 8859-1 (ECMA-94), ISO 8859-2 (ECMA-94), Kamenick (CP 895),
KOI-8 CS, Latin 2 (CP 852), Macintosh, Windows (CP 1250).

Pozn. Pevdny jsou tak skryt a systmov soubory.

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

Ovldn programu
-----------------
Program lze ovldat nkolika zpsoby:
 1) z pkazovho dku, co jej umouje vyut nap. pi asto provdn
    konverzi stejn struktury soubor a adres (v dvkovm souboru)
 2) pomoc dialogovch oken, kde lze pohodln nastavit potebn parametry
 3) kombinac obou pedchozch zpsob

Pi sputn programu se zobraz pracovn plocha, kter je rozdlena na 3
sti. V horn sti je nabdkov menu, ve spodn sti je stavov dek a
mezi menu a stavovm dkem je pracovn plocha programu. Menu obsahuje 2
poloky a to "XX" a "Kdovn". Vbr menu lze provst stiskem klvesy F10,
piem pohyb v menu se provd ipkami "vlevo" a "vpravo". Vbr zvolenho
menu (tj. toho, kter barevn podsvceno) se provede klvesou "Enter".
Vybran menu se rozbal a opt se v nm lze pohybovat ipkovmi klvesami.
Vybranou funkci spustme stiskem klvesy "Enter".

Nkter funkce maj tak sv zkratkov klvesy. Slou k rychlmu sputn
dan funkce a jsou zobrazeny ve stavovm dku programu. V manulu jsou
zkratkov klvesy psny kurzvou. V menu programu jsou nkter psmena
nzvu zobrazena jinou barvou - lut. Pi stisku klvesy "Alt" a zrove
barevnho psmena se menu rozbal nebo spust funkce. Slou pro zrychlen
prce, nen-li mon pout my.

Parametry pkazov dky
-------------------------
Pro usnadnn prce s programem je vhodn zadat zdrojov soubor/adres a
clov soubor/adres ji pi spoutn programu. Pokud soubor/adres
zadan jako 1.parametr (tj. zdrojov) neexistuje, neobjev se jeho jmno v
dialogovm okn ped sputnm pevodu. Zadn parametr na pkazovou
dku tak slou jako kontrola existence zdrojovho souboru nebo adrese.
Parametry na pkazov dce pi spoutn programu jsou nepovinn.

Syntaxe na pkazov dce pi sputn programu:

   KOD_DOS.EXE 1.parametr 2.parametr

Jde o nsledujc parametry:
 1) Jmno zdrojovho souboru/adrese - nap. README.TXT. Tento zdrojov
    soubor/adres mus nutn existovat, jinak nelze provst konverzi.
 2) 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.

Podrobn popis funkc
---------------------
Npovda (F1)

Kontextovou npovdu je mon vyvolat kdykoliv pi bhu programu. Npovda
se vdy vztahuje k aktulnmu problmu. Vyvoln npovdy je podmnno
existenc souboru KOD_DOS.HLP ve stejnm adresi jako je program
KOD_DOS.EXE.

Pevod jedinho souboru (F2)
Pro zadn zdrojovho i clovho souboru je zde mon pout pkazovou
dku. Bude-li na pkazov dce zadno jako 1.parametr (tj. zdrojov
soubor) jmno neexistujcho souboru, pak se pi vyvoln dialogu na pevod
souboru toto jmno neobjev. Clov soubor nemus existovat - bude vytvoen.
Pokud  bude existovat, program nabdne monost pepsn nebo zachovn
pvodnho souboru.

Pevod adrese bez podadres	(F3)
Zadn zdrojovho i clovho adrese lze tak jako u souboru zadat pomoc
pkazov dky ji pi sputn programu. Zdrojov adres mus existovat,
clov bude ppadn vytvoen. Do clovho adrese budou pevedeny v
pslunm kdovn vechny soubory v zdrojovm adresi. Existence clovho
souboru bude oznmena dialogovm oknem s monost pepisu nebo peskoen
souboru, nebo je mon pevod ukonit.

Pevod adrese i s podadresi	(F4)
Zadn zdrojovho i clovho adrese je stejn jako u obou pedchozch
funkc, tedy pomoc pkazov dky ji pi sputn programu. Zdrojov
adres mus existovat, clov bude vytvoen. Do clovho adrese budou
pevedeny v pslunm kdovn vechny soubory v zdrojovm adresi pi
zachovn adresov struktury. Existence clovho souboru bude oznmena
dialogovm oknem s monost pepisu nebo peskoen souboru, nebo je mon
pevod ukonit.

Nastaven (Alt+N)
Tento dialog umouje nastavit nkter vlastnosti pevodu. Aktuln verze
umouje vybrat, zda se m existujc clov soubor automaticky pepsat i
nikoliv. Toto nastaven je poteba opakovat pi kadm sputn programu.

Konec programu (Alt+K)
Tato poloka menu ukon program a vrt zen operanmu systmu.

Copyright
Informace o autorovi, verzi a datumu vytvoen programu.

Adresa
V dialogovm okn je uvedena internetov adresa, na kter je mono zskat
nejnovj verzi programu. Tak je zde uvedena e-mailov adresa autora
programu, na kterou lze poslat jakkoliv dotazy ohledn programu.

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.

Testovn programu
------------------
Program byl testovn ve vech 3 ppustnch kombinacch zadn, tedy
samotn soubor, adres bez podadres a adres s podadresi. To jak v
dialogovch oknech tak i z pkazov dky. Dle byla ovena funknost
ovovn existujcch soubor a vechna dotazovac dialogov okna.

Jak zskat nejnovj verzi ?
-----------------------------
Program KDOVN ETINY je typu FREEWARE, lze pouvat a it pouze v
souladu s licennmi podmnkami. Tedy: nen dovoleno program distribuovat
za elem zisku, provdt v programu jakkoliv zmny a autor v dnm
ppad nenese odpovdnost za ppadn kody zpsoben programem.

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 nebo manulu lze
poslat na adresu zskanou na ve uveden strnce.

Manul (c) 1999-2001 Pavel Slezk
