CnPack 开发组 周劲羽
http://www.cnpack.org

1. CVSTrac 简介
--------------
CVSTrac 是与 CVS 搭配使用的任务管理和错误跟踪工具，基于 WEB 方式访问。
这个轻量级的工具很好地扩展了 CVS 的功能，支持以下特性：

  * 使用内建的 SQLite3 数据库引擎，不需要外部数据库支持
  * 支持 CGI、inetd 或 web 服务器方式
  * CVS 帐号和访问权限管理
  * CVS 更新日志 Timeline 功能
  * CVS 仓库在线浏览、分析
  * Ticket 任务单管理跟踪功能
  * 可自定义任务单报表格式
  * 内建 Wiki 发布网站功能

非常适合网上分布式小团队协同开发使用。

官方网站: http://www.cvstrac.org
中文网站: http://www.cnpack.org

2. Windows 移植多语言版说明
---------------------------
CVSTrac 通常在 Unix/Linux 下使用，官方主页上有一份文档介绍了 Windows
下编译安装的方法，不过配置非常复杂。为了方便大家使用，我花了点时间做了
一些工作，现在可以非常方便地在 Windows 下使用了。

我所做的工作有：

  * 在 cygwin 下编译 SQLite3 和 cvstrac
  * 编写 CVSTracSvc.exe 服务程序，可在 NT 系统中以服务方式启动 cvstrac
  * 编写 CVSTracOption.exe 以方便配置使用
  * 编写 CTSender.exe 及扩展插件用来发送更新通知
  * 修改 cvstrac 源码使之使用 GB2312 字符集以支持中文
  * 一个服务程序同时支持 CVS/SVN/GIT 多种版本控制系统
  * 翻译 cvstrac 除 Wiki 文档外所有界面
  * 支持在 CVSNT 下使用 passwd 方式管理用户帐号
  * 增加 cvstrac 数据库用户列表导入导出等实用功能
  * 增加用户自定义字符集的支持
  * 解决其它一系列与 CVSNT 不兼容的问题
  
编译环境：

  * cygwin-1.5.18.1
  * sqlite-3.5.9
  * cvstrac-2.0.1
  * Delphi 7

已测试的平台：

  * Windows Server 2003 Stardard Edition
  * Windows 2000 Server SP4
  * Windows XP Professtional SP2
  * CVSNT 2.0.58d/2.5.03 build 2382

3. 安装
-------
使用以下步骤进行安装：

  * 执行安装程序进行安装，安装前不需要卸载旧的版本。
  * 运行 CVSTrac 配置程序。
  * 点击“自动导入”按钮导入在 CVSNT 中定义的 CVS Repository 仓库。
  * 双击各个子项，修改模块前缀等，每个数据库对应一个仓库。
  * 在数据库设置目录中可导入、导出 CVSTrac 用户列表。
  * 也可手工添加、删除 CVS 仓库。

测试使用：

在设置程序中选择一个数据库，点击“浏览”按钮，如果能看到登录界面，
表示安装已经成功，恭喜！

默认管理员帐号是 setup 密码 setup，登录成功后可建立其它帐号。
如果系统中存在 anonymous 帐号，则允许匿名访问。

4. 使用
-------
几个概念：

  * CVS Repository: 在 CVSNT 中指定的 CVS 仓库路径。
  * CVS 模块: 一个 CVS 仓库下可有多个模块，每个模块对应一个子目录。
  * CVSTrac 数据库: 保存 CVS 更新信息及错误跟踪任务单的数据库，所有
    数据库文件统一放在同一个目录下。每个数据库要求设置一个 CVS 仓库
    路径，并可指定一个模块前缀（可选）来进行模块过滤。如果有必要，
    也可为同一个 CVS 仓库下每个模块创建数据库（分别定义模块前缀）。

注意事项：

  * 修改数据库路径、端口号或语种后需要重新启动服务才能生效。
  * 增加、删除或修改 CVS 仓库不需要重新启动服务。
  * 系统运行后，建议不要修改 CVS 路径和模块前缀，除非移动 CVS 仓库。
  * 备份时只需要备份整个数据库目录即可，恢复时覆盖掉原目录。
  * 如果要使用任务单更新通知功能，需要设置任务单通知插件。

