Diff for /loncom/build/readme.html between versions 1.19 and 1.23

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>

Removed from v.1.19  
changed lines
  Added in v.1.23


FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>