Changes between Version 5 and Version 6 of TracMercurial

Timestamp:

Nov 4, 2005, 11:35:13 PM (19 years ago)

Author:

Christian Boos

Comment:

Added more details for the installation of the plugin, and set the advised version to use for v0.1 to r2491

TracMercurial

@@ -1 +1 @@
 = Mercurial Plugin for Trac (#1847) =
 
-There is an experimental plugin for Trac [milestone:0.9] which enables
+There is an '''experimental''' plugin for Trac [milestone:0.9] which enables
 [http://www.selenic.com/mercurial Mercurial] to be used 
 instead of [http://subversion.tigris.org Subversion]
 for the VersioningSystemBackend.
+
+''The plugin being experimental, expect some rough edges
+and a somewhat instable set of features/documentation...''
 
 
@@ -34 +37 @@
 ===== Releases =====
 || '''Version''' || mercurial-plugin || Trac vc-refactoring ||
-||      0.1      ||       r2482      ||        r2479        ||
+||      0.1      ||       r2491      ||        r2491        ||
 
 
@@ -47 +50 @@
 == Configuration ==
 
+For general instructions about plugins, see also TracPlugins.
+
 The plugin egg can be added to the `plugins` folder of an existing environment,
 or to a brand new environment. Note that if you create a new environment, it's
-currently necessary to ''not'' specify the repository directory during the
+currently necessary to leave the repository directory '''empty''' during the
 `initenv` step (''this will probably be fixed soon'').
 
-In either case, you'll need to specify the backend scheme to be used
-(here `hg:`) in front of the actual repository location, in TracIni:
+Then, you need to specify which version control backend has to be used:
 {{{
 [trac]
-repository_dir = hg:/path/to/my/hg/repository
-}}}
+repository_type = hg
+repository_dir = /path/to/my/hg/repository
+}}}
+''Note: those installing from 0.9 + the patch on #1847 still have to specify `repository_dir=hg:/path/to/my/hg/repository`''
 
 Also, you'll need to explicitely disable the SVN components:
@@ -66 +72 @@
 
 ''Note: that constraint will most certainly be lifted in the future''
+
+Finally, if you installed the egg by doing a `python setup.py install`,
+there's the additional constraint of specifically ''enabling'' the plugin:
+{{{
+[components]
+trac.versioncontrol.svn_fs.* = disabled
+hgtrac.* = enabled
+}}}