--- doc/loncapafiles/buildfiles.lpml	2002/04/21 23:31:32	1.1
+++ doc/loncapafiles/buildfiles.lpml	2024/07/28 19:40:59	1.34
@@ -1,9 +1,8 @@
 <!DOCTYPE lpml PUBLIC "-//TUX/DTD lpml 1.0 Final//EN"
  "http://lpml.sourceforge.net/DTD/lpml.dtd">
 <!-- buildfiles.lpml -->
-<!-- Scott Harrison -->
 
-<!-- $Id: buildfiles.lpml,v 1.1 2002/04/21 23:31:32 harris41 Exp $ -->
+<!-- $Id: buildfiles.lpml,v 1.34 2024/07/28 19:40:59 raeburn Exp $ -->
 
 <!--
 
@@ -74,6 +73,20 @@ Makefile for LON-CAPA
 </description>
 <note>
 </note>
+<dependencies>
+doc/loncapafiles/configurable.gif;
+doc/loncapafiles/directory.gif;
+doc/loncapafiles/emptydirectory.gif;
+doc/loncapafiles/graphicfile.gif;
+doc/loncapafiles/handler.gif;
+doc/loncapafiles/interfacefile.gif;
+doc/loncapafiles/link.gif;
+doc/loncapafiles/rootscript.gif;
+doc/loncapafiles/script.gif;
+doc/loncapafiles/setuid.gif;
+doc/loncapafiles/static.gif;
+doc/loncapafiles/systemfile.gif
+</dependencies>
 </file>
 <file>
 <source>doc/loncapafiles/loncapafiles.lpml</source>
@@ -97,6 +110,27 @@ file tree.
 </note>
 </file>
 <file>
+<source>doc/loncapafiles/installfiles.lpml</source>
+<target dist='default'>installfiles.lpml</target>
+<categoryname>system file</categoryname>
+<description>
+Describes the files that help automate LON-CAPA installations on specific
+operating systems.
+</description>
+<note>
+</note>
+</file>
+<file>
+<source>doc/loncapafiles/modify_config_files.piml</source>
+<target dist='default'>modify_config_files.piml</target>
+<categoryname>system file</categoryname>
+<description>
+Post-installation of MySQL and yum config files
+</description>
+<note>
+</note>
+</file>
+<file>
 <source>doc/loncapafiles/webserver.piml</source>
 <target dist='default'>webserver.piml</target>
 <categoryname>system file</categoryname>
@@ -107,6 +141,90 @@ Post-installation of web server configur
 </note>
 </file>
 <file>
+<source>doc/loncapafiles/reseval_fixup.piml</source>
+<target dist='default'>reseval_fixup.piml</target>
+<categoryname>system file</categoryname>
+<description>
+Migrates reseval.db to nohist_eseval.db, deletes useless hist file
+</description>
+<note>
+</note>
+</file>
+<file>
+  <source>doc/loncapafiles/clean_file_permissions.piml</source>
+  <target dist='default'>clean_file_permissions.piml</target>
+  <categoryname>system file</categoryname>
+  <description>
+Executes clean_db.pl on each file_permisions.db file to remove erroneuos keys.
+  </description>
+  <note>
+  </note>
+</file>
+<file>
+  <source>doc/loncapafiles/chkconfig.piml</source>
+  <target dist='default'>chkconfig.piml</target>
+  <categoryname>system file</categoryname>
+  <description>
+Checks that the webserver and loncontrol are properly set to run at startup
+  </description>
+  <note>
+  </note>
+</file>
+<file>
+  <source>doc/loncapafiles/html_parser_check.piml</source>
+  <target dist='default'>html_parser_check.piml</target>
+  <categoryname>system file</categoryname>
+  <description>
+Checks that the HTML::parser installation has the needed patches.
+  </description>
+  <note>
+  </note>
+</file>
+<file>
+  <source>doc/loncapafiles/math_random_check.piml</source>
+  <target dist='default'>math_random_check.piml</target>
+  <categoryname>system file</categoryname>
+  <description>
+Checks that the Math::Random installation has the correct phrase to 
+seed generator.
+  </description>
+  <note>
+  </note>
+</file>
+<file>
+  <source>doc/loncapafiles/logcleanup.piml</source>
+  <target dist='default'>logcleanup.piml</target>
+  <categoryname>system file</categoryname>
+  <description>
+Cleans the .perm logs, removing useless spam messages
+  </description>
+  <note>
+  </note>
+</file>
+<file>
+<source>doc/loncapafiles/accesscount_seed.piml</source>
+<target dist='default'>accesscount_seed.piml</target>
+<categoryname>system file</categoryname>
+<description>
+Executes seed_accesscount.pl on each nohist_resevaldata.db file to move access
+count data to nohist_accesscount.db and compact the nohist_resevaldata.db
+file.
+</description>
+<note>
+</note>
+</file>
+<file>
+<source>doc/loncapafiles/clearoutoldspreadsheetcache.piml</source>
+<target dist='default'>clearoutoldspreadsheetcache.piml</target>
+<categoryname>system file</categoryname>
+<description>
+Deletes all of the old spreadsheet cache files, the ones generated prior 
+to version 0.6 were incorrect
+</description>
+<note>
+</note>
+</file>
+<file>
 <source>doc/loncapafiles/sanitycheck.piml</source>
 <target dist='default'>sanitycheck.piml</target>
 <categoryname>system file</categoryname>
