/************************************************************************\
*
* PROGRAM   : CPCONV
*
* UCEL      : Konverze kodove strany dokumentu
*             (nahrada znaku ze zdrojove kodove strany odpovidajicimi  
*              znaky z cilove kodove strany)
*
\************************************************************************/


COMMAND LINE:
=============
   cpconv  source  [target]  [options] 

source  ~ Jmeno zdrojoveho souboru nebo zdrojoveho adresare.

target  ~ Jmeno ciloveho souboru nebo adresare. Pokud neni uvedeno, je
          target shodny se source.

options ~ Volby. Specielni volba zacinajici znakem @ znamena jmeno
          sekce v CPCONV.INI. Ostatni volby zacinaji znakem /.


CPCONV.INI:
===========
Volby (options) je mozne zadat i pomoci CPCONV.INI. Sekce [Default]
muze obsahovat default nastaveni (jina nez uvedeno dale). Sekce jinych
jmen mohou slouzit pro konkretni situace.

Postup nastaveni voleb pri behu programu je nasledujici:
1. defaulty programu
2. CPCONV.INI, sekce [Default]
3. command line options
   V pripade ze volbou je @section (napr. @CP852), jsou nacteny volby z
   CPCONV.INI, sekce [section] (napr. [CP852]). Po volbe @section jiz 
   prikazova radka neni dale zpracovana.


OPTIONS:
========

Kodova strana zdroje
--------------------
Command line:  /sourcecodepage:scpname   nebo
               /scp:scpname              nebo
               /s:scpname
CPCONV.INI:    SourceCodePage=scpname

  scpname je jmeno kodove strany, kteremu odpovida soubor scpname.ENC v 
  adresari kodovych tabulek. 
  Default je scpname=CP1250.


Kodova strana cile
------------------
Command line:  /targetcodepage:tcpname   nebo
               /tcp:tcpname              nebo
               /t:tcpname
CPCONV.INI:    TargetCodePage=tcpname

  tcpname je jmeno kodove strany, kteremu odpovida soubor tcpname.ENC v 
  adresari kodovych tabulek. 
  Default je tcpname=CP1250.


Adresar kodovych tabulek
------------------------
Command line:  /dir:dirname     nebo
               /d:dirname
CPCONV.INI:  EncodingDir=dirname

  dirname je jmeno adresare, ve kterem jsou ulozeny kodove tabulky
  (soubory *.ENC a ACCENT.CONV).
  Default je adresar shodny s tim, ve kterem se nachazi prave spusteny
  program CPCONV.EXE.


Mod nahrady
-----------
Nastaveni zda provadet pouze jednoznakove nahrady nebo zda je
povolena nahrada znaku viceznakovym retezcem (pokud neexistuje 
jednoznakovy ekvivalent v cilovem kodovani).
Viceznakova nahrada povolena  
  CPCONV.INI:  OneToMore=yes
Viceznakova nahrada neni povolena, default  
  CPCONV.INI:  OneToMore=no
Command line option pro tuto volbu neni.


Nahrazovaci znak
----------------
Znak, ktery se vypise v miste znaku k nemuz neexistuje ekvivalent v
cilovem kodovani.
  CPCONV.INI:  DefChar=c
    kde c je zvoleny znak.
Default je mezera.


Cas souboru
-----------
Command line:  /time:timemode     nebo
               /t:timemode
CPCONV.INI:    FileTime=timemode

  timemode je volba casu (date/time) pro cilove soubory. Jsou mozne 
  tyto hodnoty (texty):
    current    Okamzity cas v dobe nahrady.
    original   Puvodni cas zdrojoveho souboru. Default. 
  V command line muze byt pouzito na miste timemode i odpovidajici prvni 
  pismeno (c misto current, o misto original).


Podadresare
-----------
Nastaveni zda prevadet soubory v celem adresarovem stromu nebo jen ve
zdrojovem adresari. (Ma smysl pouze pokud source je adresar).
Cely strom  
  Command line:  /subdir+ nebo
                 /s+
  CPCONV.INI:    Subdirectories=yes
Pouze source adresar  
  Command line:  /subdir- nebo
                 /s-
  CPCONV.INI:    Subdirectories=no
Default je cely strom.


Extensions
----------
Nastaveni extensions jmen souboru, pro ktere se provede konverze. Ostatni
se zkopiruji.
Default je konverze pro vsechny soubory.
Pouzit extension
  Command line:  /ext:extension nebo
                 /e:extension 
  CPCONV.INI:    Extension#=extension  nebo
                 Extension#=extension,1
Nepouzit extension
  Command line:  /noext:extension nebo
                 /n:extension 
  CPCONV.INI:    Extension#=extension,0
extension je retezec obsahujici extension souboru (napr. HTML).
V CPCONV.INI je na miste # poradove cislo volby. Volby musi zacinat od 1
a mit vzestupna neprerusena cisla.
Voleb extensions muze byt az 50 a nejsou case sensitive. Jedina mozna
wildcard volba je "*" pro vsechny mozne extensions.
Priklad 1:
   Command line:  /ext:HTML /ext:htm /e:txt      nebo
   CPCONV.INI:    Extension1=HTML
                  Extension2=htm
                  Extension3=txt
     Konvertovat soubory *.HTML (tj. i *.html, *.Html apod.), *.HTM, *.TXT, 
     ostatni kopirovat.
Priklad 2:
   Command line:  /noext:gif
   CPCONV.INI:    Extension1=gif,0
     Konvertovat vsechny soubory mimo *.GIF (ty kopirovat). 


19.1.1996
Jiri Kvarda
kvarda@vc.cvut.cz