Difference between revisions of "Version Control System Access"

From GMOD
Jump to: navigation, search
m (CVS Access moved to Version Control System Access: more generic title, not tied to any specific version control system)
(modified intro paragraph to name SVN as primary VCS, added info for svn read-only and developer access)
Line 1: Line 1:
 
<div class="emphasisbox" style="font-size: 120%">
 
<div class="emphasisbox" style="font-size: 120%">
GMOD is migrating from CVS to [http://subversion.tigris.org/ Subversion] in on September 15 2009.  See the [[CVS to Subversion Conversion]] page for more.
+
GMOD is migrating from CVS to [http://subversion.tigris.org/ Subversion] on September 15, 2009.  See the [[CVS to Subversion Conversion]] page for more.
 
</div>
 
</div>
  
 +
''Subversion'' (often abbreviated ''SVN'' is the ''source code control'' system used by most of GMOD.  Source code control systems, also known as ''revision control'' or ''version control'' systems are used to record changes to computer files.  GMOD's main source code repository is at [http://gmod.svn.sourceforge.net/ SourceForge].
  
''CVS'' is the ''source code control'' system used by most of GMOD.  Source code control systems, also known as ''revision control'' or ''version control'' systems are used to record changes to computer files.  GMOD's main source code repository is at [http://gmod.cvs.sourceforge.net/ SourceForge].
+
This page explains how to both download and update the main GMOD repository at SourceForge.  For more on SVN itself see the [http://subversion.tigris.org/ Subversion Home Page] and the official [http://svnbook.red-bean.com/ Subversion Book].
  
This page explains how to both download and update the main GMOD repository at SourceForgeFor more on CVS itself see the [http://ximbiot.com/cvs/ CVS Home Page].
+
SVN is used by GMOD developers to update the components.  SVN is also used by some GMOD users, most of whom never modify any GMOD codeGMOD users access SVN when they want to get component source code so they can use the latest development version of that component, without having to wait for the next official release. Please note, however, that components pulled from SVN are '''development''' versions, and may not always work as expected.
  
CVS matters to GMOD developers, who use it to update the components.  CVS also matters to many GMOD users, most of whom never modify any GMOD code.  GMOD users access CVS when they want to get component source code so they can build the latest and greatest version of that component, without having to wait for the next official release.
+
== Browsing SVN Repositories ==
  
== Checkout (Read-only) Access ==
+
GMOD SVN repositories can be browsed via web: http://gmod.svn.sourceforge.net/gmod/.
 +
 
 +
== SVN Read-only Access ==
 +
 
 +
The GMOD [[Glossary#SVN|SVN]] repository can be checked out through anonymous SVN with the following instruction set. The module you wish to check out must be specified in place of '''PROJECTNAME'''.
 +
 
 +
svn co https://gmod.svn.sourceforge.net/svnroot/gmod/PROJECTNAME/trunk
 +
 
 +
See http://gmod.svn.sourceforge.net/ for available GMOD projects in SVN repositories.
 +
 
 +
You can then get updates with the <code>svn update</code> command.
 +
 
 +
GMOD SVN repositories can also be browsed on the web: http://gmod.svn.sourceforge.net/gmod/.
 +
 
 +
== SVN Developer Access ==
 +
 
 +
Developer access uses the same URL paths as read-only access.  When performing write operations, you will simply be prompted for your SourceForge.net username and password. To perform write operations, a GMOD project administrator must have granted you write access to the repository.
 +
 
 +
<div class="emphasisbox" style="font-size: 120%">
 +
GMOD is migrating from CVS to [http://subversion.tigris.org/ Subversion] on September 15, 2009.  See the [[CVS to Subversion Conversion]] page for more.
 +
</div>
 +
 
 +
== Browsing CVS Repositories ==
 +
 
 +
GMOD CVS repositories can also be browsed on the web: http://gmod.cvs.sourceforge.net/gmod/.
 +
 
 +
== CVS Checkout (Read-only) Access ==
  
 
The GMOD [[Glossary#CVS|CVS]] repository can be checked out through anonymous (pserver) CVS with the following instruction set. The module you wish to check out must be specified as the ''modulename''. When prompted for a password for anonymous, simply press the Enter or Return key.
 
The GMOD [[Glossary#CVS|CVS]] repository can be checked out through anonymous (pserver) CVS with the following instruction set. The module you wish to check out must be specified as the ''modulename''. When prompted for a password for anonymous, simply press the Enter or Return key.
Line 27: Line 54:
 
Please note that although we do our best not to check in malfunctioning software, the CVS versions of these packages are cutting edge and hence not guaranteed to be bug-free. Always be careful when using these packages!
 
Please note that although we do our best not to check in malfunctioning software, the CVS versions of these packages are cutting edge and hence not guaranteed to be bug-free. Always be careful when using these packages!
  
==Developer CVS Access via SSH==
+
== CVS Developer Access via SSH==
  
 
Only project developers can access the CVS tree via this method. SSH1 must be installed on your client machine. Substitute ''modulename'' and ''developer'' name with the proper values. Enter your site password when prompted.
 
Only project developers can access the CVS tree via this method. SSH1 must be installed on your client machine. Substitute ''modulename'' and ''developer'' name with the proper values. Enter your site password when prompted.
Line 33: Line 60:
 
  export CVS_RSH=ssh
 
  export CVS_RSH=ssh
 
  cvs -z3 -d:ext:''developername''@gmod.cvs.sourceforge.net:/cvsroot/gmod co ''modulename''
 
  cvs -z3 -d:ext:''developername''@gmod.cvs.sourceforge.net:/cvsroot/gmod co ''modulename''
 
 
==Browsing CVS repositories==
 
 
GMOD CVS repositories can also be browsed on the web: http://gmod.cvs.sourceforge.net/gmod/.
 
  
 
[[Category:GMOD Developers]]
 
[[Category:GMOD Developers]]

Revision as of 05:35, 15 September 2009

GMOD is migrating from CVS to Subversion on September 15, 2009. See the CVS to Subversion Conversion page for more.

Subversion (often abbreviated SVN is the source code control system used by most of GMOD. Source code control systems, also known as revision control or version control systems are used to record changes to computer files. GMOD's main source code repository is at SourceForge.

This page explains how to both download and update the main GMOD repository at SourceForge. For more on SVN itself see the Subversion Home Page and the official Subversion Book.

SVN is used by GMOD developers to update the components. SVN is also used by some GMOD users, most of whom never modify any GMOD code. GMOD users access SVN when they want to get component source code so they can use the latest development version of that component, without having to wait for the next official release. Please note, however, that components pulled from SVN are development versions, and may not always work as expected.

Browsing SVN Repositories

GMOD SVN repositories can be browsed via web: http://gmod.svn.sourceforge.net/gmod/.

SVN Read-only Access

The GMOD SVN repository can be checked out through anonymous SVN with the following instruction set. The module you wish to check out must be specified in place of PROJECTNAME.

svn co https://gmod.svn.sourceforge.net/svnroot/gmod/PROJECTNAME/trunk

See http://gmod.svn.sourceforge.net/ for available GMOD projects in SVN repositories.

You can then get updates with the svn update command.

GMOD SVN repositories can also be browsed on the web: http://gmod.svn.sourceforge.net/gmod/.

SVN Developer Access

Developer access uses the same URL paths as read-only access. When performing write operations, you will simply be prompted for your SourceForge.net username and password. To perform write operations, a GMOD project administrator must have granted you write access to the repository.

GMOD is migrating from CVS to Subversion on September 15, 2009. See the CVS to Subversion Conversion page for more.

Browsing CVS Repositories

GMOD CVS repositories can also be browsed on the web: http://gmod.cvs.sourceforge.net/gmod/.

CVS Checkout (Read-only) Access

The GMOD CVS repository can be checked out through anonymous (pserver) CVS with the following instruction set. The module you wish to check out must be specified as the modulename. When prompted for a password for anonymous, simply press the Enter or Return key.

cvs -d:pserver:anonymous@gmod.cvs.sourceforge.net:/cvsroot/gmod login
cvs -d:pserver:anonymous@gmod.cvs.sourceforge.net:/cvsroot/gmod co modulename

If you need to check out a particular revision/tag in the repository, add -r tag_name to the command. For example, if you needed the 'stable' branch of the GBrowse repository, you would do this in your checkout command:

 cvs -d:pserver:anonymous@gmod.cvs.sourceforge.net:/cvsroot/gmod co -r stable Generic-Genome-Browser

See http://gmod.cvs.sourceforge.net/ for available CVS repositories.

You can then get updates with the cvs update -d command (the -d command tells CVS to get any new directories that have been added to the repository since the last update).

Please note that although we do our best not to check in malfunctioning software, the CVS versions of these packages are cutting edge and hence not guaranteed to be bug-free. Always be careful when using these packages!

CVS Developer Access via SSH

Only project developers can access the CVS tree via this method. SSH1 must be installed on your client machine. Substitute modulename and developer name with the proper values. Enter your site password when prompted.

export CVS_RSH=ssh
cvs -z3 -d:ext:developername@gmod.cvs.sourceforge.net:/cvsroot/gmod co modulename