|
version 1.19, 2002/07/31 18:14:31
|
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, July 31, 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 564 For safety reasons (so as to preserve a
|
Line 547 For safety reasons (so as to preserve a
|
| configuration files are NOT installed during this step. This means |
configuration files are NOT installed during this step. This means |
| that files such as <tt>/etc/httpd/conf/loncapa.conf</tt>, |
that files such as <tt>/etc/httpd/conf/loncapa.conf</tt>, |
| <tt>/home/httpd/html/res/adm/includes/copyright.tab</tt>, and |
<tt>/home/httpd/html/res/adm/includes/copyright.tab</tt>, and |
| <tt>/home/httpd/spare.tab are not overwritten</tt>, but remain as old, |
<tt>/home/httpd/spare.tab</tt> are not overwritten, but remain as old, |
| non-updated copies. (To automatically update these files and save/restore |
non-updated copies. (To automatically update these files and save/restore |
| their encoded machine configuration, you must run "make configinstall"). |
their encoded machine configuration, you must run "make configinstall"). |
| </p> |
</p> |
|
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> |
![[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