Diff for /loncom/build/Makefile between versions 1.55 and 1.144

version 1.55, 2002/01/09 22:19:40 version 1.144, 2003/02/03 18:03:52
Line 1 Line 1
 # The LearningOnline Network with CAPA  # The LearningOnline Network with CAPA
   
 # Scott Harrison  
 # $Id$  # $Id$
   
 DIST="default"  # TYPICAL USAGE of this Makefile is primarily for two targets:
   # "make build" and "make install".
   # Many other targets and features are supported (see the initial
   # help targets).
   
   # ======================================= Default settings for Makefile options
   DISTPROBE=`perl ./distprobe`
   DIST=$(DISTPROBE)
 CATEGORY="development"  CATEGORY="development"
 SOURCE="../.."  SOURCE=../..
 TARGET=""  TARGET=""
 NORESTORECONF="0"  NORESTORECONF="0"
   HOSTNAME=""
 help:   LAUNCH=| perl
   QUERYLAUNCH=> /tmp/loncapa_query.pl; perl /tmp/loncapa_query.pl
   OUTSTREAM=>
   SAVE=program.pl.$(TIMESTAMP)
   LAUNCHSAVE=$(OUTSTREAM) $(SAVE)
   METAMTARGET=""
   MTARGET=""
   VERSION=0.6.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
   # it is the first target.
   help:
  @echo "*** You need to specify a valid target ***"   @echo "*** You need to specify a valid target ***"
  @echo "NOTE: You can specify options to your Makefile target."   @echo "To get a list of valid targets: \"make help_TARGETS\""
  @echo "(option) DIST can be redhat7.1, debian, redhat6.2, or default"   @echo "To get a list of valid options: \"make help_OPTIONS\""
  @echo "(option) CATEGORY can be runtime or development"   @echo " "
  @echo "(option) SOURCE is an absolute or relative directory path"   @echo "Typically invoked targets are:"
  @echo "(option) TARGET is an absolute or relative directory path"   @echo "    make build"
  @echo "build: compile the CVS source tree"   @echo "    make install"
  @echo "install: install from a compiled CVS source tree to a "   @echo "    make test"
  @echo "         specified TARGET destination on the filesystem"   @echo "    make clean"
  @echo "test: test different parts of the LON-CAPA system (TEST_*)"  
  @echo "TEST_lpml_scripts: make sure that the system can process "  help_OPTIONS:
  @echo "                   the Linux Packaging Markup Language"   @echo "* ADJUSTABLE OPTIONS *"
    @echo "(option) DIST can be redhat7, debian, redhat6.2, or default"
    @echo "         You probably do not need to specify this; it is"
    @echo "         automatically probed for."
    @echo "(option) CATEGORY can be 'runtime' or 'development'; currently"
    @echo "         the 'development' setting is the most reliable;"
    @echo "         eventually, production machines should be using the"
    @echo "         'runtime' settings"
    @echo "(option) SOURCE is an absolute or relative directory path."
    @echo "         SOURCE corresponds to the root directory of the"
    @echo "         loncapa source release"
    @echo "(option) TARGET is an absolute or relative directory path."
    @echo "         This is where files will be installed on your system."
    @echo "         Typically, this should be set to nothing (which"
    @echo "         corresponds to the '/' root of the entire filesystem)."
    @echo "(option) NORESTORECONF, when set to a non-zero value, stops"
    @echo "         filesystem upgrades from overwriting existing "
    @echo "         configuration files.  Ordinarily, NORESTORECONF=0, "
    @echo "         because the existing configuration files are safely"
    @echo "         dealt with (or so one hopes... :) )."
    @echo "(option) HOSTNAME specifies the name of a remote server for"
    @echo "         which a NET_* Makefile target should be launched"
    @echo "(option) VERSION; especially useful for the 'tardist' target"
    @echo "         this tags the tarball file and internal directories"
    @echo "         with a specific version string (conventionally "
    @echo "         numeric)"
   
   help_TARGETS:
    @echo "*** RUNNING TESTS TO ENSURE SOLID PERFORMANCE ***"
    @echo "test: test different parts of the LON-CAPA system (TEST_*)."
    @echo "      Makefile-dependent processes as well as horizontal and"
    @echo "      vertical aspects of the LON-CAPA system architecture"
    @echo "      are all tested."
    @echo "TEST_lpml_scripts: make sure that the system can process"
    @echo "                   the Linux Packaging Markup Language."
    @echo "                   This is neither horizontal or vertical"
    @echo "                   testing.  The idea is to make sure that"
    @echo "                   the installation software itself works"
    @echo "                   as expected."
  @echo "TEST_system_dependencies: make sure that all needed system "   @echo "TEST_system_dependencies: make sure that all needed system "
  @echo "                          components are active and present "   @echo "                          components are active and present "
  @echo "                          on the server such as perl modules"   @echo "                          on the server such as perl modules"
  @echo "                          and the MySQL database"   @echo "                          and the MySQL database"
  @echo "TEST_web_layer: mimic a login and various system actions on "   @echo "                          (horizontal testing)"
    @echo "TEST_web_layer: mimic a login and various vertical actions on "
  @echo "                a LON-CAPA system"   @echo "                a LON-CAPA system"
    @echo "TEST_hosts_tab: make sure that a loncapa/loncom/hosts.tab"
    @echo "                file is specified for installation"
    @echo "TEST_html2ps: test for the presence of html2ps which is needed"
    @echo "              for making a PDF compilation for pdfdoc"
    @echo "*** GENERAL TARGETS SUCH AS 'build' AND 'install' ***"
    @echo "build: compile the source tree"
    @echo "buildflag: a semaphore that helps educate the user to run"
    @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 "         (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"
    @echo "            any bells or whistles (e.g. double-checking"
    @echo "            configurations, fine-tuning webserver, etc.)"
    @echo "hosts_tab: install the hosts.tab to the filesystem"
    @echo "webserverconf: fine-tune the web server configuration;"
    @echo "               make sure the proper 'Include' statements"
    @echo "               are appended to httpd.conf"
    @echo "vanillatar: generate top-level files such as README, UPDATE,"
    @echo "            CHECKRPMS, and TEST (needed by tardist)"
    @echo "tardist: build a tarball that will upgrade the software on a "
    @echo "         system"
    @echo "sanitycheck: probe for common errors and recommend fixes to"
    @echo "             the user"
    @echo "updatequery: solicit the user for machine configuration"
    @echo "             information; to be incorporated during an update"
    @echo "             procedure (via the UPDATE command)"
    @echo "postinstall: double-check things after installation"
    @echo "VERSION: tag the filesystem with version information inside"
    @echo "         /etc/loncapa-release"
    @echo "aboutVERSION: place version information inside about.html"
    @echo "*** Makefile.* TARGETS BUILT DYNAMICALLY FROM loncapafiles.lpml ***"
    @echo "Makefile.configinstall: generate a Makefile for configuration"
    @echo "                        files; built dynamically from"
    @echo "                        loncapafiles.lpml"
    @echo "Makefile.build: generate a Makefile for compiling"
    @echo "                files inside the source directory; "
    @echo "                Makefile.build is generated from"
    @echo "                loncapafiles.lpml"
    @echo "Makefile.install: generate a Makefile for installing"
    @echo "                  files; built dynamically from"
    @echo "                  loncapafiles.lpml"
    @echo "*** TARGETS FOR OPERATING ON FILESYSTEMS ACROSS THE NETWORK ***"
    @echo "lpmladm: coordinates username=lpmladm mediated secure shell"
    @echo "         processes; needed for the NET_* targets"
    @echo "NET_hosts_tab: install the hosts.tab to a filesystem elsewhere"
    @echo "               on the network"
    @echo "NET_webserverconf: fine-tune the web server configuration on a"
    @echo "                   filesystem elsewhere on the network"
    @echo "NET_rawinstall: launch the rawinstall target on a filesystem"
    @echo "                elsewhere on the network"
    @echo "*** TARGETS FOR MAKING LISTS (MANIFESTS) OF LON-CAPA FILES ***"
    @echo "MANIFEST_all: generate a list of all files to be included in"
    @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 "               compile from, used as building software, and"
    @echo "               testing"
    @echo "MANIFEST_vanillatar: 'README'-type top-level files that a user"
    @echo "                     of the distributed tarball would first"
    @echo "                     look at and work with"
    @echo "*** STATUS REPORT TARGETS ***"
    @echo "warningnote: analyze the WARNINGS file and produce a synopsis"
    @echo "             and recommended action to the user"
  @echo "HTML: generate an HTML-formatted description of the LON-CAPA"   @echo "HTML: generate an HTML-formatted description of the LON-CAPA"
  @echo "      CVS files"   @echo "      source files"
  @echo "documentation_tree: compiles a documentation tree from the "   @echo "status: compare the TARGET filesystem with a compiled loncapa "
         @echo "                    CVS:doc directory"  
  @echo "status: compare the TARGET filesystem with a compiled CVS "  
  @echo "        source directory"   @echo "        source directory"
  @echo "statuspost: post the results of "make status" to "   @echo "statuspost: post the results of "make status" to "
  @echo "            TARGET/home/httpd/html/lon-status/filestatus.html"   @echo "            TARGET/home/httpd/html/lon-status/filestatus.html"
  @echo "rpmstatus: compare the rpms on a system to defined lists "   @echo "rpmstatus: compare the rpms on a system to defined lists "
  @echo "           CVS:doc/otherfiles/cd_rpms and "   @echo "           loncapa/doc/otherfiles/cd_rpms and "
  @echo "           CVS:doc/otherfiles/rpm_list.txt"   @echo "           loncapa/doc/otherfiles/rpm_list.txt"
  @echo "rpmstatuspost: post the results of "make rpmstatus" to "   @echo "rpmstatuspost: post the results of 'make rpmstatus' to "
  @echo "            TARGET/home/httpd/html/lon-status/rpmstatus.html"   @echo "            TARGET/home/httpd/html/lon-status/rpmstatus.html"
  @echo "RPM: build LON-CAPA-base RPM from CVS repository"   @echo "*** ALTERNATIVE PACKAGING TARGETS ***"
  @echo "setup_RPM: build LON-CAPA-setup RPM from CVS repository"   @echo "RPM: build LON-CAPA-base RPM from loncapa source repository"
  @echo "           handy for CD-ROM generation"   @echo "     (still under development)"
    @echo "DPKG: build a loncapa Debian package from loncapa source"
    @echo "      repository (still under development)"
    @echo "base_rpm_file_list: create a file listing to be used for"
    @echo "                    generating an RPM software package"
    @echo "BinaryRoot: create a BinaryRoot directory to be used for"
    @echo "            generating an RPM software package"
    @echo "*** MASTER DOCUMENTATION TARGETS ***"
    @echo "doc: generate web-page documentation for install.lon-capa.org"
    @echo "     (and eventually for documentation on installed machines)"
    @echo "pdfdoc: make a PDF-formatted compilation of all installation"
    @echo "        documentation"
    @echo "*** KEEPING THINGS CLEAN ***"
    @echo "clean: remove any files that might (even by remote chance)"
    @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\""
   
   # =========================== *** RUNNING TESTS TO ENSURE SOLID PERFORMANCE ***
   
 test: TEST_lpml_scripts TEST_system_dependencies TEST_web_layer  test: TEST_lpml_scripts TEST_system_dependencies TEST_web_layer
  @echo "ALL SYSTEM DEPENDENCY TESTS SUCCESSFUL"   @echo "ALL SYSTEM DEPENDENCY TESTS SUCCESSFUL"
