view README.rst @ 46885:fc8a5c9ecee0

win32: enable legacy I/O mode to fix missing pager output on Windows with py3

The equivalent interpreter option is set by wrapper.exe, but this *.bat file is
what gets installed in a venv.  Without this mode, any command that spins up a
pager has no output, unless the pager is explicitly disabled.  The variable is
set inside the `setlocal` scope to keep it from leaking into the environment
after the bat file exits.

We should probably still figure out how to ship a compiled hg.exe when
installing with `pip`, because the binary does other things like enable long
filename support.  But this avoids the dangerous and confusing lack of output in
the meantime.

Differential Revision: https://phab.mercurial-scm.org/D10354

Mercurial
=========

Mercurial is a fast, easy to use, distributed revision control tool
for software developers.

Basic install::

 $ make            # see install targets
 $ make install    # do a system-wide install
 $ hg debuginstall # sanity-check setup
 $ hg              # see help

Running without installing::

 $ make local      # build for inplace usage
 $ ./hg --version  # should show the latest version

See https://mercurial-scm.org/ for detailed installation
instructions, platform-specific notes, and Mercurial user information.

Notes for packagers
===================

Mercurial ships a copy of the python-zstandard sources. This is used to
provide support for zstd compression and decompression functionality. The
module is not intended to be replaced by the plain python-zstandard nor
is it intended to use a system zstd library. Patches can result in hard
to diagnose errors and are explicitly discouraged as unsupported
configuration.