--- loncom/build/Makefile	2002/08/15 15:53:09	1.133
+++ loncom/build/Makefile	2003/05/29 21:47:12	1.146
@@ -1,7 +1,6 @@
 # The LearningOnline Network with CAPA
 
-# Scott Harrison, your friendly neighborhood volunteer
-# $Id: Makefile,v 1.133 2002/08/15 15:53:09 harris41 Exp $
+# $Id: Makefile,v 1.146 2003/05/29 21:47:12 albertel Exp $
 
 # TYPICAL USAGE of this Makefile is primarily for two targets:
 # "make build" and "make install".
@@ -23,8 +22,13 @@ SAVE=program.pl.$(TIMESTAMP)
 LAUNCHSAVE=$(OUTSTREAM) $(SAVE)
 METAMTARGET=""
 MTARGET=""
-VERSION=0.4
+VERSION=0.99.1
+# The current working definition for "RELEASE" is: changes not in the software,
+# but in the operating system dependent packaging of the software.  Thus, the
+# generic tarball releases do not need to have a release number specified.
+RELEASE=1 # As a general rule for now, this is always being set to "1".
 DIRTARGET=loncapa-$(VERSION)
+LOCALAUTHPATH=/home/httpd/lib/perl
 
 # =============================================== Help targets for the Makefile
 # If 'make' is run without any arguments, the 'help' target is called since
@@ -97,7 +101,7 @@ help_TARGETS:
 	@echo "           'make build' first before running 'make install'"
 	@echo "configinstall: install configuration files and restore with"
 	@echo "               prior information"
-	@echo "install: install from a ***compiled*** source tree
+	@echo "install: install from a ***compiled*** source tree"
 	@echo "         (see make build) to a specified TARGET destination"
 	@echo "         on the filesystem (default setting is TARGET=/)."
 	@echo "rawinstall: just install files, links and directories without"
@@ -145,7 +149,7 @@ help_TARGETS:
 	@echo "              the distributed tarball"
 	@echo "MANIFEST_cvs: essentially a list of all CVS/Entries files used"
 	@echo "              for 'time-checking' intelligence"
-	@echo "MANIFEST_lpml: a list of all LON-CAPA files to be installed,
+	@echo "MANIFEST_lpml: a list of all LON-CAPA files to be installed,"
 	@echo "               compile from, used as building software, and"
 	@echo "               testing"
 	@echo "MANIFEST_vanillatar: 'README'-type top-level files that a user"
@@ -184,6 +188,20 @@ help_TARGETS:
 	@echo "       interfere with rebuilding/recompiling software"
 	@echo "reallyclean: remove all files that were generated during"
 	@echo "             building or compilation of the software"
+	@echo "uninstall: remove all directories that do not contain files"
+	@echo "           from other software packages and that do not contain"
+	@echo "           student and instructor data; NOTE THAT THIS IS"
+	@echo "           INTERACTIVE--you will be given a final chance"
+	@echo "           to look at what will and will not be deleted."
+	@echo "           Still, be careful.  This is a very new target and is"
+	@echo "           an alpha-level software feature for now."
+	@echo "backup: rolls a tarball backup of all important student and "
+	@echo "        instructor data (NOT YET IMPLEMENTED)"
+	@echo "restore: reseeds a LON-CAPA server with tarball backups "
+	@echo "         generated by \"make backup\" (NOT YET IMPLEMENTED)"
+	@echo "*** AUXILIARY TESTS ***"
+	@echo "localauth: tests to see if localauth exists or not and run"
+	@echo "           appropriate tests"
 	@echo "*** A HELPFUL DEPENDENCY ***"
 	@echo "alwaysrun: blank target that is a dependency for targets"
 	@echo "           that should \"always run\""
@@ -315,7 +333,7 @@ vanillatar:
 	chmod a+rx $(SOURCE)/TEST
 	chmod a+rx $(SOURCE)/CHECKRPMS
 	# -------------------------------- Copy README to the vanilla top-level
-	cp -v $(SOURCE)/doc/shortest_path_redhat7.2.txt $(SOURCE)/README
+	#cp -v $(SOURCE)/doc/shortest_path_redhat7.2.txt $(SOURCE)/README
 
 tardist:
 	make MANIFEST_all
@@ -354,6 +372,11 @@ reseval_fixup:
 	perl piml_parse.pl $(CATEGORY) $(DIST) "$(TARGET)" $(LAUNCH) | \
 	tee -a WARNINGS
 
