Annotation of doc/build/make.html, revision 1.3

1.1       harris41    1: <pre>
                      2: Description of LON-CAPA Makefile
                      3: 
                      4: Scott Harrison
                      5: 
                      6: 1. What is it and where is it?
                      7: ------------------------------
                      8: LON-CAPA's Makefile is in CVS:loncom/build.
                      9: The Makefile controls compilation
                     10: of the CVS source tree and subsequent installation
                     11: onto the target filesystem.
                     12: 
                     13: The most commands to run are:
                     14: make build
                     15: and
                     16: make install
                     17: 
                     18: There are additional targets for producing
                     19: status reports related to files and software
                     20: packages present on your system.
                     21: 
                     22: 2. How and when are files backed up during "make install"?
                     23: ----------------------------------------------------------
                     24: LON-CAPA groups files into different categories according
                     25: to CVS:doc/loncapafiles.lpml.  There are 'conf' files
                     26: which are configuration files, and there are about six other
                     27: categories.  "make install" operates differently depending on
                     28: the category of file to install.
                     29: 
                     30: * CATEGORY='conf' and .lpmlnew
                     31: 'conf' files are NEVER overwritten.  When there are changes
                     32: in the CVS source repository, the user is notified, and 
                     33: a TARGETFILENAME.lpmlnew file is made instead of overwriting
1.2       harris41   34: the current TARGETFILENAME.  The user must then edit the
                     35: .lpmlnew file and manually overwrite the target.
1.1       harris41   36: 
                     37: * CATEGORY=non-'conf' and .lpmlsave
                     38: non-'conf' files are ALWAYS overwritten (if there is a md5sum
                     39: change).  If the target file is both different than the source file
                     40: and suspiciously newer than the last CVS/Entries date, a
                     41: TARGETFILENAME.lpmlsave file is made and the user is WARNED.
                     42: 
                     43: 3. What if I can't remember all of this?
                     44: ----------------------------------------
1.3     ! harris41   45: LON-CAPA's make install/build commands now log messages in a WARNINGS file
1.1       harris41   46: and, at the end, outputs a synopsis of things for the user to take a look
                     47: at (conf file changes, file permissions and ownership alterations,
                     48: unexpectedly new non-conf target files, etc).
                     49: 
                     50: You should be able to run these commands, look at
                     51: the WARNINGS file, and be confident as to the preservation and
                     52: status of files BEFORE and AFTER the upgrade.
                     53: </pre>
                     54: 
                     55: 

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