1 *************************************************************************
2 * WARNING * WARNING * WARNING * WARNING * WARNING * WARNING *
4 This code has no warranty and might contain bugs. Use at
5 your own risk. This code might not even install so there
6 is no guarantee. We have released this code primarily for
7 educational purposes and to make it easier for the
8 community to contribute back to the code.
10 * WARNING * WARNING * WARNING * WARNING * WARNING * WARNING *
11 *************************************************************************
13 GForge CVSTracker Plugin
15 GForge is a web-based Collaborative Development Environment offering
16 easy access to CVS, mailing lists, bug tracking, message
17 boards/forums, task management, permanent file archival,
18 and total web-based administration.
20 All files contained in this archive are licensed as stated in the
21 COPYING file. Please check out the AUTHORS file to see who helped
24 Thanks for taking the time to download this code. If you have any
25 questions please feel free to visit http://fusionforge.org/
28 1. Installation Instructions
29 ----------------------------
31 Decompress the plugin tarball and place it into your plugins directory.
32 Usually, this would be in a location like /opt/gforge/gforge/plugins/cvstracker
33 Whereever you place it, be sure your @CONFIG_PATH@/local.inc file has
34 $sys_plugins_path pointing to the plugins directory.
36 The cvstracker/etc/plugins/cvstracker/config.php should be copied and edited
39 @CONFIG_PATH@/plugins/cvstracker/config.php
41 The 'Site Admin' tab on the GForge web interface now has a 'Plugin Manager'
42 page where you can activate plugins on a sitewide basis. Be sure to do that
43 if you want this plugin to be available to projects.
49 CVSTracker plugin allows linking CVS Log messages to Trackers and Tasks.
50 It will review all commits in a project and search for a specific string
51 to know which task or tracker is related.
53 This string is on the form: [#NNN] for Tracker, and [TNNN] for Tasks.
56 $ cvs ci README -m "This patch will solve a problem on Bug [#123] and closes
59 Then, in the task or tracker detail page, it will appear that logs with links
60 to the involved files.
65 You have to enable CVSTracker Plugin for the project you want to use it. You
66 can change enabled/disabled checkbox in Project -> Admin -> Edit Public Info.
67 You'll see a checkbox near the bottom saying: "Use Cvs 2 Tracker Plugin".
68 Enable it, and wait for cronfiles to be executed.
70 Once it's active, you can use cvs log message to attach commit info to related
73 You can see those Logs in the detail page of trackers and tasks.
78 Edit the file $GFORGE_ETC_DIR/plugins/cvstracker/config.php and set the $cvs_binary_version to
79 1.11 or 1.12 depending on the version in the SCM server.
80 Also set $sys_default_domain and $sys_plugins_path accordingly