home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / TEXT / UTILITY / TSFILT18.ZIP / TSFILT.INF < prev    next >
Encoding:
Text File  |  1991-10-18  |  13.2 KB  |  371 lines
  1. Fri 18-October-1991
  2.  
  3. About TSFILT in General
  4. =======================
  5.  
  6. This package may be used and distributed freely for NON-COMMERCIAL,
  7. NON-INSTITUTIONAL, PRIVATE purposes, provided it is not changed in
  8. any way. (Repacking with another method, such as pkzip, is ok,
  9. though.) For ANY other usage, such as use in a business enterprise
  10. or at a university, contact the author for registration. Uploading
  11. to bulletin boards is encouraged. Please do not distribute any part
  12. of this package separately.
  13.  
  14. The programs are under development. Comments and contacts are
  15. solicited. If you have any questions, please do not hesitate to use
  16. electronic mail for communication.
  17. InterNet address: ts@chyde.uwasa.fi         (preferred)
  18. Bitnet address:   SALMI@FINFUN.BITNET
  19. Funet address:    GADO::SALMI
  20.  
  21. The author shall not be liable to the user for any direct, indirect
  22. or consequential loss arising from the use of, or inability to use,
  23. any program or file howsoever caused. No warranty is given that the
  24. programs will work under all circumstances.
  25.  
  26. Timo Salmi
  27. Professor of Accounting and Business Finance
  28. School of Business Studies, University of Vaasa
  29. P.O.Box 297, SF-65101 Vaasa, Finland
  30.  
  31. CONTENTS:
  32.  
  33.   1. Summary
  34.   2. Program Abstracts
  35.   3. Release Notes (have been moved tsfilt.nws)
  36.  
  37.  
  38. 1. SUMMARY
  39.  
  40. Timo Salmi FILTer utilities, release 1.8 (TSFILT18) includes the
  41. *    *     ****                      * *
  42. following filter programs.
  43.  
  44. TSFILT18.ARC    Filters for textfiles by T.Salmi
  45. Filename        Comment
  46. --------        --------------------------------
  47. ASC2IBM.EXE     toasc.exe in filter format
  48. FLMARG.EXE      Filter for adding a left margin
  49. FLRMARG.EXE     Filter for a right margin
  50. FLSUBS.EXE      Filter for string substitution
  51. IBM2ASC.EXE     toibm.exe in filter format
  52. LOGFILT.EXE     Filters backspaces from logfiles
  53. PC2UNIX.EXE     PC text eolns to Unix eolns
  54. QUOTE.EXE       Quotes to messages
  55. TOASC.EXE       8bit ibm to Scandinavian 7 ascii
  56. TOASCI.EXE      8bit ibm to International 7ascii
  57. TOIBM.EXE       7 ascii to Scandinavian 8bit ibm
  58. TSFILT.INF      Document (a readme)
  59. TSFILT.NWS      News announcements about tsfilt
  60. TSPROG.INF      List of PD programs from T.Salmi
  61. U2PC.BAT        Change Unix eolns to MsDos eolns
  62. UNIX2PC.EXE     Unix text eolns to PC eolns
  63. UNIXTEST.TXT    For testing Unix -> PC eolns
  64. UNZIPTXT.BAT    Get text files from Unix zips
  65. VAASA.INF       Info: Finland, Vaasa, U of Vaasa
  66. ----            ------             ------  -----
  67. 0019
  68.  
  69.  
  70. 2. PROGRAM ABSTRACTS
  71.  
  72. ASC2IBM (Ver. 1.1)  (Appended to TSFILT package starting from TSFILT16.)
  73. ==================
  74.  
  75. ASC2IBM is a filter for changing 7-bit Scandinavian characters to
  76. their 8-bit equivalents.
  77.  
  78. E.g. if you have a text file UNIX.TXT, apply
  79. TYPE UNIX.TXT | ASC2IBM > PC.TXT
  80.    or
  81. ASC2IBM < UNIX.TXT
  82.    or
  83. ASC2IBM < UNIX.TXT > PC.TXT
  84.  
  85.  
  86. FLMARG (Ver. 1.2)   (Appended to TSFILT package starting from TSFILT13.)
  87. =================
  88.  
  89. FiLter: left MARGin
  90.                                                                               
  91. FLMARG is a true filter for inserting a left margin. E.g. if you
  92. have a source text file source.txt, and want have a left margin of 8
  93. characters wide, apply
  94. TYPE SOURCE.TXT | FLMARG 8
  95.       or
  96. FLMARG 8 < SOURCE.TXT                                                         
  97. This is filter is particularly useful when directing a file to the
  98. printer, e.g.
  99. TYPE SOURCE.TXT | FLMARG 8 > PRN
  100. Using a negative margin can be used to strip characters from the
  101. beginning of of the lines.
  102.  
  103.  
  104. FLRMARG (Ver. 1.1)  (Appended to TSFILT package starting from TSFILT14.)
  105. ==================
  106.  
  107. FiLter: Right MARGin
  108.  
  109. FLRMARG is a true filter for imposing a right margin on the output
  110. from a text file.
  111.  
  112. Usage: FLRMARG RightMarginPosition [PadCharAscii] [/p(ad)] [/w(rap)]
  113.  
  114. E.g. if you have a source text file source.txt, and want have a
  115. right margin at column 68 without padding and wrapping, apply
  116.      TYPE SOURCE.TXT | FLRMARG 68
  117.        or
  118.      FLRMARG 68 < SOURCE.TXT
  119. To direct the output to the printer with the right margin at 72,
  120. with wrapping, without padding, apply
  121.      TYPE SOURCE.TXT | FLRMARG 72 /w > PRN
  122.  
  123. If you use the padding /p option the default pad character is blank
  124. (ascii 32). You can change the pad character by giving its ascii
  125. value as the second parameter. If the /p switch is not on, a pad
  126. character value has no effect.
  127.  
  128. Advanced usage: You can combine FLRMARG and FLMARG to extract
  129. columns of text from a text file. E.g. for extracting the columns
  130. 3-10 from source.txt apply
  131.      TYPE SOURCE.TXT | FLRMARG 10 | FLMARG -2
  132.  
  133.  
  134. FLSUBS (Ver. 1.2)
  135. =================
  136.  
  137. FiLter: SUBStitution
  138.  
  139. FLSUBS is a true filter for substituting a string of a text file
  140. with another string. E.g. if you have a source text file source.txt
  141. and want to alter every occurrence of the word "home" to "domicile"
  142. apply
  143. TYPE SOURCE.TXT | FLSUBS home domicile
  144. or
  145. FLSUBS home domicile < SOURCE.TXT
  146. Also more complicated pipes are possible such as
  147. TYPE SOURCE.TXT | FLSUBS home domicile | FLSUBS pc PC | MORE
  148.  
  149. The other programs in this set are not true filters but command-like
  150. utilities for filtering text files.
  151.  
  152.  
  153. IBM2ASC (Ver. 1.1)  (Appended to TSFILT package starting from TSFILT16.)
  154. ==================
  155.  
  156. IBM2ASC is a filter for changing 8-bit Scandinavian characters to
  157. their 7-bit equivalents.
  158.  
  159. E.g. if you have a text file PC.TXT, apply
  160. TYPE PC.TXT | IBM2ASC > UNIX.TXT
  161.    or
  162. IBM2ASC < PC.TXT
  163.    or
  164. IBM2ASC < PC.TXT > UNIX.TXT
  165.  
  166.  
  167. LOGFILT (Ver. 1.3)
  168. ==================
  169.  
  170. LOG FILTer
  171.  
  172. Usage: LOGFILT <source file> <destination file> [/p] [/m] [/n]
  173. /p = pause, /m = more, /n = noise filter
  174.  
  175. or: LOGFILT ? for these instructions.
  176.  
  177. Performs an intelligent filtering of backspaces from a text file.
  178.  
  179. This program is needed e.g. if you use a communication program like
  180. Procomm Plus, and you want to capture your chat with the SysOp in a
  181. log file. If you make typing errors, and correct them, the
  182. backspaces you use will be included in your log file. Furthermore,
  183. there may be noise on the line flooding the log file with extra
  184. characters. - You can save in your phone bills by reading the
  185. messages in a BBS with fastscan and high speeds, and having a log
  186. open. Then filter the potential noise from your log with LOGFILT.
  187.                                                                              
  188. The /p, /m and /n parameters in the brackets [] are optional. If you
  189. are working with a single disk drive, /p allows to change the disk
  190. by pausing after you have loaded LOGFILT. If you direct output to
  191. the screen (that is to CON) the /m option causes pause at the end of
  192. each screen. The /n option performs a simple noise control by
  193. filtering the characters beyond ascii 125 (except äåöÄÅÖ) and below
  194. 32. Noise control also filters out some strings which usually are
  195. noise (at least on the author's configuration). These strings can be
  196. seen by entering LOGFILT ?
  197.  
  198.  
  199. PC2UNIX (Ver 1.1)  PC text eolns to Unix eolns
  200. =================
  201.  
  202. PC2UNIX is a true filter for changing PC end of lines (ascii 13, 10)
  203. to Unix end of lines (ascii 10). This kind of filter is useful if
  204. you transfer ascii data from a PC to a Unix machine.
  205.  
  206. E.g. if you have a text file pc.txt, apply
  207. TYPE PC.TXT | PC2UNIX > UNIX.TXT
  208.    or
  209. PC2UNIX < PC.TXT
  210.    or
  211. PC2UNIX < PC.TXT > UNIX.TXT
  212.  
  213. A test switch can be used for batch programming. PC2UNIX /t returns
  214. errorlevel==1 if the file looks like a non-text or non-MsDos-file.
  215. When the test switch is on, the conversion will not be made, that is
  216. no output will be produced.
  217.  
  218. Errorlevel==1 is also returned if the input is not redirected, or if
  219. the MsDos version is earlier than 2.0.
  220.  
  221.  
  222. QUOTE (Ver. 1.1)  Quotes to messages
  223. ================
  224.  
  225. Usage: QUOTE [QuoteString] [/a(ppend a > )] [/b(lank insert)] [/h(elp)]
  226.  
  227. QUOTE is a true filter for appending a quote string at the beginning
  228. of each line of input. Eg. if you have a message file MESS.TXT, and
  229. want it quoted, apply:
  230.   TYPE MESS.TXT | QUOTE sender > NEWMESS.TXT
  231.  
  232. You must choose your quote string. Eg. QUOTE ts /a < MESSAGE.TXT
  233. appends ts> at the beginning of each line.
  234.  
  235.  
  236. TOASC (Ver. 1.2)
  237. ================
  238.  
  239. 8-bit ibm TO scandinavian 7-bit ASCii
  240.  
  241. Usage: TOASC <source file> <destination file> [/p (pause)] [/m (more)]
  242.  
  243.    or: TOASC ? for these instructions
  244.  
  245. The program performs a Scandinavian conversion of 8-bit ibm ascii
  246. characters. It also converts the other 8-bit characters into their
  247. nearest counterparts in the 7-bit character set. TOASC is intended
  248. for text files only. The Scandinavian conversion is needed e.g. if
  249. you have pre-prepared a Finnish message with an editor, and want to
  250. upload your message into a bulletin board.
  251.  
  252. The /p and /m parameters in the brackets [] are optional. If you are
  253. working with a single disk drive, /p allows to change the disk by
  254. pausing after you have loaded TOASC. If you direct output to the
  255. screen (that is to CON), the /m option causes pause at the end of
  256. each screen.
  257.  
  258. The Scandinavian (or rather the Finnish) conversions are ä{ å} ö| Ä[ Å] Ö\
  259. The entire translation table is given below.
  260. Çc üu ée âa ä{ àa å} çc êe ëe èe ïi îi ìi Ä[ Å] ÉE æa ÆA ôo ö| òo ûu ùu ÿy
  261. Ö\ ÜU ¢c £L ¥y ₧P ƒf áa íi óo úu ñn ÑN ªa ºo ¿? ⌐+ ¬+ ½. ¼. ¡i «< »> ░# ▒#
  262. ▓# │! ┤+ ╡+ ╢+ ╖+ ╕+ ╣+ ║! ╗+ ╝+ ╜+ ╛+ ┐+ └+ ┴+ ┬+ ├+ ─- ┼+ ╞+ ╟+ ╚+ ╔+ ╩+
  263. ╦+ ╠+ ═- ╬+ ╧+ ╨+ ╤+ ╥+ ╙+ ╘+ ╒+ ╓+ ╫+ ╪+ ┘+ ┌+ █# ▄# ▌! ▐! ▀# αa ßb ΓG πp
  264. ΣS σs µm τt ΦF ΘT ΩO δd ∞@ φo εe ∩n ≡= ±+ ≥> ≤< ⌠( ⌡) ÷/ ≈= °o ∙. ·. √R ⁿn
  265. ²2 ■.
  266.  
  267.  
  268. TOASCI (Ver. 1.2)
  269. =================
  270.  
  271. 8-bit ibm TO 7-bit ASCii International
  272.  
  273. Usage: TOASCI <source file> <destination file> [/p (pause)] [/m (more)]
  274.  
  275.    or: TOASCI ? for these instructions
  276.                                                                             
  277. The program converts 8-bit ibm ascii characters into their nearest
  278. counterparts in the 7-bit character set. TOASCI is intended for text
  279. files only.
  280.                                                                             
  281. The /p and /m parameters in the brackets [] are optional. If you are
  282. working with a single disk drive, /p allows to change the disk by
  283. pausing after you have loaded TOASCI. If you direct output to the
  284. screen (that is to CON), the /m option causes pause at the end of
  285. each screen.
  286.  
  287. The entire translation table is given below.                                
  288. Çc üu ée âa äa àa åa çc êe ëe èe ïi îi ìi ÄA ÅA ÉE æa ÆA ôo öo òo ûu ùu ÿy  
  289. ÖO ÜU ¢c £L ¥y ₧P ƒf áa íi óo úu ñn ÑN ªa ºo ¿? ⌐+ ¬+ ½. ¼. ¡i «< »> ░# ▒#  
  290. ▓# │! ┤+ ╡+ ╢+ ╖+ ╕+ ╣+ ║! ╗+ ╝+ ╜+ ╛+ ┐+ └+ ┴+ ┬+ ├+ ─- ┼+ ╞+ ╟+ ╚+ ╔+ ╩+  
  291. ╦+ ╠+ ═- ╬+ ╧+ ╨+ ╤+ ╥+ ╙+ ╘+ ╒+ ╓+ ╫+ ╪+ ┘+ ┌+ █# ▄# ▌! ▐! ▀# αa ßb ΓG πp  
  292. ΣS σs µm τt ΦF ΘT ΩO δd ∞@ φo εe ∩n ≡= ±+ ≥> ≤< ⌠( ⌡) ÷/ ≈= °o ∙. ·. √R ⁿn  
  293. ²2 ■.                                                                       
  294.  
  295.  
  296. TOIBM (Ver. 1.4)
  297. ================
  298.  
  299. 7-ascii TO 8-bit IBM
  300.  
  301. Usage: TOIBM <source file> <destination file> [/p] [/m] [/v] [/c] [/o]
  302. /p = pause, /m = more, /v = VAX /c = caret, /o = control                    
  303.  
  304.    or: TOIBM ? for these instructions
  305.  
  306. The program performs a Scandinavian conversion of 7-bit ascii
  307. characters. It also can convert assorted VAX, caret, and control
  308. characters into their Scandinavian counterparts. VAX and caret
  309. translations were introduced in version 1.1.
  310.  
  311. TOIBM is intended for text files only.
  312.  
  313. The /p and /m parameters in the brackets [] are optional. If you are
  314. working with a single disk drive, /p allows to change the disk by
  315. pausing after you have loaded TOIBM. If you direct output to the
  316. screen (that is to CON), the /m option causes pause at the end of
  317. each screen.
  318.  
  319. The applied Scandinavian (or rather the Finnish) translation table is
  320. [Ä \Ö ]Å {ä |ö }å
  321. The /v option adds the following VAX character translations:
  322. <IND> ä, <SSA> å, <CCH> ö, <SS2> Ä, <SS3> Å, <X99> Ö,
  323. The /c option adds the following caret character translations:
  324. ^D ä, ^F å, ^T ö, ^N Ä, ^O Å, ^Y Ö,
  325. The /o option adds the following control character translations:
  326. ä å Ä Å ö Ö
  327.  
  328.  
  329. UNIX2PC (Ver. 1.1)  Unix text eolns to PC eolns
  330. ==================
  331.  
  332. UNIX2PC is a true filter for changing Unix end of lines (ascii 10)
  333. to PC end of lines (ascii 13, 10). This kind of filter is useful if
  334. you transfer ascii data from a Unix machine to a PC.
  335.  
  336. E.g. if you have a text file unix.txt, apply
  337. TYPE UNIX.TXT | UNIX2PC > PC.TXT
  338.    or
  339. UNIX2PC < UNIX.TXT
  340.    or
  341. UNIX2PC < UNIX.TXT > PC.TXT
  342.  
  343. A test switch can be used for batch programming. UNIX2PC /t returns
  344. errorlevel==1 if the file looks like a non-text file. When the test
  345. switch is on, the conversion will not be made, that is no output
  346. will be produced.
  347.  
  348. Errorlevel==1 is also returned if the input is not redirected, or if
  349. the MsDos version is earlier than 2.0.
  350.  
  351.  
  352. U2PC.BAT  Unix eolns to MsDos eolns, preserving the date/time stamp
  353. ========
  354.  
  355. The purpose of the U2PC batch is to convert the original Unix
  356. textfile into an MsDos textfile, and preserve the date/time stamp of
  357. the file in converting it.
  358.  
  359. To use U2PC you'll need at least MsDos version 3.30, TOUCH.EXE from
  360. my TSUTLB collection and UNIX2PC from this TSFILT collection.
  361.  
  362. No wildcards allowed.
  363.  
  364.  
  365. UNZIPTXT.BAT  Get text files from Unix zips
  366. ============
  367.  
  368. Unzips the files from a Unix Zip file and converts the unzipped text
  369. files into MsDos format using U2PC.BAT. Wildcards and path names
  370. allowed.
  371.