|
version 1.22, 2003/02/03 18:03:52
|
version 1.23, 2011/01/09 19:01:23
|
|
Line 2
|
Line 2
|
| "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
| <!-- The LearningOnline Network with CAPA --> |
<!-- The LearningOnline Network with CAPA --> |
| <!-- $Id$ --> |
<!-- $Id$ --> |
| <html> |
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> |
| <head> |
<head> |
| <meta http-equiv="Content-Type" content="text/html; charset=utf-8"></meta> |
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"></meta> |
| <title>LON-CAPA Software Developer Guide</title> |
<title>LON-CAPA Software Developer Guide</title> |
|
Line 10
|
Line 10
|
| <body> |
<body> |
| <h1>LON-CAPA Software Developer Guide</h1> |
<h1>LON-CAPA Software Developer Guide</h1> |
| <p> |
<p> |
| January 17, 2001</i> |
Created: <i>January 17, 2001</i> |
| <br /><i>Last updated, August 14, 2002</i> |
<br />Last updated: <i>January 9, 2011</i> |
| </p> |
</p> |
| <ol> |
<ol> |
| <li><a href="#Using_CVS">Using CVS</a> |
<li><a href="#Using_CVS">Using CVS</a> |
| <ul> |
<ul> |
| <li><a href="#cvslog">Logging in and out (cvs login; cvs logout)</a></li> |
<li><a href="#cvslog">Setting up cvs access</a></li> |
| <li><a href="#cvsupdate">Updating files (cvs update -d)</a></li> |
<li><a href="#cvsupdate">Updating files (cvs update -d)</a></li> |
| <li><a href="#cvssave">Saving files (cvs commit)</a></li> |
<li><a href="#cvssave">Saving files (cvs commit)</a></li> |
| <li><a href="#cvsadd">Adding files (cvs add)</a></li> |
<li><a href="#cvsadd">Adding files (cvs add)</a></li> |
|
Line 44 These instructions assume that you are u
|
Line 44 These instructions assume that you are u
|
| terminal. |
terminal. |
| <ul> |
<ul> |
| <li><a name="cvslog" /> |
<li><a name="cvslog" /> |
| <h3>Using CVS: Logging in and out (cvs login; cvs logout)</h3> |
<h3>Setting up cvs access</h3> |
| <p> |
<p> |
| In order to log into CVS, CVS needs to be part of your system environment. |
CVS needs to be part of your system environment in order to access the LON-CAPA CVS repository, |
| You can do this by: |
You can do this by: |
| </p> |
</p> |
| <p> |
<p> |
| <font color="#008800"> |
<font color="#008800"> |
| <tt>export CVSROOT=:pserver:USERNAME@install.lon-capa.org:/home/cvs</tt> |
<tt>export CVS_RSH=ssh</tt><br /> |
| |
<tt>export CVSROOT=:ext:USERNAME@source.lon-capa.org:/home/cvs</tt> |
| </font> |
</font> |
| </p> |
</p> |
| <p> |
<br /> |
| To actually login, you will need to execute the following command: |
To actually issue CVS commands you will need to: |
| </p> |
<br /><br /> |
| <p> |
<ol> |
| <font color="#008800"> |
<li>Have installed the CVS client, e.g., <font color="#008800"><tt>yum install cvs</tt></font></li> |
| <tt>cvs login</tt> |
<li>Have been issued a CVS account, (send a request to the <a href="mailto:helpdesk@loncapa.org">LON-CAPA helpdesk</a>)</li> |
| </font> |
<li>Have generated public and private keys via <font color="#008800"><tt>ssh-keygen -t dsa</tt></font> and sent the public key to the LON-CAPA helpdesk for installation on the CVS server.</li> |
| </p> |
</ol> |
| <p> |
|
| You are then prompted for a password. |
|
| If you do not have a password, or the password is not working, you |
|
| should contact <a href="mailto:helen@lon-capa.org">helen@lon-capa.org</a>. |
|
| </p> |
|
| <p> |
<p> |
| The first time you use CVS, you need to CHECKOUT the repository. |
The first time you use CVS, you need to CHECKOUT the repository. |
| Generally speaking, you need to checkout <tt>loncapa</tt> only once |
Generally speaking, you need to checkout <tt>loncapa</tt> only once |
|
Line 80 To check-out the repository, use the <tt
|
Line 76 To check-out the repository, use the <tt
|
| <tt>cd loncapa</tt> |
<tt>cd loncapa</tt> |
| </font> |
</font> |
| </p> |
</p> |
| <p>After completing work with the CVS repository, |
|
| you can log out: |
|
| </p> |
|
| <p> |
|
| <font color="#008800"> |
|
| <tt>cvs logout</tt> |
|
| </font> |
|
| </p> |
|
| </li> |
</li> |
| <li><a name="cvsupdate" /> |
<li><a name="cvsupdate" /> |
| <h3>Using CVS: Updating files (cvs update -d)</h3> |
<h3>Using CVS: Updating files (cvs update -d)</h3> |
|
Line 196 cvs commit FILENAME
|
Line 184 cvs commit FILENAME
|
| Note that CVS typically invokes the |
Note that CVS typically invokes the |
| <a href="http://www.eng.hawaii.edu/Tutor/vi.html">vi</a> editor and solicits |
<a href="http://www.eng.hawaii.edu/Tutor/vi.html">vi</a> editor and solicits |
| comments about your latest changes to the software. Your comments should be |
comments about your latest changes to the software. Your comments should be |
| both short yet uniquely descriptive. For example: |
descriptive and informative. For example: |
| </p> |
</p> |
| <ul> |
<ul> |
| <li><strong>BAD</strong> - "made some changes and am drinking soda"</li> |
<li><strong>BAD</strong> - "saving my work"</li> |
| <li><strong>GOOD</strong> - "implemented syntax checking of perl scripts |
<li><strong>GOOD</strong> - "implemented syntax checking of perl scripts |
| with -c flag"</li> |
with -c flag"</li> |
| </ul> |
</ul> |
![[BACK]](/icons/back.gif){kind=icon}
Return to readme.html CVS log ![[TXT]](/icons/text.gif){kind=icon}
![[DIR]](/icons/dir.gif){kind=icon}
Up to [LON-CAPA] / loncom / build