tofrodos
tofrodos(s)                                           tofrodos(s)



NAME
       tofrodos  -  Converts text files between DOS and Unix for-
       mats.

SYNOPSIS
       fromdos [ options ] [file...]
       todos [ options ] [file...]

DESCRIPTION
       DOS text files traditionally have carriage return and line
       feed  pairs  as  their  newline characters while Unix text
       files have the  line  feed  as  their  newline  character.
       fromdos  converts  text  files  from the DOS format to the
       Unix format, while todos converts text files from the Unix
       format to the DOS format.

       The  programs  accept  multiple filenames and wildcards as
       their arguments.  You may also use them  in  a  pipe.   If
       either program finds its input redirected, it will process
       stdin and place the output on stdout.

OPTIONS
       -a     Always convert. If converting  from  DOS  to  Unix,
              this  option  will  cause the program to remove ALL
              carriage returns. The default is to remove carriage
              returns  only  if  they are followed by line feeds.
              If converting from Unix to DOS,  this  option  will
              cause  the program to convert ALL linefeeds to car-
              riage return pairs. The default is to convert line-
              feeds  only  if they are not already preceeded by a
              carriage return.

       -b     Make a backup of original file. The  original  file
              is  renamed  with  the original filename and a .bak
              extension.

       -d     Convert from DOS to Unix. This forces  the  program
              to  convert  the file in a particular direction. By
              default,  if  the  program  is  named  fromdos   or
              dos2unix,  it will assume that the input file is in
              a DOS format and convert it to a  Unix  format.  If
              the  program  is  named  todos or unix2dos, it will
              assume that the input file is in a Unix format  and
              convert  it  to  a  DOS format. Using the -d option
              forces the program to convert from a DOS format  to
              a  Unix  format  regardless  of  how the program is
              named. Likewise, using the  -u  option  forces  the
              program to convert from a Unix format to a DOS for-
              mat regardless of the name of the program.

       -e     Abort processing on any error  in  any  file.  Nor-
              mally,  the program will simply skip to process the
              next file on the command line  when  it  encounters
              any  errors.  This  option  causes  it  to abort on
              errors.

       -f     Force: convert even if the file  is  not  writeable
              (read-only).  By default, if fromdos or todos finds
              that the file does not have  write  permission,  it
              will  not process that file. This option forces the
              conversion even if the file is read-only.

       -h     Display a short help screen on  the  program  usage
              and quit.

       -o     Overwrite  the  original  file (no backup). This is
              the default.

       -p     Preserve file ownership and time. On  systems  like
              Linux, the file ownership will only be preserved if
              the user is root, otherwise it will  just  set  the
              file time and silently fail the change of file own-
              ership. If you want a warning message when the file
              ownership cannot be changed, use -v.

       -u     Convert  from  DOS to Unix. See the -d option above
              for more information.

       -v     Verbose.

       -V     Show version message and quit.

AUTHOR
       The program and  its  documentation  are  copyrighted  (c)
       1996-1999  by  Christopher  S L Heng. All rights reserved.
       They are distributed under the terms of  the  GNU  General
       Public License Version 2.

       Email address
              chrisheng@bigfoot.com
              cyfheng@singnet.com.sg


       Primary site (Singapore)
              http://chrisheng.cjb.net/
              http://web.singnet.com.sg/~cslheng/


       Primary mirror (USA)
              http://chrisheng.hypermart.net/



1999                       Version 1.4                tofrodos(s)