Annotation of loncom/build/lpml_parse.pl, revision 1.62

1.1       harris41    1: #!/usr/bin/perl
1.2       albertel    2: 
1.43      harris41    3: # -------------------------------------------------------- Documentation notice
                      4: # Run "perldoc ./lpml_parse.pl" in order to best view the software
                      5: # documentation internalized in this program.
                      6: 
1.45      harris41    7: # --------------------------------------------------------- Distribution notice
                      8: # This script is distributed with the LPML software project available at
                      9: # http://lpml.sourceforge.net
                     10: 
1.43      harris41   11: # --------------------------------------------------------- License Information
1.28      harris41   12: # The LearningOnline Network with CAPA
                     13: # lpml_parse.pl - Linux Packaging Markup Language parser
                     14: #
1.62    ! raeburn    15: # $Id: lpml_parse.pl,v 1.61 2014/06/09 05:14:12 raeburn Exp $
1.28      harris41   16: #
1.43      harris41   17: # Written by Scott Harrison, codeharrison@yahoo.com
1.28      harris41   18: #
                     19: # Copyright Michigan State University Board of Trustees
                     20: #
                     21: # This file is part of the LearningOnline Network with CAPA (LON-CAPA).
                     22: #
                     23: # LON-CAPA is free software; you can redistribute it and/or modify
                     24: # it under the terms of the GNU General Public License as published by
                     25: # the Free Software Foundation; either version 2 of the License, or
                     26: # (at your option) any later version.
                     27: #
                     28: # LON-CAPA is distributed in the hope that it will be useful,
                     29: # but WITHOUT ANY WARRANTY; without even the implied warranty of
                     30: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
                     31: # GNU General Public License for more details.
                     32: #
                     33: # You should have received a copy of the GNU General Public License
                     34: # along with LON-CAPA; if not, write to the Free Software
                     35: # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
                     36: #
                     37: # /home/httpd/html/adm/gpl.txt
                     38: #
                     39: # http://www.lon-capa.org/
                     40: #
1.4       harris41   41: # YEAR=2001
1.2       albertel   42: # May 2001
1.3       harris41   43: # 06/19/2001,06/20,06/24 - Scott Harrison
1.5       harris41   44: # 9/5/2001,9/6,9/7,9/8 - Scott Harrison
1.14      harris41   45: # 9/17,9/18 - Scott Harrison
1.21      harris41   46: # 11/4,11/5,11/6,11/7,11/16,11/17 - Scott Harrison
1.35      harris41   47: # 12/2,12/3,12/4,12/5,12/6,12/13,12/19,12/29 - Scott Harrison
                     48: # YEAR=2002
1.45      harris41   49: # 1/8,1/9,1/29,1/31,2/5,3/21,4/8,4/12 - Scott Harrison
1.51      harris41   50: # 4/21,4/26,5/19,5/23,10/13 - Scott Harrison
1.43      harris41   51: #
1.18      harris41   52: ###
1.3       harris41   53: 
1.4       harris41   54: ###############################################################################
                     55: ##                                                                           ##
                     56: ## ORGANIZATION OF THIS PERL SCRIPT                                          ##
                     57: ## 1. Notes                                                                  ##
                     58: ## 2. Get command line arguments                                             ##
                     59: ## 3. First pass through (grab distribution-specific information)            ##
                     60: ## 4. Second pass through (parse out what is not necessary)                  ##
                     61: ## 5. Third pass through (translate markup according to specified mode)      ##
1.14      harris41   62: ## 6. Functions (most all just format contents of different markup tags)     ##
                     63: ## 7. POD (plain old documentation, CPAN style)                              ##
1.4       harris41   64: ##                                                                           ##
                     65: ###############################################################################
                     66: 
                     67: # ----------------------------------------------------------------------- Notes
                     68: #
1.3       harris41   69: # I am using a multiple pass-through approach to parsing
                     70: # the lpml file.  This saves memory and makes sure the server
1.45      harris41   71: # will never be overloaded.
1.4       harris41   72: #
                     73: # This is meant to parse files meeting the lpml document type.
                     74: # See lpml.dtd.  LPML=Linux Packaging Markup Language.
1.2       albertel   75: 
1.1       harris41   76: use HTML::TokeParser;
1.2       albertel   77: 
1.3       harris41   78: my $usage=<<END;
                     79: **** ERROR ERROR ERROR ERROR ****
                     80: Usage is for lpml file to come in through standard input.
1.45      harris41   81: 1st argument is the mode of parsing:
                     82:     install,configinstall,build,rpm,dpkg,htmldoc,textdoc,status
                     83: 2nd argument is the category permissions to use:
                     84:     typical choices: runtime,development
                     85: 3rd argument is the distribution:
                     86:     typical choices: default,redhat6.2,debian2.2,redhat7
1.4       harris41   87: 4th argument is to manually specify a sourceroot.
                     88: 5th argument is to manually specify a targetroot.
1.57      raeburn    89: 6th argument is to manually specify a shell.
1.3       harris41   90: 
                     91: Only the 1st argument is mandatory for the program to run.
                     92: 
                     93: Example:
                     94: 
                     95: cat ../../doc/loncapafiles.lpml |\\
1.25      harris41   96: perl lpml_parse.pl html development default /home/sherbert/loncapa /tmp/install
1.45      harris41   97: 
                     98: For more information, type "perldoc lpml_parse.pl".
1.3       harris41   99: END
                    100: 
                    101: # ------------------------------------------------- Grab command line arguments
                    102: 
1.43      harris41  103: my $mode='';
1.57      raeburn   104: if (@ARGV == 6 || @ARGV == 5) {
1.3       harris41  105:     $mode = shift @ARGV;
                    106: }
                    107: else {
1.4       harris41  108:     @ARGV=();shift @ARGV;
1.3       harris41  109:     while(<>){} # throw away the input to avoid broken pipes
                    110:     print $usage;
                    111:     exit -1; # exit with error status
                    112: }
                    113: 
1.43      harris41  114: my $categorytype='';
1.4       harris41  115: if (@ARGV) {
                    116:     $categorytype = shift @ARGV;
                    117: }
                    118: 
1.43      harris41  119: my $dist='';
1.3       harris41  120: if (@ARGV) {
                    121:     $dist = shift @ARGV;
                    122: }
1.2       albertel  123: 
1.43      harris41  124: my $targetroot='';
                    125: my $sourceroot='';
                    126: my $targetrootarg='';
                    127: my $sourcerootarg='';
1.3       harris41  128: if (@ARGV) {
1.4       harris41  129:     $sourceroot = shift @ARGV;
1.3       harris41  130: }
                    131: if (@ARGV) {
1.4       harris41  132:     $targetroot = shift @ARGV;
1.3       harris41  133: }
1.45      harris41  134: $sourceroot=~s/\/$//; # remove trailing directory slash
                    135: $targetroot=~s/\/$//; # remove trailing directory slash
1.27      harris41  136: $sourcerootarg=$sourceroot;
                    137: $targetrootarg=$targetroot;
1.3       harris41  138: 
1.57      raeburn   139: my $shell = 'sh';
                    140: if (@ARGV) {
                    141:     $shell = shift @ARGV;
                    142: }
                    143: 
1.19      harris41  144: my $logcmd='| tee -a WARNINGS';
                    145: 
1.45      harris41  146: my $invocation; # Record how the program was invoked
1.5       harris41  147: # --------------------------------------------------- Record program invocation
1.17      harris41  148: if ($mode eq 'install' or $mode eq 'configinstall' or $mode eq 'build') {
1.5       harris41  149:     $invocation=(<<END);
                    150: # Invocation: STDINPUT | lpml_parse.pl
                    151: #             1st argument (mode) is: $mode
                    152: #             2nd argument (category type) is: $categorytype
                    153: #             3rd argument (distribution) is: $dist
1.36      harris41  154: #             4th argument (sourceroot) is: described below
                    155: #             5th argument (targetroot) is: described below
1.57      raeburn   156: #             6th argument (shell) is: $shell	
1.5       harris41  157: END
                    158: }
                    159: 
1.45      harris41  160: # -------------------------- Start first pass through (just gather information)
                    161: my @parsecontents=<>;
                    162: my $parsestring=join('',@parsecontents);
1.2       albertel  163: 
1.3       harris41  164: # Need to make a pass through and figure out what defaults are
1.45      harris41  165: # overrided.  Top-down overriding strategy (tree leaves don't know
                    166: # about distant tree leaves).
1.3       harris41  167: 
                    168: my @hierarchy;
                    169: $hierarchy[0]=0;
                    170: my $hloc=0;
                    171: my $token;
                    172: $parser = HTML::TokeParser->new(\$parsestring) or
                    173:     die('can\'t create TokeParser object');
                    174: $parser->xml_mode('1');
1.45      harris41  175: my %setting;
                    176: 
                    177: # Values for the %setting hash
                    178: my $defaultset=1; # a default setting exists for a key
                    179: my $distset=2; # a distribution setting exists for a key
                    180:                # (overrides default setting)
                    181: 
                    182: my $key=''; # this is a unique key identifier (the token name with its
                    183:             # coordinates inside the hierarchy)
                    184: while ($token = $parser->get_token()) { # navigate through $parsestring
1.3       harris41  185:     if ($token->[0] eq 'S') {
                    186: 	$hloc++;
                    187: 	$hierarchy[$hloc]++;
                    188: 	$key=$token->[1].join(',',@hierarchy[0..($hloc-1)]);
                    189: 	my $thisdist=' '.$token->[2]{'dist'}.' ';
                    190: 	if ($thisdist eq ' default ') {
1.45      harris41  191: 	    $setting{$key}=$defaultset;
1.3       harris41  192: 	}
1.45      harris41  193: 	elsif (length($dist)>0 &&
                    194: 	       $setting{$key}==$defaultset &&
                    195: 	       $thisdist=~/\s$dist\s/) {
                    196: 	    $setting{$key}=$distset;
                    197:                    # disregard default setting for this key if
                    198:                    # there is a directly requested distribution match
                    199:                    # (in other words, there must first be a default
                    200: 	           # setting for a key in order for it to be overridden)
1.3       harris41  201: 	}
                    202:     }
                    203:     if ($token->[0] eq 'E') {
                    204: 	$hloc--;
                    205:     }
                    206: }
                    207: 
1.45      harris41  208: # - Start second pass through (clean up the string to allow for easy rendering)
                    209: 
                    210: # The string is cleaned up so that there is no white-space surrounding any
                    211: # XML tag.  White-space inside text 'T' elements is preserved.
                    212: 
                    213: # Clear up memory
1.43      harris41  214: undef($hloc);
                    215: undef(@hierarchy);
                    216: undef($parser);
1.45      harris41  217: $hierarchy[0]=0; # initialize hierarchy
1.3       harris41  218: $parser = HTML::TokeParser->new(\$parsestring) or
                    219:     die('can\'t create TokeParser object');
                    220: $parser->xml_mode('1');
