--- doc/help/render.texxml.pl	2003/07/21 15:04:48	1.13
+++ doc/help/render.texxml.pl	2018/11/01 03:31:21	1.20
@@ -27,13 +27,13 @@
 
 use strict;
 use Fcntl;
-use POSIX qw(tmpnam);
+use File::Temp;
 
 if ( scalar(@ARGV) < 2 )
 {
     print (<<USAGE);
 Usage: $0 texxml_file_name or
-       perl $0 -- texxml_file_name
+       perl $0 -- texxml_file_name [epssource] [--with-filenames]
        where "texxml_file_name" optionally includes the extension
 Output: texxml_file_name.dvi
 
@@ -46,12 +46,18 @@ If a second argument is passed, it is us
 
 Must be run as somebody with permissions to write temp files and 
 access /home/httpd/html/adm/help/eps.
+
+If thre is a second argument, it will be used as the path to the 
+eps files, otherwise "../../loncom/html/adm/help/eps" is used.
+
+If the optional argument --with-filenames is included then
+the filename for each fragment is stuck into the finished file.
 USAGE
 
     exit();
 }
 
-my $tmpdir = tmpnam();
+my $tmpdir = File::Temp::tempdir();
 my $fileroot = $ARGV[1];
 
 if (substr($fileroot, -7) eq ".texxml")
@@ -60,25 +66,34 @@ if (substr($fileroot, -7) eq ".texxml")
 }
 
 my $epssource = "../../loncom/html/adm/help/eps";
-
-if ( defined ( $ARGV[2] ) ) # override eps source, for build on install
-{
+# override eps source, for build on install
+if ( $ARGV[2] && $ARGV[2] ne '--with-filenames') {
     $epssource = $ARGV[2];
 }
 
-my $redir = ">& /dev/null"; # empty this for easier debugging
-#my $redir = ">> error_log.txt";
+my $include_filenames='';
+if ( $ARGV[2] eq '--with-filenames' || $ARGV[3] eq '--with-filenames') {
+    $include_filenames='--with-filenames';
+}
+
+#my $redir = ">& /dev/null"; # empty this for easier debugging
+my $redir = "~/error_log.txt";
+system("rm -f $redir");
+$redir=">> $redir";
 
 mkdir $tmpdir, 0755;
 
 print "Converting texxml to tex...\n";
-system ( "perl texxml2latex.pl $fileroot.texxml > $tmpdir/$fileroot.tex" );
+if (system ( "perl texxml2latex.pl $fileroot.texxml $include_filenames > $tmpdir/$fileroot.tex" )) {
+    $! = 1;
+    die "Terminated render because texxml2latex failed; see previous error message.";
+};
 
 print "Copying .eps files...\n";
 system ( "cp $epssource/* $tmpdir/" );
 
 print "Running Latex...\n";
-system ( "cd $tmpdir; echo | latex $fileroot $redir; makeindex $fileroot.idx; echo | latex $fileroot $redir; echo | latex $fileroot\ $redir; " );
+system ( "cd $tmpdir; echo | latex $fileroot $redir; echo | latex $fileroot $redir; makeindex $fileroot.idx; echo | latex $fileroot\ $redir; " );
 
 print "Running dvips...\n";
 system ( "cd $tmpdir; dvips -Ppdf -G0 -f $fileroot.dvi > $fileroot.ps  " );
@@ -89,6 +104,10 @@ system ( "cp $tmpdir/$fileroot.ps .");
 print "Converting to PDF (may take a bit)...\n";
 system ( "ps2pdf $fileroot.ps $fileroot.pdf" );
 
+print "Rescuing log and tex file for debugging ...\n";
+system ("cp $tmpdir/$fileroot.log ."); 
+system ("cp $tmpdir/$fileroot.tex ."); 
+
 print "Clearing temp directory...\n";
 system ( "rm -rf $tmpdir" );
 
@@ -98,5 +117,5 @@ if ( -e $fileroot . ".ps" )
 }
 else
 {
-    print "Generationr of $fileroot.ps failed.\n";
+    print "Generation of $fileroot.ps failed.\n";
 }