home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / dc054c.zip / DC_eng.TXT < prev    next >
Text File  |  1999-01-20  |  8KB  |  214 lines
  1. /* <=====  DC.TXT  =====> */
  2.  
  3. DC
  4. Universal Russian codepage DeCoder v 0.54c
  5. (c)Evgeny Kotsuba, 1997-1999
  6.  
  7. --------------------------------------------
  8. Licence.
  9.  
  10. This software is shareware.
  11. You can use it for free for education and evaluation purposes only.
  12. For any use for commercial, corporative or government purposes you 
  13. should register your copy of DC or delete it from your computer(s).
  14.  
  15. You cannot delete author information; you cannot change exe file, 
  16. do reverse engineering, etc.
  17.  
  18.  
  19. Operation systems:
  20. * OS/2 ver 3,4,5; DOS+DOS4GW, FreeBSD, Win9x/NT 
  21. * Supported russian codepages:
  22.         Dos,Koi8-R,Win,Mac,Iso,Quoted,Translit,Volapyuk,HTML,Dos-Fido
  23. * special decoding modes:
  24.         "psevdographics -> DOS", "Win + Special characters -> Win"
  25.  
  26. * Supported text modes:  Dos, Unix
  27. * Decode modes:
  28.   - precise coding from one to another codepage.
  29.   - Autodecoding with search for appropriate c decoding sequence.
  30.   - Autodecoding "Last Chance" with codepage construction.
  31. * Working mode: only from file to file, one file - one codepage.
  32. * Memory requirement:
  33.     no less than 128K + file size * 2
  34.  
  35. =============================================================================
  36. Usage.
  37.  
  38. In short.
  39.  
  40. To decode file f.txt
  41.    to CP866 (DOS & OS/2) :        dc.exe ?D f.txt fdos.txt
  42.    from  CP866 to CP1251(Widows): dc.exe DW f.txt fwin.txt
  43.  
  44. ------------------------------------------------------
  45. In brief.
  46.  
  47. Usage.: dc.exe [-][mode] FileFrom [FileTo] [-debug]
  48. mode: CodepageFrom+CodepageTo+[Unix text mode][-]
  49.  
  50. Codepage:  D(os)|K(oi8)|W(in)|M(ac)|I(so)|
  51.            Q(uoted)|T(ranslit)|V(olapyuk)|H(TML)|F(ido)
  52.  
  53. CodepageFrom: Codepage|?|!
  54. CodepageTo:   Codepage
  55.  
  56. Text mode: U(nix)|D(os) (default)
  57. Reverse decoding is defined for unary U,D,Q,T,H,F (say, U-)
  58.  
  59. FileFrom - input file name
  60. FileTo   - output file name, when omitted then FileTo = FileFrom
  61.  
  62. debug -  debug option for usage with auto decoding
  63. ----------------------
  64. If mode is omitted,than default from DC.INI is used.
  65.  
  66. DC.INI define 7 codepages, you can change it or write your own
  67.  
  68. ----------------------
  69.  
  70. Dos  -> Koi8-R:                  dc.exe DK  textDos.txt   TextKoi.txt
  71. Dos  -> Koi8-R + Unix text mode: dc.exe DKU textDos.txt   TextKoi.txt
  72. Koi8 -> Dos + Dos text mode:     dc.exe KD  textDos.txt   TextKoi.txt
  73.  
  74. Win -> Koi8 and Unix text mode: dc.exe WKU textWin.txt   TextKoi.txt
  75. Unknown -> Dos:                 dc.exe ?D  text.txt      TextDos.txt
  76. Test for coding:                dc.exe ?   text.txt
  77. Unknown, "Last Chance" -> Dos:  dc.exe *D  text.txt      TextDos.txt
  78.  
  79. Default decoding:               dc.exe     text.txt      TextDef.txt
  80. Default decoding ó Γ«Γ ªÑ Σá⌐½: dc.exe     text.txt
  81.  
  82. To Unix text mode:              dc.exe U   text.txt
  83.                or:              dc.exe D-  text.txt
  84. To DOS  text mode:              dc.exe D   textUnix.txt  TextDos.txt
  85.                or:              dc.exe U-  textUnix.txt  TextDos.txt
  86.  
  87.            Quoted-printable:
  88. From Quoted:                    dc.exe Q   TextQuot.txt  text.txt
  89. To   Quoted:                    dc.exe Q-  text.txt      TextQuot.txt
  90.  
  91.            Transliteration:
  92. KOI8-R -> Translit:             dc.exe T   TextKoi.txt   textTrans.txt
  93. Translit -> KOI8-R:             dc.exe T-  textTrans.txt TextKoi.txt
  94.  
  95.            Volapyuk:
  96. KOI8-R -> Volapyuk:             dc.exe V   TextVolap.txt textKOI.txt
  97. Volapyuk -> KOI8-R:             dc.exe V   TextVolap.txt textKOI.txt
  98. DOS -> Volapyuk:                dc.exe DV  TextDos.txt   textVolap.txt
  99. Volapyuk ->DOS :                dc.exe VD  textVolap.txt TextDos.txt
  100.  
  101.            Dos-Fido:
  102. Fido -> Dos:                    dc.exe F   textFido.txt  TextDos.txt
  103. Fido -> Dos:                    dc.exe FD  textFido.txt  TextDos.txt
  104. Dos  -> Fido:                   dc.exe F-  TextDos.txt   textFido.txt
  105.  
  106.              HTML:
  107. Normal  -> HTML:                dc.exe H   Text.txt      textHTML.txt
  108. HTML    -> Normal:              dc.exe H-  textHTML.txt  Text.txt
  109.  
  110.  
  111. Output to screan (console) (OS/2, Win9x/NT, FreeBSD): 
  112.                                 dc.exe ?D  text.txt     con
  113.  
  114.    Special coding modes (realise with DC.INI):
  115. psevdographics CP866 to '+','|','-':    DC  AD  Text.txt 
  116.  
  117. Special characters of Windows (upper and lower commas, etc.)
  118. to Dos characters(realise with DC.INI):
  119.  
  120.  DC SW text.txt
  121. ----------------------------------------------------------------
  122. 1.2 FreeBSD
  123.  
  124. In FreeBSD and Co there is some probem with using options with "?" , etc.
  125. for DC and csh, sh , etc.
  126. Use commas as:
  127. DC "?K" intext outext
  128.  
  129. There is one more problem with application dc (digital calculator) 
  130. use DC for DeCoder and dc for calculator.
  131.  
  132. 1.3 Win9x/NT - for better perfomance use normal commanders as FC or Far.
  133.  
  134.  
  135. =============================================================================
  136.  
  137. 2. How much russian's codepage(s) is ?
  138. --------------------------------------
  139.  
  140. D(os)    Usial Dos codepage (CP866), also sometimes called "Alternave"
  141. F(ido)   is CP866 with change of russian characters 'H' and 'p' to 
  142.          latin.
  143. Alternave - original alternative coding (CP855),
  144.  
  145. K(oi8)   used on unix system and throwout the Net (CP-878) Was registered
  146.          by A.Chernov as KOI8-R in (RFC 1489).
  147.  
  148. W(in)    Suxx codepage for Windows(CP1251), was invented by Microsoft/rus
  149.          and joint venture "Paragraf" for Dos incompatibility.
  150.          Humor is that in russian Windos CP1251 is used simultaneous with
  151.          CP866.
  152. M(ac)    Codepage for russian MAC (CP10007). Upper case is from CP866, 
  153.          lower case - from CP1251.
  154.  
  155. I(so)    Iso 8859-5. Strange codepage from standart committee, also
  156.          called as GOST. 
  157.  
  158. Q(uoted) quoted-printable. It is not codepage at all, but regullary climbs out
  159.           various windows (=A0=A1=A2) It is  intrigues of imperializm and
  160.           defined in RFC 1521.
  161.  
  162.  
  163. 7(bit)   Koi8 without bit 8. This is why KOI8 was invented - russian text
  164.          can be readable only on 7bit systems.
  165.  
  166. T(ranslit)  right transliteration can use 2-3 english characters for one
  167.          russian. Is almost the same as  Volapyuk but it has no way to 
  168.          code change russian/english
  169.  
  170. V(olapyuk) it is transliteration with coding of russain/english changes
  171.          via using  <r> and <l> .
  172.  
  173.  
  174. H(TML) - coding for russain characters from english HTML editors.
  175.         (ÀÁ€). 
  176.  
  177. deBill  codepage is codepage for abuse to Billy's mother. It is construsted
  178.         only from question marks for upper 128 characters.
  179.         ( ?????? ???? Windows.)
  180.  
  181. There was also "old gost"/"Osnovna'a", "bolgarian", "BESM-6", "DVK/PDP"
  182. coding...
  183. -----------------------------------------------------------------------------
  184. The simplest way to install russian codepage in pure DOS or fullscrean
  185. Dos session in OS/2 or MS Windows is to use KEYRUS by great russian
  186. programmer Dm.Gurtiak, you can find it at http://www.softpanorama.org
  187. =============================================================================
  188. Some important info:
  189. use DC.INI as binary file, 
  190. you can change it only with pure text ASCII editors.  
  191. =============================================================================
  192.  
  193. OS/2 users and developers can use DCPACK
  194. http://g23.relcom.ru/g23/9749/dc/dcpack.zip 
  195.  
  196.  DCPACK
  197.  
  198.  o Universal Russian codepage DeCoder v0.54 
  199.  o Clipboard Coder v0.06  (old name -  Pmclico)
  200.  o Clipboard Coder for lazy v0.01 
  201.  o REXX extention library rxDCplus v0.01 
  202.  o Developer Kit DCdll v0.54 
  203.  o Developer Kit DCplus v0.01 
  204. ----------------------------------------------
  205. ==============================================
  206. DC homepage   http://g23.relcom.ru/g23/9749/DC
  207. Author E-mail: laser.nictl@g23.relcom.ru
  208.  
  209.  
  210. Evgeny Kotsuba,
  211. S&R Laser Center,  Shatura, Russia
  212. http://g23.relcom.ru/g23/9749
  213.  
  214.