1.45      harris41  221: my $cleanstring; # contains the output of the second step
                    222: while ($token = $parser->get_token()) { # navigate through $parsestring
                    223:     if ($token->[0] eq 'S') { # a start tag
1.3       harris41  224: 	$hloc++;
                    225: 	$hierarchy[$hloc]++;
                    226: 	$key=$token->[1].join(',',@hierarchy[0..($hloc-1)]);
1.45      harris41  227: 
                    228: 	# Surround tagdist (the dist attribute of an XML tag)
                    229: 	# with white-space to allow for uniform searching a few
                    230: 	# lines below here.
                    231: 	my $tagdist=' '.$token->[2]{'dist'}.' ';
                    232: 
1.4       harris41  233: 	# This conditional clause is set up to ignore two sets
                    234: 	# of invalid conditions before accepting entry into
1.45      harris41  235: 	# $cleanstring.
                    236: 
                    237: 	# Condition #1: Ignore this part of the string if the tag 
                    238: 	# has a superior distribution-specific setting and the tag
                    239: 	# being evaluated has a dist setting something other than
                    240: 	# blank or $dist.
                    241: 	if ($setting{$key}==$distset and
                    242: 	    !($tagdist eq '  ' or $tagdist =~/\s$dist\s/)) {
1.3       harris41  243: 	    if ($token->[4]!~/\/>$/) {
                    244: 		$parser->get_tag('/'.$token->[1]);
                    245: 		$hloc--;
                    246: 	    }
                    247: 	}
1.45      harris41  248: 	# Condition #2: Ignore this part of the string if the tag has
                    249: 	# is not blank and does not equal dist and
                    250: 	# either does not equal default or it has a prior $dist-specific
                    251: 	# setting.
                    252: 	elsif ($tagdist ne '  ' and $tagdist!~/\s$dist\s/ and
                    253: 	       !($tagdist eq ' default ' and $setting{$key}!=$distset)) {
1.3       harris41  254: 	    if ($token->[4]!~/\/>$/) {
                    255: 		$parser->get_tag('/'.$token->[1]);
                    256: 		$hloc--;
                    257: 	    }
                    258: 	}
1.45      harris41  259: 	# In other words, output to $cleanstring if the tag is dist=default
                    260: 	# or if the tag is set to dist=$dist for the first time.  And, always
                    261: 	# output when dist='' is not present.
1.3       harris41  262: 	else {
                    263: 	    $cleanstring.=$token->[4];
                    264: 	}
                    265:     }
1.45      harris41  266:     # Note: this loop DOES work with <tag /> style markup as well as
                    267:     # <tag></tag> style markup since I always check for $token->[4] ending
                    268:     # with "/>".
                    269:     if ($token->[0] eq 'E') { # an end tag
1.3       harris41  270: 	$cleanstring.=$token->[2];
                    271: 	$hloc--;
                    272:     }
1.45      harris41  273:     if ($token->[0] eq 'T') { # text contents inside tags
1.3       harris41  274: 	$cleanstring.=$token->[1];
                    275:     }
                    276: }
                    277: $cleanstring=&trim($cleanstring);
1.10      harris41  278: $cleanstring=~s/\>\s*\n\s*\</\>\</g;
                    279: 
1.45      harris41  280: # -------------------------------------------- Start final (third) pass through
1.3       harris41  281: 
                    282: # storage variables
                    283: my $lpml;
                    284: my $categories;
1.29      harris41  285: my @categorynamelist;
1.3       harris41  286: my $category;
                    287: my $category_att_name;
                    288: my $category_att_type;
                    289: my $chown;
                    290: my $chmod;
1.25      harris41  291: my $abbreviation; # space-free abbreviation; esp. for image names
1.3       harris41  292: my $rpm;
                    293: my $rpmSummary;
                    294: my $rpmName;
                    295: my $rpmVersion;
                    296: my $rpmRelease;
                    297: my $rpmVendor;
                    298: my $rpmBuildRoot;
                    299: my $rpmCopyright;
                    300: my $rpmGroup;
                    301: my $rpmSource;
                    302: my $rpmAutoReqProv;
                    303: my $rpmdescription;
                    304: my $rpmpre;
                    305: my $directories;
                    306: my $directory;
                    307: my $targetdirs;
                    308: my $targetdir;
1.51      harris41  309: my $protectionlevel;
1.3       harris41  310: my $categoryname;
                    311: my $description;
                    312: my $files;
                    313: my $fileglobs;
                    314: my $links;
                    315: my $file;
                    316: my $link;
                    317: my $fileglob;
                    318: my $sourcedir;
                    319: my $targets;
                    320: my $target;
                    321: my $source;
                    322: my $note;
1.53      albertel  323: my $installscript;
1.3       harris41  324: my $build;
1.14      harris41  325: my $buildlink;
1.3       harris41  326: my $commands;
                    327: my $command;
                    328: my $status;
                    329: my $dependencies;
                    330: my $dependency;
1.4       harris41  331: my @links;
                    332: my %categoryhash;
1.26      harris41  333: my $dpathlength;
                    334: my %fab; # file category abbreviation
1.29      harris41  335: my $directory_count;
                    336: my $file_count;
                    337: my $link_count;
                    338: my $fileglob_count;
                    339: my $fileglobnames_count;
                    340: my %categorycount;
1.3       harris41  341: 
1.11      harris41  342: my @buildall;
1.12      harris41  343: my @buildinfo;
                    344: 
                    345: my @configall;
1.11      harris41  346: 
1.3       harris41  347: # Make new parser with distribution specific input
                    348: undef $parser;
                    349: $parser = HTML::TokeParser->new(\$cleanstring) or
                    350:     die('can\'t create TokeParser object');
                    351: $parser->xml_mode('1');
                    352: 
                    353: # Define handling methods for mode-dependent text rendering
1.26      harris41  354: 
1.3       harris41  355: $parser->{textify}={
1.31      harris41  356:     specialnotices => \&format_specialnotices,
                    357:     specialnotice => \&format_specialnotice,
1.3       harris41  358:     targetroot => \&format_targetroot,
                    359:     sourceroot => \&format_sourceroot,
                    360:     categories => \&format_categories,
                    361:     category => \&format_category,
1.25      harris41  362:     abbreviation => \&format_abbreviation,
1.3       harris41  363:     targetdir => \&format_targetdir,
1.51      harris41  364:     protectionlevel => \&format_protectionlevel,
1.3       harris41  365:     chown => \&format_chown,
                    366:     chmod => \&format_chmod,
                    367:     rpm => \&format_rpm,
                    368:     rpmSummary => \&format_rpmSummary,
                    369:     rpmName => \&format_rpmName,
                    370:     rpmVersion => \&format_rpmVersion,
                    371:     rpmRelease => \&format_rpmRelease,
                    372:     rpmVendor => \&format_rpmVendor,
                    373:     rpmBuildRoot => \&format_rpmBuildRoot,
                    374:     rpmCopyright => \&format_rpmCopyright,
                    375:     rpmGroup => \&format_rpmGroup,
                    376:     rpmSource => \&format_rpmSource,
                    377:     rpmAutoReqProv => \&format_rpmAutoReqProv,
                    378:     rpmdescription => \&format_rpmdescription,
                    379:     rpmpre => \&format_rpmpre,
1.35      harris41  380:     rpmRequires => \&format_rpmRequires,
1.3       harris41  381:     directories => \&format_directories,
                    382:     directory => \&format_directory,
                    383:     categoryname => \&format_categoryname,
                    384:     description => \&format_description,
                    385:     files => \&format_files,
                    386:     file => \&format_file,
                    387:     fileglob => \&format_fileglob,
1.4       harris41  388:     links => \&format_links,
1.3       harris41  389:     link => \&format_link,
                    390:     linkto => \&format_linkto,
                    391:     source => \&format_source,
                    392:     target => \&format_target,
                    393:     note => \&format_note,
                    394:     build => \&format_build,
1.53      albertel  395:     installscript => \&format_installscript,
1.3       harris41  396:     status => \&format_status,
                    397:     dependencies => \&format_dependencies,
1.52      albertel  398:     privatedependencies => \&format_privatedependencies,
1.14      harris41  399:     buildlink => \&format_buildlink,
1.3       harris41  400:     glob => \&format_glob,
                    401:     sourcedir => \&format_sourcedir,
                    402:     filenames => \&format_filenames,
                    403:     };
                    404: 
                    405: my $text;
                    406: my $token;
                    407: undef $hloc;
                    408: undef @hierarchy;
                    409: my $hloc;
                    410: my @hierarchy2;
                    411: while ($token = $parser->get_tag('lpml')) {
                    412:     &format_lpml(@{$token});
                    413:     $text = &trim($parser->get_text('/lpml'));
                    414:     $token = $parser->get_tag('/lpml');
                    415:     print $lpml; 
                    416:     print "\n";
1.4       harris41  417: #    $text=~s/\s*\n\s*\n\s*/\n/g;
1.3       harris41  418:     print $text;
                    419:     print "\n";
                    420:     print &end();
                    421: }
                    422: exit;
                    423: 
1.14      harris41  424: # ---------- Functions (most all just format contents of different markup tags)
                    425: 
                    426: # ------------------------ Final output at end of markup parsing and formatting
