home *** CD-ROM | disk | FTP | other *** search
/ Tools en Utilities / CDASS_5.ISO / shell / file / doscvt24.arj / README.TXT < prev   
Encoding:
Text File  |  1993-03-06  |  2.7 KB  |  74 lines
  1. DOSCVT is a small program to convert text files back and forth between
  2. UNIX(tm) and DOS formats with the following command syntax:
  3.  
  4.   usage: doscvt [-u | -d ] [-v] [-z] [ <filename> ]
  5.             -u   :  convert <filename> to unix format
  6.             -d   :  convert <filename> to DOS format
  7.             -v   :  display the program version and exit
  8.             -z   :  append a CTRL-Z to the converted file
  9.  
  10. It defaults to -d on dos systems and -u on unix systems.
  11.  
  12. DOSCVT, in unix mode, converts <CR><LF> pairs to just <LF> and removes
  13. any trailing ^Z EOF marker.  It looks for <CR><LF> pairs rather than
  14. merely removing <CR> characters to avoid corrupting files that use
  15. <CR> to do character overstrike (such as BOLD).  DOSCVT also converts
  16. Unix format to MS-DOS format by adding <CR> before <LF> and,
  17. optionally, adding ^Z at the end.
  18.  
  19. When converting files, DOSCVT converts the specified file into a temp
  20. file and, when finished, deletes the original file and renames the
  21. temp to the original file name.  If there was an error writing the
  22. temp file, the conversion is aborted, and the input file is left
  23. intact.
  24.  
  25. The accessed and modified times of the original are preserved.
  26.  
  27. Multiple filenames may be specified and each will be converted
  28. in turn.  If no filename is specified, stdin will be converted
  29. and written to stdout.
  30.  
  31. DOSCVT is designed so that the same C source file can be compiled
  32. to run on wither DOS or UNIX systems.  I have compiled it with
  33. Microsoft C V5.1 and MODCOMP GLS C B.2.  I tried to stay with the
  34. ANSI spec but timestamps fell outside of this standard.  They do,
  35. however, seem to work the same on DOS and UNIX systems.
  36.  
  37. History:
  38.     2.0    First public release
  39.  
  40.     2.1    Removed debugging printf of tempfile name
  41.  
  42.     2.2    Changed file opens to "binary" mode.  This
  43.         gave the program control over what went into
  44.         the file.
  45.  
  46.     2.3    Added code to change the mode of STDIN and STDOUT
  47.         to O_BINARY, allowing DOSCVT to work as a filter
  48.         in a pipeline under MSDOS.
  49.  
  50.     2.4    Use a fixed tempfile name under MSDOS since the
  51.         "tempnam" function seems to ignore the directory
  52.         hint given in the first parameter if the environment
  53.         variable TMP is set and returns a filename including
  54.         the path specified in TMP.  If TMP pointed at another
  55.         device, the rename operation failed.
  56.         Thanks to Peter Herweijer for noticing this.
  57.  
  58.  
  59. DOSCVT is freeware.  You may do what you like with DOSCVT except
  60. remove my name from it.
  61.  
  62. I do NOT warrant DOSCVT to be suitable for any purpose at all,
  63. particularly your purpose.
  64.  
  65. UNIX is a trademark of AT&T.
  66.  
  67. DOSCVT is brought to you by:
  68.  
  69.     Norm Brake
  70.     Modular Computer Systems, Inc.
  71.       internet:   norm@modcomp.com
  72.       snailmail:  PO Box 6099
  73.                       Ft Lauderdale, FL 33340-6099
  74.