Japanese

CVS start guide

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)

cvs main trunk/branch history map

                                  +---------+    +---------+
                 legacy branch    | 10.62.2 |----| 10.62.x |
                                / +---------+    +---------+
                               /
                              /
+----------------+    +------------------+    +---------------+    +-----+    +-----+
|10.62 (skk10_62)|----|10.62a (skk10_62a)|----| 11.3 (Sakurai)|----|11.4 |----|11.x |  <- The main trunk
+----------------+    +------------------+    +---------------+    +-----+    +-----+     (daredevil skk)
                                                     /
                                                    /
                                                   /
                                    +-----+    +-----+    +-----+
                daredevil branch    |11.1 |----|11.2 |----|11.x |
                                    +-----+    +-----+    +-----+

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.

Login

First, you need to 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 CVS password.

     CVS password: guest (CR)

File ~/.cvspass holds the password.(*1)

Checkout

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

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

To checkout a branch called `legacy' (maintenance version of SKK-10.x):

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

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

     $ cd skk/main

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

Update

You can use `update' command from within your working directory to bring work tree in sync with the repository.

Your working copy knows the root of the repository (i.e. openlab.jp:/circus/cvsroot)(*3), thus you can type the following:

   $ cvs update -dP

The option of update command `-d' adds to your working copy new directories that exist only in repository. `-P' removes from your working copy directories that does not exist repository. I recommend that you specify these options of update command by adding the following lines to your ~/.cvsrc file.

     update -P -d

How to check files into the repository (commit, tag)

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 by OpenSSH.

SSH login

There's no need to login when you access the cvs server via ssh. All committers share a unique account called skk-cvs.

Checkout/Update

You can checkout sources by the following command. 
% cvs -d:ext:skk-cvs@openlab.jp:/circus/cvsroot co skk/main

You can similarly execute other commands like update, etc.

Commit

Please follow the procedure before you commit changes.

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

Tag

Each version of Daredevil SKK uses its codename as a release tag. See `READMEs/Codename'. 

     $ cvs tag (Codename) .

legacy branch uses tag name like skk10_62, skk10_63, skk10_64...

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

`CVS/Root' in the working copy directory (and its subdirectories) holds information of the root of the repository.

*4

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.

Table of Contents

Top

mailto: skk@ring.gr.jp

Last Modified: $Date: 2007/05/16 13:15:26 $