1.3       harris41  427: sub end {
                    428:     if ($mode eq 'html') {
1.29      harris41  429: 	return "<br />&nbsp;<br />".
                    430: 	    "<a name='summary' /><font size='+2'>Summary of Source Repository".
                    431: 	    "</font>".
                    432: 	    "<br />&nbsp;<br />".
                    433: 	    "<table border='1' cellpadding='5'>".
                    434: 	    "<caption>Files, Directories, and Symbolic Links</caption>".
                    435: 	    "<tr><td>Files (not referenced by globs)</td><td>$file_count</td>".
                    436: 	    "</tr>".
                    437: 	    "<tr><td>Files (referenced by globs)</td>".
                    438: 	    "<td>$fileglobnames_count</td>".
                    439: 	    "</tr>".
                    440: 	    "<tr><td>Total Files</td>".
                    441: 	    "<td>".($fileglobnames_count+$file_count)."</td>".
                    442: 	    "</tr>".
                    443: 	    "<tr><td>File globs</td>".
                    444: 	    "<td>".$fileglob_count."</td>".
                    445: 	    "</tr>".
                    446: 	    "<tr><td>Directories</td>".
                    447: 	    "<td>".$directory_count."</td>".
                    448: 	    "</tr>".
                    449: 	    "<tr><td>Symbolic links</td>".
                    450: 	    "<td>".$link_count."</td>".
                    451: 	    "</tr>".
                    452: 	    "</table>".
                    453: 	    "<table border='1' cellpadding='5'>".
                    454: 	    "<caption>File Category Count</caption>".
                    455: 	    "<tr><th>Icon</th><th>Name</th><th>Number of Occurrences</th>".
1.32      harris41  456: 	    "<th>Number of Incorrect Counts</th>".
                    457: 	    "</tr>".
1.29      harris41  458: 	    join("\n",(map {"<tr><td><img src='$fab{$_}.gif' ".
                    459: 		 "alt='$_ icon' /></td>".
1.32      harris41  460:  	         "<td>$_</td><td>$categorycount{$_}</td>".
                    461: 		 "<td><!-- POSTEVALINLINE $_ --></td></tr>"}
1.29      harris41  462: 		@categorynamelist)).
                    463: 	    "</table>".
                    464: 	    "</body></html>\n";
                    465: 
1.3       harris41  466:     }
1.4       harris41  467:     if ($mode eq 'install') {
                    468: 	return '';
                    469:     }
1.3       harris41  470: }
                    471: 
                    472: # ----------------------- Take in string to parse and the separation expression
                    473: sub extract_array {
                    474:     my ($stringtoparse,$sepexp) = @_;
                    475:     my @a=split(/$sepexp/,$stringtoparse);
                    476:     return \@a;
                    477: }
                    478: 
                    479: # --------------------------------------------------------- Format lpml section
                    480: sub format_lpml {
                    481:     my (@tokeninfo)=@_;
                    482:     my $date=`date`; chop $date;
                    483:     if ($mode eq 'html') {
1.24      harris41  484: 	$lpml=<<END;
                    485: <html>
                    486: <head>
1.25      harris41  487: <title>LPML Description Page
                    488: (dist=$dist, categorytype=$categorytype, $date)</title>
1.24      harris41  489: </head>
                    490: <body>
                    491: END
                    492: 	$lpml .= "<br /><font size='+2'>LPML Description Page (dist=$dist, ".
1.25      harris41  493: 	    "categorytype=$categorytype, $date)".
1.23      harris41  494: 	    "</font>";
                    495: 	$lpml .=<<END;
                    496: <ul>
1.24      harris41  497: <li><a href='#about'>About this file</a></li>
                    498: <li><a href='#ownperms'>File Type Ownership and Permissions
                    499: Descriptions</a></li>
                    500: <li><a href='#package'>Software Package Description</a></li>
                    501: <li><a href='#directories'>Directory Structure</a></li>
1.26      harris41  502: <li><a href='#files'>Files</a></li>
1.29      harris41  503: <li><a href='#summary'>Summary of Source Repository</a></li>
1.23      harris41  504: </ul>
                    505: END
                    506:         $lpml .=<<END;
1.24      harris41  507: <br />&nbsp;<br /><a name='about' />
1.23      harris41  508: <font size='+2'>About this file</font>
                    509: <p>
                    510: This file is generated dynamically by <tt>lpml_parse.pl</tt> as
1.28      harris41  511: part of a development compilation process.</p>
                    512: <p>LPML written by Scott Harrison (harris41\@msu.edu).
1.23      harris41  513: </p>
                    514: END
                    515:     }
                    516:     elsif ($mode eq 'text') {
                    517: 	$lpml = "LPML Description Page (dist=$dist, $date)";
                    518: 	$lpml .=<<END;
                    519: 
                    520: * About this file
                    521: * Software Package Description
                    522: * Directory Structure
                    523: * File Type Ownership and Permissions
1.26      harris41  524: * Files
1.23      harris41  525: END
                    526:         $lpml .=<<END;
                    527: 
                    528: About this file
                    529: 
                    530: This file is generated dynamically by lpml_parse.pl as
                    531: part of a development compilation process.  Author: Scott
                    532: Harrison (harris41\@msu.edu).
                    533: 
                    534: END
1.3       harris41  535:     }
1.4       harris41  536:     elsif ($mode eq 'install') {
                    537: 	print '# LPML install targets. Linux Packaging Markup Language,';
                    538: 	print ' by Scott Harrison 2001'."\n";
                    539: 	print '# This file was automatically generated on '.`date`;
1.5       harris41  540: 	print "\n".$invocation;
1.54      raeburn   541: 	$lpml .= "\n";
1.4       harris41  542:     }
1.16      harris41  543:     elsif ($mode eq 'configinstall') {
1.17      harris41  544: 	print '# LPML configuration file targets (configinstall).'."\n";
                    545: 	print '# Linux Packaging Markup Language,';
1.16      harris41  546: 	print ' by Scott Harrison 2001'."\n";
                    547: 	print '# This file was automatically generated on '.`date`;
                    548: 	print "\n".$invocation;
1.54      raeburn   549: 	$lpml .= "\n";
1.16      harris41  550:     }
1.11      harris41  551:     elsif ($mode eq 'build') {
1.14      harris41  552: 	$lpml = "# LPML build targets. Linux Packaging Markup Language,";
                    553: 	$lpml .= ' by Scott Harrison 2001'."\n";
1.11      harris41  554: 	$lpml .= '# This file was automatically generated on '.`date`;
1.17      harris41  555: 	$lpml .= "\n".$invocation;
1.54      raeburn   556: 	$lpml .= "\n";
1.11      harris41  557:     }
1.4       harris41  558:     else {
                    559: 	return '';
                    560:     }
1.3       harris41  561: }
                    562: # --------------------------------------------------- Format targetroot section
                    563: sub format_targetroot {
                    564:     my $text=&trim($parser->get_text('/targetroot'));
                    565:     $text=$targetroot if $targetroot;
                    566:     $parser->get_tag('/targetroot');
                    567:     if ($mode eq 'html') {
1.10      harris41  568: 	return $targetroot="\n<br />TARGETROOT: $text";
1.3       harris41  569:     }
1.17      harris41  570:     elsif ($mode eq 'install' or $mode eq 'build' or
                    571: 	   $mode eq 'configinstall') {
1.11      harris41  572: 	return '# TARGET INSTALL LOCATION is "'.$targetroot."\"\n";
                    573:     }
1.3       harris41  574:     else {
                    575: 	return '';
                    576:     }
                    577: }
                    578: # --------------------------------------------------- Format sourceroot section
                    579: sub format_sourceroot {
                    580:     my $text=&trim($parser->get_text('/sourceroot'));
                    581:     $text=$sourceroot if $sourceroot;
                    582:     $parser->get_tag('/sourceroot');
                    583:     if ($mode eq 'html') {
1.10      harris41  584: 	return $sourceroot="\n<br />SOURCEROOT: $text";
1.3       harris41  585:     }
1.17      harris41  586:     elsif ($mode eq 'install' or $mode eq 'build' or
                    587: 	   $mode eq 'configinstall') {
1.11      harris41  588: 	return '# SOURCE CODE LOCATION IS "'.$sourceroot."\"\n";;
                    589:     }
1.3       harris41  590:     else {
                    591: 	return '';
                    592:     }
                    593: }
                    594: # --------------------------------------------------- Format categories section
                    595: sub format_categories {
                    596:     my $text=&trim($parser->get_text('/categories'));
                    597:     $parser->get_tag('/categories');
                    598:     if ($mode eq 'html') {
1.24      harris41  599: 	return $categories="\n<br />&nbsp;<br />".
                    600: 	    "\n<a name='ownperms'>".
                    601: 	    "\n<font size='+2'>File Type Ownership and Permissions".
                    602: 	    " Descriptions</font>".
1.25      harris41  603: 	    "\n<p>This table shows what permissions and ownership settings ".
                    604: 	    "correspond to each category.</p>".
                    605: 	    "\n<table border='1' cellpadding='5' width='60%'>\n".
                    606: 	    "<tr>".
                    607: 	    "<th align='left' bgcolor='#ffffff'>Icon</th>".
                    608: 	    "<th align='left' bgcolor='#ffffff'>Category Name</th>".
                    609: 	    "<th align='left' bgcolor='#ffffff'>Permissions ".
                    610: 	    "($categorytype)</th>".
                    611: 	    "</tr>".
                    612: 	    "\n$text\n".
1.24      harris41  613: 	    "</table>\n";
                    614:     }
                    615:     elsif ($mode eq 'text') {
                    616: 	return $categories="\n".
                    617: 	    "\nFile Type Ownership and Permissions".
                    618: 	    " Descriptions".
1.25      harris41  619: 	    "\n$text".
1.24      harris41  620: 	    "\n";
1.3       harris41  621:     }
                    622:     else {
                    623: 	return '';
                    624:     }
                    625: }
                    626: # --------------------------------------------------- Format categories section
                    627: sub format_category {
                    628:     my (@tokeninfo)=@_;
                    629:     $category_att_name=$tokeninfo[2]->{'name'};
                    630:     $category_att_type=$tokeninfo[2]->{'type'};
1.25      harris41  631:     $abbreviation=''; $chmod='';$chown='';
1.3       harris41  632:     $parser->get_text('/category');
                    633:     $parser->get_tag('/category');
1.26      harris41  634:     $fab{$category_att_name}=$abbreviation;
1.3       harris41  635:     if ($mode eq 'html') {
1.25      harris41  636: 	if ($category_att_type eq $categorytype) {
1.29      harris41  637: 	    push @categorynamelist,$category_att_name;
1.27      harris41  638: 	    $categoryhash{$category_att_name}="$chmod $chown";
1.25      harris41  639: 	    return $category="<tr>".
                    640: 		"<td><img src='$abbreviation.gif' ".
                    641:    	        "alt='${category_att_name}' /></td>\n".
                    642: 		"<td>${category_att_name}</td>\n".
                    643: 		"<td>$chmod $chown</td>\n".
                    644: 		"</tr>".
                    645: 		"\n";
                    646: #	return $category="\n<br />CATEGORY $category_att_name ".
                    647: #	    "$category_att_type $chmod $chown";
                    648: 	}
1.3       harris41  649:     }
                    650:     else {
1.4       harris41  651: 	if ($category_att_type eq $categorytype) {
                    652: 	    my ($user,$group)=split(/\:/,$chown);
                    653: 	    $categoryhash{$category_att_name}='-o '.$user.' -g '.$group.
                    654: 		' -m '.$chmod;
1.53      albertel  655: 	    $categoryhash{"chmod.".$category_att_name}=$chmod;
                    656: 	    $categoryhash{"chown.".$category_att_name}=$chown;
1.4       harris41  657: 	}
1.3       harris41  658: 	return '';
                    659:     }
                    660: }
1.25      harris41  661: # --------------------------------------------------- Format categories section
                    662: sub format_abbreviation {
                    663:     my @tokeninfo=@_;
                    664:     $abbreviation='';
                    665:     my $text=&trim($parser->get_text('/abbreviation'));
                    666:     if ($text) {
                    667: 	$parser->get_tag('/abbreviation');
                    668: 	$abbreviation=$text;
                    669:     }
                    670:     return '';
                    671: }
