[documentation] CVS Checkout Instructions Wrong -- please verify

[Greg Knaddison - GVS]

On Feb 5, 2008 9:57 PM, Shai Gluskin <shai at content2zero.com> wrote:
> Okay, so I really don't get it. Glad I raised this.
>
> So let's say I have a CVS version of 5.6 installed.
>
> At the command line I navigate to the Drupal directory.
>
> And then I go:
>
>  cvs up -r DRUPAL-5-7
>
> Please confirm.

Yes, that would upgrade your current installation to the tag
DRUPAL-5-7.  If you have modified files locally (notably the
settings.php) then cvs will do its best to leave your edits alone
while merging in edits that have been made to parts of the file that
you did not change.

CVS (and most tools) do a pretty good job of this merging process.

You can try this out in a non production environment.  Do the first
command with "-r DRUPAL-5-6" to get the 5.6 version.  Then modify some
files and do a "cvs up -r DRUPAL-5-7" to see what happens.  At least
that was the way that I learned best.  There are lots of useful
options to the "cvs co" and "cvs up" commands which you can use to get
different versions of data from the code repository such as by date.

> That would suggest that it's the upgrade part of the instructions that are
> the most incomplete. One benefit of me going through this learning process
> is that I think I'll be able to improve the docs.

I'm not sure if they're incomplete or not, but certainly it would help
to better interlink that checkout page to an upgrading page.

Definitely - it's always easiest to find areas to improve as you are
learning yourself.  Thanks for sharing your search for knowledge and
for documenting it.

Greg

-- 
Greg Knaddison
Denver, CO | http://knaddison.com
World Spanish Tour | http://wanderlusting.org/user/greg