RE: CVS newbie setup questions

[Charlie Wu]

Hi all:

Thank you all for your kind help.. I've finally got this to work.

For other newbies on the list.. here's the answer and what I expect
to see in a Dummy's guide to CVS

1. Download and install CVS
2. set the CVSROOT environment variable 
3. run cvs init to create a repository
4. this is what I missed.. if you have a directory /a/b/c you want to have
controlled by cvs, you have to cd /a/b/c, and run cvs import -m 'description
of c' c tag1 tag2 where tag1 and tag2 seems to really be useless :)
5. maybe descriptions on how to set up pservers but i'm not there yet :)

Thanks again for all your help, really appreciate it

Charlie

-----Original Message-----
From: David Taylor [mailto:address@hidden
Sent: Tuesday, September 18, 2001 4:34 PM
To: Charlie Wu
Cc: David Rasmussen; address@hidden
Subject: Re: CVS newbie setup questions


Charlie Wu wrote:

>
>
> Hi David:
>
> I've gone through most online manuals.. including the verbose one you
> suggested below.. but despite reading all these *fine* manuals, I am
> still getting nowhere.
>
> I installed CVS, set my env variable, did the init, then what? The
> manual said: (http://www.cvshome.org/docs/blandy.html)
>
> Checking out a working directory

Actually, for a new repository, the next step is to populate the
repository. From your previous message:

Charlie Wu wrote:
> address@hidden/users/home11/cwu}: echo $CVSROOT
> /users/home11/cwu/junk
>  address@hidden/users/home11/cwu}: ls junk
> CVSROOT/

it looks like your repository is empty (only the directory CVSROOT,
containing CVS administrative files, appears). That is why checkout
fails:

>  address@hidden/users/home11/cwu}: cvs checkout extra
> cvs checkout: cannot find module `extra' - ignored
> address@hidden/users/home11/cwu}: cvs checkout /users/home11/cwu/extra
> cvs checkout: cannot find module `/users/home11/cwu/extra' - ignored

In general, if "ls $CVSROOT/<path>*" doesn't work, neither will "cvs
checkout $CVSROOT/<path>" (ignoring, for now, the more advanced case
where $CVSROOT/<path> doesn't exist but is defined in
$CVSROOT/CVSROOT/modules file).

The standard way to start populating the repository is with the "cvs
import" command. This command is almost too hideous to discuss in
public. It is generally the first CVS command used by
non-administrators, but it unfortunately is one of the most confusing.
The most common questions an admin has to be ready to field:

- Two of its arguments are "tags". What are "tags"?
- What should I put for "vendor-tag" ? (Standard answer:  "It doesn't
matter")
- If it doesn't matter, why do I need it?
- I've used "cvs import" before, but I can't remember the syntax (it has
*three* required arguments! But one doesn't matter...)
- When I execute the command, should I be in the directory, or one level
up? (Answer: In the directory - "import" creates the path given in the
"repository" argument. This question probably arises from the
expectation that "import" works like "cp -r * dest" , which would NOT
create a directory dest if it did not exist.)

So this is the point where the manuals kick in: read up on "cvs
import".  Once the repository is populated, you're ready to checkout: cd
to an empty directory and checkout as before. After that you can add
and/or modify, and then commit files.

> It's really not that I don't want to RTFM before I ask, but I have to
say CVS > can definitely use> some better step-by-step guide -

I'd like to hear some specifics on how the existing tutorials failed to
meet your needs: to create a "better" guide, we need to define "better".
Otherwise, we risk creating Yet Another Useless CVS Tutorial.
> I'm not a unix sys admin and I'm trying to convince my group> that CVS
is a much better tool than those commercial ones like clearcase, vss, >
and heaven> forbid, interwoven, and this user-unfriendliness is really
pulling my leg here>> Thanks again>> Charlie

Again, it depends on how you define "better". But its initial cost is
certainly less and, these days, that can be a very decisive argument.
Managing parallel development is inherently not easy. Even if you've got
the bucks to spend, a case can be made for first  using a free tool like
CVS (to better understand the issues and your needs) before locking into
a more expensive solution.

dtayl