File:  [LON-CAPA] / doc / build / Attic / make.html
Revision 1.3: download - view: text, annotated - select for diffs
Tue Nov 20 14:55:44 2001 UTC (22 years, 11 months ago) by harris41
Branches: MAIN
CVS tags: version_1_0_3, version_1_0_2, version_1_0_1, version_1_0_0, version_0_99_5, version_0_99_4, version_0_99_3, version_0_99_2, version_0_99_1, version_0_99_0, version_0_6_2, version_0_6, version_0_5_1, version_0_5, version_0_4, stable_2002_spring, stable_2002_july, stable_2002_april, conference_2003, STABLE, HEAD
removing ambiguous usage of word targets -Scott

<pre>
Description of LON-CAPA Makefile

Scott Harrison

1. What is it and where is it?
------------------------------
LON-CAPA's Makefile is in CVS:loncom/build.
The Makefile controls compilation
of the CVS source tree and subsequent installation
onto the target filesystem.

The most commands to run are:
make build
and
make install

There are additional targets for producing
status reports related to files and software
packages present on your system.

2. How and when are files backed up during "make install"?
----------------------------------------------------------
LON-CAPA groups files into different categories according
to CVS:doc/loncapafiles.lpml.  There are 'conf' files
which are configuration files, and there are about six other
categories.  "make install" operates differently depending on
the category of file to install.

* CATEGORY='conf' and .lpmlnew
'conf' files are NEVER overwritten.  When there are changes
in the CVS source repository, the user is notified, and 
a TARGETFILENAME.lpmlnew file is made instead of overwriting
the current TARGETFILENAME.  The user must then edit the
.lpmlnew file and manually overwrite the target.

* CATEGORY=non-'conf' and .lpmlsave
non-'conf' files are ALWAYS overwritten (if there is a md5sum
change).  If the target file is both different than the source file
and suspiciously newer than the last CVS/Entries date, a
TARGETFILENAME.lpmlsave file is made and the user is WARNED.

3. What if I can't remember all of this?
----------------------------------------
LON-CAPA's make install/build commands now log messages in a WARNINGS file
and, at the end, outputs a synopsis of things for the user to take a look
at (conf file changes, file permissions and ownership alterations,
unexpectedly new non-conf target files, etc).

You should be able to run these commands, look at
the WARNINGS file, and be confident as to the preservation and
status of files BEFORE and AFTER the upgrade.
</pre>



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