1.3       harris41  672: # -------------------------------------------------------- Format chown section
                    673: sub format_chown {
                    674:     my @tokeninfo=@_;
                    675:     $chown='';
                    676:     my $text=&trim($parser->get_text('/chown'));
                    677:     if ($text) {
                    678: 	$parser->get_tag('/chown');
                    679: 	$chown=$text;
                    680:     }
                    681:     return '';
                    682: }
                    683: # -------------------------------------------------------- Format chmod section
                    684: sub format_chmod {
                    685:     my @tokeninfo=@_;
                    686:     $chmod='';
                    687:     my $text=&trim($parser->get_text('/chmod'));
                    688:     if ($text) {
                    689: 	$parser->get_tag('/chmod');
                    690: 	$chmod=$text;
                    691:     }
                    692:     return '';
                    693: }
                    694: # ---------------------------------------------------------- Format rpm section
                    695: sub format_rpm {
                    696:     my $text=&trim($parser->get_text('/rpm'));
                    697:     $parser->get_tag('/rpm');
                    698:     if ($mode eq 'html') {
1.23      harris41  699: 	return $rpm=<<END;
1.24      harris41  700: <br />&nbsp;<br />
                    701: <a name='package' />
1.23      harris41  702: <font size='+2'>Software Package Description</font>
                    703: <p>
                    704: <table bgcolor='#ffffff' border='0' cellpadding='10' cellspacing='0'>
                    705: <tr><td><pre>
                    706: $text
                    707: </pre></td></tr>
                    708: </table>
                    709: END
                    710:     }
1.35      harris41  711:     elsif ($mode eq 'make_rpm') {
                    712: 	return $text;
                    713:     }
1.23      harris41  714:     elsif ($mode eq 'text') {
                    715: 	return $rpm=<<END;
                    716: Software Package Description
                    717: 
                    718: $text
                    719: END
1.3       harris41  720:     }
                    721:     else {
                    722: 	return '';
                    723:     }
                    724: }
                    725: # --------------------------------------------------- Format rpmSummary section
                    726: sub format_rpmSummary {
                    727:     my $text=&trim($parser->get_text('/rpmSummary'));
                    728:     $parser->get_tag('/rpmSummary');
                    729:     if ($mode eq 'html') {
1.23      harris41  730: 	return $rpmSummary="\nSummary     : $text";
                    731:     }
                    732:     elsif ($mode eq 'text') {
                    733: 	return $rpmSummary="\nSummary     : $text";
1.3       harris41  734:     }
1.35      harris41  735:     elsif ($mode eq 'make_rpm') {
                    736: 	return <<END;
                    737: <summary>$text</summary>
                    738: END
                    739:     }
1.3       harris41  740:     else {
                    741: 	return '';
                    742:     }
                    743: }
                    744: # ------------------------------------------------------ Format rpmName section
                    745: sub format_rpmName {
                    746:     my $text=&trim($parser->get_text('/rpmName'));
                    747:     $parser->get_tag('/rpmName');
                    748:     if ($mode eq 'html') {
1.24      harris41  749: 	return $rpmName="\nName        : $text";
                    750:     }
                    751:     elsif ($mode eq 'text') {
                    752: 	return $rpmName="\nName        : $text";
1.3       harris41  753:     }
1.35      harris41  754:     elsif ($mode eq 'make_rpm') {
                    755: 	return <<END;
                    756: <name>$text</name>
                    757: END
                    758:     }
1.3       harris41  759:     else {
                    760: 	return '';
                    761:     }
                    762: }
                    763: # --------------------------------------------------- Format rpmVersion section
                    764: sub format_rpmVersion {
                    765:     my $text=$parser->get_text('/rpmVersion');
                    766:     $parser->get_tag('/rpmVersion');
                    767:     if ($mode eq 'html') {
1.24      harris41  768: 	return $rpmVersion="\nVersion     : $text";
                    769:     }
                    770:     elsif ($mode eq 'text') {
                    771: 	return $rpmVersion="\nVersion     : $text";
1.3       harris41  772:     }
                    773:     else {
                    774: 	return '';
                    775:     }
                    776: }
                    777: # --------------------------------------------------- Format rpmRelease section
                    778: sub format_rpmRelease {
                    779:     my $text=$parser->get_text('/rpmRelease');
                    780:     $parser->get_tag('/rpmRelease');
                    781:     if ($mode eq 'html') {
1.24      harris41  782: 	return $rpmRelease="\nRelease     : $text";
                    783:     }
                    784:     elsif ($mode eq 'text') {
                    785: 	return $rpmRelease="\nRelease     : $text";
1.3       harris41  786:     }
                    787:     else {
                    788: 	return '';
                    789:     }
                    790: }
                    791: # ---------------------------------------------------- Format rpmVendor section
                    792: sub format_rpmVendor {
                    793:     my $text=$parser->get_text('/rpmVendor');
                    794:     $parser->get_tag('/rpmVendor');
                    795:     if ($mode eq 'html') {
1.24      harris41  796: 	return $rpmVendor="\nVendor      : $text";
                    797:     }
                    798:     elsif ($mode eq 'text') {
                    799: 	return $rpmVendor="\nVendor      : $text";
1.3       harris41  800:     }
1.35      harris41  801:     elsif ($mode eq 'make_rpm') {
                    802: 	return <<END;
                    803: <vendor>$text</vendor>
                    804: END
                    805:     }
1.3       harris41  806:     else {
                    807: 	return '';
                    808:     }
                    809: }
                    810: # ------------------------------------------------- Format rpmBuildRoot section
                    811: sub format_rpmBuildRoot {
                    812:     my $text=$parser->get_text('/rpmBuildRoot');
                    813:     $parser->get_tag('/rpmBuildRoot');
                    814:     if ($mode eq 'html') {
1.24      harris41  815: 	return $rpmBuildRoot="\nBuild Root  : $text";
                    816:     }
                    817:     elsif ($mode eq 'text') {
                    818: 	return $rpmBuildRoot="\nBuild Root  : $text";
1.3       harris41  819:     }
                    820:     else {
                    821: 	return '';
                    822:     }
                    823: }
                    824: # ------------------------------------------------- Format rpmCopyright section
                    825: sub format_rpmCopyright {
                    826:     my $text=$parser->get_text('/rpmCopyright');
                    827:     $parser->get_tag('/rpmCopyright');
                    828:     if ($mode eq 'html') {
1.24      harris41  829: 	return $rpmCopyright="\nLicense     : $text";
                    830:     }
                    831:     elsif ($mode eq 'text') {
                    832: 	return $rpmCopyright="\nLicense     : $text";
1.3       harris41  833:     }
1.35      harris41  834:     elsif ($mode eq 'make_rpm') {
                    835: 	return <<END;
                    836: <copyright>$text</copyright>
                    837: END
                    838:     }
1.3       harris41  839:     else {
                    840: 	return '';
                    841:     }
                    842: }
                    843: # ----------------------------------------------------- Format rpmGroup section
                    844: sub format_rpmGroup {
                    845:     my $text=$parser->get_text('/rpmGroup');
                    846:     $parser->get_tag('/rpmGroup');
                    847:     if ($mode eq 'html') {
1.24      harris41  848: 	return $rpmGroup="\nGroup       : $text";
                    849:     }
                    850:     elsif ($mode eq 'text') {
                    851: 	return $rpmGroup="\nGroup       : $text";
1.3       harris41  852:     }
1.35      harris41  853:     elsif ($mode eq 'make_rpm') {
                    854: 	return <<END;
                    855: <group>Utilities/System</group>
                    856: END
                    857:     }
1.3       harris41  858:     else {
                    859: 	return '';
                    860:     }
                    861: }
                    862: # ---------------------------------------------------- Format rpmSource section
                    863: sub format_rpmSource {
                    864:     my $text=$parser->get_text('/rpmSource');
                    865:     $parser->get_tag('/rpmSource');
                    866:     if ($mode eq 'html') {
1.24      harris41  867: 	return $rpmSource="\nSource      : $text";
                    868:     }
                    869:     elsif ($mode eq 'text') {
                    870: 	return $rpmSource="\nSource      : $text";
1.3       harris41  871:     }
                    872:     else {
                    873: 	return '';
                    874:     }
                    875: }
                    876: # ----------------------------------------------- Format rpmAutoReqProv section
                    877: sub format_rpmAutoReqProv {
                    878:     my $text=$parser->get_text('/rpmAutoReqProv');
                    879:     $parser->get_tag('/rpmAutoReqProv');
                    880:     if ($mode eq 'html') {
1.24      harris41  881: 	return $rpmAutoReqProv="\nAutoReqProv : $text";
                    882:     }
1.35      harris41  883:     elsif ($mode eq 'text') {
1.24      harris41  884: 	return $rpmAutoReqProv="\nAutoReqProv : $text";
1.3       harris41  885:     }
1.35      harris41  886:     elsif ($mode eq 'make_rpm') {
                    887: 	return <<END;
                    888: <AutoReqProv>$text</AutoReqProv>
                    889: END
                    890:     }
1.3       harris41  891:     else {
                    892: 	return '';
                    893:     }
                    894: }
                    895: # ----------------------------------------------- Format rpmdescription section
                    896: sub format_rpmdescription {
                    897:     my $text=$parser->get_text('/rpmdescription');
                    898:     $parser->get_tag('/rpmdescription');
                    899:     if ($mode eq 'html') {
1.25      harris41  900: 	$text=~s/\n//g;
                    901: 	$text=~s/\\n/\n/g;
1.24      harris41  902: 	return $rpmdescription="\nDescription : $text";
                    903:     }
                    904:     elsif ($mode eq 'text') {
1.25      harris41  905: 	$text=~s/\n//g;
                    906: 	$text=~s/\\n/\n/g;
1.24      harris41  907: 	return $rpmdescription="\nDescription : $text";
1.3       harris41  908:     }
1.35      harris41  909:     elsif ($mode eq 'make_rpm') {
                    910: 	$text=~s/\n//g;
                    911: 	$text=~s/\\n/\n/g;
                    912: 	return <<END;
                    913: <description>$text</description>
                    914: END
                    915:     }
1.3       harris41  916:     else {
                    917: 	return '';
                    918:     }
                    919: }
                    920: # ------------------------------------------------------- Format rpmpre section
                    921: sub format_rpmpre {
                    922:     my $text=$parser->get_text('/rpmpre');
                    923:     $parser->get_tag('/rpmpre');
                    924:     if ($mode eq 'html') {
1.24      harris41  925: #	return $rpmpre="\n<br />RPMPRE $text";
                    926: 	return '';
1.3       harris41  927:     }
1.35      harris41  928:     elsif ($mode eq 'make_rpm') {
                    929: 	return <<END;
                    930: <pre>$text</pre>
                    931: END
                    932:     }
1.3       harris41  933:     else {
                    934: 	return '';
                    935:     }
                    936: }
1.35      harris41  937: # -------------------------------------------------- Format requires section
                    938: sub format_rpmRequires {
                    939:     my @tokeninfo=@_;
                    940:     my $aref;
                    941:     my $text;
                    942:     if ($mode eq 'make_rpm') {
                    943: 	while ($aref=$parser->get_token()) {
                    944: 	    if ($aref->[0] eq 'E' && $aref->[1] eq 'rpmRequires') {
                    945: 		last;
                    946: 	    }
                    947: 	    elsif ($aref->[0] eq 'S') {
                    948: 		$text.=$aref->[4];
                    949: 	    }
                    950: 	    elsif ($aref->[0] eq 'E') {
                    951: 		$text.=$aref->[2];
                    952: 	    }
                    953: 	    else {
                    954: 		$text.=$aref->[1];
                    955: 	    }
                    956: 	}
                    957:     }
                    958:     else {
                    959: 	$parser->get_tag('/rpmRequires');
                    960: 	return '';
                    961:     }
                    962:     return '<rpmRequires>'.$text.'</rpmRequires>';
                    963: }