使用 Passwd 文件：

  * 创建本地用户 cvsuser，赋予 CVS 仓库目录和临时目录的访问权限。
  * 在配置工具中设置 CVSTrac 数据库支持 Passwd 管理。

详细使用方法见 cvstrac 自带的说明或 CnPack 开发组发布的 cvstrac 使用
手册。

5. 卸载
-------
使用以下步骤卸载：

  * 运行反安装程序即可

6. 源码下载
-----------
SVN 下载： http://cnpack.googlecode.com/svn/cvstracnt

关于 SVN 的说明，请访问 CnPack 开发网站。

7. 更新记录
-----------

2008.06.01 V2.0.1 Build 20080601

  * 升级到官方 2.0.1 版本 (见 http://www.cvstrac.org)。
  * 增加数据库自动升级功能。
  * 通知插件支持扩展字段内容。
  * 增加自动为 CVS 仓库创建 history 文件功能。

2006.01.12 V1.2.1 Build 20060112

  * 升级到官方 1.2.1 版本 (见 http://www.cvstrac.org)。
  * 修正邮件通知插件中文标题过长可能导致邮件头被截断的问题。

2005.09.15 V1.2.0 Build 20050916

  * 升级到官方 1.2.0 版本 (见 http://www.cvstrac.org)。
  + 使用同一个 CVSTrac 服务同时支持 CVS/Subversion/GIT。
  * 修正在某些环境下任务单通知失效的问题。
  * 增加每天自动备份数据库的功能。
  * 使用最新的 cygwin 1.5.18.1 和 sqlite 2.8.16 重新编译。

2005.07.03 V1.1.5 Build 20050703

  * 修正服务停止后起不来的问题。
  * 修改库文件名，解决与其它软件的兼容性问题。

2005.04.26 V1.1.5 Build 20050426

  * 增加自定义网页字符集功能。
  * 邮件插件修正不支持带 - 信箱的问题。

2005.04.13 V1.1.5 Build 20050413

  * 修正插件不支持自定义数据库路径的问题。

2005.04.08 V1.1.5 Build 20050408

  + 任务单通知改用插件体系，可自由扩展。
  + 新增 RTX 通知插件。
  + 新增 Net Send 通知插件。
  + 增加发送日志记录功能。
  * 邮件通知支持发送到多个帐号，及其它增强。
  * 修正部分系统上时间线不能正常工作的问题。

2005.01.15 V1.1.5 Build 20050115

  * 同步升级到 1.1.5 版，修正安全问题。

2004.12.07 V1.1.4 Build 20041207

  * 修正英文系统下窗体变大的问题。

2004.09.10 V1.1.4 Build 20040910

  * 修正仓库浏览不支持带中文和空格文件名的文件下载问题
    （感谢 jeack 帮助修改）

2004.08.13 V1.1.4 Build 20040813

  * 同步升级到官方版本 1.1.4
  * 修正由 filediff 引起的严重安全漏洞
  * 允许设置新任务单的默认优先级和严重度

2004.05.26 V1.1.3 Build 20040529

  * 增加多语言支持，目前支持简体/英文，繁体中文暂不支持
  * 修正中文版中时间线部分图标判断错误的问题
  * 新建数据库默认允许passwd文件控制
  * 修正中文版默认报表格式一处错误
  * 修正邮件发送程序在发送多行描述邮件时无效的问题
  * 修正其它已知错误

2004.04.09 V1.1.3 Build 20040409

  * 同步升级到官方版本 1.1.3
  + 新增访问流量限制功能
  + 新增对任务单追加备注的功能
  + 新增撤消对任务单的修改的功能
  + 新增为一次提交添加检查报告的功能
  * 更新相关文档

2003.12.14 V1.1.2 Build 20031213

  + 增加任务单更新邮件通知功能
  * 在时间线中显示提交者的全名
  * 修正 Wiki 文档比较时的错误
  * 修正已经有翻译错误和遗漏

2003.12.10 V1.1.2 Build 20031210

  + 增加对 CVSNT 下使用 passwd 文件的支持
  + 增加 CVSTrac 用户列表导入导出功能
  * 修正部分翻译问题

2003.11.15 V1.1.2 Build 20031115

  * 日期显示支持中文格式
  * 修改服务运行方式，只需要一个端口管理所有 CVS 仓库

2003.11.12 V1.1.2 Build 20031112

  * 第一版本发布