will give hints on which branches need adjustment for starting over
again.
+When a mercurial repository does not use utf-8 for encoding author
+strings and commit messages the "-e <encoding>" command line option
+can be used to force fast-export to convert incoming meta data from
+<encoding> to utf-8. This encoding option is also applied to file names.
+
+In some locales Mercurial uses different encodings for commit messages
+and file names. In that case, you can use "--fe <encoding>" command line
+option which overrides the -e option for file names.
+
As mercurial appears to be much less picky about the syntax of the
author information than git, an author mapping file can be given to
hg-fast-export to fix up malformed author strings. The file is
User <garbage<user@example.com>=User <user@example.com>
-- End of authors.map --
+Tag and Branch Naming
+=====================
+
+As Git and Mercurial have differ in what is a valid branch and tag
+name the -B and -T options allow a mapping file to be specified to
+rename branches and tags (respectively). The syntax of the mapping
+file is the same as for the author mapping.
+
Notes/Limitations
=================