1.3       harris41  964: # -------------------------------------------------- Format directories section
                    965: sub format_directories {
1.4       harris41  966:     my $text=$parser->get_text('/directories');
1.3       harris41  967:     $parser->get_tag('/directories');
                    968:     if ($mode eq 'html') {
1.26      harris41  969: 	$text=~s/\[\{\{\{\{\{DPATHLENGTH\}\}\}\}\}\]/$dpathlength/g;
1.24      harris41  970: 	return $directories="\n<br />&nbsp;<br />".
                    971: 	    "<a name='directories' />".
                    972: 	    "<font size='+2'>Directory Structure</font>".
1.26      harris41  973: 	    "\n<br />&nbsp;<br />".
                    974: 	    "<table border='1' cellpadding='3' cellspacing='0'>\n".
                    975: 	    "<tr><th bgcolor='#ffffff'>Category</th>".
                    976: 	    "<th bgcolor='#ffffff'>Status</th>\n".
                    977: 	    "<th bgcolor='#ffffff'>Expected Permissions & Ownership</th>\n".
                    978: 	    "<th bgcolor='#ffffff' colspan='$dpathlength'>Target Directory ".
                    979: 	    "Path</th></tr>\n".
                    980:  	    "\n$text\n</table><br />"."\n";
1.24      harris41  981:     }
                    982:     elsif ($mode eq 'text') {
                    983: 	return $directories="\nDirectory Structure\n$text\n".
                    984: 	    "\n";
1.3       harris41  985:     }
1.4       harris41  986:     elsif ($mode eq 'install') {
                    987: 	return "\n".'directories:'."\n".$text;
1.35      harris41  988:     }
                    989:     elsif ($mode eq 'rpm_file_list') {
                    990: 	return $text;
                    991:     }
1.51      harris41  992:     elsif ($mode eq 'uninstall_shell_commands') {
                    993: 	return $text;
                    994:     }
1.3       harris41  995:     else {
                    996: 	return '';
                    997:     }
                    998: }
                    999: # ---------------------------------------------------- Format directory section
                   1000: sub format_directory {
                   1001:     my (@tokeninfo)=@_;
1.51      harris41 1002:     $targetdir='';$categoryname='';$description='';$protectionlevel='';
1.3       harris41 1003:     $parser->get_text('/directory');
                   1004:     $parser->get_tag('/directory');
1.29      harris41 1005:     $directory_count++;
                   1006:     $categorycount{$categoryname}++;
1.3       harris41 1007:     if ($mode eq 'html') {
1.26      harris41 1008: 	my @a;
                   1009: 	@a=($targetdir=~/\//g);
                   1010: 	my $d=scalar(@a)+1;
                   1011: 	$dpathlength=$d if $d>$dpathlength;
                   1012: 	my $thtml=$targetdir;
                   1013: 	$thtml=~s/\//\<\/td\>\<td bgcolor='#ffffff'\>/g;
1.28      harris41 1014: 	my ($chmod,$chown)=split(/\s/,$categoryhash{$categoryname});
1.26      harris41 1015: 	return $directory="\n<tr><td rowspan='2' bgcolor='#ffffff'>".
                   1016: 	    "$categoryname</td>".
1.41      harris41 1017: 	    "<td rowspan='2' bgcolor='#ffffff'><!-- POSTEVAL [$categoryname] ".
                   1018: 	    "verify.pl directory /$targetdir $categoryhash{$categoryname} -->".
                   1019: 	    "&nbsp;</td>".
1.26      harris41 1020: 	    "<td rowspan='2' bgcolor='#ffffff'>$chmod<br />$chown</td>".
                   1021: 	    "<td bgcolor='#ffffff'>$thtml</td></tr>".
                   1022: 	    "<tr><td bgcolor='#ffffff' colspan='[{{{{{DPATHLENGTH}}}}}]'>".
                   1023: 	    "$description</td></tr>";
                   1024:     }
                   1025:     if ($mode eq 'text') {
                   1026: 	return $directory="\nDIRECTORY $targetdir $categoryname ".
1.10      harris41 1027: 	    "$description";
1.3       harris41 1028:     }
1.4       harris41 1029:     elsif ($mode eq 'install') {
1.8       harris41 1030: 	return "\t".'install '.$categoryhash{$categoryname}.' -d '.
                   1031: 	    $targetroot.'/'.$targetdir."\n";
1.4       harris41 1032:     }
1.35      harris41 1033:     elsif ($mode eq 'rpm_file_list') {
                   1034: 	return $targetroot.'/'.$targetdir."\n";
                   1035:     }
1.51      harris41 1036:     elsif ($mode eq 'uninstall_shell_commands') {
                   1037: 	if ($protectionlevel eq 'never_delete') {
                   1038: 	    return 'echo "LEAVING BEHIND '.$targetroot.'/'.$targetdir.
                   1039: 		' which may have important data worth saving"'."\n";
                   1040: 	}
                   1041: 	elsif ($protectionlevel eq 'weak_delete') {
                   1042: 	    if ($targetdir!~/\w/) {
                   1043: 		die("targetdir=\"$targetdir\"! NEVER EVER DELETE THE WHOLE ".
                   1044: 		    "FILESYSTEM"."\n");
                   1045: 	    }
                   1046: 	    return 'rm -Rvf -i '.$targetroot.'/'.$targetdir."\n";
                   1047: 	}
                   1048: 	elsif ($protectionlevel =~ /never/) {
                   1049: 	    die("CONFUSING PROTECTION LEVEL \"$protectionlevel\" FOUND ".
                   1050: 		"FOR directory $targetdir"."\n");
                   1051: 	}
                   1052: 	elsif ($protectionlevel !~
                   1053:     /^never_delete|weak_delete|modest_delete|strong_delete|absolute_delete$/) {
                   1054: 	    die("CONFUSING OR MISSING PROTECTION LEVEL \"$protectionlevel\" ".
                   1055: 		"FOUND FOR directory $targetdir\n");
                   1056: 	}
                   1057: 	else {
                   1058: 	    if ($targetdir!~/\w/) {
                   1059: 		die("targetdir=\"$targetdir\"! NEVER EVER DELETE THE WHOLE ".
                   1060: 		    "FILESYSTEM"."\n");
                   1061: 	    }
                   1062: 	    return 'rm -Rvf '.$targetroot.'/'.$targetdir.
                   1063: 		"| grep 'removed directory'"."\n";
                   1064: 	}
                   1065:     }
1.3       harris41 1066:     else {
                   1067: 	return '';
                   1068:     }
                   1069: }
                   1070: # ---------------------------------------------------- Format targetdir section
                   1071: sub format_targetdir {
                   1072:     my @tokeninfo=@_;
                   1073:     $targetdir='';
                   1074:     my $text=&trim($parser->get_text('/targetdir'));
                   1075:     if ($text) {
                   1076: 	$parser->get_tag('/targetdir');
                   1077: 	$targetdir=$text;
1.51      harris41 1078:     }
                   1079:     return '';
                   1080: }
                   1081: # ---------------------------------------------- Format protectionlevel section
                   1082: sub format_protectionlevel {
                   1083:     my @tokeninfo=@_;
                   1084:     $protectionlevel='';
                   1085:     my $text=&trim($parser->get_text('/protectionlevel'));
                   1086:     if ($text) {
                   1087: 	$parser->get_tag('/protectionlevel');
                   1088: 	$protectionlevel=$text;
1.3       harris41 1089:     }
                   1090:     return '';
                   1091: }
                   1092: # ------------------------------------------------- Format categoryname section
                   1093: sub format_categoryname {
                   1094:     my @tokeninfo=@_;
                   1095:     $categoryname='';
                   1096:     my $text=&trim($parser->get_text('/categoryname'));
                   1097:     if ($text) {
                   1098: 	$parser->get_tag('/categoryname');
                   1099: 	$categoryname=$text;
                   1100:     }
                   1101:     return '';
                   1102: }
                   1103: # -------------------------------------------------- Format description section
                   1104: sub format_description {
                   1105:     my @tokeninfo=@_;
                   1106:     $description='';
1.10      harris41 1107:     my $text=&htmlsafe(&trim($parser->get_text('/description')));
1.3       harris41 1108:     if ($text) {
                   1109: 	$parser->get_tag('/description');
                   1110: 	$description=$text;
                   1111:     }
                   1112:     return '';
                   1113: }
                   1114: # -------------------------------------------------------- Format files section
                   1115: sub format_files {
1.4       harris41 1116:     my $text=$parser->get_text('/files');
1.3       harris41 1117:     $parser->get_tag('/files');
1.46      harris41 1118:     if ($mode eq 'MANIFEST') {
                   1119: 	return $text;
                   1120:     }
                   1121:     elsif ($mode eq 'html') {
1.24      harris41 1122: 	return $directories="\n<br />&nbsp;<br />".
                   1123: 	    "<a name='files' />".
1.26      harris41 1124: 	    "<font size='+2'>Files</font><br />&nbsp;<br />".
                   1125: 	    "<p>All source and target locations are relative to the ".
                   1126: 	    "sourceroot and targetroot values at the beginning of this ".
                   1127: 	    "document.</p>".
                   1128: 	    "\n<table border='1' cellpadding='5'>".
                   1129: 	    "<tr><th>Status</th><th colspan='2'>Category</th>".
                   1130: 	    "<th>Name/Location</th>".
                   1131: 	    "<th>Description</th><th>Notes</th></tr>".
                   1132: 	    "$text</table>\n".
1.24      harris41 1133: 	    "\n";
                   1134:     }
                   1135:     elsif ($mode eq 'text') {
                   1136: 	return $directories="\n".
                   1137: 	    "File and Directory Structure".
                   1138: 	    "\n$text\n".
                   1139: 	    "\n";
1.3       harris41 1140:     }
1.4       harris41 1141:     elsif ($mode eq 'install') {
                   1142: 	return "\n".'files:'."\n".$text.
                   1143: 	    "\n".'links:'."\n".join('',@links);
                   1144:     }
1.12      harris41 1145:     elsif ($mode eq 'configinstall') {
                   1146: 	return "\n".'configfiles: '.
                   1147: 	join(' ',@configall).
1.14      harris41 1148: 	"\n\n".$text.
                   1149: 	"\n\nalwaysrun:\n\n";
1.12      harris41 1150:     }
1.11      harris41 1151:     elsif ($mode eq 'build') {
                   1152: 	my $binfo;
                   1153: 	my $tword;
                   1154: 	my $command2;
                   1155: 	my @deps;
                   1156: 	foreach my $bi (@buildinfo) {
1.14      harris41 1157: 	    my ($target,$source,$command,$trigger,@deps)=split(/\;/,$bi);
1.11      harris41 1158: 	    $tword=''; $tword=' alwaysrun' if $trigger eq 'always run'; 
1.33      harris41 1159: 	    if ($command!~/\s/) {
                   1160: 		$command=~s/\/([^\/]*)$//;
1.57      raeburn  1161: 		$command2="cd $command; $shell ./$1;\\";
1.33      harris41 1162: 	    }
                   1163: 	    else {
                   1164: 		$command=~s/(.*?\/)([^\/]+\s+.*)$/$1/;
1.57      raeburn  1165: 		$command2="cd $command; $shell ./$2;\\";
1.33      harris41 1166: 	    }
1.11      harris41 1167: 	    my $depstring;
1.14      harris41 1168: 	    my $depstring2="\t\t\@echo '';\\\n";
                   1169: 	    my $olddep;
1.11      harris41 1170: 	    foreach my $dep (@deps) {
1.14      harris41 1171: 		unless ($olddep) {
                   1172: 		    $olddep=$deps[$#deps];
                   1173: 		}
1.11      harris41 1174: 		$depstring.="\telif !(test -r $command/$dep);\\\n";
                   1175: 		$depstring.="\t\tthen echo ".
1.14      harris41 1176: 		"\"**** WARNING **** missing the file: ".
1.19      harris41 1177:  	        "$command/$dep\"$logcmd;\\\n";
1.14      harris41 1178: 		$depstring.="\t\ttest -e $source || test -e $target || echo ".
                   1179: 		    "'**** ERROR **** neither source=$source nor target=".
1.19      harris41 1180: 		    "$target exist and they cannot be built'$logcmd;\\\n";
1.14      harris41 1181: 		$depstring.="\t\tmake -f Makefile.build ${source}___DEPS;\\\n";
                   1182: 		if ($olddep) {
                   1183: 		    $depstring2.="\t\tECODE=0;\\\n";
                   1184: 		    $depstring2.="\t\t! test -e $source && test -r $command/$olddep &&".
1.19      harris41 1185: 			" { perl filecompare.pl -b2 $command/$olddep $target ||  ECODE=\$\$?; } && { [ \$\$ECODE != \"2\" ] || echo \"**** WARNING **** dependency $command/$olddep is newer than target file $target; SOMETHING MAY BE WRONG\"$logcmd; };\\\n";
1.14      harris41 1186: 		}
                   1187: 		$olddep=$dep;
1.11      harris41 1188: 	    }
                   1189: 	    $binfo.="$source: $tword\n".
                   1190: 		"\t\@if !(echo \"\");\\\n\t\tthen echo ".
1.14      harris41 1191: 		"\"**** WARNING **** Strange shell. ".
1.19      harris41 1192:  	        "Check your path settings.\"$logcmd;\\\n".
1.11      harris41 1193: 		$depstring.
                   1194: 		"\telse \\\n\t\t$command2\n\tfi\n\n";
1.14      harris41 1195: 	    $binfo.="${source}___DEPS:\n".$depstring2."\t\tECODE=0;\n\n";
1.11      harris41 1196: 	}
                   1197: 	return 'all: '.join(' ',@buildall)."\n\n".
                   1198:   	        $text.
                   1199: 		$binfo."\n".
                   1200: 		"alwaysrun:\n\n";
                   1201:     }
1.35      harris41 1202:     elsif ($mode eq 'rpm_file_list') {
                   1203: 	return $text;
                   1204:     }
1.3       harris41 1205:     else {
                   1206: 	return '';
                   1207:     }
                   1208: }
                   1209: # ---------------------------------------------------- Format fileglobs section
                   1210: sub format_fileglobs {
                   1211: 
                   1212: }
                   1213: # -------------------------------------------------------- Format links section
1.4       harris41 1214: # deprecated.. currently <link></link>'s are included in <files></files>
1.3       harris41 1215: sub format_links {
1.4       harris41 1216:     my $text=$parser->get_text('/links');
                   1217:     $parser->get_tag('/links');
                   1218:     if ($mode eq 'html') {
1.10      harris41 1219: 	return $links="\n<br />BEGIN LINKS\n$text\n<br />END LINKS\n";
1.4       harris41 1220:     }
                   1221:     elsif ($mode eq 'install') {
                   1222: 	return "\n".'links:'."\n\t".$text;
                   1223:     }
                   1224:     else {
                   1225: 	return '';
                   1226:     }
1.1       harris41 1227: }
1.3       harris41 1228: # --------------------------------------------------------- Format file section
                   1229: sub format_file {
                   1230:     my @tokeninfo=@_;
                   1231:     $file=''; $source=''; $target=''; $categoryname=''; $description='';
1.53      albertel 1232:     $note=''; $build=''; $status=''; $dependencies=''; $installscript='';
1.61      raeburn  1233:     $buildlink = '';
1.3       harris41 1234:     my $text=&trim($parser->get_text('/file'));
1.14      harris41 1235:     my $buildtest;
1.29      harris41 1236:     $file_count++;
                   1237:     $categorycount{$categoryname}++;
1.3       harris41 1238:     if ($source) {
                   1239: 	$parser->get_tag('/file');
1.46      harris41 1240: 	if ($mode eq 'MANIFEST') {
1.47      harris41 1241: 	    my $command=$build;
                   1242: 	    if ($command!~/\s/) {
                   1243: 		$command=~s/\/([^\/]*)$//;
                   1244: 	    }
                   1245: 	    else {
                   1246: 		$command=~s/(.*?\/)([^\/]+\s+.*)$/$1/;
                   1247: 	    }
                   1248: 	    $command=~s/^$sourceroot\///;
                   1249: 	    my (@deps)=split(/\;/,$dependencies);
                   1250: 	    my $retval=join("\n",($source,
                   1251: 		       (map {"$command$_"} @deps)));
1.52      albertel 1252: 	    if ($tokeninfo[2]{type} eq 'private') {
                   1253: 		return "\n";
                   1254: 	    }
1.47      harris41 1255: 	    return $retval."\n";
1.46      harris41 1256: 	}
                   1257: 	elsif ($mode eq 'html') {
1.26      harris41 1258: 	    return ($file="\n<!-- FILESORT:$target -->".
                   1259: 		    "<tr>".
1.41      harris41 1260:           "<td><!-- POSTEVAL [$categoryname] verify.pl file '$sourcerootarg' ".
1.28      harris41 1261: 		    "'$targetrootarg' ".
                   1262: 		    "'$source' '$target' ".
                   1263: 		    "$categoryhash{$categoryname} -->&nbsp;</td><td>".
1.27      harris41 1264: 		    "<img src='$fab{$categoryname}.gif' ".
1.26      harris41 1265: 		    "alt='$categoryname icon' /></td>".
1.27      harris41 1266: 		    "<td>$categoryname<br /><font size='-1'>".
                   1267: 		    $categoryhash{$categoryname}."</font></td>".
1.26      harris41 1268: 		    "<td>SOURCE: $source<br />TARGET: $target</td>".
                   1269: 		    "<td>$description</td>".
                   1270: 		    "<td>$note</td>".
                   1271: 		    "</tr>");
                   1272: #	    return ($file="\n<br />BEGIN FILE\n".
                   1273: #		"$source $target $categoryname $description $note " .
                   1274: #		"$build $status $dependencies" .
                   1275: #		"\nEND FILE");
1.3       harris41 1276: 	}
1.56      raeburn  1277: 	elsif (($mode eq 'install') && (($categoryname ne 'conf') && 
                   1278: 					($categoryname ne 'www conf'))) {
1.14      harris41 1279: 	    if ($build) {
                   1280: 		my $bi=$sourceroot.'/'.$source.';'.$build.';'.
                   1281: 		    $dependencies;
                   1282: 		my ($source2,$command,$trigger,@deps)=split(/\;/,$bi);
                   1283: 		$tword=''; $tword=' alwaysrun' if $trigger eq 'always run'; 
                   1284: 		$command=~s/\/([^\/]*)$//;
1.57      raeburn  1285: 		$command2="cd $command; $shell ./$1;\\";
1.14      harris41 1286: 		my $depstring;
                   1287: 		foreach my $dep (@deps) {
                   1288: 		    $depstring.=<<END;
                   1289: 		ECODE=0; DEP=''; \\
1.34      harris41 1290: 		test -e $dep || (echo '**** WARNING **** cannot evaluate status of dependency $dep (for building ${sourceroot}/${source} with)'$logcmd); DEP="1"; \\
                   1291: 		[ -n DEP ] && { perl filecompare.pl -b2 $dep ${targetroot}/${target} || ECODE=\$\$?; } || DEP="1"; \\
1.14      harris41 1292: 		case "\$\$ECODE" in \\
1.34      harris41 1293: 			2) echo "**** WARNING **** dependency $dep is newer than target file ${targetroot}/${target}; you may want to run make build"$logcmd;; \\
1.14      harris41 1294: 		esac; \\
                   1295: END
                   1296: 		}
                   1297:                 chomp $depstring;
                   1298: 		$buildtest=<<END;
                   1299: 	\@if !(test -e "${sourceroot}/${source}") && !(test -e "${targetroot}/${target}"); then \\
1.19      harris41 1300: 		echo "**** ERROR **** ${sourceroot}/${source} is missing and is also not present at target location ${targetroot}/${target}; you must run make build"$logcmd; exit; \\
1.14      harris41 1301: END
                   1302:                 $buildtest.=<<END if $depstring;
                   1303: 	elif !(test -e "${sourceroot}/${source}"); then \\
                   1304: $depstring
                   1305: END
                   1306:                 $buildtest.=<<END;
                   1307: 	fi
                   1308: END
1.55      albertel 1309:             }
1.53      albertel 1310: 	    if ($installscript) {
                   1311: 		my $dir = $sourceroot.'/'.$source;
                   1312: 		$dir =~ s|/([^/]*)$||;
1.55      albertel 1313: 		my $result =" 
1.57      raeburn  1314: $buildtest	cd $dir ; $shell $installscript";
1.55      albertel 1315: 		if ($categoryname 
                   1316: 		    && exists($categoryhash{"chmod.$categoryname"}) ) {
                   1317: 		    $result .="\\\n";
                   1318: 		    $result .=<<"END"
                   1319: 		chmod -R $categoryhash{"chmod.$categoryname"} ${targetroot}/${target} \\
                   1320: 		chown -R $categoryhash{"chown.$categoryname"} ${targetroot}/${target} 
1.53      albertel 1321: END
1.55      albertel 1322:                 } else {
                   1323: 		    $result.="\n";
                   1324: 		}
                   1325: 		return $result;
1.53      albertel 1326: 	    }
1.62    ! raeburn  1327: 	    my $testtarget = $target;
        !          1328: 	    if ($categoryname eq 'setuid script') {
        !          1329: 		my ($path,$filename) = ($target =~ /^(.*\/)([^\/]+)$/);
        !          1330: 		my $alttarget = $path.'.'.$filename;
        !          1331: 		if ((-e "$targetroot/$target") && (-B "$targetroot/$target") &&
        !          1332: 		    (-e "$targetroot/$alttarget") && (-T "$targetroot/$alttarget")) {
        !          1333: 		    $testtarget = $alttarget;
        !          1334: 		}
        !          1335: 	    }
1.61      raeburn  1336:             my $bflag='-b5';
                   1337:             $bflag='-b3' if ($buildlink);
                   1338:             $bflag='-b6' if (($dependencies) or
1.60      raeburn  1339:                              ($categoryname eq 'pdf manual'));
1.58      raeburn  1340: 	    if ($tokeninfo[2]{type} eq 'private') {
                   1341: 		return <<END;
                   1342: $buildtest	\@if (test -e "${sourceroot}/${source}") && (test -e "${targetroot}/${target}"); then \\
                   1343: 		ECODE=0; \\
1.62    ! raeburn  1344: 		perl filecompare.pl $bflag ${sourceroot}/${source} ${targetroot}/${testtarget} || ECODE=\$\$?; \\
1.58      raeburn  1345: 		case "\$\$ECODE" in \\
                   1346: 			1) echo "${targetroot}/${target} is unchanged";; \\
1.59      raeburn  1347: 			2) echo "**** WARNING **** target file ${targetroot}/${target} is newer than CVS source; saving current (old) target file to ${targetroot}/${target}.lpmlsave and then overwriting"$logcmd && install -o www -g www -m 0600 ${targetroot}/${target} ${targetroot}/${target}.lpmlsave && install -p $categoryhash{$categoryname} ${sourceroot}/${source} ${targetroot}/${target};; \\
                   1348: 			0) echo "install -p $categoryhash{$categoryname} ${sourceroot}/${source} ${targetroot}/${target}" && install -p $categoryhash{$categoryname} ${sourceroot}/${source} ${targetroot}/${target};; \\
1.58      raeburn  1349:                 esac; \\
                   1350: 	elif (test -e "${sourceroot}/${source}") && !(test -e "${targetroot}/${target}"); then\\
1.59      raeburn  1351: 		echo "install -p $categoryhash{$categoryname} ${sourceroot}/${source} ${targetroot}/${target}" && install -p $categoryhash{$categoryname} ${sourceroot}/${source} ${targetroot}/${target}; \\
1.58      raeburn  1352: 	fi
                   1353: 	\@if (test -e "${targetroot}/${target}"); then \\
                   1354: 		perl verifymodown.pl ${targetroot}/${target} "$categoryhash{$categoryname}"$logcmd; \\
                   1355: 	fi
                   1356: END
                   1357:             } else {
                   1358: 	        return <<END;
1.19      harris41 1359: $buildtest	\@if !(test -e "${sourceroot}/${source}") && !(test -e "${targetroot}/${target}"); then \\
                   1360: 		echo "**** ERROR **** CVS source file does not exist: ${sourceroot}/${source} and neither does target: ${targetroot}/${target}"$logcmd; \\
                   1361: 	elif !(test -e "${sourceroot}/${source}"); then \\
                   1362: 		echo "**** WARNING **** CVS source file does not exist: ${sourceroot}/${source}"$logcmd; \\
1.21      harris41 1363: 		perl verifymodown.pl ${targetroot}/${target} "$categoryhash{$categoryname}"$logcmd; \\
1.59      raeburn  1364: 	elif !(test -e "${targetroot}/${target}"); then \\
                   1365: 		echo "install -p $categoryhash{$categoryname} ${sourceroot}/${source} ${targetroot}/${target}" && install -p $categoryhash{$categoryname} ${sourceroot}/${source} ${targetroot}/${target}; \\
1.14      harris41 1366: 	else \\
                   1367: 		ECODE=0; \\
1.62    ! raeburn  1368: 		perl filecompare.pl $bflag ${sourceroot}/${source} ${targetroot}/${testtarget} || ECODE=\$\$?; \\
1.14      harris41 1369: 		case "\$\$ECODE" in \\
                   1370: 			1) echo "${targetroot}/${target} is unchanged";; \\
1.59      raeburn  1371: 			2) echo "**** WARNING **** target file ${targetroot}/${target} is newer than CVS source; saving current (old) target file to ${targetroot}/${target}.lpmlsave and then overwriting"$logcmd && install -o www -g www -m 0600 ${targetroot}/${target} ${targetroot}/${target}.lpmlsave && install -p $categoryhash{$categoryname} ${sourceroot}/${source} ${targetroot}/${target};; \\
                   1372: 			0) echo "install -p $categoryhash{$categoryname} ${sourceroot}/${source} ${targetroot}/${target}" && install -p $categoryhash{$categoryname} ${sourceroot}/${source} ${targetroot}/${target};; \\
