Fast-Export/plugins/overwrite_null_messages/README.md

## Overwrite Null Commit Messages

There are cases (such as when creating a new, empty snippet on bitbucket
before they deprecated mercurial repositories) where you could create a
new repo with a single commit in it, but the message would be null.  Then,
when attempting to convert this repository to a git repo and pushing to 
a new host, the git push would fail with an error like this:

    error: a NUL byte in commit log message not allowed

To get around this, you may provide a string that will be used in place of
a null byte in commit messages.

To use the plugin, add

    --plugin overwrite_null_messages=""

This will use the default commit message `"<empty commit message>"`.

Or to specify a different commit message, you may pass this in at the
command line like so:

    --plugin overwrite_null_messages="use this message instead"