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.

       Unix2dos  has  a  few  conversion  modes  similar  to  unix2dos   under
       SunOS/Solaris.

       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:

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


       -h --help
              Print online help.


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


       -L --license
              Print software license.


       -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 lose your files.


       -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.


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


       -V --version
              Print version information.


CONVERSION MODES
       Conversion modes ASCII , 7bit  ,  and  ISO  are  similar  to  those  of
       unix2dos under SunOS/Solaris.


       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.   Characters  are  converted  from   ISO   character   set
              ISO-8859-1  to  DOS  character set (code page) CP437. ISO-8859-1
              characters without CP437 equivalent, for which conversion is not
              possible, are converted to a wrong, but unique, CP437 character.
              This means that if the converted file is converted back to  Unix
              with dos2unix(1) in ISO mode, you get exactly the same file back
              as the original.  So you can convert forth and back without loss
              of  original  text.  The  down side is that you may find strange
              characters in the converted file. CP437 is mainly  used  in  the
              USA. In Western Europe CP850 is more standard.

              Another option to convert text files between different encodings
              is to use unix2dos in combination with iconv(1). Iconv can  con-
              vert between a long list of character encodings. Some examples:

              Convert from Unix Latin-1 to DOS DOSLatinUS

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

              Convert from Unix Latin-1 to DOS DOSLatin1

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

              Convert from Unix Latin-1 to Windows WinLatin1

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

              Convert from Unix UTF-8 (Unicode) to Windows WinLatin1

              iconv -f UTF-8 -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.1                     unix2dos(1)
