cropper

Help: environment

Environment Variables

    HG
        Path to the 'hg' executable, automatically passed when running hooks,
        extensions or external tools. If unset or empty, this is the hg
        executable's name if it's frozen, or an executable named 'hg' (with
        %PATHEXT% [defaulting to COM/EXE/BAT/CMD] extensions on Windows) is
        searched.

    HGEDITOR
        This is the name of the editor to run when committing. See EDITOR.

        (deprecated, use configuration file)

    HGENCODING
        This overrides the default locale setting detected by Mercurial. This
        setting is used to convert data including usernames, changeset
        descriptions, tag names, and branches. This setting can be overridden
        with the --encoding command-line option.

    HGENCODINGMODE
        This sets Mercurial's behavior for handling unknown characters while
        transcoding user input. The default is "strict", which causes
        Mercurial to abort if it can't map a character. Other settings include
        "replace", which replaces unknown characters, and "ignore", which
        drops them. This setting can be overridden with the --encodingmode
        command-line option.

    HGENCODINGAMBIGUOUS
        This sets Mercurial's behavior for handling characters with
        "ambiguous" widths like accented Latin characters with East Asian
        fonts. By default, Mercurial assumes ambiguous characters are narrow,
        set this variable to "wide" if such characters cause formatting
        problems.

    HGMERGE
        An executable to use for resolving merge conflicts. The program will
        be executed with three arguments: local file, remote file, ancestor
        file.

        (deprecated, use configuration file)

    HGRCPATH
        A list of files or directories to search for configuration files. Item
        separator is ":" on Unix, ";" on Windows. If HGRCPATH is not set,
        platform default search path is used. If empty, only the .hg/hgrc from
        the current repository is read.

        For each element in HGRCPATH:

        - if it's a directory, all files ending with .rc are added
        - otherwise, the file itself will be added

    HGPLAIN
        When set, this disables any configuration settings that might change
        Mercurial's default output. This includes encoding, defaults, verbose
        mode, debug mode, quiet mode, tracebacks, and localization. This can
        be useful when scripting against Mercurial in the face of existing
        user configuration.

        Equivalent options set via command line flags or environment variables
        are not overridden.

    HGPLAINEXCEPT
        This is a comma-separated list of features to preserve when HGPLAIN is
        enabled. Currently the only value supported is "i18n", which preserves
        internationalization in plain mode.

        Setting HGPLAINEXCEPT to anything (even an empty string) will enable
        plain mode.

    HGUSER
        This is the string used as the author of a commit. If not set,
        available values will be considered in this order:

        - HGUSER (deprecated)
        - configuration files from the HGRCPATH
        - EMAIL
        - interactive prompt
        - LOGNAME (with "@hostname" appended)

        (deprecated, use configuration file)

    EMAIL
        May be used as the author of a commit; see HGUSER.

    LOGNAME
        May be used as the author of a commit; see HGUSER.

    VISUAL
        This is the name of the editor to use when committing. See EDITOR.

    EDITOR
        Sometimes Mercurial needs to open a text file in an editor for a user
        to modify, for example when writing commit messages. The editor it
        uses is determined by looking at the environment variables HGEDITOR,
        VISUAL and EDITOR, in that order. The first non-empty one is chosen.
        If all of them are empty, the editor defaults to 'sensible-editor'.

    PYTHONPATH
        This is used by Python to find imported modules and may need to be set
        appropriately if this Mercurial is not installed system-wide.