upstream/mercurial-mirror Files · contrib/win32/ReadMe.html

streamclone: disable the volatile file open handle optimization on Windows...

streamclone: disable the volatile file open handle optimization on Windows Leaving files open caused new failures like this, since a47f09da8bd1: diff --git a/tests/test-persistent-nodemap-stream-clone.t b/tests/test-persistent-nodemap-stream-clone.t --- a/tests/test-persistent-nodemap-stream-clone.t +++ b/tests/test-persistent-nodemap-stream-clone.t @@ -115,7 +115,12 @@ Do a mix of clone and commit at the same $ (hg clone -U --stream ssh://user@dummy/test-repo stream-clone-race-1 --debug 2>> clone-output | grep -E '00(changelog|manifest)' >> clone-output; touch $HG_TEST_STREAM_WALKED_FILE_3) & $ $RUNTESTDIR/testlib/wait-on-file 10 $HG_TEST_STREAM_WALKED_FILE_1 $ hg -R test-repo/ commit -m foo - created new head + transaction abort! + failed to recover 00changelog.n ([WinError 32] The process cannot access the file because it is being used by another process: b'$STR_REPR_TESTTMP\\test-repo/.hg/store/00changelog.n' -> b'$STR_REPR_TESTTMP\\test-repo/.hg/store/00changelog.n-f418dcd6') + rollback failed - please run hg recover + (failure reason: [WinError 32] The process cannot access the file because it is being used by another process: b'$STR_REPR_TESTTMP\\test-repo/.hg/store/00changelog.n' -> b'$STR_REPR_TESTTMP\\test-repo/.hg/store/00changelog.n-f418dcd6') + abort: The process cannot access the file because it is being used by another process: '$TESTTMP\test-repo\.hg\store\00changelog.n' + [255] $ touch $HG_TEST_STREAM_WALKED_FILE_2 $ $RUNTESTDIR/testlib/wait-on-file 10 $HG_TEST_STREAM_WALKED_FILE_3 $ cat clone-output Since the `VolatileManager` falls back to the old copy method when the open file threshold is exceeded, this just drops the threshold so that only 1 file is open. The actual value used (2) is unexpected, and explained inline. I'd like to have a config option for this so that we can test both ways (in theory, it could resort to copies on non-Windows systems too), but I don't see a `uimod.ui` handy. Alternately, I tried replacing the 3 `open()` calls in the `VolatileManager` with `util.posixfile()`, but that simply hung the test on Windows for some reason, I think on the same line that's indicated as failing above. (There was a `grep` command hanging around, as well as `hg -R test-repo serve --stdio`.)

av6 - - Load All Authors

File last commit:

r52561:45ba8416 stable


                r53081:e4b242f9

stable

Download file

             ReadMe.html
        
                    161 lines
            
             | 4.6 KiB
            
                | text/html
            
             |
                HtmlLexer
            
             / contrib / win32 / ReadMe.html
          
                    History
                
                 |
                  Annotation
                 | Raw
                 |Copy content
                 |Copy permalink

      <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

      <html>

        <head>

          <title>Mercurial for Windows</title>

          <meta http-equiv="Content-Type" content="text/html;charset=utf-8" >

          <style type="text/css">

            <!--

            html {

              font-family: sans-serif;

              margin: 1em 2em;

            }

            p {

              margin-top: 0.5em;

              margin-bottom: 0.5em;

            }

            pre {

              margin: 0.25em 0em;

              padding: 0.5em;

              background-color: #EEE;

              border: thin solid #CCC;

            }

            .indented {

              padding-left: 10pt;

            }

            -->

          </style>

        </head>

        <body>

          <h1>Mercurial for Windows</h1>

          <p>Welcome to Mercurial for Windows!</p>

          <p>

            Mercurial is a command-line application. You must run it from

            the Windows command prompt (or if you're hard core, a <a

            href="http://www.mingw.org/">MinGW</a> shell).

          </p>

          <p class="indented">

            <i>Note: the standard <a href="http://www.mingw.org/">MinGW</a>

            msys startup script uses rxvt which has problems setting up

            standard input and output. Running bash directly works

            correctly.</i>

          </p>

          <p>

            For documentation, please visit the <a

            href="https://mercurial-scm.org/">Mercurial web site</a>.

            You can also download a free book, <a

            href="https://book.mercurial-scm.org/">Mercurial: The Definitive

            Guide</a>.

          </p>

          <p>

            By default, Mercurial installs to <tt>C:\Program

            Files\Mercurial</tt>. The Mercurial command is called

            <tt>hg.exe</tt>.

          </p>

          <h1>Testing Mercurial after you've installed it</h1>

          <p>

            The easiest way to check that Mercurial is installed properly is

            to just type the following at the command prompt:

          </p>

          <pre>

      hg

      </pre>

          <p>

            This command should print a useful help message. If it does,

            other Mercurial commands should work fine for you.

          </p>

          <h1>Configuration notes</h1>

          <h4>Default editor</h4>

          <p>

            The default editor for commit messages is 'notepad'. You can set

            the <tt>EDITOR</tt> (or <tt>HGEDITOR</tt>) environment variable

            to specify your preference or set it in <tt>mercurial.ini</tt>:

          </p>

          <pre>

      [ui]

      editor = whatever

      </pre>

          <h4>Configuring a Merge program</h4>

          <p>

            It should be emphasized that Mercurial by itself doesn't attempt

            to do a Merge at the file level, neither does it make any

            attempt to Resolve the conflicts.

          </p>

          <p>

            By default, Mercurial will use the merge program defined by the

            <tt>HGMERGE</tt> environment variable, or uses the one defined

            in the <tt>mercurial.ini</tt> file. (see <a

            href="https://mercurial-scm.org/wiki/MergeProgram">MergeProgram</a>

            on the Mercurial Wiki for more information)

          </p>

          <h1>Reporting problems</h1>

          <p>

            Before you report any problems, please consult the <a

            href="https://mercurial-scm.org/">Mercurial web site</a>

            and see if your question is already in our list of <a

            href="https://mercurial-scm.org/wiki/FAQ">Frequently

            Answered Questions</a> (the "FAQ").

          </p>

          <p>

            If you cannot find an answer to your question, please feel free

            to send mail to the Mercurial mailing list, at <a

            href="mailto:mercurial@mercurial-scm.org">mercurial@mercurial-scm.org</a>.

            <b>Remember</b>, the more useful information you include in your

            report, the easier it will be for us to help you!

          </p>

          <p>

            If you are IRC-savvy, that's usually the fastest way to get

            help. Go to <tt>#mercurial</tt> on <tt>irc.freenode.net</tt>.

          </p>

          <h1>Author and copyright information</h1>

          <p>

            Mercurial was written by <a href="http://www.selenic.com">Matt

            Mackall</a>, and is maintained by Matt and a team of volunteers.

          </p>

          <p>

            The Windows installer was written by <a

            href="http://www.serpentine.com/blog">Bryan O'Sullivan</a>.

          </p>

          <p>

            Mercurial is Copyright 2005-2024 Olivia Mackall and others.

          </p>

          <p>

            Mercurial is free software; you can redistribute it and/or

            modify it under the terms of the <a

            href="http://www.gnu.org/licenses/old-licenses/gpl-2.0.txt">GNU

            General Public License version 2</a> or any later version.

          </p>

          <p>

            Mercurial is distributed in the hope that it will be useful, but

            <b>without any warranty</b>; without even the implied warranty

            of <b>merchantability</b> or <b>fitness for a particular

            purpose</b>. See the GNU General Public License for more

            details.

          </p>

        </body>

      </html>

	Site-wide shortcuts
/	Use quick search box
g h	Goto home page
g g	Goto my private gists page
g G	Goto my public gists page
g 0-9	Goto bookmarked items from 0-9
n r	New repository page
n g	New gist page

	Repositories
g s	Goto summary page
g c	Goto changelog page
g f	Goto files page
g F	Goto files page with file search activated
g p	Goto pull requests page
g o	Goto repository settings
g O	Goto repository access permissions settings
t s	Toggle sidebar on some pages

				<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
				<html>
				<head>
				<title>Mercurial for Windows</title>
				<meta http-equiv="Content-Type" content="text/html;charset=utf-8" >
				<style type="text/css">
				<!--
				html {
				font-family: sans-serif;
				margin: 1em 2em;
				}

				p {
				margin-top: 0.5em;
				margin-bottom: 0.5em;
				}

				pre {
				margin: 0.25em 0em;
				padding: 0.5em;
				background-color: #EEE;
				border: thin solid #CCC;
				}

				.indented {
				padding-left: 10pt;
				}
				-->
				</style>
				</head>

				<body>
				<h1>Mercurial for Windows</h1>

				<p>Welcome to Mercurial for Windows!</p>

				<p>
				Mercurial is a command-line application. You must run it from
				the Windows command prompt (or if you're hard core, a <a
				href="http://www.mingw.org/">MinGW</a> shell).
				</p>

				<p class="indented">
				<i>Note: the standard <a href="http://www.mingw.org/">MinGW</a>
				msys startup script uses rxvt which has problems setting up
				standard input and output. Running bash directly works
				correctly.</i>
				</p>

				<p>
				For documentation, please visit the <a
				href="https://mercurial-scm.org/">Mercurial web site</a>.
				You can also download a free book, <a
				href="https://book.mercurial-scm.org/">Mercurial: The Definitive
				Guide</a>.
				</p>

				<p>
				By default, Mercurial installs to <tt>C:\Program
				Files\Mercurial</tt>. The Mercurial command is called
				<tt>hg.exe</tt>.
				</p>

				<h1>Testing Mercurial after you've installed it</h1>

				<p>
				The easiest way to check that Mercurial is installed properly is
				to just type the following at the command prompt:
				</p>

				<pre>
				hg
				</pre>

				<p>
				This command should print a useful help message. If it does,
				other Mercurial commands should work fine for you.
				</p>

				<h1>Configuration notes</h1>
				<h4>Default editor</h4>
				<p>
				The default editor for commit messages is 'notepad'. You can set
				the <tt>EDITOR</tt> (or <tt>HGEDITOR</tt>) environment variable
				to specify your preference or set it in <tt>mercurial.ini</tt>:
				</p>
				<pre>
				[ui]
				editor = whatever
				</pre>

				<h4>Configuring a Merge program</h4>
				<p>
				It should be emphasized that Mercurial by itself doesn't attempt
				to do a Merge at the file level, neither does it make any
				attempt to Resolve the conflicts.
				</p>

				<p>
				By default, Mercurial will use the merge program defined by the
				<tt>HGMERGE</tt> environment variable, or uses the one defined
				in the <tt>mercurial.ini</tt> file. (see <a
				href="https://mercurial-scm.org/wiki/MergeProgram">MergeProgram</a>
				on the Mercurial Wiki for more information)
				</p>

				<h1>Reporting problems</h1>

				<p>
				Before you report any problems, please consult the <a
				href="https://mercurial-scm.org/">Mercurial web site</a>
				and see if your question is already in our list of <a
				href="https://mercurial-scm.org/wiki/FAQ">Frequently
				Answered Questions</a> (the "FAQ").
				</p>

				<p>
				If you cannot find an answer to your question, please feel free
				to send mail to the Mercurial mailing list, at <a
				href="mailto:mercurial@mercurial-scm.org">mercurial@mercurial-scm.org</a>.
				<b>Remember</b>, the more useful information you include in your
				report, the easier it will be for us to help you!
				</p>

				<p>
				If you are IRC-savvy, that's usually the fastest way to get
				help. Go to <tt>#mercurial</tt> on <tt>irc.freenode.net</tt>.
				</p>

				<h1>Author and copyright information</h1>

				<p>
				Mercurial was written by <a href="http://www.selenic.com">Matt
				Mackall</a>, and is maintained by Matt and a team of volunteers.
				</p>

				<p>
				The Windows installer was written by <a
				href="http://www.serpentine.com/blog">Bryan O'Sullivan</a>.
				</p>

				<p>
				Mercurial is Copyright 2005-2024 Olivia Mackall and others.
				</p>

				<p>
				Mercurial is free software; you can redistribute it and/or
				modify it under the terms of the <a
				href="http://www.gnu.org/licenses/old-licenses/gpl-2.0.txt">GNU
				General Public License version 2</a> or any later version.
				</p>

				<p>
				Mercurial is distributed in the hope that it will be useful, but
				<b>without any warranty</b>; without even the implied warranty
				of <b>merchantability</b> or <b>fitness for a particular
				purpose</b>. See the GNU General Public License for more
				details.
				</p>
				</body>
				</html>