unix2dos(1)                                                        unix2dos(1)



NAME
       unix2dos - UNIX to DOS text file format converter


SYNOPSYS
       unix2dos  [options] [-c convmode] [-o file ...] [-n infile outfile ...]

       Options:

       [-hkqLV] [--help] [--keepdate] [--quiet] [--license] [--version]


DESCRIPTION
       Unix2dos converts text files in UNIX format to DOS format.

       In DOS/Windows text files line endings exist out of  a  combination  of
       two  characters:  a  Carriage Return (CR) followed by a Line Feed (LF).
       In Unix text files line endings exists out of a single Newline  charac-
       ter which is equal to a DOS Line Feed (LF) character.


OPTIONS
       The following options are available:

       -h --help
              Print online help.


       -k --keepdate
              Keep the date stamp of output file same as input file.


       -q --quiet
              Quiet mode. Suppress all warning and messages.


       -L --license
              Print software license.


       -V --version
              Print version information.


       -c --convmode convmode
              Set  conversion mode. Where convmode is one of: ASCII, 7bit, ISO
              with ASCII being the default.


       -o --oldfile file ...
              Old file mode. Convert the file and write output to it. The pro-
              gram default to run in this mode. Wildcard names may be used.


       -n --newfile infile outfile ...
              New  file  mode. Convert the infile and write output to outfile.
              File names must be given in pairs and wildcard names should  NOT
              be used or you WILL lost your files.


CONVERSION MODES
       ASCII  In  this  mode  Unix line endings are converted to DOS line end-
              ings.

              Although the name of this mode is ASCII, which is a 7 bit  stan-
              dard, the actual mode is 8 bit.


       7bit   In  this  mode  Unix line endings are converted to DOS line end-
              ings.  All 8 bit non-ASCII characters (with values from  128  to
              255) are converted to a space.


       ISO    In  this  mode  Unix line endings are converted to DOS line end-
              ings.  The conversion of 8 bit non-ASCII characters (with values
              from 128 to 255) is unclear. Benjamin used this probably to con-
              vert between a character set he was using on SunOS in  1995  and
              DOS character set CP437. In this mode some characters are trans-
              lated from ISO-8859-1 (Latin1) to DOS code page CP437,  but  for
              several others it's not clear.

              The  ISO  conversion mode is kept for legacy reasons. To convert
              text files  between  different  encodings  it's  better  to  use
              unix2dos in combination with iconv(1). Some examples:

              Convert from Unix Latin-1 to DOSLatinUS

              iconv -f ISO-8859-1 -t CP437 in.txt | unix2dos > out.txt

              Convert from Unix Latin-1 to DOSLatin1

              iconv -f ISO-8859-1 -t CP850 in.txt | unix2dos > out.txt

              Convert from Unix Latin-1 to WinLatin1

              iconv -f ISO-8859-1 -t CP1252 in.txt | unix2dos > out.txt

              See also <http://czyborra.com/charsets/codepages.html>
              and <http://czyborra.com/charsets/iso8859.html>.


EXAMPLES
       Get input from stdin and write output to stdout.

              unix2dos


       Convert and replace a.txt. Convert and replace b.txt.

              unix2dos a.txt b.txt

              unix2dos -o a.txt b.txt


       Convert  and  replace  a.txt  in  ASCII  conversion  mode.  Convert and
       replace b.txt in 7bit conversion mode.

              unix2dos a.txt -c 7bit b.txt

              unix2dos -c ascii a.txt -c 7bit b.txt


       Convert and replace a.txt while keeping original date stamp.

              unix2dos -k a.txt

              unix2dos -k -o a.txt


       Convert a.txt and write to e.txt.

              unix2dos -n a.txt e.txt


       Convert a.txt and write to e.txt, keep date  stamp  of  e.txt  same  as
       a.txt.

              unix2dos -k -n a.txt e.txt


       Convert and replace a.txt. Convert b.txt and write to e.txt.

              unix2dos a.txt -n b.txt e.txt

              unix2dos -o a.txt -n b.txt e.txt


       Convert  c.txt  and write to e.txt. Convert and replace a.txt.  Convert
       and replace b.txt. Convert d.txt and write to f.txt.

              unix2dos -n c.txt e.txt -o a.txt b.txt -n d.txt f.txt


AUTHORS
       Benjamin Lin - <blin@socs.uts.edu.au>

       Erwin Waterlander - <waterlan@xs4all.nl>

       Project page: http://www.xs4all.nl/~waterlan/#DOS2UNIX

       SourceForge page: http://sourceforge.net/projects/dos2unix/

       Freshmeat: http://freshmeat.net/projects/dos2unix


SEE ALSO
       dos2unix(1) iconv(1)




2009                             unix2dos 4.0                      unix2dos(1)
