Configuring the General Properties
Top  Previous  Next


Use the General tab of the Project Properties dialog box to set basic information about the project.

 
 
The General tab displays the following properties:
·Project name – Enter the desired project name. This field is read-only if you edit an existing project. Click the project's label twice within the Project Library to rename a project.  
·Repository – Specify the desired repository type. The available repository types are explained below.  
·Work folder – Specify the project directory. For example, enter C:\Project1 to include all files added to the RCS Repository from the C:\Project1 folder. For details see the Work Folder Customization section below.  
·Repository folder – Specify the desired archive directory, for example, \\Server2\Project1.  
·Include sub-folders – Set this option if you wish to include sub-folders of the specified root. (This feature is available in the Pro edition only).  
·Options – Set repository specific option. This button is active only on specific repository types.  
·Work mode – Specify the desired work mode. The available work modes are explained below.  
·Import from VSS – Check this option to import a Microsoft Visual SourceSafe (VSS) project. Click '...' to select the desired VSS project. For full details, please see below. (This feature is available in the Pro edition only)  
·Description and comments – Describe the project. On the first line, enter a short sentence that will be the project title. If you want, enter additional details on further lines.  
 
Project Repository Types

CS-RCS supports the following repository types:
·Central CS-RCS Repository – The project exists in a folder or sub-tree of the central Repository. This is the default repository type and requires the minimum settings since the working files are mapped to the central CS-RCS repository.  
·Alternate RCS Repository – Use this type to access an external RCS Repository tree. This type is usually used to access projects of other departments connected by the company high-speed network.  
·Internet Repository – Use this type to access co-located projects over the Internet. For full information, see Working with Internet Projects.  
·CVS Repository – Use this type to access a remote GNU CVS Repository using one of the CVS client/server protocols (pserver, sspi, rsh, ssh, sserver). For full information, see Working with CVS Network Projects.  
·CS-RCS Repository on FTP Server – Use this type to access a remote CS-RCS Repository using FTP protocol. FTP access is only suitable for small projects. For larger projects, you should select the Internet Repository or CVS Repository type. (see above) See 'Defining FTP projects' later in this chapter for more information.  

The CS-RCS Repository on FTP Server and CVS Repository types are available in the Pro edition only. The FTP Server type is not available if you are running CS-RCS in single-user mode.

Work Folder Customization

The project work folder is normally defined by using a local workstation path such as C:\Project1. This means that all workstations that retrieve the project files will do so to their own local C:\Project1 folder. This method provides each user with a "sandbox" in which to perform and test changes. Then, the changes may be committed to the Repository.

If multiple users share the same computer, it is possible to give each user their own unique work folder using the %USERNAME% key word. For example, enter C:\%USERNAME%\Project1 to create a separate work directory for each user. The %USERNAME% keyword is replaced by the current user's Windows username
 
If users change workstations frequently, it is advised to use a network path in conjunction with %USERNAME% keyword
For example, enter \\Server\Work\%USERNAME%\Project1 to create a separate network work folder for each user.

In special situations you may choose to use a work folder that is shared by all users, for example \\Server\Work\Project1. If you choose to use a shared work folder, make sure to set the Use shared work folder option in the project Properties to NTFS Permissions or Windows Permissions. With NTFS Permissions CS-RCS uses NTFS security features to grant edit permission only to the user that checked-out the document, however, some Windows file-servers do not support these security features. On these servers, all users may be able to edit an exclusively locked document. For more details, see the FAQ: How should I define a shared work folder on the server?
 
By default, the work folder definitions affect all project users on all workstations. You may customize this default behavior, by definition of per workstation local work folder. For more details see Customizing Projects on a Local Workstation

Project Work Modes

CS-RCS supports the following work modes:
·Single Owner – Only the project administrator may check-in new revisions. This mode is useful for private projects or to provide better control during critical release phases. This is the only work mode available in a single-user environment.  
·Exclusive Locks – This mode prevents two users from modifying the same file at the same time. Users must lock the file before they can edit and check it in. This is the default mode in a workgroup environment.  
·Concurrent Changes (CVS) – This mode supports concurrent changes to the same file. Whenever possible, CS-RCS will automatically merge the changes. Refer to Concurrent Changes (CVS) Mode for more details. (This mode is available in the Pro edition only.)  

Import from VSS
 
Check this option to import a Microsoft Visual SourceSafe (VSS) project. Click ... to select the desired VSS project. The following parameters need to specified :
·Database path – The folder that contains the VSS SRCSAFE.INI file. Click to select the database folder.  
·User – The VSS user name.  
·Password – The VSS user password.  
·Project – Specify the VSS project name. Click to select the project from the database.