version 1.20, 2002/08/14 17:07:19
|
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> |
<meta name="GENERATOR" |
|
content="Scott Harrison and Emacs Version 3.14159265358979"></meta> |
|
<title>LON-CAPA Software Developer Guide</title> |
<title>LON-CAPA Software Developer Guide</title> |
</head> |
</head> |
<body> |
<body> |
<h1>LON-CAPA Software Developer Guide</h1> |
<h1>LON-CAPA Software Developer Guide</h1> |
<p> |
<p> |
<br /><i>Written by Scott,<br /> |
Created: <i>January 17, 2001</i> |
<a href="mailto:sharrison@users.sourceforge.net"> |
<br />Last updated: <i>January 9, 2011</i> |
sharrison@users.sourceforge.net</a>,<br /> |
|
January 17, 2001</i> |
|
<br /><i>Last updated, August 14, 2002</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 49 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 85 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 201 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> |
Line 659 RPM: BinaryRoot base_rpm_file_list
|
Line 642 RPM: BinaryRoot base_rpm_file_list
|
cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \ |
cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \ |
perl lpml_parse.pl make_rpm $(CATEGORY) $(DIST) $(SOURCE) $(TARGET) \ |
perl lpml_parse.pl make_rpm $(CATEGORY) $(DIST) $(SOURCE) $(TARGET) \ |
> base_customizerpm.xml |
> base_customizerpm.xml |
cat base_rpm_file_list.txt | perl make_rpm.pl base 3.2 '' '' \ |
cat base_rpm_file_list.txt | perl make_rpm.pl base 3.2 1 '' '' \ |
BinaryRoot base_customizerpm.xml |
BinaryRoot base_customizerpm.xml |
|
|
BinaryRoot: base_rpm_file_list |
BinaryRoot: base_rpm_file_list |
Line 683 occur on the '/' filesystem location.
|
Line 666 occur on the '/' filesystem location.
|
span of months) and, unlike other automated RPM-builders, cleanly |
span of months) and, unlike other automated RPM-builders, cleanly |
builds new RPMs without any after-effect of temporary files left |
builds new RPMs without any after-effect of temporary files left |
on the system. The generated RPM is labeled in the format |
on the system. The generated RPM is labeled in the format |
LON-CAPA-base-(VERSION)-1.i386. VERSION is specified inside the |
LON-CAPA-base-(VERSION)-(RELEASE).i386. VERSION is specified inside the |
Makefile. |
Makefile. |
</p> |
</p> |
</li> |
</li> |