diff README @ 2099:47017b3086d4

README: more update to prepare for pypi upload

 * mention the evolve.serveronly extension,

 * remove help related to topic into a different README file.

--- 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 [e-mail] --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.