Checking Out And Updating Sources

Checking Out A Fresh Copy

To start working on your own server, the sources of the development version need to be checked out with the checkout command. This command downloads the sources to your computer where it can later be updated to synchronize with the changes made on the repository server.

To checkout the /trunk/ directory the following command is used:

svn checkout http://svn.oscommerce.com/repos/trunk oscommerce_svn_trunk

This will download a fresh copy of /trunk/ in the oscommerce_svn_trunk directory you are currently located in.

To checkout a branch of a developer the following command is used:

svn checkout http://svn.oscommerce.com/repos/branches/<name of branch> target_name

The <name of branch> part must be replaced with the name of the branch you would like to checkout, without the <> symbols. The files will then be saved in the target_name directory you are currently located in.

Please note that a checkout of the development repository is performed only once. Subsequent updates to your working files are then performed with the update command.

Updating Your Working Directory

Your working directory, which contains a checkout of the development repository, can be synchronized with the changes made on the development server with the update command:

svn update

Before updating your working directory it is a good habit to find out what files will be updated by running the status command. Please read the Finding Out The Status document for more information.

If you have modified your local working version, subversion will automatically try to merge the differences into the updated and locally-modified files. If a conflict occurs in the merging of the updates, you are required to manually edit the file to fix the marked conflicts.

Certain directories and files can be updated individually by entering the directory in your local version of where you would like to perform the update.

To update all files in the /oscommerce/includes/classes directory the following command is used:

cd oscommerce/includes/classes
svn update

The same function can be performed from the root of your working directory as:

svn update oscommerce/includes/classes

To update a specific file, for example /oscommerce/includes/application_top.php, the following command is used:

cd oscommerce/includes
svn update application_top.php

The same function can be performed from the root of your working directory as:

svn update includes/application_top.php