1.14      harris41 1373: 		esac; \\
1.21      harris41 1374: 		perl verifymodown.pl ${targetroot}/${target} "$categoryhash{$categoryname}"$logcmd; \\
1.14      harris41 1375: 	fi
                   1376: END
1.58      raeburn  1377:             }
1.12      harris41 1378: 	}
1.56      raeburn  1379: 	elsif ($mode eq 'configinstall' && (($categoryname eq 'conf') ||
                   1380: 					    ($categoryname eq 'www conf'))) {
1.12      harris41 1381: 	    push @configall,$targetroot.'/'.$target;
1.14      harris41 1382: 	    return $targetroot.'/'.$target.': alwaysrun'."\n".
1.48      harris41 1383: 		"\t".'@# Compare source with target and intelligently respond'.
                   1384: 		"\n\t\n\t\n".
                   1385: 
                   1386: 
                   1387: 		"\t".'@echo -n ""; ECODE=0 && { perl filecompare.pl -b4 \\'.
                   1388: 		"\n\t".$sourceroot.'/'.$source." \\\n\t".
                   1389: 		$targetroot.'/'.$target." \\\n\t".
                   1390: 		' || ECODE=$$?; } && '."\\\n\t"."\\\n\t"."\\\n\t".
                   1391: 
                   1392: 
                   1393: 		'{ [ $$ECODE != "2" ] || '." \\\n\t".'(install '.
                   1394:                 $categoryhash{$categoryname}." \\\n\t\t".
                   1395: 		$sourceroot.'/'.$source." \\\n\t\t".
                   1396: 		$targetroot.'/'.$target.'.lpmlnew'." \\\n\t\t".
1.19      harris41 1397: 		' && echo "**** NOTE: CONFIGURATION FILE CHANGE ****"'.
1.48      harris41 1398: 		" \\\n\t\t".$logcmd.' && '." \\\n\t\t"."echo -n \"".
                   1399: 		'You likely need to compare contents of "'."\\\n\t\t\t".
1.49      harris41 1400: 		'&& echo -n "'.$targetroot.'/'.$target.'"'."\\\n\t\t".
                   1401: 		'&& echo -n " with the new "'."\\\n\t\t\t".
                   1402:                 '&& echo "'.$targetroot.'/'.$target.'.lpmlnew"'."\\\n\t\t".
1.48      harris41 1403: 		"$logcmd); } && "." \\\n\t"."\\\n\t"."\\\n\t".
                   1404: 
                   1405: 
                   1406: 		'{ [ $$ECODE != "3" ] || '."\\\n\t".
                   1407: 		'(install '.
                   1408:                 $categoryhash{$categoryname}."\\\n\t\t".
                   1409: 		$sourceroot.'/'.$source."\\\n\t\t".
                   1410: 		$targetroot.'/'.$target."\\\n\t\t".
1.20      harris41 1411: 		' && echo "**** WARNING: NEW CONFIGURATION FILE ADDED ****"'.
1.48      harris41 1412: 		"\\\n\t\t".$logcmd.' && '."\\\n\t\t".
1.50      harris41 1413: 		'echo -n "'.
1.48      harris41 1414: 		'You likely need to review the contents of "'."\\\n\t\t\t".
1.49      harris41 1415: 		'&& echo -n "'.
1.48      harris41 1416: 		$targetroot.'/'.$target.'"'."\\\n\t\t\t".
1.49      harris41 1417: 		'&& echo -n "'.
                   1418: 		' to make sure its "'."\\\n\t\t".
                   1419: 		'&& echo "'.
1.48      harris41 1420:                 'settings are compatible with your overall system"'."\\\n\t\t".
                   1421: 		"$logcmd); } && "."\\\n\t"."\\\n\t"."\\\n\t".
                   1422: 
                   1423: 
                   1424: 		'{ [ $$ECODE != "1" ] || ('."\\\n\t\t".
                   1425: 		'echo "**** ERROR ****"'.$logcmd.' && '."\\\n\t\t".'echo -n "'.
                   1426: 		'Configuration source file does not exist "'."\\\n\t\t".
1.50      harris41 1427: 		'&& echo -n "'.$sourceroot.'/'.$source.'"'."\\\n\t\t".
1.48      harris41 1428: 		"$logcmd); } && "."\\\n\t\t".
                   1429: 		"perl verifymodown.pl ${targetroot}/${target} "."\\\n\t\t\t".
                   1430: 		"\"$categoryhash{$categoryname}\""."\\\n\t\t\t".
                   1431: 		"$logcmd;\n\n";
1.4       harris41 1432: 	}
1.11      harris41 1433: 	elsif ($mode eq 'build' && $build) {
                   1434: 	    push @buildall,$sourceroot.'/'.$source;
1.14      harris41 1435: 	    push @buildinfo,$targetroot.'/'.$target.';'.$sourceroot.'/'.
                   1436: 		$source.';'.$build.';'.
1.11      harris41 1437: 		$dependencies;
                   1438: #	    return '# need to build '.$source.";
                   1439: 	}
