man/man1/dos2unix.htm

   1 <?xml version="1.0" ?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml">
   4 <head>
   5 <title>dos2unix 7.1 - DOS/MAC to UNIX and vice versa text file format converter</title>
   6 <meta http-equiv="content-type" content="text/html; charset=utf-8" />
   7 <link rev="made" href="mailto:root@localhost" />
   8 </head>
   9
  10 <body style="background-color: white">
  11
  12
  13
  14 <ul id="index">
  15   <li><a href="#NAME">NAME</a></li>
  16   <li><a href="#SYNOPSIS">SYNOPSIS</a></li>
  17   <li><a href="#DESCRIPTION">DESCRIPTION</a></li>
  18   <li><a href="#OPTIONS">OPTIONS</a></li>
  19   <li><a href="#MAC-MODE">MAC MODE</a></li>
  20   <li><a href="#CONVERSION-MODES">CONVERSION MODES</a></li>
  21   <li><a href="#UNICODE">UNICODE</a>
  22     <ul>
  23       <li><a href="#Encodings">Encodings</a></li>
  24       <li><a href="#Conversion">Conversion</a></li>
  25       <li><a href="#Byte-Order-Mark">Byte Order Mark</a></li>
  26       <li><a href="#Unicode-examples">Unicode examples</a></li>
  27     </ul>
  28   </li>
  29   <li><a href="#EXAMPLES">EXAMPLES</a></li>
  30   <li><a href="#RECURSIVE-CONVERSION">RECURSIVE CONVERSION</a></li>
  31   <li><a href="#LOCALIZATION">LOCALIZATION</a></li>
  32   <li><a href="#RETURN-VALUE">RETURN VALUE</a></li>
  33   <li><a href="#STANDARDS">STANDARDS</a></li>
  34   <li><a href="#AUTHORS">AUTHORS</a></li>
  35   <li><a href="#SEE-ALSO">SEE ALSO</a></li>
  36 </ul>
  37
  38 <h1 id="NAME">NAME</h1>
  39
  40 <p>dos2unix - DOS/Mac to Unix and vice versa text file format converter</p>
  41
  42 <h1 id="SYNOPSIS">SYNOPSIS</h1>
  43
  44 <pre><code>    dos2unix [options] [FILE ...] [-n INFILE OUTFILE ...]
  45     unix2dos [options] [FILE ...] [-n INFILE OUTFILE ...]</code></pre>
  46
  47 <h1 id="DESCRIPTION">DESCRIPTION</h1>
  48
  49 <p>The Dos2unix package includes utilities <code>dos2unix</code> and <code>unix2dos</code> to convert plain text files in DOS or Mac format to Unix format and vice versa.</p>
  50
  51 <p>In DOS/Windows text files a line break, also known as newline, is a combination of two characters: a Carriage Return (CR) followed by a Line Feed (LF). In Unix text files a line break is a single character: the Line Feed (LF). In Mac text files, prior to Mac OS X, a line break was single Carriage Return (CR) character. Nowadays Mac OS uses Unix style (LF) line breaks.</p>
  52
  53 <p>Besides line breaks Dos2unix can also convert the encoding of files. A few DOS code pages can be converted to Unix Latin-1. And Windows Unicode (UTF-16) files can be converted to Unix Unicode (UTF-8) files.</p>
  54
  55 <p>Binary files are automatically skipped, unless conversion is forced.</p>
  56
  57 <p>Non-regular files, such as directories and FIFOs, are automatically skipped.</p>
  58
  59 <p>Symbolic links and their targets are by default kept untouched. Symbolic links can optionally be replaced, or the output can be written to the symbolic link target. Writing to a symbolic link target is not supported on Windows.</p>
  60
  61 <p>Dos2unix was modelled after dos2unix under SunOS/Solaris. There is one important difference with the original SunOS/Solaris version. This version does by default in-place conversion (old file mode), while the original SunOS/Solaris version only supports paired conversion (new file mode). See also options <code>-o</code> and <code>-n</code>.</p>
  62
  63 <h1 id="OPTIONS">OPTIONS</h1>
  64
  65 <dl>
  66
  67 <dt id="pod"><b>--</b></dt>
  68 <dd>
  69
  70 <p>Treat all following options as file names. Use this option if you want to convert files whose names start with a dash. For instance to convert a file named &quot;-foo&quot;, you can use this command:</p>
  71
  72 <pre><code>    dos2unix -- -foo</code></pre>
  73
  74 <p>Or in new file mode:</p>
  75
  76 <pre><code>    dos2unix -n -- -foo out.txt</code></pre>
  77
  78 </dd>
  79 <dt id="ascii"><b>-ascii</b></dt>
  80 <dd>
  81
  82 <p>Convert only line breaks. This is the default conversion mode.</p>
  83
  84 </dd>
  85 <dt id="iso"><b>-iso</b></dt>
  86 <dd>
  87
  88 <p>Conversion between DOS and ISO-8859-1 character set. See also section CONVERSION MODES.</p>
  89
  90 </dd>
  91 <dt id="pod-1252"><b>-1252</b></dt>
  92 <dd>
  93
  94 <p>Use Windows code page 1252 (Western European).</p>
  95
  96 </dd>
  97 <dt id="pod-437"><b>-437</b></dt>
  98 <dd>
  99
 100 <p>Use DOS code page 437 (US). This is the default code page used for ISO conversion.</p>
 101
 102 </dd>
 103 <dt id="pod-850"><b>-850</b></dt>
 104 <dd>
 105
 106 <p>Use DOS code page 850 (Western European).</p>
 107
 108 </dd>
 109 <dt id="pod-860"><b>-860</b></dt>
 110 <dd>
 111
 112 <p>Use DOS code page 860 (Portuguese).</p>
 113
 114 </dd>
 115 <dt id="pod-863"><b>-863</b></dt>
 116 <dd>
 117
 118 <p>Use DOS code page 863 (French Canadian).</p>
 119
 120 </dd>
 121 <dt id="pod-865"><b>-865</b></dt>
 122 <dd>
 123
 124 <p>Use DOS code page 865 (Nordic).</p>
 125
 126 </dd>
 127 <dt id="pod-7"><b>-7</b></dt>
 128 <dd>
 129
 130 <p>Convert 8 bit characters to 7 bit space.</p>
 131
 132 </dd>
 133 <dt id="b---keep-bom"><b>-b, --keep-bom</b></dt>
 134 <dd>
 135
 136 <p>Keep Byte Order Mark (BOM). When the input file has a BOM, write a BOM in the output file. This is the default behavior when converting to DOS line breaks. See also option <code>-r</code>.</p>
 137
 138 </dd>
 139 <dt id="c---convmode-CONVMODE"><b>-c, --convmode CONVMODE</b></dt>
 140 <dd>
 141
 142 <p>Set conversion mode. Where CONVMODE is one of: <i>ascii</i>, <i>7bit</i>, <i>iso</i>, <i>mac</i> with ascii being the default.</p>
 143
 144 </dd>
 145 <dt id="f---force"><b>-f, --force</b></dt>
 146 <dd>
 147
 148 <p>Force conversion of binary files.</p>
 149
 150 </dd>
 151 <dt id="h---help"><b>-h, --help</b></dt>
 152 <dd>
 153
 154 <p>Display help and exit.</p>
 155
 156 </dd>
 157 <dt id="i-FLAGS---info-FLAGS-FILE"><b>-i[FLAGS], --info[=FLAGS] FILE ...</b></dt>
 158 <dd>
 159
 160 <p>Display file information. No conversion is done.</p>
 161
 162 <p>The following information is printed, in this order: number of DOS line breaks, number of Unix line breaks, number of Mac line breaks, byte order mark, text or binary, file name.</p>
 163
 164 <p>Example output:</p>
 165
 166 <pre><code>     6       0       0  no_bom    text    dos.txt
 167      0       6       0  no_bom    text    unix.txt
 168      0       0       6  no_bom    text    mac.txt
 169      6       6       6  no_bom    text    mixed.txt
 170     50       0       0  UTF-16LE  text    utf16le.txt
 171      0      50       0  no_bom    text    utf8unix.txt
 172     50       0       0  UTF-8     text    utf8dos.txt
 173      2     418     219  no_bom    binary  dos2unix.exe</code></pre>
 174
 175 <p>Optionally extra flags can be set to change the output. One or more flags can be added.</p>
 176
 177 <dl>
 178
 179 <dt id="d"><b>d</b></dt>
 180 <dd>
 181
 182 <p>Print number of DOS line breaks.</p>
 183
 184 </dd>
 185 <dt id="u"><b>u</b></dt>
 186 <dd>
 187
 188 <p>Print number of Unix line breaks.</p>
 189
 190 </dd>
 191 <dt id="m"><b>m</b></dt>
 192 <dd>
 193
 194 <p>Print number of Mac line breaks.</p>
 195
 196 </dd>
 197 <dt id="b"><b>b</b></dt>
 198 <dd>
 199
 200 <p>Print the byte order mark.</p>
 201
 202 </dd>
 203 <dt id="t"><b>t</b></dt>
 204 <dd>
 205
 206 <p>Print if file is text or binary.</p>
 207
 208 </dd>
 209 <dt id="c"><b>c</b></dt>
 210 <dd>
 211
 212 <p>Print only the files that would be converted.</p>
 213
 214 <p>With the <code>c</code> flag dos2unix will print only the files that contain DOS line breaks, unix2dos will print only file names that have Unix line breaks.</p>
 215
 216 </dd>
 217 </dl>
 218
 219 <p>Examples:</p>
 220
 221 <p>Show information for all *.txt files:</p>
 222
 223 <pre><code>    dos2unix -i *.txt</code></pre>
 224
 225 <p>Show only the number of DOS line breaks and Unix line breaks:</p>
 226
 227 <pre><code>    dos2unix -idu *.txt</code></pre>
 228
 229 <p>Show only the byte order mark:</p>
 230
 231 <pre><code>    dos2unix --info=b *.txt</code></pre>
 232
 233 <p>List the files that have DOS line breaks.</p>
 234
 235 <pre><code>    dos2unix -ic *.txt</code></pre>
 236
 237 <p>List the files that have Unix line breaks.</p>
 238
 239 <pre><code>    unix2dos -ic *.txt</code></pre>
 240
 241 </dd>
 242 <dt id="k---keepdate"><b>-k, --keepdate</b></dt>
 243 <dd>
 244
 245 <p>Keep the date stamp of output file same as input file.</p>
 246
 247 </dd>
 248 <dt id="L---license"><b>-L, --license</b></dt>
 249 <dd>
 250
 251 <p>Display program&#39;s license.</p>
 252
 253 </dd>
 254 <dt id="l---newline"><b>-l, --newline</b></dt>
 255 <dd>
 256
 257 <p>Add additional newline.</p>
 258
 259 <p><b>dos2unix</b>: Only DOS line breaks are changed to two Unix line breaks. In Mac mode only Mac line breaks are changed to two Unix line breaks.</p>
 260
 261 <p><b>unix2dos</b>: Only Unix line breaks are changed to two DOS line breaks. In Mac mode Unix line breaks are changed to two Mac line breaks.</p>
 262
 263 </dd>
 264 <dt id="m---add-bom"><b>-m, --add-bom</b></dt>
 265 <dd>
 266
 267 <p>Write a Byte Order Mark (BOM) in the output file. By default an UTF-8 BOM is written.</p>
 268
 269 <p>When the input file is UTF-16, and the option <code>-u</code> is used, an UTF-16 BOM will be written.</p>
 270
 271 <p>Never use this option when the output encoding is other than UTF-8 or UTF-16. See also section UNICODE.</p>
 272
 273 </dd>
 274 <dt id="n---newfile-INFILE-OUTFILE"><b>-n, --newfile INFILE OUTFILE ...</b></dt>
 275 <dd>
 276
 277 <p>New file mode. Convert file INFILE and write output to file OUTFILE. File names must be given in pairs and wildcard names should <i>not</i> be used or you <i>will</i> lose your files.</p>
 278
 279 <p>The person who starts the conversion in new file (paired) mode will be the owner of the converted file. The read/write permissions of the new file will be the permissions of the original file minus the umask(1) of the person who runs the conversion.</p>
 280
 281 </dd>
 282 <dt id="o---oldfile-FILE"><b>-o, --oldfile FILE ...</b></dt>
 283 <dd>
 284
 285 <p>Old file mode. Convert file FILE and overwrite output to it. The program defaults to run in this mode. Wildcard names may be used.</p>
 286
 287 <p>In old file (in-place) mode the converted file gets the same owner, group, and read/write permissions as the original file. Also when the file is converted by another user who has write permissions on the file (e.g. user root). The conversion will be aborted when it is not possible to preserve the original values. Change of owner could mean that the original owner is not able to read the file any more. Change of group could be a security risk, the file could be made readable for persons for whom it is not intended. Preservation of owner, group, and read/write permissions is only supported on Unix.</p>
 288
 289 </dd>
 290 <dt id="q---quiet"><b>-q, --quiet</b></dt>
 291 <dd>
 292
 293 <p>Quiet mode. Suppress all warnings and messages. The return value is zero. Except when wrong command-line options are used.</p>
 294
 295 </dd>
 296 <dt id="r---remove-bom"><b>-r, --remove-bom</b></dt>
 297 <dd>
 298
 299 <p>Remove Byte Order Mark (BOM). Do not write a BOM in the output file. This is the default behavior when converting to Unix line breaks. See also option <code>-b</code>.</p>
 300
 301 </dd>
 302 <dt id="s---safe"><b>-s, --safe</b></dt>
 303 <dd>
 304
 305 <p>Skip binary files (default).</p>
 306
 307 </dd>
 308 <dt id="u---keep-utf16"><b>-u, --keep-utf16</b></dt>
 309 <dd>
 310
 311 <p>Keep the original UTF-16 encoding of the input file. The output file will be written in the same UTF-16 encoding, little or big endian, as the input file. This prevents transformation to UTF-8. An UTF-16 BOM will be written accordingly. This option can be disabled with the <code>-ascii</code> option.</p>
 312
 313 </dd>
 314 <dt id="ul---assume-utf16le"><b>-ul, --assume-utf16le</b></dt>
 315 <dd>
 316
 317 <p>Assume that the input file format is UTF-16LE.</p>
 318
 319 <p>When there is a Byte Order Mark in the input file the BOM has priority over this option.</p>
 320
 321 <p>When you made a wrong assumption (the input file was not in UTF-16LE format) and the conversion succeeded, you will get an UTF-8 output file with wrong text. You can undo the wrong conversion with iconv(1) by converting the UTF-8 output file back to UTF-16LE. This will bring back the original file.</p>
 322
 323 <p>The assumption of UTF-16LE works as a <i>conversion mode</i>. By switching to the default <i>ascii</i> mode the UTF-16LE assumption is turned off.</p>
 324
 325 </dd>
 326 <dt id="ub---assume-utf16be"><b>-ub, --assume-utf16be</b></dt>
 327 <dd>
 328
 329 <p>Assume that the input file format is UTF-16BE.</p>
 330
 331 <p>This option works the same as option <code>-ul</code>.</p>
 332
 333 </dd>
 334 <dt id="v---verbose"><b>-v, --verbose</b></dt>
 335 <dd>
 336
 337 <p>Display verbose messages. Extra information is displayed about Byte Order Marks and the amount of converted line breaks.</p>
 338
 339 </dd>
 340 <dt id="F---follow-symlink"><b>-F, --follow-symlink</b></dt>
 341 <dd>
 342
 343 <p>Follow symbolic links and convert the targets.</p>
 344
 345 </dd>
 346 <dt id="R---replace-symlink"><b>-R, --replace-symlink</b></dt>
 347 <dd>
 348
 349 <p>Replace symbolic links with converted files (original target files remain unchanged).</p>
 350
 351 </dd>
 352 <dt id="S---skip-symlink"><b>-S, --skip-symlink</b></dt>
 353 <dd>
 354
 355 <p>Keep symbolic links and targets unchanged (default).</p>
 356
 357 </dd>
 358 <dt id="V---version"><b>-V, --version</b></dt>
 359 <dd>
 360
 361 <p>Display version information and exit.</p>
 362
 363 </dd>
 364 </dl>
 365
 366 <h1 id="MAC-MODE">MAC MODE</h1>
 367
 368 <p>In normal mode line breaks are converted from DOS to Unix and vice versa. Mac line breaks are not converted.</p>
 369
 370 <p>In Mac mode line breaks are converted from Mac to Unix and vice versa. DOS line breaks are not changed.</p>
 371
 372 <p>To run in Mac mode use the command-line option <code>-c mac</code> or use the commands <code>mac2unix</code> or <code>unix2mac</code>.</p>
 373
 374 <h1 id="CONVERSION-MODES">CONVERSION MODES</h1>
 375
 376 <dl>
 377
 378 <dt id="ascii1"><b>ascii</b></dt>
 379 <dd>
 380
 381 <p>In mode <code>ascii</code> only line breaks are converted. This is the default conversion mode.</p>
 382
 383 <p>Although the name of this mode is ASCII, which is a 7 bit standard, the actual mode is 8 bit. Use always this mode when converting Unicode UTF-8 files.</p>
 384
 385 </dd>
 386 <dt id="bit"><b>7bit</b></dt>
 387 <dd>
 388
 389 <p>In this mode all 8 bit non-ASCII characters (with values from 128 to 255) are converted to a 7 bit space.</p>
 390
 391 </dd>
 392 <dt id="iso1"><b>iso</b></dt>
 393 <dd>
 394
 395 <p>Characters are converted between a DOS character set (code page) and ISO character set ISO-8859-1 (Latin-1) on Unix. DOS characters without ISO-8859-1 equivalent, for which conversion is not possible, are converted to a dot. The same counts for ISO-8859-1 characters without DOS counterpart.</p>
 396
 397 <p>When only option <code>-iso</code> is used dos2unix will try to determine the active code page. When this is not possible dos2unix will use default code page CP437, which is mainly used in the USA. To force a specific code page use options <code>-437</code> (US), <code>-850</code> (Western European), <code>-860</code> (Portuguese), <code>-863</code> (French Canadian), or <code>-865</code> (Nordic). Windows code page CP1252 (Western European) is also supported with option <code>-1252</code>. For other code pages use dos2unix in combination with iconv(1). Iconv can convert between a long list of character encodings.</p>
 398
 399 <p>Never use ISO conversion on Unicode text files. It will corrupt UTF-8 encoded files.</p>
 400
 401 <p>Some examples:</p>
 402
 403 <p>Convert from DOS default code page to Unix Latin-1</p>
 404
 405 <pre><code>    dos2unix -iso -n in.txt out.txt</code></pre>
 406
 407 <p>Convert from DOS CP850 to Unix Latin-1</p>
 408
 409 <pre><code>    dos2unix -850 -n in.txt out.txt</code></pre>
 410
 411 <p>Convert from Windows CP1252 to Unix Latin-1</p>
 412
 413 <pre><code>    dos2unix -1252 -n in.txt out.txt</code></pre>
 414
 415 <p>Convert from Windows CP1252 to Unix UTF-8 (Unicode)</p>
 416
 417 <pre><code>    iconv -f CP1252 -t UTF-8 in.txt | dos2unix &gt; out.txt</code></pre>
 418
 419 <p>Convert from Unix Latin-1 to DOS default code page</p>
 420
 421 <pre><code>    unix2dos -iso -n in.txt out.txt</code></pre>
 422
 423 <p>Convert from Unix Latin-1 to DOS CP850</p>
 424
 425 <pre><code>    unix2dos -850 -n in.txt out.txt</code></pre>
 426
 427 <p>Convert from Unix Latin-1 to Windows CP1252</p>
 428
 429 <pre><code>    unix2dos -1252 -n in.txt out.txt</code></pre>
 430
 431 <p>Convert from Unix UTF-8 (Unicode) to Windows CP1252</p>
 432
 433 <pre><code>    unix2dos &lt; in.txt | iconv -f UTF-8 -t CP1252 &gt; out.txt</code></pre>
 434
 435 <p>See also <a href="http://czyborra.com/charsets/codepages.html">http://czyborra.com/charsets/codepages.html</a> and <a href="http://czyborra.com/charsets/iso8859.html">http://czyborra.com/charsets/iso8859.html</a>.</p>
 436
 437 </dd>
 438 </dl>
 439
 440 <h1 id="UNICODE">UNICODE</h1>
 441
 442 <h2 id="Encodings">Encodings</h2>
 443
 444 <p>There exist different Unicode encodings. On Unix and Linux Unicode files are typically encoded in UTF-8 encoding. On Windows Unicode text files can be encoded in UTF-8, UTF-16, or UTF-16 big endian, but are mostly encoded in UTF-16 format.</p>
 445
 446 <h2 id="Conversion">Conversion</h2>
 447
 448 <p>Unicode text files can have DOS, Unix or Mac line breaks, like regular text files.</p>
 449
 450 <p>All versions of dos2unix and unix2dos can convert UTF-8 encoded files, because UTF-8 was designed for backward compatibility with ASCII.</p>
 451
 452 <p>Dos2unix and unix2dos with Unicode UTF-16 support, can read little and big endian UTF-16 encoded text files. To see if dos2unix was built with UTF-16 support type <code>dos2unix -V</code>.</p>
 453
 454 <p>UTF-16 encoded files are by default converted to UTF-8. On Unix/Linux it is required that the locale character encoding is set to UTF-8. Use the locale(1) command to find out what the locale character encoding is. UTF-8 formatted text files are well supported on both Windows and Unix/Linux.</p>
 455
 456 <p>UTF-16 and UTF-8 encoding are fully compatible, there will no text be lost in the conversion. When an UTF-16 to UTF-8 conversion error occurs, for instance when the UTF-16 input file contains an error, the file will be skipped.</p>
 457
 458 <p>When option <code>-u</code> is used, the output file will be written in the same UTF-16 encoding as the input file. Option <code>-u</code> prevents conversion to UTF-8.</p>
 459
 460 <p>Dos2unix and unix2dos have no option to convert UTF-8 files to UTF-16.</p>
 461
 462 <p>ISO and 7-bit mode conversion do not work on UTF-16 files.</p>
 463
 464 <h2 id="Byte-Order-Mark">Byte Order Mark</h2>
 465
 466 <p>On Windows Unicode text files typically have a Byte Order Mark (BOM), because many Windows programs (including Notepad) add BOMs by default. See also <a href="http://en.wikipedia.org/wiki/Byte_order_mark">http://en.wikipedia.org/wiki/Byte_order_mark</a>.</p>
 467
 468 <p>On Unix Unicode files typically don&#39;t have a BOM. It is assumed that text files are encoded in the locale character encoding.</p>
 469
 470 <p>Dos2unix can only detect if a file is in UTF-16 format if the file has a BOM. When an UTF-16 file doesn&#39;t have a BOM, dos2unix will see the file as a binary file.</p>
 471
 472 <p>Use option <code>-ul</code> or <code>-ub</code> to convert an UTF-16 file without BOM.</p>
 473
 474 <p>Dos2unix writes by default no BOM in the output file. With option <code>-b</code> Dos2unix writes a BOM when the input file has a BOM.</p>
 475
 476 <p>Unix2dos writes by default a BOM in the output file when the input file has a BOM. Use option <code>-r</code> to remove the BOM.</p>
 477
 478 <p>Dos2unix and unix2dos write always a BOM when option <code>-m</code> is used.</p>
 479
 480 <h2 id="Unicode-examples">Unicode examples</h2>
 481
 482 <p>Convert from Windows UTF-16 (with BOM) to Unix UTF-8</p>
 483
 484 <pre><code>    dos2unix -n in.txt out.txt</code></pre>
 485
 486 <p>Convert from Windows UTF-16LE (without BOM) to Unix UTF-8</p>
 487
 488 <pre><code>    dos2unix -ul -n in.txt out.txt</code></pre>
 489
 490 <p>Convert from Unix UTF-8 to Windows UTF-8 with BOM</p>
 491
 492 <pre><code>    unix2dos -m -n in.txt out.txt</code></pre>
 493
 494 <p>Convert from Unix UTF-8 to Windows UTF-16</p>
 495
 496 <pre><code>    unix2dos &lt; in.txt | iconv -f UTF-8 -t UTF-16 &gt; out.txt</code></pre>
 497
 498 <h1 id="EXAMPLES">EXAMPLES</h1>
 499
 500 <p>Read input from &#39;stdin&#39; and write output to &#39;stdout&#39;.</p>
 501
 502 <pre><code>    dos2unix
 503     dos2unix -l -c mac</code></pre>
 504
 505 <p>Convert and replace a.txt. Convert and replace b.txt.</p>
 506
 507 <pre><code>    dos2unix a.txt b.txt
 508     dos2unix -o a.txt b.txt</code></pre>
 509
 510 <p>Convert and replace a.txt in ascii conversion mode.</p>
 511
 512 <pre><code>    dos2unix a.txt</code></pre>
 513
 514 <p>Convert and replace a.txt in ascii conversion mode. Convert and replace b.txt in 7bit conversion mode.</p>
 515
 516 <pre><code>    dos2unix a.txt -c 7bit b.txt
 517     dos2unix -c ascii a.txt -c 7bit b.txt
 518     dos2unix -ascii a.txt -7 b.txt</code></pre>
 519
 520 <p>Convert a.txt from Mac to Unix format.</p>
 521
 522 <pre><code>    dos2unix -c mac a.txt
 523     mac2unix a.txt</code></pre>
 524
 525 <p>Convert a.txt from Unix to Mac format.</p>
 526
 527 <pre><code>    unix2dos -c mac a.txt
 528     unix2mac a.txt</code></pre>
 529
 530 <p>Convert and replace a.txt while keeping original date stamp.</p>
 531
 532 <pre><code>    dos2unix -k a.txt
 533     dos2unix -k -o a.txt</code></pre>
 534
 535 <p>Convert a.txt and write to e.txt.</p>
 536
 537 <pre><code>    dos2unix -n a.txt e.txt</code></pre>
 538
 539 <p>Convert a.txt and write to e.txt, keep date stamp of e.txt same as a.txt.</p>
 540
 541 <pre><code>    dos2unix -k -n a.txt e.txt</code></pre>
 542
 543 <p>Convert and replace a.txt. Convert b.txt and write to e.txt.</p>
 544
 545 <pre><code>    dos2unix a.txt -n b.txt e.txt
 546     dos2unix -o a.txt -n b.txt e.txt</code></pre>
 547
 548 <p>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.</p>
 549
 550 <pre><code>    dos2unix -n c.txt e.txt -o a.txt b.txt -n d.txt f.txt</code></pre>
 551
 552 <h1 id="RECURSIVE-CONVERSION">RECURSIVE CONVERSION</h1>
 553
 554 <p>Use dos2unix in combination with the find(1) and xargs(1) commands to recursively convert text files in a directory tree structure. For instance to convert all .txt files in the directory tree under the current directory type:</p>
 555
 556 <pre><code>    find . -name *.txt |xargs dos2unix</code></pre>
 557
 558 <h1 id="LOCALIZATION">LOCALIZATION</h1>
 559
 560 <dl>
 561
 562 <dt id="LANG"><b>LANG</b></dt>
 563 <dd>
 564
 565 <p>The primary language is selected with the environment variable LANG. The LANG variable consists out of several parts. The first part is in small letters the language code. The second is optional and is the country code in capital letters, preceded with an underscore. There is also an optional third part: character encoding, preceded with a dot. A few examples for POSIX standard type shells:</p>
 566
 567 <pre><code>    export LANG=nl               Dutch
 568     export LANG=nl_NL            Dutch, The Netherlands
 569     export LANG=nl_BE            Dutch, Belgium
 570     export LANG=es_ES            Spanish, Spain
 571     export LANG=es_MX            Spanish, Mexico
 572     export LANG=en_US.iso88591   English, USA, Latin-1 encoding
 573     export LANG=en_GB.UTF-8      English, UK, UTF-8 encoding</code></pre>
 574
 575 <p>For a complete list of language and country codes see the gettext manual: <a href="http://www.gnu.org/software/gettext/manual/gettext.html#Language-Codes">http://www.gnu.org/software/gettext/manual/gettext.html#Language-Codes</a></p>
 576
 577 <p>On Unix systems you can use to command locale(1) to get locale specific information.</p>
 578
 579 </dd>
 580 <dt id="LANGUAGE"><b>LANGUAGE</b></dt>
 581 <dd>
 582
 583 <p>With the LANGUAGE environment variable you can specify a priority list of languages, separated by colons. Dos2unix gives preference to LANGUAGE over LANG. For instance, first Dutch and then German: <code>LANGUAGE=nl:de</code>. You have to first enable localization, by setting LANG (or LC_ALL) to a value other than &quot;C&quot;, before you can use a language priority list through the LANGUAGE variable. See also the gettext manual: <a href="http://www.gnu.org/software/gettext/manual/gettext.html#The-LANGUAGE-variable">http://www.gnu.org/software/gettext/manual/gettext.html#The-LANGUAGE-variable</a></p>
 584
 585 <p>If you select a language which is not available you will get the standard English messages.</p>
 586
 587 </dd>
 588 <dt id="DOS2UNIX_LOCALEDIR"><b>DOS2UNIX_LOCALEDIR</b></dt>
 589 <dd>
 590
 591 <p>With the environment variable DOS2UNIX_LOCALEDIR the LOCALEDIR set during compilation can be overruled. LOCALEDIR is used to find the language files. The GNU default value is <code>/usr/local/share/locale</code>. Option <b>--version</b> will display the LOCALEDIR that is used.</p>
 592
 593 <p>Example (POSIX shell):</p>
 594
 595 <pre><code>    export DOS2UNIX_LOCALEDIR=$HOME/share/locale</code></pre>
 596
 597 </dd>
 598 </dl>
 599
 600 <h1 id="RETURN-VALUE">RETURN VALUE</h1>
 601
 602 <p>On success, zero is returned. When a system error occurs the last system error will be returned. For other errors 1 is returned.</p>
 603
 604 <p>The return value is always zero in quiet mode, except when wrong command-line options are used.</p>
 605
 606 <h1 id="STANDARDS">STANDARDS</h1>
 607
 608 <p><a href="http://en.wikipedia.org/wiki/Text_file">http://en.wikipedia.org/wiki/Text_file</a></p>
 609
 610 <p><a href="http://en.wikipedia.org/wiki/Carriage_return">http://en.wikipedia.org/wiki/Carriage_return</a></p>
 611
 612 <p><a href="http://en.wikipedia.org/wiki/Newline">http://en.wikipedia.org/wiki/Newline</a></p>
 613
 614 <p><a href="http://en.wikipedia.org/wiki/Unicode">http://en.wikipedia.org/wiki/Unicode</a></p>
 615
 616 <h1 id="AUTHORS">AUTHORS</h1>
 617
 618 <p>Benjamin Lin - &lt;blin@socs.uts.edu.au&gt; Bernd Johannes Wuebben (mac2unix mode) - &lt;wuebben@kde.org&gt;, Christian Wurll (add extra newline) - &lt;wurll@ira.uka.de&gt;, Erwin Waterlander - &lt;waterlan@xs4all.nl&gt; (Maintainer)</p>
 619
 620 <p>Project page: <a href="http://waterlan.home.xs4all.nl/dos2unix.html">http://waterlan.home.xs4all.nl/dos2unix.html</a></p>
 621
 622 <p>SourceForge page: <a href="http://sourceforge.net/projects/dos2unix/">http://sourceforge.net/projects/dos2unix/</a></p>
 623
 624 <h1 id="SEE-ALSO">SEE ALSO</h1>
 625
 626 <p>file(1) find(1) iconv(1) locale(1) xargs(1)</p>
 627
 628
 629 </body>
 630
 631 </html>
 632
 633