<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <title> recode.pl</title> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" > </head> <body id="pod"> <p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents"><<</a></b></p> <h1>recode.pl</h1> <div class='indexgroup'> <ul class='indexList indexList1'> <li class='indexItem indexItem1'><a href='#NAME'>NAME</a> <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a> <li class='indexItem indexItem1'><a href='#OPTIONS'>OPTIONS</a> </ul> </div> <h1><a class='u' href='#___top' title='click to go to top of document' name="NAME" >NAME</a></h1> <p>recode.pl - Converts a database from one encoding (or multiple encodings) to UTF-8.</p> <h1><a class='u' href='#___top' title='click to go to top of document' name="SYNOPSIS" >SYNOPSIS</a></h1> <pre class="code"> contrib/recode.pl [--guess [--show-failures]] [--charset=iso-8859-2] [--overrides=file_name] --dry-run Don't modify the database. --charset Primary charset your data is currently in. This can be optionally omitted if you do --guess. --guess Try to guess the charset of the data. --show-failures If we fail to guess, show where we failed. --overrides Specify a file containing overrides. See --help for more info. --help Display detailed help. If you aren't sure what to do, try: contrib/recode.pl --guess --charset=cp1252</pre> <h1><a class='u' href='#___top' title='click to go to top of document' name="OPTIONS" >OPTIONS</a></h1> <dl> <dt><a name="--dry-run" >--dry-run</a></dt> <dd> <p>Don't modify the database, just print out what the conversions will be.</p> <p>recode.pl will print out a Key for each item. You can use this in the overrides file, described below.</p> <dt><a name="--guess" >--guess</a></dt> <dd> <p>If your database is in multiple different encodings, specify this switch and recode.pl will do its best to determine the original charset of the data. The detection is usually very reliable.</p> <p>If recode.pl cannot guess the charset, it will leave the data alone, unless you've specified --charset.</p> <dt><a name="--charset=charset-name" >--charset=charset-name</a></dt> <dd> <p>If you do not specify --guess, then your database is converted from this character set into the UTF-8.</p> <p>If you have specified --guess, recode.pl will use this charset as a fallback--when it cannot guess the charset of a particular piece of data, it will guess that the data is in this charset and convert it from this charset to UTF-8.</p> <p>charset-name must be a charset that is known to perl's Encode module. To see a list of available charsets, do:</p> <p><code class="code">perl -MEncode -e 'print join("\n", Encode->encodings(":all"))'</code></p> <dt><a name="--show-failures" >--show-failures</a></dt> <dd> <p>If --guess fails to guess a charset, print out the data it failed on.</p> <dt><a name="--overrides=file_name" >--overrides=file_name</a></dt> <dd> <p>This is a way of specifying certain encodings to override the encodings of --guess. The file is a series of lines. The line should start with the Key from --dry-run, and then a space, and then the encoding you'd like to use.</p> </dd> </dl> <p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents"><<</a></b></p> <!-- end doc --> </body></html>