Creating a Local Repository (Optional)
If you plan to do something a bit more sophisticated locally, it is a good idea to use the CVS features. It is easy to set up, and there is not much difference between working with a local repository or with a repository accessed via a network protocol: you make all changes in the working folder and use your favorite CVS tools to update and commit, just like if you were using the network. To create a local repository in the "user" home folder, and to start a "myproject" module for your work, type on any console application:
mkdir /home/user/repository cvs -d /home/user/repository init mkdir /home/user/repository/myproject
Now you have a local CVS repository at "/home/user/repository"!
Finding and Setting The Repository Location And The Retrieval Method
There are several methods to access a CVS repository. It may be a local repository, reached via password authentication (:pserver:), secure shell (using :ext:), kerberos authentication (:kserver:) and others. This guide covers local and password authenticated repositories. If you want to use another method, additional information can be found in the cvs info page. The format for the repository location is:
Not all this information (user, password, hostname, port) is always necessary. For instance, if you created a local CVS repository from the example above, the name of the repository would be the path to the repository. (In the example, /home/user/repository).
Open source projects typically offer Anonymous CVS access to their sources. This means you can easily grab the latest sources without asking for a CVS account. Anonymous CVS uses password authentication.If you want to work with an project that offers this kind of access, visit the project homepage and search for the anonymous cvs location and mirrors.
As we will show, you don't need a CVS account to improve your favorite project. With Anonymous CVS, you can modify your working folder, create a file with the modifications (a diff or patch file) and send them to the project. But if you start working in a regular way either as an artist, documenter, translator, web master, whatever, it is sensible to ask for a CVS account.
Below, we use the main KDE Anonymous CVS repository location in the command examples. Replace it with the location you selected. If you selected a location using pserver as retrieval method, you will need to login and type a password. If you are using an Anonymous CVS mirror, just hit enter when asked for this password. This is required only once per location, because the CVS passwords are stored for later use in the ".cvspass" file in your home folder. If you are using a local repository, you won't need to login.
Cervisia has the ability to store different repository locations.
- To add a repository location, click the "Repository" menu then the "Repositories..." menu item. .
- The "Configure Access to Repositories" dialog box will pop up.
- Press the "Add..." button. The "Add Repository" dialog should appear.
- Type the repository location in the "Repository" text box. Press "OK". One example is "/home/user/repository". KDE's main Anonymous CVS repository is ":pserver:firstname.lastname@example.org:/home/kde".
- If your repository's retrieval method is pserver, you still have to log in. The "Status" column is probably showing "Not logged in".
- Press the "Login" button. If you are using an Anonymous CVS mirror just hit enter. Else, type your password. If everything went well, now the "Status" column should show: "Logged in". .
- If you want, add another location. Cervisia will store as many locations as you like!.