1.35      harris41 1440:         elsif ($mode eq 'rpm_file_list') {
                   1441: 	    if ($categoryname eq 'doc') {
                   1442: 		return $targetroot.'/'.$target.' # doc'."\n";
                   1443: 	    }
                   1444: 	    elsif ($categoryname eq 'conf') {
                   1445: 		return $targetroot.'/'.$target.' # config'."\n";
                   1446: 	    }
                   1447: 	    else {
                   1448: 		return $targetroot.'/'.$target."\n";
                   1449: 	    }
                   1450: 	}
1.3       harris41 1451: 	else {
                   1452: 	    return '';
                   1453: 	}
                   1454:     }
                   1455:     return '';
                   1456: }
                   1457: # --------------------------------------------------------- Format link section
                   1458: sub format_link {
                   1459:     my @tokeninfo=@_;
1.27      harris41 1460:     $link=''; $linkto=''; $source=''; $target=''; $categoryname=''; 
                   1461:     $description=''; $note=''; $build=''; $status=''; $dependencies='';
1.3       harris41 1462:     my $text=&trim($parser->get_text('/link'));
                   1463:     if ($linkto) {
                   1464: 	$parser->get_tag('/link');
                   1465: 	if ($mode eq 'html') {
1.27      harris41 1466: 	    my @targets=map {s/^\s*//;s/\s$//;$_} split(/\;/,$target);
1.29      harris41 1467: 	    $link_count+=scalar(@targets);
1.27      harris41 1468: 	    foreach my $tgt (@targets) {
1.29      harris41 1469: 		$categorycount{$categoryname}++;
1.27      harris41 1470: 		push @links,("\n<!-- FILESORT:$tgt -->".
                   1471: 		    "<tr>".
1.32      harris41 1472: 		    "<td><!-- POSTEVAL [$categoryname] verify.pl link ".
1.28      harris41 1473: 		    "'/$targetrootarg$linkto' '/$targetrootarg$tgt' ".
                   1474: 		    "$categoryhash{$categoryname} -->&nbsp;</td><td>".
1.27      harris41 1475: 		    "<img src='$fab{$categoryname}.gif' ".
                   1476: 		    "alt='$categoryname icon' /></td>".
                   1477: 		    "<td><font size='-1'>$categoryname</font></td>".
                   1478: 		    "<td>LINKTO: $linkto<br />TARGET: $tgt</td>".
                   1479: 		    "<td>$description</td>".
                   1480: 		    "<td>$note</td>".
                   1481: 		    "</tr>");
                   1482: #		push @links,"\t".'ln -fs /'.$linkto.' /'.$targetroot.$tgt.
                   1483: #		    "\n";
                   1484: 	    }
                   1485: 	    return join('',@links);
                   1486: #	    return ($link="\n<!-- FILESORT:$target -->".
                   1487: #		    "<tr>".
                   1488: #		    "<td>&nbsp;</td><td><img src='$fab{$categoryname}.gif' ".
                   1489: #		    "alt='$categoryname icon' /></td>".
                   1490: #		    "<td>$categoryname</td>".
                   1491: #		    "<td>LINKTO: $linkto<br />TARGET: $target</td>".
                   1492: #		    "<td>$description</td>".
                   1493: #		    "<td>$note</td>".
                   1494: #		    "</tr>");
                   1495: #	    return $link="\n<tr><td colspan='6'>BEGIN LINK\n".
                   1496: #		"$linkto $target $categoryname $description $note " .
                   1497: #		"$build $status $dependencies" .
                   1498: #		    "\nEND LINK</td></tr>";
1.4       harris41 1499: 	}
                   1500: 	elsif ($mode eq 'install') {
1.10      harris41 1501: 	    my @targets=map {s/^\s*//;s/\s$//;$_} split(/\;/,$target);
1.5       harris41 1502: 	    foreach my $tgt (@targets) {
1.35      harris41 1503: 		push @links,"\t".'ln -fs /'.$linkto.' '.$targetroot.'/'.$tgt.
1.5       harris41 1504: 		    "\n";
                   1505: 	    }
1.35      harris41 1506: #	    return join('',@links);
1.4       harris41 1507: 	    return '';
1.3       harris41 1508: 	}
1.35      harris41 1509: 	elsif ($mode eq 'rpm_file_list') {
                   1510: 	    my @linklocs;
                   1511: 	    my @targets=map {s/^\s*//;s/\s$//;$_} split(/\;/,$target);
                   1512: 	    foreach my $tgt (@targets) {
                   1513: 		push @linklocs,''.$targetroot.'/'.$tgt."\n";
                   1514: 	    }
                   1515: 	    return join('',@linklocs);
                   1516: 	}
1.3       harris41 1517: 	else {
                   1518: 	    return '';
                   1519: 	}
                   1520:     }
                   1521:     return '';
                   1522: }
                   1523: # ----------------------------------------------------- Format fileglob section
                   1524: sub format_fileglob {
                   1525:     my @tokeninfo=@_;
                   1526:     $fileglob=''; $glob=''; $sourcedir='';
                   1527:     $targetdir=''; $categoryname=''; $description='';
                   1528:     $note=''; $build=''; $status=''; $dependencies='';
                   1529:     $filenames='';
                   1530:     my $text=&trim($parser->get_text('/fileglob'));
1.27      harris41 1531:     my $filenames2=$filenames;$filenames2=~s/\s//g;
1.29      harris41 1532:     $fileglob_count++;
                   1533:     my @semi=($filenames2=~/(\;)/g);
                   1534:     $fileglobnames_count+=scalar(@semi)+1;
                   1535:     $categorycount{$categoryname}+=scalar(@semi)+1;
1.3       harris41 1536:     if ($sourcedir) {
                   1537: 	$parser->get_tag('/fileglob');
1.46      harris41 1538: 	if ($mode eq 'MANIFEST') {
                   1539:          return join("\n",(map {"$sourcedir$_"} split(/\;/,$filenames2)))."\n";
                   1540: 	}
                   1541: 	elsif ($mode eq 'html') {
1.27      harris41 1542: 	    return $fileglob="\n<tr>".
1.41      harris41 1543:       "<td><!-- POSTEVAL [$categoryname] verify.pl fileglob '$sourcerootarg' ".
1.27      harris41 1544: 		"'$targetrootarg' ".
                   1545: 		"'$glob' '$sourcedir' '$filenames2' '$targetdir' ".
                   1546: 		"$categoryhash{$categoryname} -->&nbsp;</td>".
                   1547: 		"<td>"."<img src='$fab{$categoryname}.gif' ".
                   1548: 	        "alt='$categoryname icon' /></td>".
                   1549: 		"<td>$categoryname<br />".
                   1550: 		"<font size='-1'>".$categoryhash{$categoryname}."</font></td>".
                   1551: 		"<td>SOURCEDIR: $sourcedir<br />".
                   1552: 		"TARGETDIR: $targetdir<br />".
                   1553:                 "GLOB: $glob<br />".
                   1554:                 "FILENAMES: $filenames".
                   1555: 		"</td>".
                   1556: 		"<td>$description</td>".
                   1557: 		"<td>$note</td>".
                   1558: 		"</tr>";
                   1559: #	    return $fileglob="\n<tr><td colspan='6'>BEGIN FILEGLOB\n".
                   1560: #		"$glob sourcedir $targetdir $categoryname $description $note ".
                   1561: #		"$build $status $dependencies $filenames" .
                   1562: #		"\nEND FILEGLOB</td></tr>";
1.3       harris41 1563: 	}
1.5       harris41 1564: 	elsif ($mode eq 'install') {
1.30      harris41 1565: 	    my $eglob=$glob;
                   1566: 	    if ($glob eq '*') {
                   1567: 		$eglob='[^C][^V][^S]'.$glob;
                   1568: 	    }
1.59      raeburn  1569: 	    return "\t".'install -p '.
1.5       harris41 1570: 		$categoryhash{$categoryname}.' '.
1.30      harris41 1571: 		$sourceroot.'/'.$sourcedir.$eglob.' '.
1.5       harris41 1572: 		$targetroot.'/'.$targetdir.'.'."\n";
1.35      harris41 1573: 	}
                   1574: 	elsif ($mode eq 'rpm_file_list') {
                   1575: 	    my $eglob=$glob;
                   1576: 	    if ($glob eq '*') {
                   1577: 		$eglob='[^C][^V][^S]'.$glob;
                   1578: 	    }
                   1579: 	    my $targetdir2=$targetdir;$targetdir2=~s/\/$//;
                   1580: 	    my @gfiles=map {s/^.*\///;"$targetroot/$targetdir2/$_\n"}
                   1581: 	               glob("$sourceroot/$sourcedir/$eglob");
                   1582: 	    return join('',@gfiles);
1.5       harris41 1583: 	}
1.3       harris41 1584: 	else {
                   1585: 	    return '';
                   1586: 	}
                   1587:     }
                   1588:     return '';
                   1589: }
                   1590: # ---------------------------------------------------- Format sourcedir section
                   1591: sub format_sourcedir {
                   1592:     my @tokeninfo=@_;
                   1593:     $sourcedir='';
                   1594:     my $text=&trim($parser->get_text('/sourcedir'));
                   1595:     if ($text) {
                   1596: 	$parser->get_tag('/sourcedir');
                   1597: 	$sourcedir=$text;
                   1598:     }
                   1599:     return '';
                   1600: }
                   1601: # ------------------------------------------------------- Format target section
                   1602: sub format_target {
                   1603:     my @tokeninfo=@_;
                   1604:     $target='';
                   1605:     my $text=&trim($parser->get_text('/target'));
                   1606:     if ($text) {
                   1607: 	$parser->get_tag('/target');
                   1608: 	$target=$text;
                   1609:     }
                   1610:     return '';
                   1611: }
                   1612: # ------------------------------------------------------- Format source section
                   1613: sub format_source {
                   1614:     my @tokeninfo=@_;
                   1615:     $source='';
                   1616:     my $text=&trim($parser->get_text('/source'));
                   1617:     if ($text) {
                   1618: 	$parser->get_tag('/source');
                   1619: 	$source=$text;
                   1620:     }
                   1621:     return '';
                   1622: }
                   1623: # --------------------------------------------------------- Format note section
                   1624: sub format_note {
                   1625:     my @tokeninfo=@_;
                   1626:     $note='';
1.26      harris41 1627: #    my $text=&trim($parser->get_text('/note'));
                   1628:     my $aref;
                   1629:     my $text;
                   1630:     while ($aref=$parser->get_token()) {
                   1631: 	if ($aref->[0] eq 'E' && $aref->[1] eq 'note') {
                   1632: 	    last;
                   1633: 	}
                   1634: 	elsif ($aref->[0] eq 'S') {
                   1635: 	    $text.=$aref->[4];
                   1636: 	}
                   1637: 	elsif ($aref->[0] eq 'E') {
                   1638: 	    $text.=$aref->[2];
                   1639: 	}
                   1640: 	else {
                   1641: 	    $text.=$aref->[1];
                   1642: 	}
                   1643:     }
1.3       harris41 1644:     if ($text) {
1.26      harris41 1645: #	$parser->get_tag('/note');
1.3       harris41 1646: 	$note=$text;
                   1647:     }
                   1648:     return '';
                   1649: 
                   1650: }
                   1651: # -------------------------------------------------------- Format build section
                   1652: sub format_build {
                   1653:     my @tokeninfo=@_;
                   1654:     $build='';
                   1655:     my $text=&trim($parser->get_text('/build'));
                   1656:     if ($text) {
                   1657: 	$parser->get_tag('/build');
1.11      harris41 1658: 	$build=$sourceroot.'/'.$text.';'.$tokeninfo[2]{'trigger'};
1.42      harris41 1659: 	$build=~s/([^\\])\\\s+/$1/g; # allow for lines split onto new lines
1.3       harris41 1660:     }
                   1661:     return '';
                   1662: }
1.53      albertel 1663: # ------------------------------------------------ Format installscript section
                   1664: sub format_installscript {
                   1665:     my @tokeninfo=@_;
                   1666:     $installscript= &trim($parser->get_text('/installscript'));
                   1667:     if ($installscript) {
                   1668: 	$parser->get_tag('/installscript');
                   1669: 	$installscript=~s/([^\\])\\\s+/$1/g; # allow for lines split onto new lines
                   1670:     }
                   1671:     return '';
                   1672: }
1.14      harris41 1673: # -------------------------------------------------------- Format build section
                   1674: sub format_buildlink {
                   1675:     my @tokeninfo=@_;
                   1676:     my $text=&trim($parser->get_text('/buildlink'));
                   1677:     if ($text) {
                   1678: 	$parser->get_tag('/buildlink');
                   1679: 	$buildlink=$sourceroot.'/'.$text;
1.61      raeburn  1680:     } else {
                   1681:         $buildlink='';
1.14      harris41 1682:     }
                   1683:     return '';
                   1684: }
1.3       harris41 1685: # ------------------------------------------------------- Format status section
                   1686: sub format_status {
                   1687:     my @tokeninfo=@_;
                   1688:     $status='';
                   1689:     my $text=&trim($parser->get_text('/status'));
                   1690:     if ($text) {
                   1691: 	$parser->get_tag('/status');
                   1692: 	$status=$text;
                   1693:     }
                   1694:     return '';
                   1695: }
                   1696: # ------------------------------------------------- Format dependencies section
                   1697: sub format_dependencies {
                   1698:     my @tokeninfo=@_;
                   1699:     my $text=&trim($parser->get_text('/dependencies'));
                   1700:     if ($text) {
                   1701: 	$parser->get_tag('/dependencies');
1.52      albertel 1702: 	$dependencies=join(';',((map {s/^\s*//;s/\s$//;$_} split(/\;/,$text)),$dependencies));
                   1703: 	$dependencies=~s/;$//;
1.61      raeburn  1704:     } else {
                   1705:         $dependencies='';
1.52      albertel 1706:     }
                   1707:     return '';
                   1708: }
                   1709: sub format_privatedependencies {
                   1710:     my @tokeninfo=@_;
                   1711:     #$dependencies='';
                   1712:     my $text=&trim($parser->get_text('/privatedependencies'));
                   1713:     if ($text) {
                   1714: 	$parser->get_tag('/privatedependencies');
                   1715: 	if ($mode eq 'MANIFEST') { return '';	}
                   1716: 	$dependencies=join(';',((map {s/^\s*//;s/\s$//;$_} split(/\;/,$text)),$dependencies));
                   1717: 	$dependencies=~s/;$//;
1.3       harris41 1718:     }
                   1719:     return '';
                   1720: }
                   1721: # --------------------------------------------------------- Format glob section
                   1722: sub format_glob {
                   1723:     my @tokeninfo=@_;
                   1724:     $glob='';
                   1725:     my $text=&trim($parser->get_text('/glob'));
                   1726:     if ($text) {
                   1727: 	$parser->get_tag('/glob');
                   1728: 	$glob=$text;
                   1729:     }
                   1730:     return '';
                   1731: }
                   1732: # ---------------------------------------------------- Format filenames section
                   1733: sub format_filenames {
                   1734:     my @tokeninfo=@_;
                   1735:     my $text=&trim($parser->get_text('/filenames'));
                   1736:     if ($text) {
                   1737: 	$parser->get_tag('/filenames');
                   1738: 	$filenames=$text;
                   1739:     }
1.31      harris41 1740:     return '';
                   1741: }
1.38      harris41 1742: # ----------------------------------------------- Format specialnotices section
1.31      harris41 1743: sub format_specialnotices {
                   1744:     $parser->get_tag('/specialnotices');
                   1745:     return '';
                   1746: }
                   1747: # ------------------------------------------------ Format specialnotice section
                   1748: sub format_specialnotice {
                   1749:     $parser->get_tag('/specialnotice');
1.3       harris41 1750:     return '';
                   1751: }
                   1752: # ------------------------------------------------------- Format linkto section
                   1753: sub format_linkto {
                   1754:     my @tokeninfo=@_;
                   1755:     my $text=&trim($parser->get_text('/linkto'));
                   1756:     if ($text) {
                   1757: 	$parser->get_tag('/linkto');
                   1758: 	$linkto=$text;
                   1759:     }
                   1760:     return '';
1.10      harris41 1761: }
                   1762: # ------------------------------------- Render less-than and greater-than signs
                   1763: sub htmlsafe {
                   1764:     my $text=@_[0];
                   1765:     $text =~ s/</&lt;/g;
                   1766:     $text =~ s/>/&gt;/g;
                   1767:     return $text;
1.3       harris41 1768: }
                   1769: # --------------------------------------- remove starting and ending whitespace
                   1770: sub trim {
                   1771:     my ($s)=@_; $s=~s/^\s*//; $s=~s/\s*$//; return $s;
                   1772: } 
1.14      harris41 1773: 
                   1774: # ----------------------------------- POD (plain old documentation, CPAN style)
1.18      harris41 1775: 
1.43      harris41 1776: =pod
                   1777: 
1.18      harris41 1778: =head1 NAME
                   1779: 
1.45      harris41 1780: lpml_parse.pl - This is meant to parse files meeting the lpml document type.
1.18      harris41 1781: 
                   1782: =head1 SYNOPSIS
                   1783: 
1.45      harris41 1784: <STDIN> | perl lpml_parse.pl <MODE> <CATEGORY> <DIST> <SOURCE> <TARGET>
                   1785: 
                   1786: Usage is for the lpml file to come in through standard input.
1.18      harris41 1787: 
                   1788: =over 4
                   1789: 
                   1790: =item *
                   1791: 
                   1792: 1st argument is the mode of parsing.
                   1793: 
                   1794: =item * 
                   1795: 
                   1796: 2nd argument is the category permissions to use (runtime or development)
                   1797: 
                   1798: =item *
                   1799: 
                   1800: 3rd argument is the distribution
                   1801: (default,redhat6.2,debian2.2,redhat7.1,etc).
                   1802: 
                   1803: =item *
                   1804: 
                   1805: 4th argument is to manually specify a sourceroot.
                   1806: 
                   1807: =item *
                   1808: 
                   1809: 5th argument is to manually specify a targetroot.
                   1810: 
                   1811: =back
                   1812: 
                   1813: Only the 1st argument is mandatory for the program to run.
                   1814: 
                   1815: Example:
                   1816: 
                   1817: cat ../../doc/loncapafiles.lpml |\\
1.45      harris41 1818: perl lpml_parse.pl html runtime default /home/sherbert/loncapa /tmp/install
1.18      harris41 1819: 
                   1820: =head1 DESCRIPTION
                   1821: 
1.45      harris41 1822: The general flow of the script is to get command line arguments, run through
                   1823: the XML document three times, and output according to any desired mode:
                   1824: install, configinstall, build, rpm, dpkg, htmldoc, textdoc, and status.
                   1825: 
                   1826: A number of coding decisions are made according to the following principle:
                   1827: installation software must be stand-alone.  Therefore, for instance, I try
                   1828: not to use the GetOpt::Long module or any other perl modules.  (I do however
                   1829: use HTML::TokeParser.)  I also have tried to keep all the MODES of
                   1830: parsing inside this file.  Therefore, format_TAG subroutines are fairly
                   1831: lengthy with their conditional logic.  A more "elegant" solution might
                   1832: be to dynamically register the parsing mode and subroutines, or maybe even work
                   1833: with stylesheets.  However, in order to make this the installation back-bone
                   1834: of choice, there are advantages for HAVING EVERYTHING IN ONE FILE.
                   1835: This way, the LPML installation software does not have to rely on OTHER
                   1836: installation software (a chicken versus the egg problem).  Besides, I would
                   1837: suggest the modes of parsing are fairly constant: install, configinstall,
                   1838: build, rpm, dpkg, htmldoc, textdoc, and status.
                   1839: 
                   1840: Another coding decision is about using a multiple pass-through approach to
                   1841: parsing the lpml file.  This saves memory and makes sure the server will never
                   1842: be overloaded.  During the first pass-through, the script gathers information
                   1843: specific as to resolving what tags with what 'dist=' attributes are to be used.
                   1844: During the second pass-through, the script cleans up white-space surrounding
                   1845: the XML tags, and filters through the tags based on information regarding the
                   1846: 'dist=' attributes (information gathered in the first pass-through).
                   1847: The third and final pass-through involves formatting and rendering the XML
                   1848: into whatever XML mode is chosen: install, configinstall, build, rpm, dpkg,
                   1849: htmldoc, textdoc, and status.
                   1850: 
                   1851: The hierarchy mandated by the DTD does not always correspond to the hierarchy
                   1852: that is sensible for a Makefile.  For instance, in a Makefile it is sensible
                   1853: that soft-links are installed after files.  However, in an LPML document, it
                   1854: is sensible that files and links be considered together and the writer of the
                   1855: LPML document should be free to place things in whatever order makes best
                   1856: sense in terms of LOOKING at the information.  The complication that arises
                   1857: is that the parser needs to have a memory for passing values from
                   1858: leaves on the XML tree to higher-up branches.  Currently, this memory is
                   1859: hard-coded (like with the @links array), but it may benefit from a more
                   1860: formal approach in the future.
1.18      harris41 1861: 
                   1862: =head1 README
                   1863: 
1.45      harris41 1864: This parses an LPML file to generate information useful for
                   1865: source to target installation, compilation, filesystem status
                   1866: checking, RPM and Debian software packaging, and documentation.
                   1867: 
                   1868: More information on LPML is available at http://lpml.sourceforge.net.
1.18      harris41 1869: 
                   1870: =head1 PREREQUISITES
                   1871: 
                   1872: HTML::TokeParser
                   1873: 
                   1874: =head1 COREQUISITES
                   1875: 
                   1876: =head1 OSNAMES
                   1877: 
                   1878: linux
                   1879: 
                   1880: =head1 SCRIPT CATEGORIES
                   1881: 
1.45      harris41 1882: UNIX/System_administration
1.43      harris41 1883: 
                   1884: =head1 AUTHOR
                   1885: 
                   1886:  Scott Harrison
                   1887:  codeharrison@yahoo.com
                   1888: 
                   1889: Please let me know how/if you are finding this script useful and
                   1890: any/all suggestions.  -Scott
1.18      harris41 1891: 
                   1892: =cut

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>