@@ -117,6 +235,203 @@ Checks LON-CAPA system for frequently oc
 </note>
 </file>
 <file>
+  <source>doc/loncapafiles/cron_lpmlcheck.piml</source>
+  <target dist='default'>cron_lpmlcheck.piml</target>
+  <categoryname>system file</categoryname>
+  <description>
+    Checks that there is no lpmlsave file in the cron.d dir
+  </description>
+</file>
+<file>
+<source>doc/loncapafiles/ntpcheck.piml</source>
+<target dist='default'>ntpcheck.piml</target>
+<categoryname>system file</categoryname>
+<description>
+Checks server to determine status of ntpd.
+</description>
+<note>
+</note>
+</file>
+<file>
+<source>doc/loncapafiles/rpmcheck.piml</source>
+<target dist='default'>rpmcheck.piml</target>
+<categoryname>system file</categoryname>
+<description>
+Checks server for rpms known to conflict with LON-CAPA.
+</description>
+<note>
+</note>
+</file>
+<file>
+<source>doc/loncapafiles/updatequery.piml</source>
+<target dist='default'>updatequery.piml</target>
+<categoryname>system file</categoryname>
+<description>
+Checks LON-CAPA system for frequently occuring bugs.
+</description>
+<note>
+</note>
+</file>
+<file>
+<source>doc/loncapafiles/sendmail_fix.piml</source>
+<target dist='default'>sendmail_fix.piml</target>
+<categoryname>system file</categoryname>
+<description>
+Checks LON-CAPA system for sendmail permissions error.
+</description>
+<note>
+</note>
+</file>
+<file>
+<source>doc/loncapafiles/ownership_fix.piml</source>
+<target dist='default'>ownership_fix.piml</target>
+<categoryname>system file</categoryname>
+<description>
+Makes sure that /home/httpd/lonUsers and /home/httpd/html are owned by www.
+</description>
+<note>
+</note>
+</file>
+<file>
+<source>doc/loncapafiles/run_searchcat.piml</source>
+<target dist='default'>run_searchcat.piml</target>
+<categoryname>system file</categoryname>
+<description>
+Makes sure that /home/httpd/lonUsers and /home/httpd/html are owned by www.
+</description>
+<note>
+</note>
+</file>
+<file>
+  <source>doc/loncapafiles/update_queue_slots.piml</source>
+  <target dist='default'>update_queue_slots.piml</target>
+  <categoryname>system file</categoryname>
+  <description>
+Update the slots definitons from havin @ to having :
+  </description>
+  <note>
+  </note>
+</file>
+<file>
+  <source>doc/loncapafiles/wrap_setuid.piml</source>
+  <target dist='default'>wrap_setuid.piml</target>
+  <categoryname>system file</categoryname>
+  <description>
+Wraps the setuid perl scripts into a binary excutable wrapper.
+  </description>
+  <note>
+  </note>
+</file>
+<file>
+  <source>doc/loncapafiles/latex_fixup.piml</source>
+  <target dist='default'>latex_fixup.piml</target>
+  <categoryname>system file</categoryname>
+  <description>
+Runs /usr/bin/mktexlsr so LaTeX sees files added to texmf/tex/latex/base
+  </description>
+  <note>
+  </note>
+</file>
+<file>
+  <source>doc/loncapafiles/picins_check.piml</source>
+  <target dist='default'>picins_check.piml</target>
+  <categoryname>system file</categoryname>
+  <description>
+If picins.sty is absent, retrieves from CTAN and runs texinfo rehash 
+and fmtutil-sys --missing.
+  </description>
+  <note>
+  </note>
+</file>
+<file>
+  <source>doc/loncapafiles/langcheck.piml</source>
+  <target dist='default'>langcheck.piml</target>
+  <categoryname>system file</categoryname>
+  <description>
+Check language used for root bash and OS, and warn if language other
+than English is in use. 
+  </description>
+  <note>
+  </note>
+</file>
+<file>
+  <source>doc/loncapafiles/mimetex_version_check.piml</source>
+  <target dist='default'>mimetex_version_check.piml</target>
+  <categoryname>system file</categoryname>
+  <description>
+If mimeTeX cgi has been updated will update version number in 
+/home/httpd/lonTabs/mimetex-version and remove any .gif files from 
+/home/httpd/cgi-bin/mimtexcache/
+  </description>
+  <note>
+  </note>
+</file>
+<file>
+  <source>doc/loncapafiles/verify_domconfiguser.piml</source>
+  <target dist='default'>verify_domconfiguser.piml</target>
+  <categoryname>system file</categoryname>
+  <description>
+Determine if current machine is the primary library server for any domains.
+If it is create the $dom-domainconfig user for any of these domains if it is absent, create /home/httpd/lonUsers/$dom/1/2/3/$dom-domainconfig directory, assign author role if required, and create /home/$dom-domconfig/public_html directory, if required.
+  </description>
+  <note>
+  </note>
+</file>
+<file>
+  <source>doc/loncapafiles/latex_fmtutil.piml</source>
+  <target dist='default'>latex_fmtutil.piml</target>
+  <categoryname>system file</categoryname>
+  <description>
+Runs "/usr/bin/fmtutil-sys --missing" to create any missing TeX format files.
+  </description>
+  <note>
+  </note>
+</file>
+<file>
+  <source>doc/loncapafiles/removenolongerused.piml</source>
+  <target dist='default'>removenolongerused.piml</target>
+  <categoryname>system file</categoryname>
+  <description>
+Check for files and/or directories installed by earlier versions of LON-CAPA which are no longer used by the version being installed.  Prompt the user to confirm deletion for each file and each directory, before deleting them.
+  </description>
+  <note>
+  </note>
+</file>
+<file>
+  <source>doc/loncapafiles/bash_config_check.piml</source>
+  <target dist='default'>bash_config_check.piml</target>
+  <categoryname>system file</categoryname>
+  <description>
+Check for distros with readline 8.1 or newer whether bash for user www has bracketed paste mode enabled,
+and, if so, include advice in WARNINGS to disable it by modifying /home/www/.inputrc.
+If no change is made from the default for such distros, R commands sent to the lonr daemon will not be processed.
+  </description>
+  <note>
+  </note>
+</file>
+<file>
+  <source>doc/loncapafiles/systemd_config_check.piml</source>
+  <target dist='default'>systemd_config_check.piml</target>
+  <categoryname>system file</categoryname>
+  <description>
+Check for distros/versions which use systemctl, and check if ProtectHome property is set to readonly or yes 
+for web server (httpd.service or apache2.service, depending on distro). If so, attempt to set ProtectHome=no  
+in /etc/systemd/httpd.service.d/override.conf or /etc/systemd/apache2.service.d/override.conf, as appropriate.
+  </description>
+  <note>
+  </note>
+</file>
+<file>
+  <source>doc/loncapafiles/lcmathcomplex.piml</source>
+  <target dist='default'>lcmathcomplex.piml</target>
+  <categoryname>system file</categoryname>
+  <description>
+Use perl core module Config.pm to determine nvsize and set value for this scalar in /home/httpd/lib/perl/LONCAPA/LCMathComplex.pm.  LCMathComplex.pm is used instead of the core perl module Math::Complex in Safe Space, because the dependency on Config.pm is eliminated.
+  </description>
+  <note>
+  </note>
+</file>
+<file>
 <source>doc/loncapafiles/valid_hosts.xfml</source>
 <target dist='default'>valid_hosts.xfml</target>
 <categoryname>system file</categoryname>
@@ -168,6 +483,18 @@ rigorously compare many different values
 </note>
 </file>
 <file>
+<source>loncom/build/getcvsdate.pl</source>
+<target dist='default'>getcvsdate.pl</target>
+<categoryname>system file</categoryname>
+<description>
+script to get CVS commit date/time for a file from file's entry in
+CVS/Entries for directory containing the file
+</description>
+<note>
+</note>
+</file>
+
+<file>
 <source>loncom/build/loncaparestoreconfigurations</source>
 <target dist='default'>loncaparestoreconfigurations</target>
 <categoryname>system file</categoryname>
@@ -217,6 +544,26 @@ make a domain coordinator on a new LON-C
 </note>
 </file>
 <file>
+  <source>loncom/build/add_domain_coordinator_privilege.pl</source>
+  <target dist='default'>add_domain_coordinator_privilege.pl</target>
+  <categoryname>system file</categoryname>
+  <description>
+add domain coordinator privilege to and exisiting local LON-CAPA user
+  </description>
+  <note>
+  </note>
+</file>
+<file>
+  <source>loncom/build/expire_DC_role.pl</source>
+  <target dist='default'>expire_DC_role.pl</target>
+  <categoryname>system file</categoryname>
+  <description>
+expire domain coordinator role for exisiting local LON-CAPA user
+  </description>
+  <note>
+  </note>
+</file>
+<file>
 <source>loncom/build/piml.dtd</source>
 <target dist='default'>piml.dtd</target>
 <categoryname>system file</categoryname>