Changeset 17 for mergebot/trunk/README.txt

Timestamp:

Jun 8, 2009 3:07:47 AM (15 years ago)

Author:

retracile

Message:

Mergebot: redesigned implementation. Still has rough edges.

File:

• mergebot/trunk/README.txt (modified) (1 diff)

mergebot/trunk/README.txt

@@ -1 +1 @@
 = Installing =
 # Checkout the source.
-$ svn co <url> mergebot-0.10
-$ cd mergebot-0.10
-$ python setup.py bdist_egg
-$ cp dist/TracMergeBot*.egg <mytracenv>/plugins/
+$ svn co <url> mergebot-0.11
+$ cd mergebot-0.11
+$ ./rpm/makerpm
+$ su -c "rpm --install dist/TracMergeBot*.noarch.rpm"
 # Create the mergebot work area
 $ mkdir <mytracenv>/mergebot
 $ chown <webserver>:<webserver> <mytracenv>/mergebot
 
-# Add to trac.ini:
-[mergebot]
-work_dir = /var/www/trac/mytracenv/mergebot
-repository_url = http://servername/repos
+Enable mergebot in the [components] section:
+mergebot.web_ui.* = enabled
 
-[ticket-custom]
-mergebotstate = select
-mergebotstate.label = MergeBotState
-mergebotstate.options = | tomerge | merged | tobranch | branched | conflicts
-mergebotstate.value = 
+If you want to use the ticket workflow features you will also need to change
+[components]
+mergebot.ticket_actions.* = enabled
+[ticket]
+workflow = ConfigurableTicketWorkflow,MergebotActionController
+Restart your webserver.
+And then use "mergebot" in the .operations section of the relevant ticket actions.
 
-# Give MERGEBOT_* permissions to your users.
-# Make sure you have a version for 'trunk'
-# Make sure you have your Subversion directory structure setup as
-# <component>/trunk
-# <component>/tags
-# <component>/branches
+# Add needed entries to trac.ini:
+$ trac-admin <mytracenv> upgrade
+Then edit <mytracenv>/conf/trac.ini again.
+In particular, look for the [mergebot] section that the upgrade added, and be sure the repository_url is set.
+Give MERGEBOT_* permissions to your users.
 
-# Restart your webserver
+Be sure you have a version named 'trunk' -- and you will likely want to make that the default.
+Mergebot assumes that each component is the name of a top-level directory in the svn repository, and that the versions are 'trunk', a ticket number with a preceeding '#', or a release name with a corresponding 'branches/release-XYZ' directory.
+