changeset 578:2c106ea908b5

Add Help topic for remembering password; update CHANGELOG
author Chris Cannam
date Wed, 07 Mar 2012 14:23:56 +0000
parents cc62862d21a4
children 6ac21e5397aa
files CHANGELOG easyhg.qrc help/a-34.html help/a-35.html help/topics.html help/topics/34.txt help/topics/35.txt help/topics/40.txt
diffstat 8 files changed, 160 insertions(+), 103 deletions(-) [+]
line wrap: on
line diff
--- a/CHANGELOG	Wed Mar 07 13:18:37 2012 +0000
+++ b/CHANGELOG	Wed Mar 07 14:23:56 2012 +0000
@@ -1,3 +1,20 @@
+Changes in v1.2 since v1.1:
+
+ * Add a Find function to both My Work and History tabs
+ * Add a Cancel button to the progress bar in the status line when
+   carrying out network operations
+ * Remove Refresh button from the toolbar. This button was found to be
+   causing significant confusion, as some users interpreted it as
+   meaning resynchronise with the server, while in fact all it did was
+   re-read the local working copy. The function is still present, but
+   has been relegated to File -> Re-Read Working Folder
+ * Rework the filesystem watcher code, making it generally more
+   reliable (a requirement for removing the Refresh button)
+ * Fix problem with return codes in Mercurial 2.1 causing push and
+   pull to be reported as failing
+ * Make it possible to clear the remote repository URL
+ * Switch the Windows installer from InstallJammer to WiX
+
 Changes in v1.1 since v1.0.1:
 
  * Closed branches are now supported: you can close a branch in EasyMercurial
--- a/easyhg.qrc	Wed Mar 07 13:18:37 2012 +0000
+++ b/easyhg.qrc	Wed Mar 07 14:23:56 2012 +0000
@@ -44,6 +44,7 @@
 	<file>help/a-32.html</file>
 	<file>help/a-33.html</file>
 	<file>help/a-34.html</file>
+	<file>help/a-35.html</file>
 	<file>help/a-40.html</file>
 	<file>help/images/openremote50.png</file>
 	<file>help/images/openfolder50.png</file>
--- a/help/a-34.html	Wed Mar 07 13:18:37 2012 +0000
+++ b/help/a-34.html	Wed Mar 07 14:23:56 2012 +0000
@@ -1,57 +1,30 @@
 <link rel="stylesheet" type="text/css" href="help.css"/>
 
 
-<h2>How do I use the Merge window?</h2>
+<h2>Every time I push some changes, I have to type my password again</h2>
 
-<p>If you are working with other people on a project, it is likely that
-at some point you'll find that more than one of you have edited the
-same lines in the same file, in different ways.</p>
+<p>When you push to a remote repository with an &ldquo;https:" prefix on its
+URL, EasyMercurial's password dialog should ask whether you want to
+remember your login details.</p>
 
-<p>When that happens and you try to merge the two versions, EasyMercurial
-will pop up a merge window that looks a bit like this.</p>
+<p>If you say yes, the details will be stored until EasyMercurial
+exits&mdash;so you won't have to enter them if you push or pull again
+while the present EasyMercurial session is running. Your password will
+be stored, encrypted with a session key, in a file which is deleted
+when EasyMercurial exits.</p>
 
-<p><center><img src="images/merge50.png"></center></p>
+<p><b>If this option does not appear</b></p>
 
-<p>(This is actually a separate program, not part of EasyMercurial: it's
-a merge tool called kdiff3.)</p>
+<p>... and if you're using OS/X, then you need to install the PyCrypto
+library before EasyMercurial will be able to store encrypted passwords
+for you.</p>
 
-<p>This looks a bit complicated, but it is there to help you pick which
-of the changes from each of the two &ldquo;rival&rdquo; versions of the file you
-want to use in your merged version.</p>
+<p>Try running <code>sudo easy_install pycrypto</code> in a terminal window.</p>
 
-<p> <b>The top middle one is <i>your current version</i>.</b> That's
-  the one you had before you decided to merge the other version into
-  it.</p>
+<p><b>Not using an https repository?</b></p>
 
-<p> <b>At top right is <i>the version you're merging</i>.</b> That's the other
-  rival version &ndash; the one that the other person can see in their copy
-  of the repository.</p>
+<p>If your remote repository uses ssh or some other protocol, then
+EasyMercurial won't be able to help. You might consider using ssh
+public key authentication and an ssh agent&mdash;talk to the admin of your
+remote repository for more details.</p>
 