Line 57  TEST_lpml_scripts: Line 220  TEST_lpml_scripts:
  cd ../test; perl filecomparetest.pl   cd ../test; perl filecomparetest.pl
   
 TEST_web_layer:  TEST_web_layer:
  @echo "Testing of web layers is not yet implemented."   @echo "TESTING WEB LAYER"
    cd weblayer_test; make
   
 HTML:  TEST_hosts_tab:
  install -d HTML   @echo "Testing hosts.tab"
  cp ../../doc/loncapafiles/*.gif HTML   @if (test -e ../hosts.tab); then \
  cat ../../doc/loncapafiles/loncapafiles.lpml | \   echo "there is a defined link or file; assume okay"; \
  perl lpml_parse.pl html development default ../.. '' > HTML/index.html   else echo "**** ERROR **** hosts.tab not defined!" && \
        echo -n "You need to do one of the following within your " && \
        echo "CVS repository (cd loncapa/loncom)" && \
        echo "   1) ln -s production_hosts.tab hosts.tab" && \
        echo "   2) ln -s development_hosts.tab hosts.tab" && \
        echo "or 3) ln -s rawhide_hosts.tab hosts.tab" && \
        echo "(you most likely want option #1, production_hosts.tab)" && \
        exit 1; \
    fi
   
 status:  TEST_html2ps:
  install -d HTML   @if (test -e /usr/local/html2ps/bin/html2ps); then \
  cp ../../doc/loncapafiles/*.gif HTML   echo "I can find html2ps; assume okay"; \
  cat ../../doc/loncapafiles/loncapafiles.lpml | \   else \
  perl lpml_parse.pl html $(CATEGORY) $(DIST) "../.." "" | \   echo "**** ERROR **** cannot find /usr/local/html2ps/bin/html2ps!" && \
  perl lpml_html_posteval.pl > \          echo "Please visit http://www.tdb.uu.se/~jan/html2ps.html" && \
  HTML/filestatus.html   exit 1; \
    fi
   
 statuspost: status  # ======================= *** GENERAL TARGETS SUCH AS 'build' AND 'install' ***
  cp ../../doc/loncapafiles/*.gif $(TARGET)/home/httpd/html/lon-status  
  cp HTML/filestatus.html \  
  $(TARGET)/home/httpd/html/lon-status/filestatus.html  
   
 rpmstatus:  build: Makefile.build pod2html.sh pod2man.sh
  install -d RPMSTATUS   install -d $(SOURCE)/doc/man
  rpm -qa --queryformat \   install -d $(SOURCE)/doc/scripts
  '%{NAME}\t%{VERSION}\t%{RELEASE}\t%{BUILDTIME}\n' | sort > \   install -d $(SOURCE)/doc/lib/perl/Apache
  RPMSTATUS/current.tmp   echo -n "" > WARNINGS
  cat ../../doc/otherfiles/cd_rpms.txt > RPMSTATUS/standard.tmp   make -f Makefile.build all
  cat ../../doc/otherfiles/rpm_list.txt > RPMSTATUS/expected.tmp   echo '1' > buildflag
  perl rpmparse.pl RPMSTATUS/standard.tmp RPMSTATUS/current.tmp \   make warningnote
  RPMSTATUS/expected.tmp > RPMSTATUS/rpmstatus.html  
   
 rpmstatuspost: rpmstatus  buildflag:
  cp RPMSTATUS/rpmstatus.html /home/httpd/html/lon-status/rpmstatus.html   @echo "**** ERROR **** You need to run 'make build' first" > WARNINGS
    make warningnote
    @need_to_run_make_build_first 2>/dev/null
   
 configinstall: Makefile.configinstall  configinstall: Makefile.configinstall
  make -f Makefile.configinstall SOURCE="$(SOURCE)" TARGET="$(TARGET)" \   make -f Makefile.configinstall SOURCE="$(SOURCE)" TARGET="$(TARGET)" \
Line 97  configinstall: Makefile.configinstall Line 268  configinstall: Makefile.configinstall
  if (test "0" = $(NORESTORECONF)); then \   if (test "0" = $(NORESTORECONF)); then \
  perl loncaparestoreconfigurations suffix .lpmlnew; fi   perl loncaparestoreconfigurations suffix .lpmlnew; fi
   
 Makefile.configinstall: ../../doc/loncapafiles/loncapafiles.lpml lpml_parse.pl  install: buildflag VERSION TEST_hosts_tab Makefile.install Makefile
  cat ../../doc/loncapafiles/loncapafiles.lpml | \   echo -n "" > WARNINGS
    make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" \
    directories
    make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" files
    make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" links
    make SOURCE="$(SOURCE)" TARGET="$(TARGET)" \
    NORESTORECONF="$(NORESTORECONF)" configinstall
    make postinstall
    make warningnote
    echo "You can run 'make test' to see if your system is ready to go!"
    echo "NOTE THAT YOUR SYSTEM MUST HAVE MYSQL WITH A USER=\"www\" AND"
    echo -n "PASSWORD=\"localhostkey\" FOR www\@localhost"
    echo -n "(YOU MAY NEED TO REINITIALIZE YOUR MYSQL www\@localhost USER)"
    echo -n "Please see http://install.lon-capa.org/ for more information"
   
   rawinstall: VERSION Makefile.install Makefile
    echo -n "" > WARNINGS
    make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" \
    directories
    make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" files
    make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" links
    make SOURCE="$(SOURCE)" TARGET="$(TARGET)" \
    NORESTORECONF="$(NORESTORECONF)" configinstall
   
   hosts_tab: TEST_hosts_tab
    cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \
    perl xfml_parse.pl $(SOURCE)/doc/loncapafiles/valid_hosts.xfml | \
    perl lpml_parse.pl install $(CATEGORY) $(DIST) "$(SOURCE)" \
    "$(TARGET)" > Makefile.install
    make -f Makefile.install directories
    make -f Makefile.install files
    @echo "If hosts.tab has changed, restart httpd and loncontrol:"
    @echo "   /etc/rc.d/init.d/httpd restart"
    @echo "   /etc/rc.d/init.d/loncontrol restart"
   
   webserverconf:
    cat $(SOURCE)/doc/loncapafiles/webserver.piml | \
    perl piml_parse.pl $(CATEGORY) $(DIST) "$(TARGET)" $(LAUNCH)
   
   # ---------------- Top-level files such as README, UPDATE, CHECKRPMS, and TEST
   vanillatar:
    # --------------------------- Point UPDATE to the internal make process
    echo '#!/bin/sh' > $(SOURCE)/UPDATE
    echo 'touch loncom/build/WARNINGS' >> $(SOURCE)/UPDATE;
    echo 'ln -s loncom/build/WARNINGS WARNINGS' >> $(SOURCE)/UPDATE;
    echo 'cd loncom/build; make build' >> $(SOURCE)/UPDATE
    echo 'make rawinstall' >> $(SOURCE)/UPDATE
    echo 'make configinstall' >> $(SOURCE)/UPDATE
    echo 'make updatequery' >> $(SOURCE)/UPDATE
    echo 'make hosts_tab' >> $(SOURCE)/UPDATE
    echo 'make postinstall' >> $(SOURCE)/UPDATE
    echo 'make aboutVERSION' >> $(SOURCE)/UPDATE
    echo 'make warningnote' >> $(SOURCE)/UPDATE
    # ----------------------------- Point TEST to the internal make process
    echo '#!/bin/sh' > $(SOURCE)/TEST
    echo 'cd loncom/build; make test' >> $(SOURCE)/TEST
    echo 'cd system_dependencies || cd loncom/build/system_dependencies; cp -v CPAN_STATUS_REPORT ../../../CPAN_STATUS_REPORT' >> $(SOURCE)/TEST
    # ----------------------------- Copy CHECKRPMS to the vanilla top-level
    cp -v $(SOURCE)/loncom/build/CHECKRPMS $(SOURCE)/CHECKRPMS
    # ----------------------- vanilla executables must indeed be executable
    chmod a+rx $(SOURCE)/UPDATE
    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
   
   tardist:
    make MANIFEST_all
    make vanillatar
    # -------------------------------------------------------- Make tardist
    @cd $(SOURCE); \
    if (test -h $(DIRTARGET)); then \
    echo "$(DIRTARGET) link already defined; assume okay"; \
    else \
    ln -s . $(DIRTARGET); \
    fi
    cp -v $(SOURCE)/loncom/license/about.html \
    $(SOURCE)/loncom/license/about.html.orig
    make aboutVERSION
    cd $(SOURCE); \
    tar --no-recursion --numeric-owner --files-from MANIFEST \
    -h -czf $(DIRTARGET).tar.gz 2>tar_WARNINGS || [ "0" == "0" ]
    mv -v $(SOURCE)/loncom/license/about.html.orig \
    $(SOURCE)/loncom/license/about.html
    cat $(SOURCE)/tar_WARNINGS | \
    xargs --replace=XXX echo '**** WARNING **** XXX' > WARNINGS
    rm -f $(SOURCE)/tar_WARNINGS
    make warningnote
   
   sanitycheck:
    cat $(SOURCE)/doc/loncapafiles/sanitycheck.piml | \
    perl piml_parse.pl $(CATEGORY) $(DIST) "$(TARGET)" $(LAUNCH) | \
    tee -a WARNINGS
   
   updatequery:
    cat $(SOURCE)/doc/loncapafiles/updatequery.piml | \
    perl piml_parse.pl $(CATEGORY) $(DIST) "$(TARGET)" $(QUERYLAUNCH)
   
   reseval_fixup:
    cat $(SOURCE)/doc/loncapafiles/reseval_fixup.piml | \
    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) | \
    tee -a WARNINGS
   
   postinstall:
    make webserverconf
    make reseval_fixup
    make clearoutoldspreadsheetcache
    make sanitycheck
    make sendmail_fix
   
   VERSION:
    install -d $(TARGET)/etc
    echo -n "LON-CAPA release $(VERSION)-" > $(TARGET)/etc/loncapa-release
    date +"%Y%m%d" >> $(TARGET)/etc/loncapa-release
   
   aboutVERSION:
    cat $(SOURCE)/loncom/license/about.html | \
    perl -e '$$d=`date +"%Y%m%d"`;chomp($$d);while(<>){s/\<\!\-\- VERSION \-\-\>/$(VERSION)-$$d/; print;}' > \
    $(SOURCE)/loncom/license/about.html.new
    mv -v $(SOURCE)/loncom/license/about.html.new \
    $(SOURCE)/loncom/license/about.html
   
   # ========= *** Makefile.* TARGETS BUILT DYNAMICALLY FROM loncapafiles.lpml ***
   
   Makefile.configinstall: $(SOURCE)/doc/loncapafiles/loncapafiles.lpml \
                           lpml_parse.pl
    cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \
  perl lpml_parse.pl configinstall $(CATEGORY) $(DIST) "$(SOURCE)" \   perl lpml_parse.pl configinstall $(CATEGORY) $(DIST) "$(SOURCE)" \
  "$(TARGET)" > Makefile.configinstall   "$(TARGET)" > Makefile.configinstall
   
   Makefile.build: $(SOURCE)/doc/loncapafiles/loncapafiles.lpml lpml_parse.pl
    cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \
    perl lpml_parse.pl build $(CATEGORY) $(DIST) "$(SOURCE)" "$(TARGET)" \
    > Makefile.build
   
   Makefile.install: alwaysrun
    cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \
    perl lpml_parse.pl install $(CATEGORY) $(DIST) "$(SOURCE)" \
    "$(TARGET)" > Makefile.install
   
   # ============= *** TARGETS FOR OPERATING ON FILESYSTEMS ACROSS THE NETWORK ***
   
   lpmladm:
    @if (test $(METAMTARGET) = "TRANSPORT"); then \
    echo "Transporting to $(HOSTNAME)"; \
    sudo make DIST=$(DIST) CATEGORY=$(CATEGORY) \
    SOURCE="$(SOURCE)" \
    TARGET="lpmladm.$(TIMESTAMP)" \
    NORESTORECONF="$(NORESTORECONF)" "$(MTARGET)"; \
    cd lpmladm.$(TIMESTAMP); \
    sudo tar czvf ../tarball$(TIMESTAMP).tar.gz .; \
    cd ..; scp tarball$(TIMESTAMP).tar.gz \
    lpmladm@$(HOSTNAME):~/tarball$(TIMESTAMP).tar.gz; \
    ssh lpmladm@$(HOSTNAME) sudo mv tarball$(TIMESTAMP).tar.gz /; \
    ssh lpmladm@$(HOSTNAME) sudo tar -x -z -v -C / \
    -p --same-owner -f \
    /tarball$(TIMESTAMP).tar.gz; \
    ssh lpmladm@$(HOSTNAME) sudo rm -f \
    /tarball$(TIMESTAMP).tar.gz; \
    elif (test $(METAMTARGET) = "LAUNCH"); then \
    echo "Launching process on $(HOSTNAME)"; \
    LAUNCHSAVE=$(OUTSTREAM) $(SAVE); \
    make DIST=$(DIST) CATEGORY=$(CATEGORY) SOURCE="$(SOURCE)" \
    TARGET="$(TARGET)" NORESTORECONF="$(NORESTORECONF)" \
    LAUNCH="$(LAUNCHSAVE)" "$(MTARGET)"; \
    scp $(SAVE) lpmladm@$(HOSTNAME):~/$(SAVE); \
    ssh lpmladm@$(HOSTNAME) sudo perl $(SAVE); \
    ssh lpmladm@$(HOSTNAME) sudo rm -f $(SAVE); \
    else \
    echo "**** ERROR **** Incorrect METAMTARGET"; \
    fi
   
   NET_hosts_tab:
    make TIMESTAMP=`date +"%s"` METAMTARGET="TRANSPORT" \
    MTARGET="hosts_tab" HOSTNAME="$(HOSTNAME)" lpmladm
   
   NET_webserverconf:
    make TIMESTAMP=`date +"%s"` METAMTARGET="LAUNCH" \
    MTARGET="webserverconf" HOSTNAME="$(HOSTNAME)" lpmladm
   
   NET_rawinstall:
    make TIMESTAMP=`date +"%s"` METAMTARGET="TRANSPORT" \
    MTARGET="rawinstall" HOSTNAME="$(HOSTNAME)" lpmladm
   
   # ============== *** TARGETS FOR MAKING LISTS (MANIFESTS) OF LON-CAPA FILES ***
   
   MANIFEST_all:
    # --------------------------------------------------------- start clean
    rm -f $(SOURCE)/MANIFEST
    make MANIFEST_lpml
    make MANIFEST_vanillatar
    make MANIFEST_cvs
    # ---------------------------------- might as well include the MANIFEST
    echo 'MANIFEST' >> $(SOURCE)/MANIFEST
    # ------------------------------------------ hosts.tab are belong to us
    echo 'loncom/rawhide_hosts.tab' >> $(SOURCE)/MANIFEST
    echo 'loncom/production_hosts.tab' >> $(SOURCE)/MANIFEST
    echo 'loncom/development_hosts.tab' >> $(SOURCE)/MANIFEST
    # ------------------ Files needed for dynamically generated directories
    echo 'doc/man' >> $(SOURCE)/MANIFEST
    echo 'doc/lib' >> $(SOURCE)/MANIFEST
    echo 'doc/lib/perl' >> $(SOURCE)/MANIFEST
    echo 'doc/lib/perl/Apache' >> $(SOURCE)/MANIFEST
    echo 'doc/scripts' >> $(SOURCE)/MANIFEST
    # --------------------------------------------------- Clean up MANIFEST
    cd $(SOURCE); \
    sort MANIFEST | perl -nle 'print "$(DIRTARGET)/$$_"' | \
    perl -nle 's/\w+\/\.\.\///g;s/\w+\/\.\.\///g;print' | \
    perl -nle 's/\w+\/\.\.\///g;s/\w+\/\.\.\///g;print' | \
    perl -nle 's/\w+\/\.\.\///g;s/\w+\/\.\.\///g;print' | \
    perl -nle 's/\/\.\//\//g;print' | sort | uniq > \
    MANIFEST_loncapa
    cd $(SOURCE); mv -v MANIFEST_loncapa MANIFEST
   
   # --------------- MANIFEST files with important CVS versioning/date information
   MANIFEST_cvs:
    # ------ CVS/Entries directories to retain 'time-checking' intelligence
    cd $(SOURCE); find . -type f -name 'Entries' | grep 'CVS/Entries' >> \
    MANIFEST
   
   # ------------------- MANIFEST the building, testing and standard loncapa files
   MANIFEST_lpml:
    cat $(SOURCE)/doc/loncapafiles/buildfiles.lpml | \
    perl lpml_parse.pl MANIFEST development default \
    '$(SOURCE)' '$(TARGET)' | grep '[[:alnum:]]' >> $(SOURCE)/MANIFEST
    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
   
   # ------------ Files for top-level (the vanilla layer that the user first sees)
   MANIFEST_vanillatar:
    echo 'README' >> $(SOURCE)/MANIFEST
    echo 'UPDATE' >> $(SOURCE)/MANIFEST
    echo 'TEST' >> $(SOURCE)/MANIFEST
    echo 'CHECKRPMS' >> $(SOURCE)/MANIFEST
   
   # =============================================== *** STATUS REPORT TARGETS ***
   
 warningnote:  warningnote:
  @if (test -s WARNINGS); then \   @if (test -s WARNINGS); then \
  W=`grep -c '\*\*\*\* WARNING' WARNINGS`; \   W=`grep -c '\*\*\*\* WARNING' WARNINGS`; \
Line 114  warningnote: Line 535  warningnote:
  echo "!!!!  Please read the WARNINGS file !!!!"; \   echo "!!!!  Please read the WARNINGS file !!!!"; \
  echo "!!!!   to make sure everything is   !!!!"; \   echo "!!!!   to make sure everything is   !!!!"; \
  echo "!!!!    correct and taken care of   !!!!"; \   echo "!!!!    correct and taken care of   !!!!"; \
  echo "!!!!    (it is output below here)   !!!!"; \  
  echo "!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"; \   echo "!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"; \
  cat WARNINGS; \  
  fi   fi
   
 install: Makefile.install Makefile  HTML:
  echo -n "" > WARNINGS   install -d HTML
  make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" \   cp $(SOURCE)/doc/loncapafiles/*.gif HTML
  directories   cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \
  make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" files   perl lpml_parse.pl html development default "$(SOURCE)" '$(TARGET)' \
  make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" links   > HTML/index.html
  make SOURCE="$(SOURCE)" TARGET="$(TARGET)" \  
  NORESTORECONF="$(NORESTORECONF)" configinstall  
  make warningnote  
   
 Makefile.install: ../../doc/loncapafiles/loncapafiles.lpml lpml_parse.pl  status:
  cat ../../doc/loncapafiles/loncapafiles.lpml | \   install -d HTML
  perl lpml_parse.pl install $(CATEGORY) $(DIST) "$(SOURCE)" \   cp $(SOURCE)/doc/loncapafiles/*.gif HTML
  "$(TARGET)" > Makefile.install   cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \
    perl lpml_parse.pl html $(CATEGORY) $(DIST) "$(SOURCE)" "($TARGET)" | \
    perl lpml_html_posteval.pl > \
    HTML/filestatus.html
   
 build: Makefile.build pod2html.sh pod2man.sh  statuspost: status
  echo -n "" > WARNINGS   cp $(SOURCE)/doc/loncapafiles/*.gif \
  make -f Makefile.build all   $(TARGET)/home/httpd/html/lon-status
  make warningnote   cp HTML/filestatus.html \
    $(TARGET)/home/httpd/html/lon-status/filestatus.html
   
 Makefile.build: ../../doc/loncapafiles/loncapafiles.lpml lpml_parse.pl  rpmstatus:
  cat ../../doc/loncapafiles/loncapafiles.lpml | \   install -d RPMSTATUS
  perl lpml_parse.pl build $(CATEGORY) $(DIST) "../.." "" > \   rpm -qa --queryformat \
  Makefile.build   '%{NAME}\t%{VERSION}\t%{RELEASE}\t%{BUILDTIME}\n' | sort > \
    RPMSTATUS/current.tmp
    cat $(SOURCE)/doc/otherfiles/cd_rpms.txt > RPMSTATUS/standard.tmp
    cat $(SOURCE)/doc/otherfiles/rpm_list.txt > RPMSTATUS/expected.tmp
    perl rpmparse.pl RPMSTATUS/standard.tmp RPMSTATUS/current.tmp \
    RPMSTATUS/expected.tmp > RPMSTATUS/rpmstatus.html
   
 RPM: BinaryRoot base_rpm_file_list  rpmstatuspost: rpmstatus
  cat ../../doc/loncapafiles/loncapafiles.lpml | perl lpml_parse.pl make_rpm $(CATEGORY) $(DIST) $(SOURCE) $(TARGET) > base_customizerpm.xml   cp RPMSTATUS/rpmstatus.html /home/httpd/html/lon-status/rpmstatus.html
  cat base_rpm_file_list.txt | perl make_rpm.pl base 3.2 '' '' \  
  BinaryRoot base_customizerpm.xml  
   
 setup_RPM: SetupBinaryRoot  
  echo "SetupBinaryRoot/etc/passwd" > setup_rpm_file_list.txt  
  echo "SetupBinaryRoot/etc/group" >> setup_rpm_file_list.txt  
  echo "SetupBinaryRoot/etc/hosts.deny" >> setup_rpm_file_list.txt  
  echo "SetupBinaryRoot/home/www" >> setup_rpm_file_list.txt  
  echo "SetupBinaryRoot/etc/pam.d/passwd" >> setup_rpm_file_list.txt  
  echo "SetupBinaryRoot/etc/pam.d/login" >> setup_rpm_file_list.txt  
  perl setup_rpm_binaryroot.pl  
  cat setup_rpm_file_list.txt | perl make_rpm.pl setup 3.2 '' '' \  
  SetupBinaryRoot customizerpm.xml  
   
   # ======================================= *** ALTERNATIVE PACKAGING TARGETS ***
   
   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 $(VERSION) \
    $(RELEASE) '' '' BinaryRoot base_customizerpm.xml
   
   DPKG:
    make TARGET='lon-capa-$(VERSION)' NORESTORECONF='1' install
    @echo "You will next need to follow instructions at:"
    @echo "http://people.debian.org/~jaldhar/make_package1.html"
    @echo "A directory with a snapshot of the debian package files"
    @echo "is LON-CAPA-base."
   # What DPKG steps need to happen (for future implementation):
   # export EMAIL="" ... probably sharrison@mail.lon-capa.org
   # deb-make
   # edit debian/control
   # make debian/dirs file
   # make debian/copyright file
   # debian/README.debian... point them to LON-CAPA URLS
   # debian/changelog
   # debian/conffiles
   # debuild
   # and maybe do some GPG-related steps around here
   
 base_rpm_file_list:  base_rpm_file_list:
  cat ../../doc/loncapafiles/loncapafiles.lpml | \   cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \
  perl lpml_parse.pl rpm_file_list $(CATEGORY) $(DIST) $(SOURCE) \   perl lpml_parse.pl rpm_file_list $(CATEGORY) $(DIST) $(SOURCE) \
  'BinaryRoot' | sort > base_rpm_file_list.txt   'BinaryRoot' | sort > base_rpm_file_list.txt
   
 BinaryRoot: base_rpm_file_list  BinaryRoot: base_rpm_file_list
  make TARGET='BinaryRoot' NORESTORECONF='1' install   make TARGET='BinaryRoot' NORESTORECONF='1' install
   
 loncapaconfig:  # ======================================== *** MASTER DOCUMENTATION TARGETS ***
  rm -Rf LoncapaconfigRoot  
  install -d LoncapaconfigRoot/usr/src/  
  install -d LoncapaconfigRoot/usr/lib/python1.5/site-packages  
  install /usr/lib/python1.5/site-packages/kudzumodule.so \  
  LoncapaconfigRoot/usr/lib/python1.5/site-packages/kudzumodule.so  
  cd LoncapaconfigRoot/usr/src; cp -pR /mnt/drive/loncapaconfig .  
  install -d LoncapaconfigRoot/usr/sbin  
  @echo -e "#!/bin/sh\ncd /usr/src/loncapaconfig/usr/bin; \  
  ./loncapaconfig\n" > LoncapaconfigRoot/usr/sbin/loncapaconfig  
  chmod u+x LoncapaconfigRoot/usr/sbin/loncapaconfig  
  find LoncapaconfigRoot -type d | xargs chmod o-wxr  
  find LoncapaconfigRoot -type f | xargs chmod o-wxr  
  find LoncapaconfigRoot/ -type d | grep 'src/lon' > \  
  loncapaconfig_file_list.txt  
  find LoncapaconfigRoot/ -type d | grep \  
  '^LoncapaconfigRoot/usr/lib/python1.5/site-packages' >> \  
  loncapaconfig_file_list.txt  
  find LoncapaconfigRoot/ -type f >> loncapaconfig_file_list.txt  
  cat loncapaconfig_file_list.txt | perl make_rpm.pl loncapaconfig 3.1 \  
  '' '' LoncapaconfigRoot  
  cp LON-CAPA-loncapaconfig-3.1-1.i386.rpm \  
  /mnt/drive/install.lon-capa.org/3.1/currentcdsource/RedHat/RPMS/.  
   
 documentation_tree: cvsreport  # Generates CVS:loncom/build/docs; root location of install.lon-capa.org
   doc:
  install -d docs   install -d docs
  install ../../doc/build/cvsreport.html docs/cvsreport.html   @if (test -e installation_manual.pdf); then \
  install ../../doc/build/doc.html docs/index.html   cp -vf installation_manual.pdf docs/.; \
  install -d docs/hardware   else \
  install ../../doc/hardware/hardware.html docs/hardware/hardware.html   touch docs/installation_manual.pdf; \
  install -d docs/3.1   fi
  install ../../doc/build/install.html docs/3.1/index.html   install -m 0755 -d docs/icons
  install ../../doc/build/instructions_with_cd.html \   install -m 0644 $(SOURCE)/doc/icons/[^C][^V]* docs/icons
  docs/3.1/instructions_with_cd.html   install -m 0755 -d docs/reconfig
  install ../../doc/build/libraryserverconfiguration.gif \   cd docs; ln -fs installation_manual.pdf index.pdf
  docs/3.1/libraryserverconfiguration.gif   cd docs/reconfig; ln -fs ../installation_manual.pdf index.pdf
  install ../../doc/build/librarysystemsettings.gif \   perl doc_template.pl $(SOURCE)/doc/templates/template.html \
  docs/3.1/librarysystemsettings.gif   $(SOURCE)/doc/build/reconfig.html > docs/reconfig/index.html
  install -d docs/cvsupgrade   install -m 0755 -d docs/reconfig/confexamples
  install ../../doc/build/cvsupgrade.html docs/cvsupgrade/index.html   install -m 0644 $(SOURCE)/doc/build/confexamples/[^C][^V]* \
  install -d docs/upgrade   docs/reconfig/confexamples
  install ../../doc/build/upgrade.html docs/upgrade/index.html   perl doc_template.pl $(SOURCE)/doc/templates/template.html \
  install -d docs/reconfig   $(SOURCE)/doc/build/installindex.html > docs/index.html
  install ../../doc/build/reconfig.html docs/reconfig/index.html   install -m 0755 -d docs/license
  install -d docs/3.1/otherfiles   cd docs/license; ln -fs ../installation_manual.pdf index.pdf
  install ../../doc/otherfiles/rpm_list.txt \   perl doc_template.pl $(SOURCE)/doc/templates/template.html \
  docs/3.1/otherfiles/rpm_list.txt   $(SOURCE)/doc/build/license.html > docs/license/index.html
  install ../../doc/build/loncapanetwork.html docs/loncapanetwork.html   install -m 0755 -d docs/contact
  install ../../doc/build/loncapanfs.html docs/loncapanfs.html   cd docs/contact; ln -fs ../installation_manual.pdf index.pdf
  install ../../doc/build/loncapaappleshares.html \   perl doc_template.pl $(SOURCE)/doc/templates/template.html \
  docs/loncapaappleshares.html   $(SOURCE)/doc/build/contact.html > docs/contact/index.html
  install ../../doc/build/loncapasqldatabase.html \   install -m 0755 -d docs/faq
  docs/loncapasqldatabase.html   cd docs/faq; ln -fs ../installation_manual.pdf index.pdf
  install ../../doc/build/loncapapasswords.html \   perl doc_template.pl $(SOURCE)/doc/templates/template.html \
  docs/loncapapasswords.html   $(SOURCE)/doc/build/faq.html > docs/faq/index.html
  install ../../doc/build/loncapapasswordauthentication.html \   install -m 0755 -d docs/downloads
  docs/loncapapasswordauthentication.html   cd docs/downloads; ln -fs ../installation_manual.pdf download.pdf
  install ../../doc/build/loncapatimesync.html docs/loncapatimesync.html   perl doc_template.pl $(SOURCE)/doc/templates/template.html \
  install ../../doc/build/loncapamathequivalency.html \   $(SOURCE)/doc/build/download.html > docs/downloads/index.html
  docs/loncapamathequivalency.html   install -m 0755 -d docs/install
  tar czvf install.lon-capa.org_docs.tar.gz docs   cd docs/install; ln -fs ../installation_manual.pdf install.pdf
  rm -Rf docs   perl doc_template.pl $(SOURCE)/doc/templates/template.html \
    $(SOURCE)/doc/build/install.html > docs/install/index.html
    cp -v $(SOURCE)/doc/install/redhat7.3/new_install_rh73.html \
    docs/install/rh73.html
    cp -v $(SOURCE)/doc/install/redhat7.3/new_install_rh73.html \
    docs/downloads/rh73.html
    install -m 0755 -d docs/upgrade
    cd docs/upgrade; ln -fs ../installation_manual.pdf upgrade.pdf
    perl doc_template.pl $(SOURCE)/doc/templates/template.html \
    $(SOURCE)/doc/build/upgrade.html > docs/upgrade/index.html
    cd docs; tar czvpf ../docs.tar.gz .
   
   pdfdoc: TEST_html2ps
    install -d pdfdoc
    /usr/local/html2ps/bin/html2ps -D \
    $(SOURCE)/doc/build/installindex_noform.html > pdfdoc/installindex.ps
    /usr/local/html2ps/bin/html2ps -D \
    $(SOURCE)/doc/build/reconfig.html | \
    perl -nle 's/\[EXAMPLE\]/\[EXAMPLE \(at end of document\)\]/g;print' \
    > pdfdoc/reconfig.ps
    /usr/local/html2ps/bin/html2ps -D \
    $(SOURCE)/doc/build/install.html > pdfdoc/install.ps
    /usr/local/html2ps/bin/html2ps -D \
    $(SOURCE)/doc/build/upgrade.html > pdfdoc/upgrade.ps
    /usr/local/html2ps/bin/html2ps -D \
    $(SOURCE)/doc/build/faq.html > pdfdoc/faq.ps
    /usr/local/html2ps/bin/html2ps -D \
    $(SOURCE)/doc/build/download.html > pdfdoc/download.ps
    /usr/local/html2ps/bin/html2ps -D \
    $(SOURCE)/doc/build/contact.html > pdfdoc/contact.ps
    /usr/local/html2ps/bin/html2ps -D \
    $(SOURCE)/doc/build/license.html > pdfdoc/license.ps
   #       This creates a bad confexamples.ps... so take the long way around
   # cd $(SOURCE)/doc/build/confexamples; \
   # mpage -P- -1 -H [^C]* > ../../../loncom/build/pdfdoc/confexamples.ps
    install -d pdfdoc/confexamples
    cd $(SOURCE)/doc/build/confexamples; \
    find . -type f | cut -b3- | grep -v '^C' | grep -v 'keyword' | \
    perl -nle \
    '`mpage -P- -1 -H $$_ > ../../../loncom/build/pdfdoc/confexamples/$$_.ps`;'
    echo '' > pdfdoc/contents.txt
    echo '' >> pdfdoc/contents.txt
    echo '          The Learning Online Network' >> pdfdoc/contents.txt
    echo '                    with the' >> pdfdoc/contents.txt
    echo '     Computer-Assisted Personalized Approach' >> \
    pdfdoc/contents.txt
    echo '' >> pdfdoc/contents.txt
    echo '' >> pdfdoc/contents.txt
    echo 'CONTENTS' >> pdfdoc/contents.txt
    echo '--------' >> pdfdoc/contents.txt
    echo 'Opening' >> pdfdoc/contents.txt
    echo 'Configuration' >> pdfdoc/contents.txt
    echo 'Installation' >> pdfdoc/contents.txt
    echo 'Upgrading a LON-CAPA Server' >> pdfdoc/contents.txt
    echo 'FAQ' >> pdfdoc/contents.txt
    echo 'Download' >> pdfdoc/contents.txt
    echo 'Contact Information' >> pdfdoc/contents.txt
    echo 'License Information' >> pdfdoc/contents.txt
    echo 'Configuration Examples' >> pdfdoc/contents.txt
    mpage -P- -1 \
    pdfdoc/contents.txt \
    pdfdoc/installindex.ps \
    pdfdoc/reconfig.ps \
    pdfdoc/install.ps \
    pdfdoc/upgrade.ps \
    pdfdoc/faq.ps \
    pdfdoc/download.ps \
    pdfdoc/contact.ps \
    pdfdoc/license.ps \
    pdfdoc/confexamples/*.ps \
    > pdfdoc/installation_manual.ps
    ps2pdf pdfdoc/installation_manual.ps pdfdoc/installation_manual.pdf
    mv -vf pdfdoc/installation_manual.pdf .
   
 cvsreport:  # ================================================ *** KEEPING THINGS CLEAN ***
   
 clean:  clean:
    rm -f buildflag
  rm -Rf HTML   rm -Rf HTML
    rm -f installation_manual.pdf
  rm -f Makefile.build   rm -f Makefile.build
  rm -f Makefile.install   rm -f Makefile.install
    rm -f Makefile.configinstall
  rm -Rf BinaryRoot   rm -Rf BinaryRoot
  rm -Rf SetupBinaryRoot   rm -Rf SetupBinaryRoot
    rm -Rf LON-CAPA-base
    rm -f base_rpm_file_list.txt
    rm -f base_customizerpm.xml
    rm -f setup_rpm_file_list.txt
    rm -f docs.tar.gz
    rm -Rf docs
    rm -Rf pdfdoc
    rm -f program.pl*
    rm -Rf lpmladm.*
    rm -f WARNINGS
    rm -f CPAN_STATUS_REPORT
    rm -f $(SOURCE)/loncom/build/hosts.tab
   
   reallyclean:
    rm -f buildflag
    rm -f $(SOURCE)/README
    rm -f $(SOURCE)/UPDATE
    rm -f $(SOURCE)/TEST
    rm -f $(SOURCE)/MANIFEST
    rm -f $(SOURCE)/MANIFEST_loncapa
    rm -f $(SOURCE)/loncapa
    rm -f $(SOURCE)/loncom/build/hosts.tab
    rm -f $(SOURCE)/loncapa.tar.gz
    rm -Rf HTML
    rm -f installation_manual.pdf
    rm -f Makefile.build
    rm -f Makefile.install
    rm -f Makefile.configinstall
    rm -Rf BinaryRoot
    rm -Rf SetupBinaryRoot
    rm -Rf LON-CAPA-base
    rm -f base_rpm_file_list.txt
    rm -f base_customizerpm.xml
    rm -f setup_rpm_file_list.txt
    rm -f docs.tar.gz
    rm -Rf docs
    rm -Rf pdfdoc
    rm -f program.pl*
    rm -Rf lpmladm.*
    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:

Removed from v.1.55  
changed lines
  Added in v.1.144


FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
500 Internal Server Error

Internal Server Error

The server encountered an internal error or misconfiguration and was unable to complete your request.

Please contact the server administrator at root@localhost to inform them of the time this error occurred, and the actions you performed just before this error.

More information about this error may be available in the server error log.