home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / p / pktxl31.zip / PKTXL.INF < prev    next >
Text File  |  1992-05-22  |  8KB  |  202 lines
  1.                       PKTXL - Packet Translater.
  2.                       ==========================
  3.  
  4.                    (c) 1990, 1991, 1992 Nils Hammar.
  5.  
  6.       This program is free to use by anyone in a non-commercial manner.
  7.            For commercial use, contact me before implementation.
  8.  
  9.             This program is used to change the character set in
  10.                    type 2 and type 2 compatible PKT-files.
  11.  
  12.      The program recognizes FSC-0050, FSC-0051 and FSC-0054 level 1 and 2.
  13.  
  14.  
  15. ***************************************************************************
  16. *              If you find use for this program, please                   *
  17. *             send a funny postcard to the address below.                 *
  18. ***************************************************************************
  19.  
  20.                                 General.
  21.                                 --------
  22.  
  23. The intention of this program is to limit the problems with several different
  24. character sets floating around. All those character sets floating around is
  25. due to the wish to use national characters together with the "[]{}\|"
  26. characters. Several countries have their own 7-bit character sets, but those
  27. are conflicting with the mentioned special characters that often is used
  28. in program listings.
  29.  
  30.  
  31.                              Character sets.
  32.                              ---------------
  33.  
  34. Current character sets are the following:
  35.  
  36. -1    Translation to the so called umlaut format, usually used in Germany.
  37. 0    Swedish 7-bit.
  38. 1    IBM PC 8-bit. (CodePage 437).
  39. 2    ISO 8859-1.
  40. 3    Mac 8-bit.
  41. 4    French 7-bit.
  42. 5    German 7-bit.
  43. 6    Brittish 7-bit (UK).
  44. 7    Danish 7-bit.
  45. 8    Italian 7-bit.
  46. 9    Spanish 7-bit.
  47. 10    Japanese 7-bit.
  48.  
  49. All translations are not complete, but the 3 first Will not give you any
  50. problems, since they are tested. The remaining tables are not guaranteed to
  51. work, but should work.
  52. The japanese character set is really only the Yen sign instead of a backslash.
  53. It isn't possible to supply this program with an user-defined character set,
  54. but if you send me information about what your characters are defined as, I
  55. will try to implement it.
  56.  
  57.  
  58.                                  History.
  59.                                  --------
  60.  
  61. From version 2.0 it is possible to convert from any of the known formats given
  62. by positive numbers to the german "umlaut" format, which converts a
  63. country-specific character to two international characters.
  64. Also conversion FROM FSC-0051.001 to any other character set is possible.
  65. Conversion to FSC-0051.001 i NOT supplied, and will not be unless FSC-0051
  66. is specified in a FTS-document.
  67.  
  68. Version 2.0 and earlier had a funny bug, which would convert soft CR into
  69. another character when converting from PC-8 to other 8-bit sets.
  70.  
  71. Version 2.1 did corrupt the subject line when translating to the german
  72. "umlaut" format. Now is the subject line not translated when translation
  73. is to or from a multi-byte standard.
  74.  
  75. Version 2.2 now recognizes the CHARSET kludges and makes translations
  76. according to them. The CHARSET kludge is then removed because it is no longer
  77. correct for the translated text. The program accepts multiple charset kludges
  78. for each text. If you select a from character set that is less than 0,
  79. the charset kludges are not recognized and removed.
  80. A new CHARSET kludge is added first in the text that describes which character
  81. set the text is using. The charset kludge is only added if the environment
  82. variable PKTXL is set with the option -KLUDGE.
  83. E.g. : "SET PKTXL=-KLUDGE"
  84.  
  85. Also implemented in version 2.0 is the posibility to kill quotes in text.
  86. This will reduce the size of the texts in the message database with about 20%.
  87.  
  88. Version 3.0 is a bug-fixed and upgraded version that now can handle
  89. FSC-0050, FSC-0051 and FSC-0054 level 1 & 2.
  90. The program is currently adding either a FSC-0050 or FSC-0054 kludge,
  91. depending on if the character set was defined in FSC-0054 or not.
  92. It's some kind of fall-back function.
  93. The quote erasing function was removed, and options allowing the user
  94. to remove Soft CR:s and LF:s from the messages was added.
  95. The environment variable PKTXL can now contain two more options.
  96. "-NOLF" and "-NOSOFT". All options can be combined like the following:
  97. SET PKTXL=-KLUDGE-NOLF-NOSOFT
  98. This will tell the program to add a new character set kludge and to
  99. remove all LF:s and Soft CR:s.
  100.  
  101. Version 3.1 is another leap forward that allows the user to set the
  102. various options on the command line instead of with the environment
  103. variable. However, the environment variable may still be used.
  104. The command line will also allow short forms of the options:
  105.  
  106. -K        Add CHRS or CHARSET kludges to the processed messages.
  107. -L        Remove the line feed character from all processed messages.
  108. -S        Remove all Soft CR:s from all processed messages.
  109.  
  110. This version is also possible to execute under OS/2.
  111. The screen output has been cleaned up a little to save the user from
  112. unnecessary information.
  113. Observe that even if you are running the program with the adding of
  114. kludges as well as removing of both Soft CR:s and LF:s, the total size
  115. wouldn't increase much. I have noted an increase in message size of
  116. 0.7 percent when converting around 1MB PKT-files.
  117.  
  118.                              Kludge parameters.
  119.                              ------------------
  120.  
  121. The first alternative in the left column of the following table is used
  122. when adding a kludge for the destination character set. The other
  123. alternatives are the various definitions that are recognized on an incoming
  124. message.
  125.  
  126. Kludge data that is accepted:
  127. No.      Id.
  128. --------------------
  129. 0        SWEDISH, ISO-11, FINNISH
  130. 1        IBMPC, CP437, IBM, PC-8
  131. 2        Latin-1, ISO 8859-1, ISO8859-1, ISO Latin-1, ISO-6, AMIGA
  132. 3        MAC
  133. 4        FRENCH, ISO-69
  134. 5        GERMAN, ISO-21
  135. 6        UK, BRITISH
  136. 7        NORWEG, DANISH
  137. 8        ITALIAN
  138. 9        SPANISH
  139. 10       JAPANESE
  140.  
  141. Specifying -1 as output character set selects the german
  142. "umlaut" format as output. The umlaut format has it's own charset identifier
  143. "UMLAUT", which is inserted in FSC-0050 format.
  144.  
  145.  
  146.                                 Operation.
  147.                                 ----------
  148.  
  149. This program does not modify the original files! New files are created.
  150. Observe that input and output file must not be in the same directory.
  151.  
  152. Syntax: PKTXL [<flags>] <origfiles> <newdir> <fromcharset> <tocharset>
  153.  
  154. E.g.: PKTXL C:\OUTPACKS\*.OUT D:\TMP 1 2
  155.  
  156. This example translates *.OUT-files (which has the same format as PKT-files)
  157. from IBM PC-8 (codepage 437) to ISO 8859-1. The result is stored in the
  158. directory D:\TMP. Any message containing a kludge indicating a character
  159. set different from PC-8 will be translated from that format instead.
  160.  
  161. The operation of the program is controlled partly via the environment
  162. variable "PKTXL". This variable can be set to the following values
  163. in any combination.
  164.  
  165. Value     Explanation
  166. --------------------------------------
  167. -KLUDGE   Add CHRS or CHARSET kludges to the processed messages.
  168. -NOLF     Remove the line feed character from all processed messages.
  169. -NOSOFT   Remove all Soft CR:s from all processed messages.
  170.  
  171. E.g: SET PKTXL=-NOSOFT -NOLF
  172.  
  173. This line will tell PKTXL to remove all Soft CR:s and Linefeed characters
  174. when processing the messages. This will reduce the size of the messages
  175.  
  176.                                   Misc.
  177.                                   -----
  178.  
  179. This program is simple and efficient to implement, and fits all systems
  180. that has possibility to toss, scan, pack and unpack separately.
  181.  
  182. This program can not handle packed files, they have to be unpacked first.
  183. Packing and unpacking may be performed by the program PKTSecure.
  184.  
  185. If you recompile the program, please use memory model LARGE, otherwise
  186. you might get unpredictable effects. The stack will probably also need to
  187. be adjusted to avoid suspicious effects. I am using a stack of 0x3000,
  188. but this is probably overkill.
  189.  
  190. You will use this program on your own risk, I am not responsible for any
  191. trouble that the use of this program causes.
  192.  
  193. Any ideas regarding this program may be sent to:
  194. Nils Hammar  2:204/90@fidonet
  195. or internet address: 4341@msg.abc.se
  196.  
  197. or Snail Mail:
  198. Nils Hammar
  199. Storstigen 35B
  200. S-951 39 LULEÅ
  201. SWEDEN
  202.