+clearoutoldspreadsheetcache:
+	cat $(SOURCE)/doc/loncapafiles/clearoutoldspreadsheetcache.piml | \
+	perl piml_parse.pl $(CATEGORY) $(DIST) "$(TARGET)" $(LAUNCH) | \
+	tee -a WARNINGS
+
 sendmail_fix:
 	cat $(SOURCE)/doc/loncapafiles/sendmail_fix.piml | \
 	perl piml_parse.pl $(CATEGORY) $(DIST) "$(TARGET)" $(LAUNCH) | \
@@ -362,6 +385,7 @@ sendmail_fix:
 postinstall:
 	make webserverconf
 	make reseval_fixup
+	make clearoutoldspreadsheetcache
 	make sanitycheck
 	make sendmail_fix
 
@@ -483,6 +507,9 @@ MANIFEST_lpml:
 	cat $(SOURCE)/doc/loncapafiles/testfiles.lpml | \
 	perl lpml_parse.pl MANIFEST development default \
 	'$(SOURCE)' '$(TARGET)' | grep '[[:alnum:]]' >> $(SOURCE)/MANIFEST
+	cat $(SOURCE)/doc/loncapafiles/installfiles.lpml | \
+	perl lpml_parse.pl MANIFEST development default \
+	'$(SOURCE)' '$(TARGET)' | grep '[[:alnum:]]' >> $(SOURCE)/MANIFEST
 	cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \
 	perl lpml_parse.pl MANIFEST development default \
 	'$(SOURCE)' '$(TARGET)' | grep '[[:alnum:]]' >> $(SOURCE)/MANIFEST
@@ -551,8 +578,8 @@ RPM: BinaryRoot base_rpm_file_list
 	cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \
 	perl lpml_parse.pl make_rpm $(CATEGORY) $(DIST) $(SOURCE) $(TARGET) \
 	> base_customizerpm.xml
-	cat base_rpm_file_list.txt | perl make_rpm.pl base 3.2 '' '' \
-	BinaryRoot base_customizerpm.xml
+	cat base_rpm_file_list.txt | perl make_rpm.pl base $(VERSION) \
+	$(RELEASE) '' '' BinaryRoot base_customizerpm.xml
 
 DPKG:
 	make TARGET='lon-capa-$(VERSION)' NORESTORECONF='1' install
@@ -747,5 +774,38 @@ reallyclean:
 	make -f Makefile.cvs clean
 	rm -f WARNINGS
 
+uninstall:
+	rm -f UNINSTALL_SHELL_COMMANDS
+	cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \
+	perl lpml_parse.pl uninstall_shell_commands $(CATEGORY) $(DIST) \
+	"$(SOURCE)" "$(TARGET)" > UNINSTALL_SHELL_COMMANDS
+	@echo -n "**** NOTE **** A file \"UNINSTALL_SHELL_COMMANDS\" has been "
+	@echo "generated."
+	@echo "First, you should view the contents of this file."
+	@echo "If you are happy with the 'rm -Rf'! commands (or at least"
+	@echo "have another job lined up in case of catastrophe), then you "
+	@echo "can execute the following: sh ./UNINSTALL_SHELL_COMMANDS"
+
+backup:
+	@echo "Not yet implemented"
+
+restore:
+	@echo "Not yet implemented"
+
+# ===================================================== *** AUXILIARY TESTS ***
+localauth:
+	@if (test -e $(LOCALAUTHPATH)/localauth.pm) && \
+             !(diff $(LOCALAUTHPATH)/localauth-std.pm \
+              $(LOCALAUTHPATH)/localauth.pm > /dev/null); then \
+		echo "**** WARNING **** $(LOCALAUTHPATH)/localauth.pm is different than the $(LOCALAUTHPATH)/localauth-std.pm; if you have not customized localauth.pm, then please manually overwrite localauth.pm (rm $(LOCALAUTHPATH)/localauth.pm; ln -s $(LOCALAUTHPATH)/localauth-std.pm $(LOCALAUTHPATH)/localauth.pm); if you have customized localauth.pm, then please double-check to see that your customized localauth.pm is compatible with any localauth-std.pm changes for this version of LON-CAPA"| tee -a WARNINGS; \
+	elif (test -e $(LOCALAUTHPATH)/localauth.pm) && \
+              (diff $(LOCALAUTHPATH)/localauth-std.pm \
+              $(LOCALAUTHPATH)/localauth.pm > /dev/null); then \
+		echo "**** NOTE **** LOCAL AUTH IS IDENTICAL WITH STANDARD TEMPLATE"| tee -a WARNINGS; \
+	elif !(test -e $(LOCALAUTHPATH)/localauth.pm) && \
+	      (test -e $(LOCALAUTHPATH)/localauth-std.pm); then \
+		ln -s $(LOCALAUTHPATH)/localauth-std.pm $(LOCALAUTHPATH)/localauth.pm; \
+	fi
+
 # ================================================ *** A HELPFUL DEPENDENCY ***
 alwaysrun: