--- loncom/configuration/Configuration.pm	2002/05/04 00:03:29	1.2
+++ loncom/configuration/Configuration.pm	2002/09/09 13:57:37	1.7
@@ -1,7 +1,7 @@
 # The LearningOnline Network with CAPA
 # Configuration file reader
 #
-# $Id: Configuration.pm,v 1.2 2002/05/04 00:03:29 harris41 Exp $
+# $Id: Configuration.pm,v 1.7 2002/09/09 13:57:37 harris41 Exp $
 #
 #
 # Copyright Michigan State University Board of Trustees
@@ -31,32 +31,41 @@
 #
 ###
 
+# POD documentation is at the end of this short module.
+
 package LONCAPA::Configuration;
 
-$VERSION = sprintf("%d.%02d", q$Revision: 1.2 $ =~ /(\d+)\.(\d+)/);
+$VERSION = sprintf("%d.%02d", q$Revision: 1.7 $ =~ /(\d+)\.(\d+)/);
 
 use strict;
 
 my $confdir='/etc/httpd/conf/';
 
-# ------------------------------------ read_conf: read LON-CAPA server configuration, especially PerlSetVar values
-sub read_conf {
+# ------------------- Subroutine read_conf: read LON-CAPA server configuration.
+# This subroutine reads PerlSetVar values out of specified web server
+# configuration files.
+sub read_conf
+  {
     my (@conf_files)=@_;
     my %perlvar;
-    foreach my $filename (@conf_files) {
-	open(CONFIG,'<'.$confdir.$filename) or die("Can't read $filename");
-	while (my $configline=<CONFIG>) {
-	    if ($configline =~ /^[^\#]*PerlSetVar/) {
+    foreach my $filename (@conf_files,'loncapa_apache.conf')
+      {
+	open(CONFIG,'<'.$confdir.$filename) or
+	    die("Can't read $confdir$filename");
+	while (my $configline=<CONFIG>)
+	  {
+	    if ($configline =~ /^[^\#]*PerlSetVar/)
+	      {
 		my ($unused,$varname,$varvalue)=split(/\s+/,$configline);
 		chomp($varvalue);
 		$perlvar{$varname}=$varvalue;
-	    }
-	}
+	      }
+	  }
 	close(CONFIG);
-    }
+      }
     my $perlvarref=\%perlvar;
     return ($perlvarref);
-}
+  }
 
 __END__
 
@@ -71,21 +80,15 @@ B<LONCAPA::Configuration> - configuratio
  use lib '/home/httpd/lib/perl/';
  use LONCAPA::Configuration;
 
- LONCAPA::Configuration::read_conf('access.conf','loncapa.conf');
-
-In the future, standard invocation of the command will be:
-
  LONCAPA::Configuration::read_conf('loncapa.conf');
 
-F<access.conf> is slowly becoming deprecated.  (We are currently
-trying to support backwards compatibility.)
-
 =head1 DESCRIPTION
 
-Many different parts of the LON-CAPA software need to read in the machine-specific
-configuration information.  These included scripts controlling the TCP/IP layer
-(e.g. F<lonc> and F<lond>), testing scripts (e.g. test_weblayer.pl and sqltest.pl),
-and utility scripts (e.g. clusterstatus.pl and metadata_keywords.pl).
+Many different parts of the LON-CAPA software need to read in the
+machine-specific configuration information.  These included scripts
+controlling the TCP/IP layer (e.g. F<lonc> and F<lond>), testing scripts
+(e.g. test_weblayer.pl and sqltest.pl), and utility scripts
+(e.g. clusterstatus.pl and metadata_keywords.pl).
 
 The following methods are available:
 
@@ -104,7 +107,7 @@ have been initialized from the configura
 in the arguments.
 
 If multiple file names define the same hash key, then priority is
-given toward the last file name processed.
+given toward the B<last> file name processed.
 
 =back