TortoiseCVS中文使用指南

 

Using TortoiseCVS with SourceForge TCVS使用手册
TortoiseCVS Client Installation Instructions 安装指南
This document provides instructions for installing and using the TortoiseCVS CVS client software. These instructions are designed for SourceForge.net project developers who are using 32-bit Microsoft Windows platform. It is for developers who would like to work with the source code for a project which is hosted on SourceForge.net. For background information you may like to read the other available documents about CVS. 安装使用指南。为SF.NET开发者准备，工作于WIN21平台。工作于SF.NET项目源码。你应该学习一些关于CVS的知识背景。

TortoiseCVS has advantages over WinCVS for work on SourceForge. It has a clearer interface which is integrated into Windows Explorer. WinCVS has a more complex and mature interface. For more obscure commands it may be easier or necessary to use WinCVS. TCVS比WINCVS优势。简洁集成于资源管理器，WINCVS有一个更综合成熟的界面。更简单或者必需的WINCVS使用需要更多的命令行知识。

A particular benefit is that TortoiseCVS has an SSH client built into it, without special setup. Anyone can easily commit code to SourceForge.net projects using TortoiseCVS. 还有一点是TCVS内建SSH客户端。不需要另行安装。任何人都可以用TCVS方便的提交代码到SF。

Installing TortoiseCVS 安装
Go to and download the Download page. 访问网站从下载页面下载。

To install, run the executable and follow the instructions. 按照下列指示运行安装程序

Since TortoiseCVS is a shell extension, you need to reboot your machine. 由于是一个外壳扩展，所以需要重启

Checking out an existing project 取出一个已经存在的项目
If you are working on an existing project first you now need to check out the code. 如果你第一次工作于一个已经存在地项目，你应该取出源码

Make sure you have made an account on SourceForge.net, and that you have been added as a developer to the project you are going to work on. A project administrator needs to do this. 首先确认你有一个帐号，你已经成为项目的开发组一员，项目管理员处理

In Windows Explorer go to the folder that you would like to check the code out into. 到资源管理器中你想要放置源码的目录

Right click and from the context menu choose the command CVS Checkout...; it's next to the Tortoise icon. 右键关联菜单选择取出，TCVS图标

You will need your user name on SourceForge.net, and the project UNIX name. Fill in the dialog as follows: 你需要你的用户名、项目的UNIX名称。填充对话框 Protocol: Secure Shell (:ext) 安全协议 Server: cvs.sourceforge.net  服务器 Directory: /cvsroot/projectname  目录 Username: sername 用户名
Click Fetch List to get a choice of modules. You will need to enter your password in the dialog at this point. Then pick the module that you would like. 点击列表按钮，获得选择模块，你需要输入密码，选择你需要的模块

Choose OK.TortoiseCVS will now check out the code. You will need to enter your password. 确定，TCVS将取出源码，你需要输入密码

You can now alter files and then select CVS Commit on the top level folder to make your changes in the repository. For more information read the TortoiseCVS User's Guide. 你现在可以进行修改，在顶层目录进行提交使修改在仓库中生效。更多信息见手册

Get an error? 出现错误If you get an error saying something like Could not chdir to home folder /home/users/r/rd/rdonkin: No such file or folder then you need to log into the server with SSH to force creation of your home folder. Do this by connecting to either with Putty or a command line SSH. 如果出现错误，如说什么不能进入主目录；没有该文件或者文件夹，那么你要通过SSH登录服务器，创建HOME目录，通过使用PUTTY或者SSH命令行连接

Working on a new project 工作一个新项目If you are working on a new project then you first need to create a new module in the repository. 如果是新项目，你首先创建一个新的模块

Create a folder with the name you would like the module to have. 创建一个文件夹以模块命名

Put the files you would like to add in the folder. 把文件拷贝到这里

Right click on the folder, and choose Make New Module from the CVS submenu. 右键，新模块

Fill in the dialog as described in the previous section. Note that the module name is filled in for you. 按照上一章说的填充对话框。自己输入模块名称

Choose OK. You will need to enter your password twice, and the module will be made for you.确定，输入密码，模块创建

Proceed to add files and folders by right clicking on them and choosing CVS Add or CVS Add All Recursively from the context menu. 增加文件：右键 选择 增加；增加所有递归 For more information read the TortoiseCVS Daily User's Guide 读用户手册

Tired of entering your password all the time?始终输入密码
You need to make a public/private key pair. The public key goes on the server, and the private key sits on your hard drive. Now, when you connect the server can verify who you are because only you have your private key. 你需要制作一对公钥私钥，公钥在服务器，私钥在本地硬盘，现在你连接服务器可以校验你的身份，因为你有了私钥

To further protect your private key it is encrypted on your hard disk with a passphrase. You can however choose an empty passphrase, in which case you never have to enter a password but anyone with access to your computer can access your SSH CVS account. Or you can use an SSH Agent (such as Pageant) which will remember your passphrase for the duration of one session, so you only have to enter it once. 为了更好的保护私钥，密码加密了的，你可以选择一个空的密钥，这样你就不用每次输入密码，但是任何可以访问你电脑的人也可以访问你的SSH CVS帐号。或者你可以使用SSH代理，它可以在一个SESSION中记住你的密码，因此你只要输入一次。

TortoiseCVS uses a version of Plink as its SSH client. This means you can use PuTTYgen to make a public/private key pair, and you can use Pageant to point to where the private key is. First of all download them both from the PuTTY web site. TCVS使用一个版本的PLINK作为它的SSH客户端，意味着可以使用PUTTYGEN制作公钥私钥对，你可以使用 指向你的私钥。可以从网站下载

For information on how to use them read the PuTTY documentation on PuTTYgen and Pageant. In particular, make sure you read the sections "8.2: Using PuTTYgen, the PuTTY key generator" and "9.3.1 Making Pageant automatically load keys on startup". 如何使用看PUTTY文档，特别注意这章 8.2 使用 9.3.1

After making your public key with PuTTYgen you need to upload it using the SourceForge.net web interface. Log into the SourceForge web site, and go to your Account Preferences page. Down at the bottom is a section "Shell Account Information" with an entry "CVS/SSH Shared Authorized Keys". You need to add your public key there. 生成公钥后上传到SF.NET，登录站点，进入你的帐户参数，点击 帐号信息 CVS/SSH共享授权密钥 项目，在这里加入公钥