home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / xeol11.zip / XEOL.TXT
Text File  |  1995-04-13  |  3KB  |  88 lines
  1. XEOL v1.1 - Translate End-of-line Characters for DOS and OS/2
  2. =============================================================
  3. Copywrite (c) Paul Gallagher 1993,1995.
  4. The author grants general permission to distribute and use this package,
  5. provide it remains complete as detailed in section (1), is not modified
  6. in any way, and is not sold for more than a reasonable media and
  7. distribution charge.
  8.  
  9. Contents of this file:
  10.   1. Package
  11.   2. Version History
  12.   3. Contacting the author
  13.   4. System Requirements
  14.   5. About XEOL
  15.   6. Using XEOL
  16.  
  17. 1. Package
  18. ==========
  19.  
  20.   XEOL.TXT        = this file
  21.   DOS\XEOL.EXE    = DOS executable
  22.   OS2\XEOL.EXE    = OS/2 v2.x+ executable
  23.  
  24. 2. Version History
  25. ==================
  26.  
  27. 95.04.12 : v1.1 ignores NULL characters embedded in files. Previously,
  28.   XEOL would terminate file conversion when encountering NULL chars. 
  29.  
  30. 93.09.28 : v1.0 for DOS and OS/2. The OS/2 exe should run under NT,
  31.   but this hasn't been tested yet!
  32.  
  33. 3. Contacting the Author
  34. ========================
  35. Paul Gallagher:
  36. Contact me by mail at <paulpg@ibm.net>
  37.  
  38. 4. System Requirements
  39. ======================
  40. XEOL requires DOS v3.x or higher, or OS/2 v2.0 or higher.
  41.  
  42. 5. About XEOL
  43. =============
  44. XEOL performs end-of-line translation on text files. It can convert
  45. to/from any of the three popular end-of-line character streams:
  46.   mac     <CR>     = 0x0D
  47.   dos,os2 <CR><LF> = 0x0D,0x0A
  48.   unix    <LF>     = 0x0A
  49. XEOL operates as a command line filter. It converts a text stream appearing
  50. on the standard input handle, writing the converted lines to the standard
  51. output handle.
  52.  
  53. 6. Using XEOL
  54. =============
  55. {In the following discussion, the command XEOL has been used to represent the
  56. program. Substitute XEOL-DOS or XEOL-OS2 depending on your platform}
  57.  
  58. Getting help:     XEOL /?
  59.  
  60. Usage:
  61.        XEOL -ffmtstr -tfmtstr
  62.  
  63. where -f indicates format to translate from, and -t is
  64. the destination format, and fmtstr is one of the following:
  65.         mac          [uses <CR> = 0xD]
  66.         dos,os2      [uses <CR><LF> = 0xD,0xA]
  67.         unix         [uses <LF> = 0xA]
  68.  
  69. This is only 1/3 the story though; next you need to tell the program
  70. *what* to convert. There are 3 options:
  71.  
  72.   1. Use "redirection" Eg:
  73.      XEOL -fdos -tmac <test.txt
  74.   2. Use "pipes"
  75.      type test.txt | XEOL -fdos -tmac
  76.   3. Use default input (ie. keyboard)
  77.      XEOL -fdos -tmac
  78.  
  79. The last part of the story is to tell the program where to direct output.
  80. Again there are the same 3 options:
  81.  
  82.   1. Use "redirection" to save the output to a file Eg:
  83.      XEOL -fdos -tmac <test.txt >test.mac
  84.   2. Use "pipes" to direct output into another process (like sort) Eg:
  85.      type test.mac | XEOL -fmac -tdos | sort
  86.   3. Use default output (ie. console)
  87.      type test.mac | XEOL -fmac -tdos
  88.