docs/Development-Case

Help: import

hg import [OPTION]... PATCH...

aliases: patch

import an ordered set of patches

    Import a list of patches and commit them individually (unless --no-commit
    is specified).

    If there are outstanding changes in the working directory, import will
    abort unless given the -f/--force flag.

    You can import a patch straight from a mail message. Even patches as
    attachments work (to use the body part, it must have type text/plain or
    text/x-patch). From and Subject headers of email message are used as
    default committer and commit message. All text/plain body parts before
    first diff are added to commit message.

    If the imported patch was generated by "hg export", user and description
    from patch override values from message headers and body. Values given on
    command line with -m/--message and -u/--user override these.

    If --exact is specified, import will set the working directory to the
    parent of each patch before applying it, and will abort if the resulting
    changeset has a different ID than the one recorded in the patch. This may
    happen due to character set problems or other deficiencies in the text
    patch format.

    Use --bypass to apply and commit patches directly to the repository, not
    touching the working directory. Without --exact, patches will be applied
    on top of the working directory parent revision.

    With -s/--similarity, hg will attempt to discover renames and copies in
    the patch in the same way as "hg addremove".

    To read a patch from standard input, use "-" as the patch name. If a URL
    is specified, the patch will be downloaded from it. See "hg help dates"
    for a list of formats valid for -d/--date.

    Returns 0 on success.

options:

 -p --strip NUM             directory strip option for patch. This has the
                            same meaning as the corresponding patch option
                            (default: 1)
 -e --edit                  invoke editor on commit messages
 -f --force                 skip check for outstanding uncommitted changes
    --no-commit             don't commit, just update the working directory
    --bypass                apply patch without touching the working directory
    --exact                 apply patch to the nodes from which it was
                            generated
    --import-branch         use any branch information in patch (implied by
                            --exact)
 -m --message TEXT          use text as commit message
 -l --logfile FILE          read commit message from file
 -d --date DATE             record the specified date as commit date
 -u --user USER             record the specified user as committer
 -s --similarity SIMILARITY guess renamed files by similarity (0<=s<=100)

use "hg -v help import" to show more info