-<p> <b>At top left is <i>the common ancestor</i>.</b> That's the version that both
-  of you had, before you started editing it in different ways.</p>
-
-<p> <b>At the bottom is the output.</b></p>
-
-<p>Each <i>conflict</i> (a line which you have both changed in different ways)
-is shown with <b>Merge Conflict</b> in the output at the bottom.  To sort
-out the conflicts and get the right output, you need to go through
-them one by one, for each one pressing the A, B, or C button to say
-whether for this line you want the top-left, top-middle, or top-right
-version to &ldquo;win&rdquo;.  (You can choose more than one, if you want both
-versions of a line to appear.)</p>
-
-<p>Then having resolved a conflict, press the three-arrows-down toolbar
-button to go to the next one &ndash; and when you've done them all, save
-and exit.</p>
-
-<p>The most important thing to remember is that <i>whatever appears in the
-bottom pane is what you'll get as a result</i>.</p>
-
-<p>No matter how confusing the process, just remember that if it looks
-correct in the bottom pane, it will be correct when you save and
-exit. You can even edit the file directly in the bottom pane if you
-aren't happy with the way the merge is going.</p>
-
-
-
-
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/help/a-35.html	Wed Mar 07 14:23:56 2012 +0000
@@ -0,0 +1,57 @@
+<link rel="stylesheet" type="text/css" href="help.css"/>
+
+
+<h2>How do I use the Merge window?</h2>
+
+<p>If you are working with other people on a project, it is likely that
+at some point you'll find that more than one of you have edited the
+same lines in the same file, in different ways.</p>
+
+<p>When that happens and you try to merge the two versions, EasyMercurial
+will pop up a merge window that looks a bit like this.</p>
+
+<p><center><img src="images/merge50.png"></center></p>
+
+<p>(This is actually a separate program, not part of EasyMercurial: it's
+a merge tool called kdiff3.)</p>
+
+<p>This looks a bit complicated, but it is there to help you pick which
+of the changes from each of the two &ldquo;rival&rdquo; versions of the file you
+want to use in your merged version.</p>
+
+<p> <b>The top middle one is <i>your current version</i>.</b> That's
+  the one you had before you decided to merge the other version into
+  it.</p>
+
+<p> <b>At top right is <i>the version you're merging</i>.</b> That's the other
+  rival version &ndash; the one that the other person can see in their copy
+  of the repository.</p>
+
+<p> <b>At top left is <i>the common ancestor</i>.</b> That's the version that both
+  of you had, before you started editing it in different ways.</p>
+
+<p> <b>At the bottom is the output.</b></p>
+
+<p>Each <i>conflict</i> (a line which you have both changed in different ways)
+is shown with <b>Merge Conflict</b> in the output at the bottom.  To sort
+out the conflicts and get the right output, you need to go through
+them one by one, for each one pressing the A, B, or C button to say
+whether for this line you want the top-left, top-middle, or top-right
+version to &ldquo;win&rdquo;.  (You can choose more than one, if you want both
+versions of a line to appear.)</p>
+
+<p>Then having resolved a conflict, press the three-arrows-down toolbar
+button to go to the next one &ndash; and when you've done them all, save
+and exit.</p>
+
+<p>The most important thing to remember is that <i>whatever appears in the
+bottom pane is what you'll get as a result</i>.</p>
+
+<p>No matter how confusing the process, just remember that if it looks
+correct in the bottom pane, it will be correct when you save and
+exit. You can even edit the file directly in the bottom pane if you
+aren't happy with the way the merge is going.</p>
+
+
+
+
--- a/help/topics.html	Wed Mar 07 13:18:37 2012 +0000
+++ b/help/topics.html	Wed Mar 07 14:23:56 2012 +0000
@@ -20,6 +20,7 @@
 <p><a href="a-31.html">I want to let my colleagues pull changes directly from my local repository</a></p>
 <p><a href="a-32.html">I want to put my changes into a master repository shared with my colleagues</a></p>
 <p><a href="a-33.html">I tried to push my changes, but it told me &ldquo;the remote repository may have been changed by someone else&rdquo; and refused</a></p>
