--- a/README Mon Mar 13 16:53:42 2017 -0700
+++ b/README Mon Mar 13 23:28:57 2017 -0700
@@ -8,7 +8,9 @@
This package supplies the ``evolve`` extension for Mercurial,
**The full implementation of the changeset evolution concept is still in
-progress.** Please subscribe to the `evolve-testers mailing list <https://www.mercurial-scm.org/mailman/listinfo/evolve-testers>`_ to stay up to date with changes.
+progress.** Please subscribe to the `evolve-testers mailing list
+<https://www.mercurial-scm.org/mailman/listinfo/evolve-testers>`_ to stay up to
+date with changes.
This extensions:
@@ -19,7 +21,10 @@
* issues several warning messages when troubles from some mutable appears in
your repository,
-* provides a ``hg evolve`` command to deal with such "troubles". issues.
+* provides a ``hg evolve`` command to deal with such "troubles".
+
+* improves performance of obsolescence markers exchanges and discovery during
+ push and pull.
Documentation
-------------
@@ -62,37 +67,25 @@
Documentation lives in ``doc/``.
-Topic Extension
-================
+Server Only Version
+===================
-This packages also provides the ``topic`` extensions. It implements a new
-experimental concept to provide lightweight feature branches for the mutable
-parts of the history. The experiments is still at an early stage and have
-significant usability and performance issues.
-
-Enable
-------
-
-The topic extensions is included in the evolve package. See the install instruction for evolve.
-
-Then enable it in you configuration::
+It is possible to enable a smaller subset of the extensions aimed at server
+serving repository. It skips the additions of the new commands and local UI
+messages that might add performance overheads. To use the server only
+extension, install the package and use::
$ hg config --edit # adds the two line below:
[extensions]
- topics =
+ evolve.serveronly =
-Documentation
--------------
-
-* See 'hg help -e topic' for a generic help.
-* See 'hg help topics' and 'hg help stack' for help on specific commands.
-* See the 'tests/test-topic-tutorial.t' file for a quick tutorial.
How to Contribute
=================
-Bugs are to be reported on the mercurial's bug tracker (component: evolution):
-https://bz.mercurial-scm.org/buglist.cgi?component=evolution&query_format=advanced&resolution=---
+Bugs are to be reported on the mercurial's bug tracker (component: `evolution`_):
+
+.. _evolution: https://bz.mercurial-scm.org/buglist.cgi?component=evolution&query_format=advanced&resolution=---
Please use the patchbomb extension to send email to mercurial devel. Please
make sure to use the evolve-ext flag when doing so. You can use a command like
@@ -100,9 +93,9 @@
$ hg email --to mercurial-devel@mercurial-scm.org --flag evolve-ext --rev '<your patches>'
-See also
-https://mercurial-scm.org/wiki/ContributingChanges#Patch_descriptions
-for guidelines on the patch description.
+For guidelines on the patch description, see the `official Mercurial guideline`_.
+
+.. _`official Mercurial guideline`: https://mercurial-scm.org/wiki/ContributingChanges#Patch_descriptions
Please don't forget to update and run the tests when you fix a bug or
add a feature. To run the tests, you need a working copy of Mercurial,
@@ -113,8 +106,7 @@
(evolve's stable and default branches correspond to Mercurial's stable
and default branches. So to test evolve from default, you need
-Mercurial on default.)
-
+Mercurial on default.), Older version of Mercurial are supportd on their respective ``mercurial-x.y`` branches.
Changelog
=========
@@ -125,7 +117,7 @@
- drop compatibility for Mercurial < 3.8,
- removed old (unpackaged) pushexperiment extension,
- move all extensions in the official 'hgext3rd' namespace package,
-- add the "topic" experimental extensions.
+- add the "topic" experimental extensions. See the README.topic file for details
- officially ship 'evolve.serveronly' extensions. That extensions contains
only the part related to exchange and is intended to be used by server.