home *** CD-ROM | disk | FTP | other *** search
/ Mega Top 1 / os2_top1.zip / os2_top1 / APPS / TEKST / TEXWARE / EMTEX / DOC / ENGLISH / MAKETCP.DOC next >
Text File  |  1992-11-27  |  6KB  |  143 lines
  1. ==============================================================================
  2. MAKETCP.DOC for maketcp 1.1c                              VERSION: 27-Nov-1992
  3. ==============================================================================
  4.  
  5. ******************************************************************************
  6. ******************************************************************************
  7. **                                                                          **
  8. **      maketcp 1.1c IS A BETA TEST RELEASE for emTeX 3.14 [3c-beta5]       **
  9. **                                                                          **
  10. ******************************************************************************
  11. ******************************************************************************
  12.  
  13. maketcp generates (or decodes) TCP files (TeX code page).  These files are
  14. used by emTeX (and TeXconv) for code page conversion as well as to convert
  15. special input characters into TeX commands.  By using TCP files, emTeX can
  16. be adapted to different code pages.  Note that your texts may not be usable
  17. with other TeX implementations if you're using TCP files.  texconv can be
  18. used for converting your input files for use with other TeX implementations.
  19.  
  20.  
  21. Usage:
  22.  
  23.     maketcp <mode> [<options>] [<input_file> [<output_file>]]
  24.  
  25.  
  26. Mode:
  27.  
  28.    -c  Convert a text file into a TCP file (generate a TCP file;
  29.        compile)
  30.  
  31.    -d  Convert a TCP file into a text file (decompile).
  32.  
  33.  
  34. Options:
  35.  
  36.    -8  Set up a conversion table which leaves the characters with codes 128
  37.        to 255 unchanged (without -8, the codes from 128 to 255 are mapped to
  38.        code 127)
  39.  
  40.    -r  Set up a conversion table which leaves the characters with codes 0
  41.        to 31 unchanged (without -r, codes 0 to 31 are mapped to code 127)
  42.  
  43.  
  44. The default extension for TCP files is .tcp (with the option -c this applies
  45. to the output file, with -d the input file).
  46.  
  47. A TCP file contains three tables: the first shows which special characters are
  48. to be converted into TeX control sequences; the second converts the characters
  49. in the input file into the internal TeX characters and the third performs the
  50. reverse of this.
  51.  
  52. When no TCP file is used with emTeX, only the characters with codes 0, 9, 12
  53. and 32 to 126 are permitted.  When the /r option is given, characters in the
  54. range 0 through 31 are also allowed.  With the /8 option (only with INITEX)
  55. characters in the range 128 through 255 are permitted as well.  No conversion
  56. takes place.
  57.  
  58. This behaviour can be altered by using a TCP file.  Characters in the range
  59. 128 through 255 can be converted into TeX control sequences; in addition, the
  60. conversion of all characters for input and output can be changed - this is
  61. necessary when TeX's character coding does not correspond to the code page in
  62. use.  This should only be done for the characters above 128 as otherwise
  63. unexpected effects will be caused.  Conversion for output will only affect
  64. the LOG file, not the DVI file.
  65.  
  66. To create a TCP file you must make a text file in which both the translation
  67. of special characters into TeX control sequences and the character conversion
  68. for input and output is given.  You can get an example of the format of the
  69. file by converting the TCP file supplied (850_tex.tcp) into the equivalent
  70. text file with the command
  71.  
  72.     maketcp -d 850_tex.tcp example.txt
  73.  
  74. The text file can contain comments which are lines with a `%' in column 1:
  75. you can also make your file more readable by inserting blank lines, which
  76. are ignored.  All other lines are either special character conversions or
  77. input to internal character conversions - the output character conversion
  78. table is constructed from the input table.  Characters to be converted can be
  79. entered either as is (a single character) or in hexadecimal, in the TeX 3.0
  80. format (^^ff).  The translation of a special character is entered as follows:
  81.  
  82.     ^^84 -> \"a     % Umlaut-a
  83.  
  84. The line begins with the special character (Umlaut-a), followed by a space,
  85. an arrow (hyphen and greater than character), space and then the TeX control
  86. sequence which is to replace the character.  The `%' and the text following
  87. it up to the end of the line will be ignored unless it is part of the TeX
  88. command - in the following, ONE space will not be ignored:
  89.  
  90.     ^^fe -> \%\     % Tex control sequence: "\%\ "
  91.  
  92. The conversion of an input character into an internal code (and an internal
  93. code into an output character) is entered as follows:
  94.  
  95.     ^^84 ^^e4               % Umlaut-a (PC) -> Umlaut-a (ISO 8859/1)
  96.  
  97. The line begins with the input character followed by a space and the desired
  98. internal representation (as coded in the TFM file).  When the character ^^e4
  99. is to be output, it will be converted into ^^84 (in this example).  If more
  100. than one character is mapped into the same internal character then the last
  101. conversion will be used for output:
  102.  
  103.     a b
  104.     b b
  105.  
  106. In this pointless (but simple) example, both a and b are mapped on to the
  107. same internal character: by the rule above, b will be converted into b on
  108. output.  This feature is important if you want to map extended characters to
  109. ASCII characters.  You should use
  110.  
  111.     ^^af z
  112.     z z
  113.  
  114. to translate ^^af to z and to make z display z.  If you're using only
  115.  
  116.     ^^af z
  117.  
  118. then ^^: will be displayed for z.  (Moreover, a z in a file name would be
  119. converted into ^^: causing grief when opening the file!)
  120.  
  121. The default conversion tables are changed by such a text file: these
  122. conversion tables are set up by the -8 and -r options (see above) - in some
  123. circumstances, you may save yourself some work by using the -8 and/or -r
  124. options.  When you convert a TCP file into a text file, the output shows only
  125. the differences from the default tables set up by the -8 and -r options: the
  126. text file output will therefore depend on the settings of these options.
  127.  
  128.  
  129. History
  130. =======
  131.  
  132. Version 1.1c (27-Nov-1992)
  133. --------------------------
  134.  
  135. - Bug fixed.  That bug caused emTeX displaying a character entered in
  136.   ^^ff format to be displayed as character without conversion if there
  137.   is no conversion from an external character to that character.  Now,
  138.   those characters are displayed in ^^ff format.
  139.  
  140. - Support of HPFS filenames under OS/2
  141.  
  142.                   -------- End of MAKETCP.DOC -------------
  143.