-<p><a href="a-34.html">How do I use the Merge window?</a></p>
+<p><a href="a-34.html">Every time I push some changes, I have to type my password again</a></p>
+<p><a href="a-35.html">How do I use the Merge window?</a></p>
 <h3>See also</h3>
 <p><a href="a-40.html">Video tutorials</a></p>
--- a/help/topics/34.txt	Wed Mar 07 13:18:37 2012 +0000
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,56 +0,0 @@
-{Sharing changes}
-
-How do I use the Merge window?
-
-If you are working with other people on a project, it is likely that
-at some point you'll find that more than one of you have edited the
-same lines in the same file, in different ways.
-
-When that happens and you try to merge the two versions, EasyMercurial
-will pop up a merge window that looks a bit like this.
-
-#merge50
-
-(This is actually a separate program, not part of EasyMercurial: it's
-a merge tool called kdiff3.)
-
-This looks a bit complicated, but it is there to help you pick which
-of the changes from each of the two "rival" versions of the file you
-want to use in your merged version.
-
- *The top middle one is _your current version_.* That's
-  the one you had before you decided to merge the other version into
-  it.
-
- *At top right is _the version you're merging_.* That's the other
-  rival version -- the one that the other person can see in their copy
-  of the repository.
-
- *At top left is _the common ancestor_.* That's the version that both
-  of you had, before you started editing it in different ways.
-
- *At the bottom is the output.*
-
-Each _conflict_ (a line which you have both changed in different ways)
-is shown with *Merge Conflict* in the output at the bottom.  To sort
-out the conflicts and get the right output, you need to go through
-them one by one, for each one pressing the A, B, or C button to say
-whether for this line you want the top-left, top-middle, or top-right
-version to "win".  (You can choose more than one, if you want both
-versions of a line to appear.)
-
-Then having resolved a conflict, press the three-arrows-down toolbar
-button to go to the next one -- and when you've done them all, save
-and exit.
-
-The most important thing to remember is that _whatever appears in the
-bottom pane is what you'll get as a result_.
-
-No matter how confusing the process, just remember that if it looks
-correct in the bottom pane, it will be correct when you save and
-exit. You can even edit the file directly in the bottom pane if you
-aren't happy with the way the merge is going.
-
-
-
-
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/help/topics/35.txt	Wed Mar 07 14:23:56 2012 +0000
@@ -0,0 +1,56 @@
+{Sharing changes}
+
+How do I use the Merge window?
+
+If you are working with other people on a project, it is likely that
+at some point you'll find that more than one of you have edited the
+same lines in the same file, in different ways.
+
+When that happens and you try to merge the two versions, EasyMercurial
+will pop up a merge window that looks a bit like this.
+
+#merge50
+
+(This is actually a separate program, not part of EasyMercurial: it's
+a merge tool called kdiff3.)
+
+This looks a bit complicated, but it is there to help you pick which
+of the changes from each of the two "rival" versions of the file you
+want to use in your merged version.
+
+ *The top middle one is _your current version_.* That's
+  the one you had before you decided to merge the other version into
+  it.
+
+ *At top right is _the version you're merging_.* That's the other
+  rival version -- the one that the other person can see in their copy
+  of the repository.
+
+ *At top left is _the common ancestor_.* That's the version that both
+  of you had, before you started editing it in different ways.
+
+ *At the bottom is the output.*
+
+Each _conflict_ (a line which you have both changed in different ways)
+is shown with *Merge Conflict* in the output at the bottom.  To sort
+out the conflicts and get the right output, you need to go through
+them one by one, for each one pressing the A, B, or C button to say
+whether for this line you want the top-left, top-middle, or top-right
+version to "win".  (You can choose more than one, if you want both
+versions of a line to appear.)
+
+Then having resolved a conflict, press the three-arrows-down toolbar
+button to go to the next one -- and when you've done them all, save
+and exit.
+
+The most important thing to remember is that _whatever appears in the
+bottom pane is what you'll get as a result_.
+
+No matter how confusing the process, just remember that if it looks
+correct in the bottom pane, it will be correct when you save and
+exit. You can even edit the file directly in the bottom pane if you
+aren't happy with the way the merge is going.
+
+
+
+
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/help/topics/40.txt	Wed Mar 07 14:23:56 2012 +0000
@@ -0,0 +1,8 @@
+{See also}
+
+Video tutorials
+
+There are some very simple video tutorials available on the EasyMercurial website.
+
+Please see [[http://easyhg.org/videos.html]].
+