--- telnetbbs/telnetbbs.pl	2010/12/16 14:24:25	1.7
+++ telnetbbs/telnetbbs.pl	2010/12/16 21:53:41	1.9
@@ -6,7 +6,7 @@
 ##
 ##   Nicholas DeClario <nick@declario.com>
 ##   October 2009
-##	$Id: telnetbbs.pl,v 1.7 2010/12/16 14:24:25 nick Exp $
+##	$Id: telnetbbs.pl,v 1.9 2010/12/16 21:53:41 nick Exp $
 ##
 ################################################################################
 BEGIN {
@@ -105,8 +105,16 @@ while( 1 ) { sleep 1; }
 ## Sub-routines begin here
 ##
 ###############################################################################
-###############################################################################
 
+
+###############################################################################
+##
+## &logmsg( "string" );
+##
+##  This takes a string and prepends the process name, ID and timestamp
+##  to the message.  It then displays it to STDOUT and logs it if enabled.
+##
+###############################################################################
 sub logmsg 
 { 
 	my $message = "$0 $$ " . scalar( localtime( ) ) . ":@_\n";
@@ -116,6 +124,15 @@ sub logmsg
 
 
 ###############################################################################
+##
+## &display_config_and_options( %hash );
+##
+##  This will display via Data::Dumper a hash that is passed to it.
+##  If verbose is enabled it will got to STDOUT and if logging is enabled
+##  it will be logged.
+##
+##  This is called only once during startup.
+##
 ###############################################################################
 sub display_config_and_options
 {
@@ -165,12 +182,13 @@ sub startNetServer
 		my $lock_file = "";
 		foreach (1 .. $MAX_NODE)
 		{
-			next if ( -f $LOCK_PATH."/".$BBS_NAME."_node".$_.".lock" );
+			$lock_file = $LOCK_PATH . "/" . $BBS_NAME . 
+				     "_node" . $_ . ".lock";
+			next if ( -f $lock_file );
 
 			##
 			## Create node lock file
 			##
-			$lock_file = $LOCK_PATH."/".$BBS_NAME."_node".$_.".lock";
 			open LOCK, ">$lock_file";
 			close( LOCK );
 			$node = $BBS_NODE = $_;
@@ -434,6 +452,13 @@ sub processExists
 }
 
 ###############################################################################
+##
+## %config_hash = &fetchConfig( );
+##
+##  This reads in a file in the format of "key = value" and stores them
+## in to a hash of $hash{$key} = $value.  Lines starting with '#' are 
+## considered comments and ignored.
+##
 ###############################################################################
 sub fetchConfig 
 {
@@ -461,6 +486,13 @@ sub fetchConfig
 }
 
 ###############################################################################
+##
+## my $file = &fetchConfig( );
+##
+##  This function will look for 'telnetbbs.conf' or whatever was specified
+##  on the command line.  It will search the @paths below for the default
+##  filename if none is specifed.
+##
 ###############################################################################
 sub findConfig
 {