CVS start guide for SKK developers

Japanese

These are notes on how to get read and/or write access to SKK source repository at Ring OpenLab CVS server. If you find something wrong, or know a better way to do that, please let us know.

Table of Contents

CVS repository tree

     $CVSROOT(openlab.jp:/circus/cvsroot)
        |
        |
        +-- skk --+-- main (Main distribution -- Emacs Lisp, tutorials, etc)
                  |
                  |
                  +-- dic (Dictionaries)
                  |
                  |
                  +-- tools (Dictionary maintenance tools)
                  |
                  |
                  +-- skkserv (Dictionary server)
                  |
                  |
                  +-- pySKK (SKK related libraries using python)
                  |
                  |
                  +-- web (Web page html files)

How to get CVS

CVS is distributed at

http://ftp.gnu.org/non-gnu/cvs/

If you want to know more about CVS, visit the following site.

http://www.nongnu.org/cvs/

Do you know pcvs (pcl-cvs)? It's a GNU Emacs front-end to CVS. pcvs is included in Emacs 21 distribution.

Obtaining SKK CVS sources

First, you need to do login just once as a user guest (unless you have commit access).

     % cvs -d :pserver:guest@openlab.jp:/circus/cvsroot login

When prompted, type guest as a CVS password.

     CVS password: guest [RET]

File ~/.cvspass will hold your encrypted passwords. (*1)

To get your own working copy of the sources, use checkout command. (*2) To checkout sources in the trunk:

     % cvs -d :pserver:guest@openlab.jp:/circus/cvsroot checkout skk/main

The working copy will be placed in `skk/main' directory.

     % cd skk/main

Now you can type make. You can hack files too, but need to get commit access to SKK CVS repositories before committing your changes.

You can use update command from within your working directory to bring work tree in sync with the repository. Since your working copy remembers the root of the repository (i.e. openlab.jp:/circus/cvsroot), you can type the following:

     % cd skk/main
     % cvs update -dP

How to check files into the repository (commit)

How to get commit (R/W) access to SKK CVS repositories

If you want a right to `commit' to SKK CVS repositories, write e-mail to skk-owner@ring.gr.jp with ssh2 public key generated with OpenSSH.

There's no need to login when you access the cvs server via ssh. All committers share a unique account called skk-cvs. You can checkout sources by the following command.

     % cvs -d:ext:skk-cvs@openlab.jp:/circus/cvsroot checkout skk/main

Similarly You can update your working sources with the following command.

     % cvs update -dP

Commit

Please follow the following procedure before you commit changes.

     $ cd skk/main
     $ cvs commit -m "Update." ChangeLog
     $ cvs commit -m "write about your changes." skk.el

Footnotes

*1

Your working copy has a directory called `CVS', which is used internally by CVS. This holds information of the user name, the root of the repository (i.e. openlab.jp:/circus/cvsroot), the name of the repository, etc. (*3) Usually you can set the `$CVSROOT' environment variable to an absolute path to the root of the repository, but the -d option and the `CVS/Root' file both override the `$CVSROOT' environment variable. If -d option differs from `CVS/Root', the former is used.

*2

You can write in ~/.cvsrc

     cvs -z3

The -z3 option enables compression during transit. Digit right after z represents compression rate, and -z9 means highest. However, -z3 may be better as -z9 forces a significant overhead to pserver.

*3

In pcl-cvs, a GNU Emacs front end to CVS, press C (cvs-mode-changelog-commit) and it tries to provide appropriate default log messages by looking at the `ChangeLog's.

Move to Table of Contents
mailto: skk@ring.gr.jp
Last Modified: $Date: 2015/01/04 03:11:58 $