File:  [LON-CAPA] / loncom / interface / lonprintout.pm
Revision 1.639: download - view: text, annotated - select for diffs
Sat Feb 8 23:49:12 2014 UTC (10 years, 2 months ago) by raeburn
Branches: MAIN
CVS tags: HEAD
- Modify changes to rev. 1.619 (for bug 6499).  If the first resource in folder
  being printed is an HTML cover sheet, explictly insert header line, so new
  CODE or Name is shown on first page of each student's assignment.

# The LearningOnline Network
# Printout
#
# $Id: lonprintout.pm,v 1.639 2014/02/08 23:49:12 raeburn Exp $
#
# Copyright Michigan State University Board of Trustees
#
# This file is part of the LearningOnline Network with CAPA (LON-CAPA).
#
# LON-CAPA is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# LON-CAPA is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with LON-CAPA; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
#
# /home/httpd/html/adm/gpl.txt
# http://www.lon-capa.org/
#
#
package Apache::lonprintout;
use strict;
use Apache::Constants qw(:common :http);
use Apache::lonxml;
use Apache::lonnet;
use Apache::loncommon;
use Apache::inputtags;
use Apache::grades;
use Apache::edit;
use Apache::File();
use Apache::lonnavmaps;
use Apache::admannotations;
use Apache::lonenc;
use Apache::entities;
use Apache::londefdef;
# use Apache::structurelags;	# for language management.

use File::Basename;

use HTTP::Response;
use LONCAPA::map();
use Apache::lonlocal;
use Carp;
use LONCAPA;


my %perm;
my %parmhash;
my $resources_printed;

# Global variables that describe errors in ssi calls detected  by ssi_with_retries.
#

my $ssi_error;			# True if there was an ssi error.
my $ssi_last_error_resource;	# The resource URI that could not be fetched.
my $ssi_last_error;		# The error text from the server. (e.g. 500 Server timed out).

#
#  Our ssi max retry count.
#

my $ssi_retry_count = 5;	# Some arbitrary value.


#  Font size:

my $font_size = 'normalsize';	# Default is normalsize...

#----------------------------  Helper helpers. -------------------------

## 
# Filter function to determine if a resource is a printable sequence.
#
# @param $res -Resource to check.
#
# @return 1 - printable and a resource
#         0 - either notm a sequence or not printable.
#
sub printable_sequence {
    my $res = shift;

    # Non-sequences are not listed:

    if (!$res->is_sequence()) {
	return 0;
    }

    # Person with pav or pfo can always print:

    if ($perm{'pav'} || $perm{'pfo'}) {
	return 1;
    }

    if ($res->is_sequence()) {
	my $symb = $res->symb();
	my $navmap   = $res->{NAV_MAP};

	# Find the first resource in the map:

	my $iterator = $navmap->getIterator($res, undef, undef, 1, 1);
	my $first    = $iterator->next();

	while (1) {
	    if ($first == $iterator->END_ITERATOR) { last; }
	    if (ref($first) && ! $first->is_sequence()) {last; }
	    $first = $iterator->next();
	}


	# Might be an empty map:

	if (!ref($first)) {
	    return 0;
	}
	my $partsref = $first->parts();
	my @parts    = @$partsref;
	my ($open, $close) = $navmap->map_printdates($first, $parts[0]);
	return &printable($open, $close);
    }
    return 0;
}

# BZ5209:
#    Create the states needed to run the helper for incomplete problems from
#    the current folder for selected students.
#    This includes:
#    -  A resource selector limited to problems (incompleteness must be
#       calculated on a student per student basis.
#    -  A student selector.
#    -  Tie in to the FORMAT of the print job.
#
# States:
#   CHOOSE_INCOMPLETE_PEOPLE_SEQ      - Resource selection.
#   CHOOSE_STUDENTS_INCOMPLETE        - Student selection.
#   CHOOSE_STUDENTS_INCOMPLETE_FORMAT - Format selection
# Parameters:
#    helper - the helper which already contains info about the current folder we can
#             purloin.
#    url    - Top url of the sequence
# Return:
#     XML that can be parsed by the helper to drive the state machine.
#
sub create_incomplete_folder_selstud_helper {
    my ($helper, $map)  = @_;


    my $symbFilter = '$res->shown_symb()';
    my $selFilter   = '$res->is_problem()';


    my $resource_chooser = &generate_resource_chooser('CHOOSE_INCOMPLETE_PEOPLE_SEQ',
						      'Select problem(s) to print',
						      'multichoice="1" toponly="1" addstatus="1" closeallpages="1"',
						      'RESOURCES',
						      'CHOOSE_STUDENTS_INCOMPLETE',
						      $map,
						      $selFilter,
						      '',
						      $symbFilter, 
						      '');

    my $student_chooser = &generate_student_chooser('CHOOSE_STUDENTS_INCOMPLETE',
						 'student_sort',
						 'STUDENTS',
						 'CHOOSE_STUDENTS_INCOMPLETE_FORMAT');

    my $format_chooser = &generate_format_selector($helper,
						'Format of the print job',
						'CHOOSE_STUDENTS_INCOMPLETE_FORMAT'); # end state.

    return $resource_chooser . $student_chooser . $format_chooser;
}  


# BZ 5209
#     Create the states needed to run the helper for incomplete problems from
#     the current folder for selected students.
#     This includes:
#     - A resource selector limited to problems.  (incompleteness must be calculated
#       on a student per student basis.
#     - A student selector.
#     - Tie in to format for the print job.
# States:
#    INCOMPLETE_PROBLEMS_COURSE_RESOURCES - Resource selector.
#    INCOMPLETE_PROBLEMS_COURSE_STUDENTS  - Student selector.
#    INCOMPLETE_PROBLEMS_COURSE_FORMAT    - Format selection.
#
# Parameters:
#   helper   - Helper we are creating states for.
# Returns:
#   Text that can be parsed by the helper.
# 

sub create_incomplete_course_helper {
    my $helper = shift;

    my $filter = '$res->is_problem() || $res->contains_problem() || $res->is_sequence() || $res->is_practice())';
    my $symbfilter = '$res->shown_symb()';
    
    my $resource_chooser = &generate_resource_chooser('INCOMPLETE_PROBLEMS_COURSE_RESOURCES',
						      'Select problem(s) to print',
						      'multichoice = "1" suppressEmptySequences="0" addstatus="1" closeallpagtes="1"',
						      'RESOURCES',
						      'INCOMPLETE_PROBLEMS_COURSE_STUDENTS',
						      '',
						      $filter,
						      '',
						      $symbfilter,
						      '');

    my $people_chooser  = &generate_student_chooser('INCOMPLETE_PROBLEMS_COURSE_STUDENTS',
						    'student_sort',
						    'STUDENTS',
						    'INCOMPLETE_PROBLEMS_COURSE_FORMAT');

    my $format = &generate_format_selector($helper,
					   'Format of the print job',
					   'INCOMPLETE_PROBLEMS_COURSE_FORMAT'); # end state.

    return $resource_chooser . $people_chooser . $format;


}

# BZ5209 
#   Creates the states needed to run the print helper for a student
#   that wants to print his incomplete problems from the current folder.
# Parameters:
#   $helper - helper we are generating states for.
#   $map    - The map for which the student wants incomplete problems.
# Returns:
#   XML that defines the helper states being created.
#
# States:
#   CHOOSE_INCOMPLETE_SEQ  - Resource selector.
#
sub create_incomplete_folder_helper {
    my ($helper, $map) = @_;

    my $filter    = '$res->is_problem()';
    $filter      .= ' && $res->resprintable() ';
    $filter      .= ' && $res->is_incomplete() ';

    my $symfilter = '$res->shown_symb()';

    my $resource_chooser = &generate_resource_chooser('CHOOSE_INCOMPLETE_SEQ',
						      'Select problem(s) to print',
						      'multichoice="1", toponly ="1", addstatus="1", closeallpages="1"',
						      'RESOURCES',
						      'PAGESIZE',
						      $map,
						      $filter, '', 
						      $symfilter,
						      '');

    return $resource_chooser;
}


#  Returns the text neded for a student chooser.
#  that text must still be parsed by the helper xml parser.
# Parameters:
#   this_state   - State name of the chooser.
#   sort_choice  - variable to hold the sorting choice.
#   variable     - Name of variable to hold students.
#   next_state   - State after chooser.


sub generate_student_chooser {
    my ($this_state, 
	$sort_choice, 
	$variable, 
	$next_state) = @_;
    my $result = <<CHOOSE_STUDENTS;
  <state name="$this_state" title="Select Students and Resources">
      <message><b>Select sorting order of printout</b> </message>

    <choices variable="$sort_choice">
      <choice computer='0'>Sort by section then student</choice>
      <choice computer='1'>Sort by students across sections.</choice>
    </choices>

      <message><br /><hr /><br /> </message>
      <student multichoice='1' 
               variable="$variable" 
               nextstate="$next_state" 
               coursepersonnel="1" />
  </state>

CHOOSE_STUDENTS

  return $result;
}

# Generate the text needed for a resource chooser given the top level of
# the sequence/page
#
# Parameters:
#     this_state    - State name of the chooser.
#     prompt_text   - Text to use to prompt user.
#     resource_options - Resource tag options e.g.
#                        "multichoice='1', toponly='1', addstatus='1'"
#                     that control the selection and appearance of the
#                     resource selector.
#     variable      - Name of the variable to hold the choice
#     next_state    - Name of the next state the helper should transition
#                     to
#     top_url       - Top level URL within which to make the selector.
#                     If empty the top level sequence is shown.
#     filter        - How to filter the resources.
#     value_func    - <valuefunc> function.
#     choice_func   - If not empty generates a <choicefunc> with this function.
#     start_new_option 
#                   - Fragment appended after valuefunc.
#
#
sub generate_resource_chooser {
    my ($this_state,
	$prompt_text,
	$resource_options,
	$variable,
	$next_state,
	$top_url,
	$filter,
	$choice_func,
	$value_func,
	$start_new_option)  = @_;

    my $result = <<CHOOSE_RESOURCES;
<state name="$this_state" title="$prompt_text">
    <resource variable="$variable" $resource_options
              closeallpages="1">
      <nextstate>$next_state</nextstate>
      <filterfunc>return $filter;</filterfunc>
CHOOSE_RESOURCES
    if ($choice_func ne '') {
	$result .= "<choicefunc>return $choice_func;</choicefunc>";
    }
    if ($top_url ne '') {
	$result .=  "<mapurl>$top_url</mapurl>";
    }
    $result .= <<CHOOSE_RESOURCES;
      <valuefunc>return $value_func;</valuefunc>
      $start_new_option
      </resource>
    </state>
CHOOSE_RESOURCES
    return $result;
}
#
#   Generate the helper XML for a code choice helper dialog:
#
# Paramters:
#   $helper       - Reference to the helper.
#   $state        - Name of the state for the chooser.
#   $next_state   - Name fo the state to follow the chooser.
#   $bubble_types - Populates the bubble sheet type dropt down.
#   $code_selections - Provides set of code choices that have been used
#   $saved_codes  - Provides the list of saved codes.
#
# Returns;
#   The Xml of the code chooser.
#
sub generate_code_selector {
    my ($helper,
	$state,
	$next_state,
	$bubble_types,
	$code_selections,
	$saved_codes) = @_;	# Unpack the parameters.

    my $result = <<CHOOSE_ANON1;
  <state name="$state" title="Specify CODEd Assignments">
    <nextstate>$next_state</nextstate>
    <message><h4>Fill out one of the forms below</h4></message>
    <message><br /><hr /> <br /></message>
    <message><h3>Generate new CODEd Assignments</h3></message>
    <message><table><tr><td><b>Number of CODEd assignments to print:</b></td><td></message>
    <string variable="NUMBER_TO_PRINT_TOTAL" maxlength="5" size="5"  noproceed="1">
       <validator>
	if (((\$helper->{'VARS'}{'NUMBER_TO_PRINT_TOTAL'}+0) < 1) &&
	    !\$helper->{'VARS'}{'REUSE_OLD_CODES'}                &&
            !\$helper->{'VARS'}{'SINGLE_CODE'}                    &&
	    !\$helper->{'VARS'}{'CODE_SELECTED_FROM_LIST'} ) {

	    return "You need to specify the number of assignments to print";
	}
        if (((\$helper->{'VARS'}{'NUMBER_TO_PRINT_TOTAL'}+0) >= 1)  &&
             (\$helper->{'VARS'}{'SINGLE_CODE'} ne '') ) {
            return 'Specifying number of codes to print and a specific code is not compatible';
        }
	return undef;
       </validator>
    </string>
    <message></td></tr><tr><td></message>
    <message><b>Names to save the CODEs under for later:</b></message>
    <message></td><td></message>
    <string variable="ANON_CODE_STORAGE_NAME" maxlength="50" size="20" />
    <message></td></tr><tr><td></message>
    <message><b>Bubblesheet type:</b></message>
    <message></td><td></message>
    <dropdown variable="CODE_OPTION" multichoice="0" allowempty="0">
    $bubble_types
    </dropdown>
    <message></td></tr><tr><td colspan="2"></td></tr><tr><td></message>
    <message></td></tr><tr><td></table></message>
    <message><br /><hr /><h3>Print a Specific CODE </h3><br /><table></message>
    <message><tr><td><b>Enter a CODE to print:</b></td><td></message>
    <string variable="SINGLE_CODE" size="10">
        <validator>
	   if(!\$helper->{'VARS'}{'NUMBER_TO_PRINT_TOTAL'}           &&
	      !\$helper->{'VARS'}{'REUSE_OLD_CODES'}                 &&
	      !\$helper->{'VARS'}{'CODE_SELECTED_FROM_LIST'}) {
	      return &Apache::lonprintout::is_code_valid(\$helper->{'VARS'}{'SINGLE_CODE'},
						      \$helper->{'VARS'}{'CODE_OPTION'});
	  } elsif (\$helper->{'VARS'}{'SINGLE_CODE'} ne ''){
	      return 'Specifying a code name is incompatible with specifying number of codes.';
	   } else {
	       return undef;	# Other forces control us.
	   }
        </validator>
    </string>
    <message></td></tr><tr><td></message>
        $code_selections
    <message></td></tr></table></message>
    <message><hr /><h3>Reprint a Set of Saved CODEs</h3><table><tr><td></message>
    <message><b>Select saved CODEs:</b></message>
    <message></td><td></message>
    <dropdown variable="REUSE_OLD_CODES">
        $saved_codes
    </dropdown>
    <message></td></tr></table></message>
  </state>
CHOOSE_ANON1

   return $result;
}

#  Returns the XML for choosing how assignments are to be formatted 
#  that text must still be parsed by the helper xml parser.
# Parameters: 3 (required)

#   helper       - The helper; $helper->{'VARS'}->{'PRINT_TYPE'} used
#                  to check if splitting PDFs by section can be offered.
#   title        - Title for the current state. 
#   this_state   - State name of the chooser.

sub generate_format_selector {
    my ($helper,$title,$this_state) = @_;
    my $secpdfoption;
    unless (($helper->{'VARS'}->{'PRINT_TYPE'} eq 'problems_for_anon')     ||
            ($helper->{'VARS'}->{'PRINT_TYPE'} eq 'problems_for_anon_page') ||
            ($helper->{'VARS'}->{'PRINT_TYPE'} eq 'resources_for_anon')  ) {
        $secpdfoption =  '<choice computer="sections">Each PDF contains exactly one section</choice>';
    }
    return <<RESOURCE_SELECTOR;
    <state name="$this_state" title="$title">
    <message><br /><big><i><b>How should the results be printed?</b></i></big><br /></message>
    <choices variable="EMPTY_PAGES">
      <choice computer='0'>Start each student\'s assignment on a new page/column (add a pagefeed after each assignment)</choice>
      <choice computer='1'>Add one empty page/column after each student\'s assignment</choice>
      <choice computer='2'>Add two empty pages/column after each student\'s assignment</choice>
      <choice computer='3'>Add three empty pages/column after each student\'s assignment</choice>
    </choices>
    <nextstate>PAGESIZE</nextstate>
    <message><hr width='33%' /><b>How do you want assignments split into PDF files? </b></message>
    <choices variable="SPLIT_PDFS">
       <choice computer="all">All assignments in a single PDF file</choice>
       $secpdfoption
       <choice computer="oneper">Each PDF contains exactly one assignment</choice>
       <choice computer="usenumber" relatedvalue="NUMBER_TO_PRINT">
            Specify the number of assignments per PDF:</choice>
    </choices>
    </state>
RESOURCE_SELECTOR
}

#-----------------------------------------------------------------------

# Computes an open and close date from a list of open/close dates for a resource's
# parts.
#
# @param \@opens - reference to an array of open dates.
# @param \@closes - reference to an array of close dates.
#
# @return ($open, $close) 
#
# @note If open/close dates are not defined they will be returned as undef
# @note It is possible for there to be no overlap in which case -1,-1 
#       will be returned.
# @note The algorithm used is to take the latest open date and the earliest end date.
#
sub compute_open_window {
    my ($opensref, $closesref) = @_;

    my @opens   = @$opensref;
    my @closes  = @$closesref;

    # latest open date:
    my $latest_open;

    foreach my $open (@opens) {
	if (!defined($latest_open) || ($open > $latest_open)) {
	    $latest_open = $open;
	}
    }
    # Earliest close:

    my $earliest_close;
    foreach my $close (@closes) {
	if (!defined($earliest_close) || ($close < $earliest_close)) {
	    $earliest_close = $close;
	}
    }

    # If no overlap...both are -1 as promised.

    if (($earliest_close ne '') && ($latest_open ne '')
	 && ($earliest_close < $latest_open)) {
	$latest_open  = -1;
	$earliest_close = -1;
    }
    
    return ($latest_open, $earliest_close);
  
}

##
#  Determines if 'now' is within the set of printable dates.
#
#  @param $open_date - Starting date/timestamp.
#  @param $close_date - Ending date/timestamp.
#
#  @return 0 - Not open.
#  @return 1 - open.
#
sub printable {
    my ($open_date, $close_date) = @_;


    my $now = time();

    # Have to do a bit of fancy footwork around undefined open/close dates:

    if ($open_date && ($open_date > $now)) {
	return 0;
    }

    if ($close_date && ($close_date < $now)) {
	return 0;
    }
    
    return 1;

}

##
# Returns the innermost print start/print end dates for a resource.
# This is done by looking at the start/end dates for its parts and choosing
# the intersection of those dates.
# 
# @param res - lonnvamaps::resource object that represents the resource.
#
# @return (opendate, closedate)
#
# @note If open/close dates are not defined they will be returned as undef
# @note It is possible for there to be no overlap in which case -1,-1 
#       will be returned.
# @note The algorithm used is to take the latest open date and the earliest end date.
#       For consistency with &printable() in lonnavmaps.pm determination of start
#       date for printing checks printstartdate param first, then, if not set,
#       opendate param, then, if not set, contentopen param.

sub get_print_dates {
    my $res = shift;
    my $partsref = $res->parts();
    my @parts;
    if (ref($partsref) eq 'ARRAY') {
        @parts   = @{$partsref};
    }
    my $open_date;
    my $close_date;
    my @open_dates;
    my @close_dates;


    if (@parts) {
	foreach my $part (@parts) {
	    my $partopen  = $res->parmval('printstartdate', $part);
	    my $partclose = $res->parmval('printenddate',  $part);
            if (!$partopen) {
                $partopen = $res->parmval('opendate',$part);
            }
            if (!$partopen) {
                $partopen = $res->parmval('contentopen',$part);
            }
            if ($partopen) {
                push(@open_dates, $partopen);
            }
            if ($partclose) {
                push(@close_dates, $partclose);
            }
	    push(@open_dates, $partopen);
	    push(@close_dates, $partclose);
	}
    }

    ($open_date, $close_date)  = &compute_open_window(\@open_dates, \@close_dates);

    return ($open_date, $close_date);
}

##
# Get the dates for which a course says a resource can be printed.  This is like
# get_print_dates but namvaps::course_print_dates are gotten...and not converted
# to times either.
#
# @param $res - Reference to a resource has from lonnvampas::resource.
#
# @return (opendate, closedate)
#
sub course_print_dates {
    my $res = shift;
    my $partsref = $res->parts();
    my @parts    = @$partsref;
    my $open_date;
    my $close_date;
    my @open_dates;
    my @close_dates;
    my $navmap = $res->{NAV_MAP}; # Slightly OO dirty.

    # Don't bother looping over undefined or empty parts arraY;

    if (@parts) {
	foreach my $part (@parts) {
	    my ($partopen, $partclose) = $navmap->course_printdates($res, $part);
	    push(@open_dates, $partopen);
	    push(@close_dates, $partclose);
	}
	($open_date, $close_date) = &compute_open_window(\@open_dates, \@close_dates);
    }
    return ($open_date, $close_date);
}
##
# Same as above but for the enclosing map:
#
sub map_print_dates {
    my $res = shift;
    my $partsref = $res->parts();
    my @parts    = @$partsref;
    my $open_date;
    my $close_date;
    my @open_dates;
    my @close_dates;
    my $navmap = $res->{NAV_MAP}; # slightly OO dirty.


    # Don't bother looping over undefined or empty parts arraY;

    if (@parts) {
	foreach my $part (@parts) {
	    my ($partopen, $partclose) = $navmap->map_printdates($res, $part);
	    push(@open_dates, $partopen);
	    push(@close_dates, $partclose);
	}
	($open_date, $close_date) = &compute_open_window(\@open_dates, \@close_dates);
    }
    return ($open_date, $close_date);
}

# Determine if a resource is incomplete given the map:
# Parameters:
#   $username - Name of user for whom we are checking.
#   $domain   - Domain of user we are checking.
#   $map - map name.
# Returns:
#     0 - map is not incomplete.
#     1 - map is incomplete.
#
sub incomplete {
    my ($username, $domain, $map) = @_;


    my $navmap = Apache::lonnavmaps::navmap->new($username, $domain);
    

    if (defined($navmap)) {
	my $res = $navmap->getResourceByUrl($map);
	my $result = $res->is_incomplete();
	return $result;
    } else {
	return 1;
    }
}
#
#  When printing for students, the resoures and order of the
#  resources may need to be altered if there are folders with
#  random selectiopn or random ordering (or both) enabled.
#  This sub computes the set of resources to print for a student
#  modified both by random ordering and selection and filtered
#  to only those that are in the original set selcted to be printed.
#
# Parameters:
#   $map - The URL of the folder being printed.
#          Used to determine which startResource and finishResource
#          to use when using the navmap's getIterator method.
#   $seq   - The original set of resources to print.
#            (really an array of resource names (array of symb's).
#   $who   - Student/domain for whome the sequence will be generated.
#   $code  - CODE being printed when printing Problems/Resources
#            from folder for CODEd assignments
#
# Implicit inputs:
#   $
# Returns:
#   reference to an array of resources that can be passed to
#   print_resources.
# 
sub master_seq_to_person_seq {
    my ($map, $seq, $who, $code, $nohidemap) = @_;


    my ($username, $userdomain, $usersection) = split(/:/, $who);

    # Toss the sequence up into a hash so that we have O(1) lookup time.
    # on the items that come out of the user's list of resources.
    #

    my %seq_hash = map {$_  => 1} @$seq;
    my @output_seq;

    my $unhidden;
    if ($perm{'pav'} && $perm{'vgr'} && $nohidemap) {
        $unhidden = &Apache::lonnet::clutter($map);
    }
    
    my $navmap           = Apache::lonnavmaps::navmap->new($username, $userdomain,
                                                           $code, $unhidden);
    my ($start,$finish);

    if ($map) {
        my $mapres = $navmap->getResourceByUrl($map);
        if ($mapres->is_map()) {
            $start = $mapres->map_start();
            $finish = $mapres->map_finish();
        }
    }
    unless ($start && $finish) {
        $start = $navmap->firstResource();
        $finish = $navmap->finishResource();
    }

    my $iterator         = $navmap->getIterator($start,$finish,{},1);

    #  Iterate on the resource..select the items that are randomly selected
    #  and that are in the seq_has.  Presumably the iterator will take care
    # of the random ordering part of the deal.
    #
    my $curres;
    while ($curres = $iterator->next()) {
	#
	#  Only process resources..that are not removed by randomout...
	#  and are selected for printint as well.
	#
        if (ref($curres) && ! $curres->randomout()) {
            my $currsymb = $curres->symb();
            if (exists($seq_hash{$currsymb})) {
                push(@output_seq, $currsymb);
	    }
	}
    }

    return \@output_seq;		# for now.
    
}


# Fetch the contents of a resource, uninterpreted.
# This is used here to fetch a latex file to be included
# verbatim into the printout<
# NOTE: Ask Guy if there is a lonnet function similar to this?
#
# Parameters:
#   URL of the file
#
sub fetch_raw_resource {
    my ($url) = @_;

    my $filename  = &Apache::lonnet::filelocation("", $url);
    my $contents  = &Apache::lonnet::getfile($filename);

    if ($contents == -1) {
	return "File open failed for $filename";      # This will bomb the print.
    }
    return $contents;

    
}

#  Fetch the annotations associated with a URL and 
#  put a centered 'annotations:' title.
#  This is all suppressed if the annotations are empty.
#
sub annotate {
    my ($symb) = @_;

    my $annotation_text = &Apache::loncommon::get_annotation($symb, 1);


    my $result = "";

    if (length($annotation_text) > 0) {
	$result .= '\\hspace*{\\fill} \\\\[\\baselineskip] \textbf{Annotations:} \\\\ ';
	$result .= "\n";
	$result .= &Apache::lonxml::latex_special_symbols($annotation_text,"");	# Escape latex.
	$result .= "\n\n";
    }
    return $result;
}

#
#   Set a global document font size:
#   This is done by replacing \begin{document}
#   with \begin{document}{\some-font-directive
#   and \end{document} with
#   }\end{document
#
sub set_font_size {

    my ($text) = @_;

    # There appear to be cases where the font directive is empty.. in which
    # case the first substituion would  insert a spurious \ oh happy day.
    # as this has been the cause of much mystery and hair pulling _sigh_

    if ($font_size ne '') {

	$text =~ s/\\begin{document}/\\begin{document}{\\$font_size/;
    }
    $text =~ s/\\end{document}/}\\end{document}/;
    return $text;


}

# include_pdf - PDF files are included into the 
# output as follows:
#  - The PDF, if necessary, is replicated.
#  - The PDF is added to the list of files to convert to postscript (along with the images).
#  - The LaTeX is added to include the final converted postscript in the file as an included
#    job.  The assumption is that the includedpsheader.ps header will be included.
#
# Parameters:
#   pdf_uri   - URI of the PDF file to include.
#   
# Returns:
#  The LaTeX to include.
#
# Assumptions:
#    The uri is actually a PDF file
#    The postscript will have the includepsheader.ps included.
#
#
sub include_pdf {
    my ($pdf_uri) = @_;

    # Where is the file? If not local we'll need to repcopy it:'

    my $file = &Apache::lonnet::filelocation('', $pdf_uri);
    if (! -e $file) {
	&Apache::lonnet::repcopy($file);
	$file = &Apache::lonnet::filelocation('',$pdf_uri);
    }

    #  The file isn ow replicated locally.. or it did not exist in the first place
    # (unlikely).  If it did exist, add the pdf to the set of files/images that
    # need tob e converted for this print job:

    my $londocroot = $Apache::lonnet::perlvar{'lonDocRoot'};
    $file =~ s{(.*)/res/}{$londocroot/res/};

    open(FILE,">>$Apache::lonnet::perlvar{'lonPrtDir'}/$env{'user.name'}_$env{'user.domain'}_printout.dat");
    print FILE ("$file\n");
    close (FILE);

    # Construct the special to put out.  To do this we need to get the
    # resulting filename after conversion.  The file will have the same name
    # but will be in the user's spool directory with converted images.

    my $dirname = "/home/httpd/prtspool/$env{'user.name'}/";
    my ( $base, $path,  $ext) = &fileparse($file, '.pdf');
#    my $destname = $dirname.'/'.$base.'.eps'; # Not really an eps but easier in printout.pl
    $base =~ s/ /\_/g;


    my $output = &print_latex_header();
    $output    .= '\special{ps: _begin_job_ ('
	.$base.'.pdf.eps'.
	')run _end_job_}';

    return $output;


}
##
#  Collect the various \select_language{language_name}
#  latex tags to build a \usepackage[lang-list]{babel} which will
#  appear just prior to the \begin{document} at the front of the concatenated
#  set of resources:
# @param doc - The string of latex to search/replace.
# @return string
# @retval - the modified document stringt.
#
sub collect_languages {
    my $doc = shift;
    my %languages;
    while ($doc =~ /\\selectlanguage{(\w+)}/mg) {
	$languages{$1} = 1;	# allows us to request each language exactly once.
    }
    my @lang_list = (keys(%languages)); # List of unique languages
    if (scalar @lang_list) {
	my $babel_header = '\usepackage[' . join(',', @lang_list) .']{babel}'. "\n";
	$doc =~ s/\\begin{document}/$babel_header\\begin{document}/;
    }
    return $doc;
}
#-------------------------------------------------------------------

#
#   ssi_with_retries- Does the server side include of a resource.
#                      if the ssi call returns an error we'll retry it up to
#                      the number of times requested by the caller.
#                      If we still have a proble, no text is appended to the
#                      output and we set some global variables.
#                      to indicate to the caller an SSI error occurred.  
#                      All of this is supposed to deal with the issues described
#                      in LonCAPA BZ 5631 see:
#                      http://bugs.lon-capa.org/show_bug.cgi?id=5631
#                      by informing the user that this happened.
#
# Parameters:
#   resource   - The resource to include.  This is passed directly, without
#                interpretation to lonnet::ssi.
#   form       - The form hash parameters that guide the interpretation of the resource
#                
#   retries    - Number of retries allowed before giving up completely.
# Returns:
#   On success, returns the rendered resource identified by the resource parameter.
# Side Effects:
#   The following global variables can be set:
#    ssi_error                - If an unrecoverable error occurred this becomes true.
#                               It is up to the caller to initialize this to false
#                               if desired.
#    ssi_last_error_resource  - If an unrecoverable error occurred, this is the value
#                               of the resource that could not be rendered by the ssi
#                               call.
#    ssi_last_error           - The error string fetched from the ssi response
#                               in the event of an error.
#
sub ssi_with_retries {
    my ($resource, $retries, %form) = @_;

    my $target = $form{'grade_target'};
    my $aom    = $form{'answer_output_mode'};



    my ($content, $response) = &Apache::loncommon::ssi_with_retries($resource, $retries, %form);
    if (!$response->is_success) {
	$ssi_error               = 1;
	$ssi_last_error_resource = $resource;
	$ssi_last_error          = $response->code . " " . $response->message;
        $content='\section*{!!! An error occurred !!!}';	
    }

    return $content;

}

sub get_student_view_with_retries {
    my ($curresline,$retries,$username,$userdomain,$courseid,$target,$moreenv)=@_;

    my ($content, $response) = &Apache::loncommon::get_student_view_with_retries($curresline,$retries,$username,$userdomain,$courseid,$target,$moreenv);
    if (!$response->is_success) {
        $ssi_error               = 1;
        $ssi_last_error_resource = $curresline.' for user '.$username.':'.$userdomain;
        $ssi_last_error          = $response->code . " " . $response->message;
        $content='\section*{!!! An error occurred !!!}';
    }
    return $content;

}

#
#   printf_style_subst  item format_string repl
#  
# Does printf style substitution for a format string that
# can have %[n]item in it.. wherever, %[n]item occurs,
# rep is substituted in format_string.  Note that
# [n] is an optional integer length.  If provided,
# repl is truncated to at most [n] characters prior to 
# substitution.
#
sub printf_style_subst {
    my ($item, $format_string, $repl) = @_;
    my $result = "";
    while ($format_string =~ /(%)(\d*)\Q$item\E/g ) {
	my $fmt = $1;
	my $size = $2;
	my $subst = $repl;
	if ($size ne "") {
	    $subst = substr($subst, 0, $size);
	    
	    #  Here's a nice edge case.. supose the end of the
	    #  substring is a \.  In that case may have  just
	    #  chopped off a TeX escape... in that case, we append
	    #   " " for the trailing character, and let the field 
	    #  spill over a bit (sigh).
	    #  We don't just chop off the last character in order to deal
	    #  with one last pathology, and that would be if substr had
	    #  trimmed us to e.g. \\\  


	    if ($subst =~ /\\$/) {
		$subst .= " ";
	    }
	}
	my $item_pos = pos($format_string);
	$result .= substr($format_string, 0, $item_pos - length($size) -2) . $subst;
        $format_string = substr($format_string, pos($format_string));
    }

    # Put the residual format string into the result:

    $result .= $format_string;

    return $result;
}


# Format a header according to a format.  
# 

# Substitutions:
#     %a    - Assignment name.
#     %c    - Course name.
#     %n    - Student name.
#     %s    - The section if it is supplied.
#
sub format_page_header {
    my ($width, $format, $assignment, $course, $student, $section) = @_;



    $width = &recalcto_mm($width); # Get width in mm.
    my $chars_per_line = int($width/1.6);   # Character/textline.

    #  Default format?

    if ($format eq '') {
	# For the default format, we may need to truncate
	# elements..  To do this we need to get the page width.
	# we assume that each character is about 2mm in width.
	# (correct for the header text size??).  We ignore
	# any formatting (e.g. boldfacing in this).
	# 
	# - Allow the student/course to be one line.
	#   but only truncate the course.
	# - Allow the assignment to be 2 lines (wrapped).
	#

	

	my $name_length    = int($chars_per_line *3 /4);
	my $sec_length     = int($chars_per_line / 5);

	$format  = "%$name_length".'n';

	if ($section) {
	    $format .=  ' - Sec: '."%$sec_length".'s';
	}

	$format .= '\\\\%c \\\\ %a';
        

    }
    # An open question is how to handle long user formatted page headers...
    # A possible future is to support e.g. %na so that the user can control
    # the truncation of the elements that can appear in the header.
    #
    $format =  &printf_style_subst("a", $format, $assignment);
    $format =  &printf_style_subst("c", $format, $course);
    $format =  &printf_style_subst("n", $format, $student);
    $format =  &printf_style_subst("s", $format, $section);
    
    
    # If the user put %'s in the format string, they  must be escaped
    # to \% else LaTeX will think they are comments and terminate
    # the line.. which is bad!!!
    
    # If the user has role author, $course and $assignment are empty so
    # there is '\\ \\ ' in the page header. That's cause a error in LaTeX
    if($format =~ /\\\\\s\\\\\s/) {
        #TODO find sensible caption for page header
        my $testPrintout = '\\\\'.&mt('Authoring Space').' \\\\'.&mt('Test-Printout ');
        $format =~ s/\\\\\s\\\\\s/$testPrintout/;
    }
    #
    #  We're going to trust LaTeX to break lines appropriately, but
    #  we'll truncate anything that's more than 3 lines worth of
    # text.  This is also assuming (which will probably end badly)
    # nobody's going to embed LaTeX control sequences in the title
    # header or rather that those control sequences won't get broken
    # by the stuff below.
    #
    my $total_length = 3*$chars_per_line;
    if (length($format) > $total_length) {
	$format = substr($format, 0, $total_length);
    }


    return $format;
    
}

#
#   Convert a numeric code to letters
#
sub num_to_letters {
    my ($num) = @_;
    my @nums= split('',$num);
    my @num_to_let=('A'..'Z');
    my $word;
    foreach my $digit (@nums) { $word.=$num_to_let[$digit]; }
    return $word;
}
#   Convert a letter code to numeric.
#
sub letters_to_num {
    my ($letters) = @_;
    my @letters = split('', uc($letters));
   my %substitution;
    my $digit = 0;
    foreach my $letter ('A'..'J') {
	$substitution{$letter} = $digit;
	$digit++;
    }
    #  The substitution is done as below to preserve leading
    #  zeroes which are needed to keep the code size exact
    #
    my $result ="";
    foreach my $letter (@letters) {
	$result.=$substitution{$letter};
    }
    return $result;
}

#  Determine if a code is a valid numeric code.  Valid
#  numeric codes must be comprised entirely of digits and
#  have a correct number of digits.
#
#  Parameters:
#     value      - proposed code value.
#     num_digits - Number of digits required.
#
sub is_valid_numeric_code {
    my ($value, $num_digits) = @_;
    #   Remove leading/trailing whitespace;
    $value =~ s/^\s*//g;
    $value =~ s/\s*$//g;
    
    #  All digits?
    if ($value !~ /^[0-9]+$/) {
	return "Numeric code $value has invalid characters - must only be digits";
    }
    if (length($value) != $num_digits) {
	return "Numeric code $value incorrect number of digits (correct = $num_digits)";
    }
    return undef;
}
#   Determines if a code is a valid alhpa code.  Alpha codes
#   are ciphers that map  [A-J,a-j] -> 0..9 0..9.
#   They also have a correct digit count.
# Parameters:
#     value          - Proposed code value.
#     num_letters    - correct number of letters.
# Note:
#    leading and trailing whitespace are ignored.
#
sub is_valid_alpha_code {
    my ($value, $num_letters) = @_;
    
     # strip leading and trailing spaces.

    $value =~ s/^\s*//g;
    $value =~ s/\s*$//g;

    #  All alphas in the right range?
    if ($value !~ /^[A-J,a-j]+$/) {
	return "Invalid letter code $value must only contain A-J";
    }
    if (length($value) != $num_letters) {
	return "Letter code $value has incorrect number of letters (correct = $num_letters)";
    }
    return undef;
}

#   Determine if a code entered by the user in a helper is valid.
#   valid depends on the code type and the type of code selected.
#   The type of code selected can either be numeric or 
#   Alphabetic.  If alphabetic, the code, in fact is a simple
#   substitution cipher for the actual numeric code: 0->A, 1->B ...
#   We'll be nice and be case insensitive for alpha codes.
# Parameters:
#    code_value    - the value of the code the user typed in.
#    code_option   - The code type selected from the set in the scantron format
#                    table.
# Returns:
#    undef         - The code is valid.
#    other         - An error message indicating what's wrong.
#
sub is_code_valid {
    my ($code_value, $code_option) = @_;
    my ($code_type, $code_length) = ('letter', 6);	# defaults.
    my @lines = &Apache::grades::get_scantronformat_file();
    foreach my $line (@lines) {
	my ($name, $type, $length) = (split(/:/, $line))[0,2,4];
	if($name eq $code_option) {
	    $code_length = $length;
	    if($type eq 'number') {
		$code_type = 'number';
	    }
	}
    }
    my $valid;
    if ($code_type eq 'number') {
	return &is_valid_numeric_code($code_value, $code_length);
    } else {
	return &is_valid_alpha_code($code_value, $code_length);
    }

}
#
# Compare two students by section (Used to sort by section).
#
#  Implicit inputs, 
#    $a - The first one
#    $b - The second one.
#
#  Returns:
#     a-section cmp b-section
#
sub compare_sections {
    my ($u1, $d1, $s1, $n1, $stat1) = split(/:/, $a);
    my ($u2, $d2, $s2, $n2, $stat2) = split(/:/, $b);

    return $s1 cmp $s2;
}

#   Compare two students by name.  The students are in the form
#   returned by the helper:
#      user:domain:section:last,   first:status
#   This is a helper function for the perl sort built-in  therefore:
# Implicit Inputs:
#    $a     - The first element to compare (global)
#    $b     - The second element to compare (global)
# Returns:
#   -1   - $a < $b
#    0   - $a == $b
#   +1   - $a > $b
#   Note that the initial comparison is done on the last names with the
#   first names only used to break the tie.
#
#
sub compare_names {
    #  First split the names up into the primary fields.

    my ($u1, $d1, $s1, $n1, $stat1) = split(/:/, $a);
    my ($u2, $d2, $s2, $n2, $stat2) = split(/:/, $b);

    # Now split the last name and first name of each n:
    #

    my ($l1,$f1) = split(/,/, $n1);
    my ($l2,$f2) = split(/,/, $n2);

    # We don't bother to remove the leading/trailing whitespace from the
    # firstname, unless the last names compare identical.

    if($l1 lt $l2) {
	return -1;
    }
    if($l1 gt $l2) {
	return  1;
    }

    # Break the tie on the first name, but there are leading (possibly trailing
    # whitespaces to get rid of first 
    #
    $f1 =~ s/^\s+//;		# Remove leading...
    $f1 =~ s/\s+$//;		# Trailing spaces from first 1...
    
    $f2 =~ s/^\s+//;
    $f2 =~ s/\s+$//;		# And the same for first 2...

    if($f1 lt $f2) {
	return -1;
    }
    if($f1 gt $f2) {
	return 1;
    }
    
    #  Must be the same name.

    return 0;
}

sub latex_header_footer_remove {
    my $text = shift;
    $text =~ s/\\end{document}//;
    $text =~ s/\\documentclass([^&]*)\\begin{document}//;
    return $text;
}
#
#  If necessary, encapsulate text inside 
#  a minipage env.
#  necessity is determined by the problem_split param.
#
sub encapsulate_minipage {
    my ($text) = @_;
    if (!($env{'form.problem.split'} =~ /yes/i)) {
	$text = '\begin{minipage}{\textwidth}'.$text.'\end{minipage}';
    }
    return $text;
}
#
#  The NUMBER_TO_PRINT and SPLIT_PDFS
#  variables interact, this sub looks at these two parameters
#  and comes up with a final value for NUMBER_TO_PRINT which can be:
#     all     - if SPLIT_PDFS eq 'all'.
#     1       - if SPLIT_PDFS eq 'oneper'
#     section - if SPLIT_PDFS eq 'sections'
#     <unchanged> - if SPLIT_PDFS eq 'usenumber'
#
sub adjust_number_to_print {
    my $helper = shift;

    my $split_pdf = $helper->{'VARS'}->{'SPLIT_PDFS'};
    
    if ($split_pdf eq 'all') {
	$helper->{'VARS'}->{'NUMBER_TO_PRINT'} = 'all';
    } elsif ($split_pdf eq 'oneper') {
	$helper->{'VARS'}->{'NUMBER_TO_PRINT'} = 1;
    } elsif ($split_pdf eq 'sections') {
	$helper->{'VARS'}->{'NUMBER_TO_PRINT'} = 'section';
    } elsif ($split_pdf eq 'usenumber') {
	#  Unmodified.
    } else {
	# Error!!!!
	
	croak "bad SPLIT_PDFS: $split_pdf in lonprintout::adjust_number_to_print";

    }
}


sub character_chart {
    my $result = shift;
    return  &Apache::entities::replace_entities($result);
}

sub old_character_chart {
    my $result = shift;	
    $result =~ s/&\#0?0?(7|9);//g;
    $result =~ s/&\#0?(10|13);//g;
    $result =~ s/&\#0?32;/ /g;
    $result =~ s/&\#0?33;/!/g;
    $result =~ s/&(\#0?34|quot);/\"/g;
    $result =~ s/&\#0?35;/\\\#/g;
    $result =~ s/&\#0?36;/\\\$/g;
    $result =~ s/&\#0?37;/\\%/g; 
    $result =~ s/&(\#0?38|amp);/\\&/g; 
    $result =~ s/&\#(0?39|146);/\'/g;
    $result =~ s/&\#0?40;/(/g;
    $result =~ s/&\#0?41;/)/g;
    $result =~ s/&\#0?42;/\*/g;
    $result =~ s/&\#0?43;/\+/g;
    $result =~ s/&\#(0?44|130);/,/g;
    $result =~ s/&\#0?45;/-/g;
    $result =~ s/&\#0?46;/\./g;
    $result =~ s/&\#0?47;/\//g;
    $result =~ s/&\#0?48;/0/g;
    $result =~ s/&\#0?49;/1/g;
    $result =~ s/&\#0?50;/2/g;
    $result =~ s/&\#0?51;/3/g;
    $result =~ s/&\#0?52;/4/g;
    $result =~ s/&\#0?53;/5/g;
    $result =~ s/&\#0?54;/6/g;
    $result =~ s/&\#0?55;/7/g;
    $result =~ s/&\#0?56;/8/g;
    $result =~ s/&\#0?57;/9/g;
    $result =~ s/&\#0?58;/:/g;
    $result =~ s/&\#0?59;/;/g;
    $result =~ s/&(\#0?60|lt|\#139);/\$<\$/g;
    $result =~ s/&\#0?61;/\\ensuremath\{=\}/g;
    $result =~ s/&(\#0?62|gt|\#155);/\\ensuremath\{>\}/g;
    $result =~ s/&\#0?63;/\?/g;
    $result =~ s/&\#0?65;/A/g;
    $result =~ s/&\#0?66;/B/g;
    $result =~ s/&\#0?67;/C/g;
    $result =~ s/&\#0?68;/D/g;
    $result =~ s/&\#0?69;/E/g;
    $result =~ s/&\#0?70;/F/g;
    $result =~ s/&\#0?71;/G/g;
    $result =~ s/&\#0?72;/H/g;
    $result =~ s/&\#0?73;/I/g;
    $result =~ s/&\#0?74;/J/g;
    $result =~ s/&\#0?75;/K/g;
    $result =~ s/&\#0?76;/L/g;
    $result =~ s/&\#0?77;/M/g;
    $result =~ s/&\#0?78;/N/g;
    $result =~ s/&\#0?79;/O/g;
    $result =~ s/&\#0?80;/P/g;
    $result =~ s/&\#0?81;/Q/g;
    $result =~ s/&\#0?82;/R/g;
    $result =~ s/&\#0?83;/S/g;
    $result =~ s/&\#0?84;/T/g;
    $result =~ s/&\#0?85;/U/g;
    $result =~ s/&\#0?86;/V/g;
    $result =~ s/&\#0?87;/W/g;
    $result =~ s/&\#0?88;/X/g;
    $result =~ s/&\#0?89;/Y/g;
    $result =~ s/&\#0?90;/Z/g;
    $result =~ s/&\#0?91;/[/g;
    $result =~ s/&\#0?92;/\\ensuremath\{\\setminus\}/g;
    $result =~ s/&\#0?93;/]/g;
    $result =~ s/&\#(0?94|136);/\\ensuremath\{\\wedge\}/g;
    $result =~ s/&\#(0?95|138|154);/\\underline{\\makebox[2mm]{\\strut}}/g;
    $result =~ s/&\#(0?96|145);/\`/g;
    $result =~ s/&\#0?97;/a/g;
    $result =~ s/&\#0?98;/b/g;
    $result =~ s/&\#0?99;/c/g;
    $result =~ s/&\#100;/d/g;
    $result =~ s/&\#101;/e/g;
    $result =~ s/&\#102;/f/g;
    $result =~ s/&\#103;/g/g;
    $result =~ s/&\#104;/h/g;
    $result =~ s/&\#105;/i/g;
    $result =~ s/&\#106;/j/g;
    $result =~ s/&\#107;/k/g;
    $result =~ s/&\#108;/l/g;
    $result =~ s/&\#109;/m/g;
    $result =~ s/&\#110;/n/g;
    $result =~ s/&\#111;/o/g;
    $result =~ s/&\#112;/p/g;
    $result =~ s/&\#113;/q/g;
    $result =~ s/&\#114;/r/g;
    $result =~ s/&\#115;/s/g;
    $result =~ s/&\#116;/t/g;
    $result =~ s/&\#117;/u/g;
    $result =~ s/&\#118;/v/g;
    $result =~ s/&\#119;/w/g;
    $result =~ s/&\#120;/x/g;
    $result =~ s/&\#121;/y/g;
    $result =~ s/&\#122;/z/g;
    $result =~ s/&\#123;/\\{/g;
    $result =~ s/&\#124;/\|/g;
    $result =~ s/&\#125;/\\}/g;
    $result =~ s/&\#126;/\~/g;
    $result =~ s/&\#131;/\\textflorin /g;
    $result =~ s/&\#132;/\"/g;
    $result =~ s/&\#133;/\\ensuremath\{\\ldots\}/g;
    $result =~ s/&\#134;/\\ensuremath\{\\dagger\}/g;
    $result =~ s/&\#135;/\\ensuremath\{\\ddagger\}/g;
    $result =~ s/&\#137;/\\textperthousand /g;
    $result =~ s/&\#140;/{\\OE}/g;
    $result =~ s/&\#147;/\`\`/g;
    $result =~ s/&\#148;/\'\'/g;
    $result =~ s/&\#149;/\\ensuremath\{\\bullet\}/g;
    $result =~ s/&(\#150|\#8211);/--/g;
    $result =~ s/&\#151;/---/g;
    $result =~ s/&\#152;/\\ensuremath\{\\sim\}/g;
    $result =~ s/&\#153;/\\texttrademark /g;
    $result =~ s/&\#156;/\\oe/g;
    $result =~ s/&\#159;/\\\"Y/g;
    $result =~ s/&(\#160|nbsp);/~/g;
    $result =~ s/&(\#161|iexcl);/!\`/g;
    $result =~ s/&(\#162|cent);/\\textcent /g;
    $result =~ s/&(\#163|pound);/\\pounds /g; 
    $result =~ s/&(\#164|curren);/\\textcurrency /g;
    $result =~ s/&(\#165|yen);/\\textyen /g;
    $result =~ s/&(\#166|brvbar);/\\textbrokenbar /g;
    $result =~ s/&(\#167|sect);/\\textsection /g;
    $result =~ s/&(\#168|uml);/\\"\{\} /g;
    $result =~ s/&(\#169|copy);/\\copyright /g;
    $result =~ s/&(\#170|ordf);/\\textordfeminine /g;
    $result =~ s/&(\#172|not);/\\ensuremath\{\\neg\}/g;
    $result =~ s/&(\#173|shy);/ - /g;
    $result =~ s/&(\#174|reg);/\\textregistered /g;
    $result =~ s/&(\#175|macr);/\\ensuremath\{^{-}\}/g;
    $result =~ s/&(\#176|deg);/\\ensuremath\{^{\\circ}\}/g;
    $result =~ s/&(\#177|plusmn);/\\ensuremath\{\\pm\}/g;
    $result =~ s/&(\#178|sup2);/\\ensuremath\{^2\}/g;
    $result =~ s/&(\#179|sup3);/\\ensuremath\{^3\}/g;
    $result =~ s/&(\#180|acute);/\\'\{\} /g;
    $result =~ s/&(\#181|micro);/\\ensuremath\{\\mu\}/g;
    $result =~ s/&(\#182|para);/\\P/g;
    $result =~ s/&(\#183|middot);/\\ensuremath\{\\cdot\}/g;
    $result =~ s/&(\#184|cedil);/\\c{\\strut}/g;
    $result =~ s/&(\#185|sup1);/\\ensuremath\{^1\}/g;
    $result =~ s/&(\#186|ordm);/\\textordmasculine /g;
    $result =~ s/&(\#188|frac14);/\\textonequarter /g;
    $result =~ s/&(\#189|frac12);/\\textonehalf /g;
    $result =~ s/&(\#190|frac34);/\\textthreequarters /g;
    $result =~ s/&(\#191|iquest);/?\`/g;   
    $result =~ s/&(\#192|Agrave);/\\\`{A}/g;  
    $result =~ s/&(\#193|Aacute);/\\\'{A}/g; 
    $result =~ s/&(\#194|Acirc);/\\^{A}/g;
    $result =~ s/&(\#195|Atilde);/\\~{A}/g;
    $result =~ s/&(\#196|Auml);/\\\"{A}/g; 
    $result =~ s/&(\#197|Aring);/{\\AA}/g;
    $result =~ s/&(\#198|AElig);/{\\AE}/g;
    $result =~ s/&(\#199|Ccedil);/\\c{c}/g;
    $result =~ s/&(\#200|Egrave);/\\\`{E}/g;  
    $result =~ s/&(\#201|Eacute);/\\\'{E}/g;    
    $result =~ s/&(\#202|Ecirc);/\\^{E}/g;
    $result =~ s/&(\#203|Euml);/\\\"{E}/g;
    $result =~ s/&(\#204|Igrave);/\\\`{I}/g;
    $result =~ s/&(\#205|Iacute);/\\\'{I}/g;    
    $result =~ s/&(\#206|Icirc);/\\^{I}/g;
    $result =~ s/&(\#207|Iuml);/\\\"{I}/g;    
    $result =~ s/&(\#209|Ntilde);/\\~{N}/g;
    $result =~ s/&(\#210|Ograve);/\\\`{O}/g;
    $result =~ s/&(\#211|Oacute);/\\\'{O}/g;
    $result =~ s/&(\#212|Ocirc);/\\^{O}/g;
    $result =~ s/&(\#213|Otilde);/\\~{O}/g;
    $result =~ s/&(\#214|Ouml);/\\\"{O}/g;    
    $result =~ s/&(\#215|times);/\\ensuremath\{\\times\}/g;
    $result =~ s/&(\#216|Oslash);/{\\O}/g;
    $result =~ s/&(\#217|Ugrave);/\\\`{U}/g;    
    $result =~ s/&(\#218|Uacute);/\\\'{U}/g;
    $result =~ s/&(\#219|Ucirc);/\\^{U}/g;
    $result =~ s/&(\#220|Uuml);/\\\"{U}/g;
    $result =~ s/&(\#221|Yacute);/\\\'{Y}/g;
    $result =~ s/&(\#223|szlig);/{\\ss}/g;
    $result =~ s/&(\#224|agrave);/\\\`{a}/g;
    $result =~ s/&(\#225|aacute);/\\\'{a}/g;
    $result =~ s/&(\#226|acirc);/\\^{a}/g;
    $result =~ s/&(\#227|atilde);/\\~{a}/g;
    $result =~ s/&(\#228|auml);/\\\"{a}/g;
    $result =~ s/&(\#229|aring);/{\\aa}/g;
    $result =~ s/&(\#230|aelig);/{\\ae}/g;
    $result =~ s/&(\#231|ccedil);/\\c{c}/g;
    $result =~ s/&(\#232|egrave);/\\\`{e}/g;
    $result =~ s/&(\#233|eacute);/\\\'{e}/g;
    $result =~ s/&(\#234|ecirc);/\\^{e}/g;
    $result =~ s/&(\#235|euml);/\\\"{e}/g;
    $result =~ s/&(\#236|igrave);/\\\`{i}/g;
    $result =~ s/&(\#237|iacute);/\\\'{i}/g;
    $result =~ s/&(\#238|icirc);/\\^{i}/g;
    $result =~ s/&(\#239|iuml);/\\\"{i}/g;
    $result =~ s/&(\#240|eth);/\\ensuremath\{\\partial\}/g;
    $result =~ s/&(\#241|ntilde);/\\~{n}/g;
    $result =~ s/&(\#242|ograve);/\\\`{o}/g;
    $result =~ s/&(\#243|oacute);/\\\'{o}/g;
    $result =~ s/&(\#244|ocirc);/\\^{o}/g;
    $result =~ s/&(\#245|otilde);/\\~{o}/g;
    $result =~ s/&(\#246|ouml);/\\\"{o}/g;
    $result =~ s/&(\#247|divide);/\\ensuremath\{\\div\}/g;
    $result =~ s/&(\#248|oslash);/{\\o}/g;
    $result =~ s/&(\#249|ugrave);/\\\`{u}/g; 
    $result =~ s/&(\#250|uacute);/\\\'{u}/g;
    $result =~ s/&(\#251|ucirc);/\\^{u}/g;
    $result =~ s/&(\#252|uuml);/\\\"{u}/g;
    $result =~ s/&(\#253|yacute);/\\\'{y}/g;
    $result =~ s/&(\#255|yuml);/\\\"{y}/g;
    $result =~ s/&\#295;/\\ensuremath\{\\hbar\}/g;
    $result =~ s/&\#952;/\\ensuremath\{\\theta\}/g;
#Greek Alphabet
    $result =~ s/&(alpha|\#945);/\\ensuremath\{\\alpha\}/g;
    $result =~ s/&(beta|\#946);/\\ensuremath\{\\beta\}/g;
    $result =~ s/&(gamma|\#947);/\\ensuremath\{\\gamma\}/g;
    $result =~ s/&(delta|\#948);/\\ensuremath\{\\delta\}/g;
    $result =~ s/&(epsilon|\#949);/\\ensuremath\{\\epsilon\}/g;
    $result =~ s/&(zeta|\#950);/\\ensuremath\{\\zeta\}/g;
    $result =~ s/&(eta|\#951);/\\ensuremath\{\\eta\}/g;
    $result =~ s/&(theta|\#952);/\\ensuremath\{\\theta\}/g;
    $result =~ s/&(iota|\#953);/\\ensuremath\{\\iota\}/g;
    $result =~ s/&(kappa|\#954);/\\ensuremath\{\\kappa\}/g;
    $result =~ s/&(lambda|\#955);/\\ensuremath\{\\lambda\}/g;
    $result =~ s/&(mu|\#956);/\\ensuremath\{\\mu\}/g;
    $result =~ s/&(nu|\#957);/\\ensuremath\{\\nu\}/g;
    $result =~ s/&(xi|\#958);/\\ensuremath\{\\xi\}/g;
    $result =~ s/&(omicron|\#959);/o/g;
    $result =~ s/&(pi|\#960);/\\ensuremath\{\\pi\}/g;
    $result =~ s/&(rho|\#961);/\\ensuremath\{\\rho\}/g;
    $result =~ s/&(sigma|\#963);/\\ensuremath\{\\sigma\}/g;
    $result =~ s/&(tau|\#964);/\\ensuremath\{\\tau\}/g;
    $result =~ s/&(upsilon|\#965);/\\ensuremath\{\\upsilon\}/g;
    $result =~ s/&(phi|\#966);/\\ensuremath\{\\phi\}/g;
    $result =~ s/&(chi|\#967);/\\ensuremath\{\\chi\}/g;
    $result =~ s/&(psi|\#968);/\\ensuremath\{\\psi\}/g;
    $result =~ s/&(omega|\#969);/\\ensuremath\{\\omega\}/g;
    $result =~ s/&(thetasym|\#977);/\\ensuremath\{\\vartheta\}/g;
    $result =~ s/&(piv|\#982);/\\ensuremath\{\\varpi\}/g;
    $result =~ s/&(Alpha|\#913);/A/g;
    $result =~ s/&(Beta|\#914);/B/g;
    $result =~ s/&(Gamma|\#915);/\\ensuremath\{\\Gamma\}/g;
    $result =~ s/&(Delta|\#916);/\\ensuremath\{\\Delta\}/g;
    $result =~ s/&(Epsilon|\#917);/E/g;
    $result =~ s/&(Zeta|\#918);/Z/g;
    $result =~ s/&(Eta|\#919);/H/g;
    $result =~ s/&(Theta|\#920);/\\ensuremath\{\\Theta\}/g;
    $result =~ s/&(Iota|\#921);/I/g;
    $result =~ s/&(Kappa|\#922);/K/g;
    $result =~ s/&(Lambda|\#923);/\\ensuremath\{\\Lambda\}/g;
    $result =~ s/&(Mu|\#924);/M/g;
    $result =~ s/&(Nu|\#925);/N/g;
    $result =~ s/&(Xi|\#926);/\\ensuremath\{\\Xi\}/g;
    $result =~ s/&(Omicron|\#927);/O/g;
    $result =~ s/&(Pi|\#928);/\\ensuremath\{\\Pi\}/g;
    $result =~ s/&(Rho|\#929);/P/g;
    $result =~ s/&(Sigma|\#931);/\\ensuremath\{\\Sigma\}/g;
    $result =~ s/&(Tau|\#932);/T/g;
    $result =~ s/&(Upsilon|\#933);/\\ensuremath\{\\Upsilon\}/g;
    $result =~ s/&(Phi|\#934);/\\ensuremath\{\\Phi\}/g;
    $result =~ s/&(Chi|\#935);/X/g;
    $result =~ s/&(Psi|\#936);/\\ensuremath\{\\Psi\}/g;
    $result =~ s/&(Omega|\#937);/\\ensuremath\{\\Omega\}/g;
#Arrows (extended HTML 4.01)
    $result =~ s/&(larr|\#8592);/\\ensuremath\{\\leftarrow\}/g;
    $result =~ s/&(uarr|\#8593);/\\ensuremath\{\\uparrow\}/g;
    $result =~ s/&(rarr|\#8594);/\\ensuremath\{\\rightarrow\}/g;
    $result =~ s/&(darr|\#8595);/\\ensuremath\{\\downarrow\}/g;
    $result =~ s/&(harr|\#8596);/\\ensuremath\{\\leftrightarrow\}/g;
    $result =~ s/&(lArr|\#8656);/\\ensuremath\{\\Leftarrow\}/g;
    $result =~ s/&(uArr|\#8657);/\\ensuremath\{\\Uparrow\}/g;
    $result =~ s/&(rArr|\#8658);/\\ensuremath\{\\Rightarrow\}/g;
    $result =~ s/&(dArr|\#8659);/\\ensuremath\{\\Downarrow\}/g;
    $result =~ s/&(hArr|\#8660);/\\ensuremath\{\\Leftrightarrow\}/g;
#Mathematical Operators (extended HTML 4.01)
    $result =~ s/&(forall|\#8704);/\\ensuremath\{\\forall\}/g;
    $result =~ s/&(part|\#8706);/\\ensuremath\{\\partial\}/g;
    $result =~ s/&(exist|\#8707);/\\ensuremath\{\\exists\}/g;
    $result =~ s/&(empty|\#8709);/\\ensuremath\{\\emptyset\}/g;
    $result =~ s/&(nabla|\#8711);/\\ensuremath\{\\nabla\}/g;
    $result =~ s/&(isin|\#8712);/\\ensuremath\{\\in\}/g;
    $result =~ s/&(notin|\#8713);/\\ensuremath\{\\notin\}/g;
    $result =~ s/&(ni|\#8715);/\\ensuremath\{\\ni\}/g;
    $result =~ s/&(prod|\#8719);/\\ensuremath\{\\prod\}/g;
    $result =~ s/&(sum|\#8721);/\\ensuremath\{\\sum\}/g;
    $result =~ s/&(minus|\#8722);/\\ensuremath\{-\}/g;
    $result =~ s/–/\\ensuremath\{-\}/g;
    $result =~ s/&(lowast|\#8727);/\\ensuremath\{*\}/g;
    $result =~ s/&(radic|\#8730);/\\ensuremath\{\\surd\}/g;
    $result =~ s/&(prop|\#8733);/\\ensuremath\{\\propto\}/g;
    $result =~ s/&(infin|\#8734);/\\ensuremath\{\\infty\}/g;
    $result =~ s/&(ang|\#8736);/\\ensuremath\{\\angle\}/g;
    $result =~ s/&(and|\#8743);/\\ensuremath\{\\wedge\}/g;
    $result =~ s/&(or|\#8744);/\\ensuremath\{\\vee\}/g;
    $result =~ s/&(cap|\#8745);/\\ensuremath\{\\cap\}/g;
    $result =~ s/&(cup|\#8746);/\\ensuremath\{\\cup\}/g;
    $result =~ s/&(int|\#8747);/\\ensuremath\{\\int\}/g;
    $result =~ s/&(sim|\#8764);/\\ensuremath\{\\sim\}/g;
    $result =~ s/&(cong|\#8773);/\\ensuremath\{\\cong\}/g;
    $result =~ s/&(asymp|\#8776);/\\ensuremath\{\\approx\}/g;
    $result =~ s/&(ne|\#8800);/\\ensuremath\{\\not=\}/g;
    $result =~ s/&(equiv|\#8801);/\\ensuremath\{\\equiv\}/g;
    $result =~ s/&(le|\#8804);/\\ensuremath\{\\leq\}/g;
    $result =~ s/&(ge|\#8805);/\\ensuremath\{\\geq\}/g;
    $result =~ s/&(sub|\#8834);/\\ensuremath\{\\subset\}/g;
    $result =~ s/&(sup|\#8835);/\\ensuremath\{\\supset\}/g;
    $result =~ s/&(nsub|\#8836);/\\ensuremath\{\\not\\subset\}/g;
    $result =~ s/&(sube|\#8838);/\\ensuremath\{\\subseteq\}/g;
    $result =~ s/&(supe|\#8839);/\\ensuremath\{\\supseteq\}/g;
    $result =~ s/&(oplus|\#8853);/\\ensuremath\{\\oplus\}/g;
    $result =~ s/&(otimes|\#8855);/\\ensuremath\{\\otimes\}/g;
    $result =~ s/&(perp|\#8869);/\\ensuremath\{\\perp\}/g;
    $result =~ s/&(sdot|\#8901);/\\ensuremath\{\\cdot\}/g;
#Geometric Shapes (extended HTML 4.01)
    $result =~ s/&(loz|\#9674);/\\ensuremath\{\\Diamond\}/g;
#Miscellaneous Symbols (extended HTML 4.01)
    $result =~ s/&(spades|\#9824);/\\ensuremath\{\\spadesuit\}/g;
    $result =~ s/&(clubs|\#9827);/\\ensuremath\{\\clubsuit\}/g;
    $result =~ s/&(hearts|\#9829);/\\ensuremath\{\\heartsuit\}/g;
    $result =~ s/&(diams|\#9830);/\\ensuremath\{\\diamondsuit\}/g;
#   Chemically useful 'things' contributed by Hon Kie (bug 4652).

    $result =~ s/&\#8636;/\\ensuremath\{\\leftharpoonup\}/g;
    $result =~ s/&\#8637;/\\ensuremath\{\\leftharpoondown\}/g;
    $result =~ s/&\#8640;/\\ensuremath\{\\rightharpoonup\}/g;
    $result =~ s/&\#8641;/\\ensuremath\{\\rightharpoondown\}/g;
    $result =~ s/&\#8652;/\\ensuremath\{\\rightleftharpoons\}/g;
    $result =~ s/&\#8605;/\\ensuremath\{\\leadsto\}/g;
    $result =~ s/&\#8617;/\\ensuremath\{\\hookleftarrow\}/g;
    $result =~ s/&\#8618;/\\ensuremath\{\\hookrightarrow\}/g;
    $result =~ s/&\#8614;/\\ensuremath\{\\mapsto\}/g;
    $result =~ s/&\#8599;/\\ensuremath\{\\nearrow\}/g;
    $result =~ s/&\#8600;/\\ensuremath\{\\searrow\}/g;
    $result =~ s/&\#8601;/\\ensuremath\{\\swarrow\}/g;
    $result =~ s/&\#8598;/\\ensuremath\{\\nwarrow\}/g;

    # Left/right quotations:

    $result =~ s/&(ldquo|#8220);/\`\`/g;
    $result =~ s/&(rdquo|#8221);/\'\'/g;



    return $result;
}


                  #width, height, oddsidemargin, evensidemargin, topmargin
my %page_formats=
    ('letter' => {
	 'book' => {
	     '1' => [ '7.1 in','9.8 in', '-0.57 in','-0.57 in','0.275 in'],
	     '2' => ['3.66 in','9.8 in', '-0.57 in','-0.57 in','0.275 in']
	 },
	 'album' => {
	     '1' => [ '8.8 in', '6.8 in','-0.55 in',  '-0.55 in','0.394 in'],
	     '2' => [ '4.8 in', '6.8 in','-0.5 in', '-1.0 in','3.5 in']
	 },
     },
     'legal' => {
	 'book' => {
	     '1' => ['7.1 in','13 in',,'-0.57 in','-0.57 in','-0.5 in'],
	     '2' => ['3.66 in','13 in','-0.57 in','-0.57 in','-0.5 in']
	 },
	 'album' => {
	     '1' => ['12 in','7.1 in',,'-0.57 in','-0.57 in','-0.5 in'],
             '2' => ['6.0 in','7.1 in','-1 in','-1 in','5 in']
          },
     },
     'tabloid' => {
	 'book' => {
	     '1' => ['9.8 in','16 in','-0.57 in','-0.57 in','-0.5 in'],
	     '2' => ['4.9 in','16 in','-0.57 in','-0.57 in','-0.5 in']
	 },
	 'album' => {
	     '1' => ['16 in','9.8 in','-0.57 in','-0.57 in','-0.5 in'],
	     '2' => ['16 in','4.9 in','-0.57 in','-0.57 in','-0.5 in']
          },
     },
     'executive' => {
	 'book' => {
	     '1' => ['6.8 in','9 in','-0.57 in','-0.57 in','1.2 in'],
	     '2' => ['3.1 in','9 in','-0.57 in','-0.57 in','1.2 in']
	 },
	 'album' => {
	     '1' => [],
	     '2' => []
          },
     },
     'a2' => {
	 'book' => {
	     '1' => [],
	     '2' => []
	 },
	 'album' => {
	     '1' => [],
	     '2' => []
          },
     },
     'a3' => {
	 'book' => {
	     '1' => [],
	     '2' => []
	 },
	 'album' => {
	     '1' => [],
	     '2' => []
          },
     },
     'a4' => {
	 'book' => {
	     '1' => ['17.6 cm','27.2 cm','-1.397 cm','-2.11 cm','-1.27 cm'],
	     '2' => [ '9.1 cm','27.2 cm','-1.397 cm','-2.11 cm','-1.27 cm']
	 },
	 'album' => {
	     '1' => ['21.59 cm','19.558 cm','-1.397cm','-2.11 cm','0 cm'],
	     '2' => ['9.91 cm','19.558 cm','-1.397 cm','-2.11 cm','0 cm']
	 },
     },
     'a5' => {
	 'book' => {
	     '1' => [],
	     '2' => []
	 },
	 'album' => {
	     '1' => [],
	     '2' => []
          },
     },
     'a6' => {
	 'book' => {
	     '1' => [],
	     '2' => []
	 },
	 'album' => {
	     '1' => [],
	     '2' => []
          },
     },
     );

sub page_format {
#
#Supported paper format: "Letter [8 1/2x11 in]",      "Legal [8 1/2x14 in]",
#                        "Ledger/Tabloid [11x17 in]", "Executive [7 1/2x10 in]",
#                        "A2 [420x594 mm]",           "A3 [297x420 mm]",
#                        "A4 [210x297 mm]",           "A5 [148x210 mm]",
#                        "A6 [105x148 mm]"
# 
    my ($papersize,$layout,$numberofcolumns) = @_; 
    return @{$page_formats{$papersize}->{$layout}->{$numberofcolumns}};
}


sub get_name {
    my ($uname,$udom)=@_;
    if (!defined($uname)) { $uname=$env{'user.name'}; }
    if (!defined($udom)) { $udom=$env{'user.domain'}; }
    my $plainname=&Apache::loncommon::plainname($uname,$udom);
    if ($plainname=~/^\s*$/) { $plainname=$uname.'@'.$udom; }
   $plainname=&Apache::lonxml::latex_special_symbols($plainname,'header');
    return $plainname;
}

sub get_course {
    my $courseidinfo;
    if (defined($env{'request.course.id'})) {
	$courseidinfo = &Apache::lonxml::latex_special_symbols(&unescape($env{'course.'.$env{'request.course.id'}.'.description'}),'header');
	my $sec = $env{'request.course.sec'};
	    
    }
    return $courseidinfo;
}

sub page_format_transformation {
    my ($papersize,$layout,$numberofcolumns,$choice,$text,$assignment,$tableofcontents,$indexlist,$selectionmade) = @_; 
    my ($textwidth,$textheight,$oddoffset,$evenoffset,$topmargin);

    if ($selectionmade eq '4') {
	if ($choice eq 'all_problems') {
            $assignment=&mt('Problems from the Whole Course');
	} else {
            $assignment=&mt('Resources from the Whole Course');
	}
    } else {
	$assignment=&Apache::lonxml::latex_special_symbols($assignment,'header');
    }
    ($textwidth,$textheight,$oddoffset,$evenoffset,$topmargin) = &page_format($papersize,$layout,$numberofcolumns,$topmargin);


    my $name = &get_name();
    my $courseidinfo = &get_course();
    my $header_text  = $parmhash{'print_header_format'};
    $header_text     = &format_page_header($textwidth, $header_text, $assignment,
					   $courseidinfo, $name);
    my $topmargintoinsert = '';
    if ($topmargin ne '0') {$topmargintoinsert='\setlength{\topmargin}{'.$topmargin.'}';}
    my $fancypagestatement='';
    if ($numberofcolumns eq '2') {
	$fancypagestatement="\\fancyhead{}\\fancyhead[LO]{$header_text}";
    } else {
	$fancypagestatement="\\rhead{}\\chead{}\\lhead{$header_text}";
    }
    if ($layout eq 'album') {
	    $text =~ s/\\begin{document}/\\setlength{\\oddsidemargin}{$oddoffset}\\setlength{\\evensidemargin}{$evenoffset}$topmargintoinsert\n\\setlength{\\textwidth}{$textwidth}\\setlength{\\textheight}{$textheight}\\setlength{\\textfloatsep}{8pt plus 2\.0pt minus 4\.0pt}\n\\newlength{\\minipagewidth}\\setlength{\\minipagewidth}{\\textwidth\/\$number_of_columns-0\.2cm}\\usepackage{fancyhdr}\\addtolength{\\headheight}{\\baselineskip}\n\\pagestyle{fancy}$fancypagestatement\\usepackage{booktabs}\\begin{document}\\voffset=-0\.8 cm\\setcounter{page}{1}\n /;
    } elsif ($layout eq 'book') {
	if ($choice ne 'All class print') { 
	    $text =~ s/\\begin{document}/\\textheight $textheight\\oddsidemargin = $evenoffset\\evensidemargin = $evenoffset $topmargintoinsert\n\\textwidth= $textwidth\\newlength{\\minipagewidth}\\setlength{\\minipagewidth}{\\textwidth\/\$number_of_columns-0\.2cm}\n\\renewcommand{\\ref}{\\keephidden\}\\usepackage{fancyhdr}\\addtolength{\\headheight}{\\baselineskip}\\pagestyle{fancy}$fancypagestatement\\usepackage{booktabs}\\begin{document}\n\\voffset=-0\.8 cm\\setcounter{page}{1}\n/;
	} else {
	    $text =~ s/\\pagestyle{fancy}\\rhead{}\\chead{}\s*\\begin{document}/\\textheight = $textheight\\oddsidemargin = $evenoffset\n\\evensidemargin = $evenoffset $topmargintoinsert\\textwidth= $textwidth\\newlength{\\minipagewidth}\n\\setlength{\\minipagewidth}{\\textwidth\/\$number_of_columns-0\.2cm}\\renewcommand{\\ref}{\\keephidden\}\\pagestyle{fancy}\\rhead{}\\chead{}\\usepackage{booktabs}\\begin{document}\\voffset=-0\.8cm\n\\setcounter{page}{1}  \\vskip 5 mm\n /;
	}
	if ($papersize eq 'a4') {
	    my $papersize_text;
	    if ($perm{'pav'}) {
		$papersize_text = '\\special{papersize=210mm,297mm}';
	    } else {
		$papersize_text = '\special{papersize=210mm,297mm}';
	    }
	    $text =~ s/(\\begin{document})/$1$papersize_text/;
	}
    }
    if ($tableofcontents eq 'yes') {$text=~s/(\\setcounter\{page\}\{1\})/$1 \\tableofcontents\\newpage /;}
    if ($indexlist eq 'yes') {
	$text=~s/(\\begin{document})/\\makeindex $1/;
	$text=~s/(\\end{document})/\\strut\\\\\\strut\\printindex $1/;
    }
    return $text;
}


sub page_cleanup {
    my $result = shift;	
 
    $result =~ m/\\end{document}(\d*)$/;
    my $number_of_columns = $1;
    my $insert = '{';
    for (my $id=1;$id<=$number_of_columns;$id++) { $insert .='l'; }
    $insert .= '}';
    $result =~ s/(\\begin{longtable})INSERTTHEHEADOFLONGTABLE\\endfirsthead\\endhead/$1$insert/g;
    $result =~ s/&\s*REMOVETHEHEADOFLONGTABLE\\\\/\\\\/g;
    return $result,$number_of_columns;
}


sub details_for_menu {
    my ($helper)=@_;
    my $postdata=$env{'form.postdata'};
    if (!$postdata) { $postdata=$helper->{VARS}{'postdata'}; }
    my $name_of_resource = &Apache::lonnet::gettitle($postdata);
    my $symbolic = &Apache::lonnet::symbread($postdata);
    return if ( $symbolic eq '');

    my ($map,$id,$resource)=&Apache::lonnet::decode_symb($symbolic);
    $map=&Apache::lonnet::clutter($map);
    my $name_of_sequence = &Apache::lonnet::gettitle($map);
    if ($name_of_sequence =~ /^\s*$/) {
	$map =~ m|([^/]+)$|;
	$name_of_sequence = $1;
    }
    my $name_of_map = &Apache::lonnet::gettitle($env{'request.course.uri'});
    if ($name_of_map =~ /^\s*$/) {
	$env{'request.course.uri'} =~ m|([^/]+)$|;
	$name_of_map = $1;
    }
    return ($name_of_resource,$name_of_sequence,$name_of_map);
}

sub copyright_line {
    return '\noindent\makebox[\textwidth/$number_of_columns][b]{\hrulefill}\vspace*{-2 mm}\newline\noindent{\tiny Printed from LON-CAPA\copyright MSU{\hfill} Licensed under GNU General Public License } ';
}
my $end_of_student = "\n".'\special{ps:ENDOFSTUDENTSTAMP}'."\n";

sub latex_corrections {
    my ($number_of_columns,$result,$selectionmade,$answer_mode) = @_;
#    $result =~ s/\\includegraphics{/\\includegraphics\[width=\\minipagewidth\]{/g;
    my $copyright = &copyright_line();
    if ($selectionmade eq '1' || $answer_mode eq 'only') {
	$result =~ s/(\\end{document})/\\strut\\vskip 0 mm $copyright $end_of_student $1/;
    } else {
	$result =~ s/(\\end{document})/\\strut\\vspace\*{-4 mm}\\newline $copyright $end_of_student $1/;
    }
    $result =~ s/\$number_of_columns/$number_of_columns/g;
    $result =~ s/(\\end{longtable}\s*)(\\strut\\newline\\noindent\\makebox\[\\textwidth\/$number_of_columns\]\[b\]{\\hrulefill})/$2$1/g;
    $result =~ s/(\\end{longtable}\s*)\\strut\\newline/$1/g;
#-- LaTeX corrections     
    my $first_comment = index($result,'<!--',0);
    while ($first_comment != -1) {
	my $end_comment = index($result,'-->',$first_comment);
	substr($result,$first_comment,$end_comment-$first_comment+3) = '';
	$first_comment = index($result,'<!--',$first_comment);
    }
    $result =~ s/^\s+$//gm; #remove empty lines
    #removes more than one empty space
    $result =~ s|(\s\s+)|($1=~/[\n\r]/)?"\n":" "|ge;
    $result =~ s/\\\\\s*\\vskip/\\vskip/gm;
    $result =~ s/\\\\\s*\\noindent\s*(\\\\)+/\\\\\\noindent /g;
    $result =~ s/{\\par }\s*\\\\/\\\\/gm;
    $result =~ s/\\\\\s+\[/ \[/g;
    #conversion of html characters to LaTeX equivalents
    if ($result =~ m/&(\w+|#\d+);/) {
	$result = &character_chart($result);
    }
    $result =~ s/(\\end{tabular})\s*\\vskip 0 mm/$1/g;
    $result =~ s/(\\begin{enumerate})\s*\\noindent/$1/g;
    return $result;
}


sub index_table {
    my $currentURL = shift;
    my $insex_string='';
    $currentURL=~s/\.([^\/+])$/\.$1\.meta/;
    $insex_string=&Apache::lonnet::metadata($currentURL,'keywords');
    return $insex_string;
}


sub IndexCreation {
    my ($texversion,$currentURL)=@_;
    my @key_words=split(/,/,&index_table($currentURL));
    my $chunk='';
    my $st=index $texversion,'\addcontentsline{toc}{subsection}{';
    if ($st>0) {
	for (my $i=0;$i<3;$i++) {$st=(index $texversion,'}',$st+1);}
	$chunk=substr($texversion,0,$st+1);
	substr($texversion,0,$st+1)=' ';
    }
    foreach my $key_word (@key_words) {
	if ($key_word=~/\S+/) {
	    $texversion=~s/\b($key_word)\b/$1 \\index{$key_word} /i;
	}
    }			
    if ($st>0) {substr($texversion,0,1)=$chunk;}
    return $texversion;
}

sub print_latex_header {
    my $mode=shift;

    return &Apache::londefdef::latex_header($mode);
}

sub path_to_problem {
    my ($urlp,$colwidth)=@_;
    $urlp=&Apache::lonnet::clutter($urlp);

    my $newurlp = '';
    $colwidth=~s/\s*mm\s*$//;
#characters average about 2 mm in width
    if (length($urlp)*2 > $colwidth) {
	my @elements = split('/',$urlp);
	my $curlength=0;
	foreach my $element (@elements) {
	    if ($element eq '') { next; }
	    if ($curlength+(length($element)*2) > $colwidth) {
		$newurlp .=  '|\vskip -1 mm \verb|';
		$curlength=length($element)*2;
	    } else {
		$curlength+=length($element)*2;
	    }
	    $newurlp.='/'.$element;
	}
    } else {
	$newurlp=$urlp;
    }
    return '{\small\noindent\verb|'.$newurlp.'|\vskip 0 mm}';
}

sub recalcto_mm {
    my $textwidth=shift;
    my $LaTeXwidth;
    if ($textwidth=~/(-?\d+\.?\d*)\s*cm/) {
	$LaTeXwidth = $1*10;
    } elsif ($textwidth=~/(-?\d+\.?\d*)\s*mm/) {
	$LaTeXwidth = $1;
    } elsif ($textwidth=~/(-?\d+\.?\d*)\s*in/) {
	$LaTeXwidth = $1*25.4;
    }
    $LaTeXwidth.=' mm';
    return $LaTeXwidth;
}

sub get_textwidth {
    my ($helper,$LaTeXwidth)=@_;
    my $textwidth=$LaTeXwidth;
    if ($helper->{'VARS'}->{'pagesize.width'}=~/\d+/ &&
	$helper->{'VARS'}->{'pagesize.widthunit'}=~/\w+/) {
	$textwidth=&recalcto_mm($helper->{'VARS'}->{'pagesize.width'}.' '.
				$helper->{'VARS'}->{'pagesize.widthunit'});
    }
    return $textwidth;
}


sub unsupported {
    my ($currentURL,$mode,$symb)=@_;
    if ($mode ne '') {$mode='\\'.$mode}
    my $result.= &print_latex_header($mode);
    if ($currentURL=~m|^(/adm/wrapper/)?ext/|) {
	$currentURL=~s|^(/adm/wrapper/)?ext/|http://|;
        $currentURL=~s|^http://https://|https://|;
	my $title=&Apache::lonnet::gettitle($symb);
	$title = &Apache::lonxml::latex_special_symbols($title);
	$result.=' \strut \\\\ '.$title.' \strut \\\\ '.$currentURL.' ';
    } else {
	$result.=$currentURL;
    }
    $result.= '\vskip 0.5mm\noindent\makebox[\textwidth/$number_of_columns][b]{\hrulefill} \end{document}';
    return $result;
}

#
#  Map from helper layout style to the book/album:
#
sub map_laystyle {
    my ($laystyle) = @_;
    if ($laystyle eq 'L') {
	$laystyle='album';
    } else {
	$laystyle='book';
    }
    return $laystyle;
}

sub print_page_in_course {
    my ($helper, $rparmhash, $currentURL, $resources) = @_;

    my %parmhash       = %$rparmhash;
    my @page_resources = @$resources;
    my $mode = $helper->{'VARS'}->{'LATEX_TYPE'};
    my $symb = $helper->{'VARS'}->{'symb'};


    my $format_from_helper = $helper->{'VARS'}->{'FORMAT'};


    my @temporary_array=split /\|/,$format_from_helper;
    my ($laystyle,$numberofcolumns,$papersize,$pdfFormFields)=@temporary_array;
    $laystyle = &map_laystyle($laystyle);
    my ($textwidth,$textheight,$oddoffset,$evenoffset) = &page_format($papersize,$laystyle,
								      $numberofcolumns);
    my $LaTeXwidth=&recalcto_mm($textwidth); 


    if ($mode ne '') {$mode='\\'.$mode}
    my $result   =    &print_latex_header($mode);
    if ($currentURL=~m|^(/adm/wrapper/)?ext/|) {
	$currentURL=~s|^(/adm/wrapper/)?ext/|http://|;
	my $title=&Apache::lonnet::gettitle($symb);
	$title = &Apache::lonxml::latex_special_symbols($title);
    } else {
        my $esc_currentURL= $currentURL;
        $esc_currentURL =~ s/_/\\_/g;
	$result.=$esc_currentURL;
    }
    $result .= '\\\\';

    if ($helper->{'VARS'}->{'style_file'}=~/\w/) {
	&Apache::lonnet::appenv({'construct.style' =>
				$helper->{'VARS'}->{'style_file'}});
    } elsif ($env{'construct.style'}) {
	&Apache::lonnet::delenv('construct.style');
    }

    # First is the overall page description.  This is then followed by the 
    # components of the page. Each of which must be printed independently.
    my $the_page = shift(@page_resources); 


    foreach my $resource (@page_resources) {
	my $resource_src   = $resource->src(); # Essentially the URL of the resource.
	$result           .= $resource->title() . '\\\\';

	# Recurse if a .page:

	if ($resource_src =~ /.page$/i) {
	    my $navmap         = Apache::lonnavmaps::navmap->new();
	    my @page_resources = $navmap->retrieveResources($resource_src);
	    $result           .= &print_page_in_course($helper, $rparmhash, 
						       $resource_src, \@page_resources);
        } elsif ($resource->ext()) {
            $result .= &unsupported($currentURL,$mode,$symb);
	}
	# these resources go through the XML transformer:

	elsif ($resource_src =~ /\.(problem|exam|quiz|assess|survey|form|library|xml|html|htm|xhtml|xhtm)$/)  {

	    my $urlp = &Apache::lonnet::clutter($resource_src);

	    my %form;
	    my %moreenv;

	    &Apache::lonxml::remember_problem_counter();
	    $moreenv{'request.filename'}=$urlp;
	    if ($helper->{'VARS'}->{'probstatus'} eq 'exam') {$form{'problemtype'}='exam';}

	    $form{'grade_target'}  = 'tex';
	    $form{'textwidth'}    = &get_textwidth($helper, $LaTeXwidth);
	    $form{'pdfFormFields'} = $pdfFormFields; # 
	    $form{'showallfoils'} = $helper->{'VARS'}->{'showallfoils'};    
	    
	    $form{'problem_split'}=$parmhash{'problem_stream_switch'};
	    $form{'suppress_tries'}=$parmhash{'suppress_tries'};
	    $form{'latex_type'}=$helper->{'VARS'}->{'LATEX_TYPE'};
	    $form{'print_discussions'}=$helper->{'VARS'}->{'PRINT_DISCUSSIONS'};
	    $form{'print_annotations'}=$helper->{'VARS'}->{'PRINT_ANNOTATIONS'};
	    if (($helper->{'VARS'}->{'PRINT_DISCUSSIONS'} eq 'yes') ||
		($helper->{'VARS'}->{'PRINT_ANNOTATIONS'} eq 'yes')) {
		$form{'problem_split'}='yes';
	    }
	    my $rndseed = time;
	    if ($helper->{'VARS'}->{'curseed'}) {
		$rndseed=$helper->{'VARS'}->{'curseed'};
	    }
	    $form{'rndseed'}=$rndseed;
	    &Apache::lonnet::appenv(\%moreenv);
	    
	    &Apache::lonxml::clear_problem_counter();

	    my $texversion = &ssi_with_retries($urlp, $ssi_retry_count, %form);


	    # current document with answers.. no need to encap in minipage
	    #  since there's only one answer.

	    if(($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'no') ||
	       ($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'only')) {
		my %answerform = %form;


		$answerform{'problem_split'}=$parmhash{'problem_stream_switch'};
		$answerform{'grade_target'}='answer';
		$answerform{'answer_output_mode'}='tex';
		$answerform{'rndseed'}=$rndseed;
                if ($helper->{'VARS'}->{'probstatus'} eq 'exam') {
		    $answerform{'problemtype'}='exam';
		}
		$resources_printed .= $urlp.':';
		my $answer=&ssi_with_retries($urlp,$ssi_retry_count, %answerform);

		if ($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'no') {
		    $texversion=~s/(\\keephidden{ENDOFPROBLEM})/$answer$1/;
		} else {
		    $texversion= &print_latex_header($helper->{'VARS'}->{'LATEX_TYPE'});
		    if ($helper->{'VARS'}->{'construction'} ne '1') {
			my $title = &Apache::lonnet::gettitle($helper->{'VARS'}->{'symb'});
			$title = &Apache::lonxml::latex_special_symbols($title);
			$texversion.='\vskip 0 mm \noindent\textbf{'.$title.'}\vskip 0 mm ';
			$texversion.=&path_to_problem($urlp,$LaTeXwidth);
		    } else {
			$texversion.='\vskip 0 mm \noindent\textbf{'.
                        &mt("Printing from Authoring Space: No Title").'}\vskip 0 mm ';
			$texversion.=&path_to_problem($urlp,$LaTeXwidth);
		    }
		    $texversion.='\vskip 1 mm '.$answer.'\end{document}';
		}


		

	    
	    }
	    # Print annotations.


	    if ($helper->{'VARS'}->{'PRINT_ANNOTATIONS'} eq 'yes') {
		my $annotation .= &annotate($currentURL);
		$texversion =~ s/(\\keephidden{ENDOFPROBLEM})/$annotation$1/;
	    }
	    
	    if ($helper->{'VARS'}->{'TABLE_INDEX'} eq 'yes') {
		$texversion=&IndexCreation($texversion,$currentURL);
	    }
	    if ($helper->{'VARS'}->{'CONSTR_RESOURSE_URL'} eq 'yes') {
		$texversion=~s/(\\addcontentsline\{toc\}\{subsection\}\{[^\}]*\})/$1 URL: \\verb|$currentURL| \\strut\\\\\\strut /;

	    }
	    $texversion = &latex_header_footer_remove($texversion);

	    # the first remaining line is a comment from londefdef the second
	    # line  seems to be an extraneous \vskip 1mm \\\\ :
            # (imperfect removal from header_footer_remove?

	    $texversion =~ s/\\vskip 1mm \\\\\\\\//;

	    $result .= $texversion;
	    if ($currentURL=~m/\.page\s*$/) {
		($result,$numberofcolumns) = &page_cleanup($result);
	    }
	}
    }

    $result.= '\vskip 0.5mm\noindent\makebox[\textwidth/$number_of_columns][b]{\hrulefill} \end{document}';
    return $result;
}


#
# List of recently generated print files
#
sub recently_generated {
    my ($prtspool) = @_;
    my $output;
    my $zip_result;
    my $pdf_result;
    opendir(DIR,$prtspool);

    my @files = 
	grep(/^$env{'user.name'}_$env{'user.domain'}_printout_(\d+)_.*\.(pdf|zip)$/,readdir(DIR));
    closedir(DIR);

    @files = sort {
	my ($actime) = (stat($prtspool.'/'.$a))[10];
	my ($bctime) = (stat($prtspool.'/'.$b))[10];
	return $bctime <=> $actime;
    } (@files);

    foreach my $filename (@files) {
	my ($ext) = ($filename =~ m/(pdf|zip)$/);
	my ($cdev,$cino,$cmode,$cnlink,
	    $cuid,$cgid,$crdev,$csize,
	    $catime,$cmtime,$cctime,
	    $cblksize,$cblocks)=stat($prtspool.'/'.$filename);
        my $ext_text = 'pdf' ? &mt('PDF File'):&mt('Zip File');
	my $result=&Apache::loncommon::start_data_table_row()
                  .'<td>'
                  .'<a href="/prtspool/'.$filename.'">'.$ext_text.'</a>'
                  .'</td>'
                  .'<td>'.&Apache::lonlocal::locallocaltime($cctime).'</td>'
                  .'<td align="right">'.$csize.'</td>'
                  .&Apache::loncommon::end_data_table_row();
	if ($ext eq 'pdf') { $pdf_result .= $result; }
	if ($ext eq 'zip') { $zip_result .= $result; }
    }
    if ($zip_result || $pdf_result) {
        $output ='<hr />';
    }
    if ($zip_result) {
	$output .='<h3>'.&mt('Recently generated printout zip files')."</h3>\n"
                  .&Apache::loncommon::start_data_table()
                  .&Apache::loncommon::start_data_table_header_row()
                  .'<th>'.&mt('Download').'</th>'
                  .'<th>'.&mt('Creation Date').'</th>'
                  .'<th>'.&mt('File Size (Bytes)').'</th>'
                  .&Apache::loncommon::end_data_table_header_row()
                  .$zip_result
                  .&Apache::loncommon::end_data_table();
    }
    if ($pdf_result) {
	$output .='<h3>'.&mt('Recently generated printouts')."</h3>\n"
                  .&Apache::loncommon::start_data_table()
                  .&Apache::loncommon::start_data_table_header_row()
                  .'<th>'.&mt('Download').'</th>'
                  .'<th>'.&mt('Creation Date').'</th>'
                  .'<th>'.&mt('File Size (Bytes)').'</th>'
                  .&Apache::loncommon::end_data_table_header_row()
                  .$pdf_result
                  .&Apache::loncommon::end_data_table();
    }
    return $output;
}

#
#   Retrieve the hash of page breaks.
#
#  Inputs:
#    helper   - reference to helper object.
#  Outputs
#    A reference to a page break hash.
#
#
# use Data::Dumper;
# sub dump_helper_vars {
#    my ($helper) = @_;
#    my $helpervars = Dumper($helper->{'VARS'});
#    &Apache::lonnet::logthis("Dump of helper vars:\n $helpervars");
#}

sub get_page_breaks  {
    my ($helper) = @_;
    my %page_breaks;

    foreach my $break (split /\|\|\|/, $helper->{'VARS'}->{'FINISHPAGE'}) {
	$page_breaks{$break} = 1;
    }
    return %page_breaks;
}
# 
#   Returns text to insert for any extra vskip prior to the resource.
#   Parameters:
#     helper   - Reference to the helper object driving the printout.
#     resource - Identifies the resource about to be printed.
#
#   This is done as follows:
#    POSSIBLE_RESOURCES has the list of possible resources.
#    EXTRASPACE         has the list of extra space values.
#    EXTRASPACE_UNITS   is the set of resources for which the units are
#                       mm. All others are 'in'.
#    
#    The resource is found in the POSSIBLE_RESOURCES to get the index
#    of the EXTRASPACE value.
#
#   In order to speed this up for lengthy printouts, the first time,
#   POSSIBLE_RESOURCES is turned into a look up hash and
#   EXTRASPACE is turned into an array.
#


my %possible_resources;
my %extraspace_mm;
my @extraspace;
my $skips_loaded       = 0;

#  Function to load the skips hash and array

sub load_skips {

    my ($helper)  = @_;

    #  If this is the first time, unrap the resources and extra spaces:

    if (!$skips_loaded) {
	@extraspace = (split(/\|\|\|/, $helper->{'VARS'}->{'EXTRASPACE'}));
	my @resource_list = (split(/\|\|\|/, $helper->{'VARS'}->{'POSSIBLE_RESOURCES'}));
	my $i = 0;
	foreach my $resource (@resource_list) {
	    $possible_resources{$resource} = $i;
	    $i++;
	}
	foreach my $mm_resource (split(/\|\|\|/, $helper->{'VARS'}->{'EXTRASPACE_UNITS'})) {
	    $extraspace_mm{$mm_resource} = 1;
	}
	$skips_loaded = 1;
    }
}

sub get_extra_vspaces {
    my ($helper, $resource) = @_;

    &load_skips($helper);

    #  Lookup the resource in the possible resources hash.. that is the index
    # into the extraspace array that gives us either an empty string or
    # the number of mm to skip:

    my $index = $possible_resources{$resource};
    my $skip  = $extraspace[$index];

    my $result = '';
    if ($skip ne '') {
	my $units = 'in';
	if (defined($extraspace_mm{$resource})) {
	    $units = 'mm';
	}
	$result = '\vskip '.$skip.' '.$units;
    }

	
    return $result;


}

#
#  The resource chooser part of the helper needs more than just
#  the value of the extraspaces var to recover the value into a text
#  field option.  This sub produces the required format for the saved var:
#  specifically 
#    ||| separated fields of the form resourcename=value
#
#  Parameters:
#    $helper     - Refers to the helper we are configuring
#  Implicit input:
#     $helper->{'VARS'}->{'EXTRASPACE'}  - the spaces helper var has the text field
#                                          value.
#     $helper->{'VARS'}->{'EXTRASPACE_UNITS'} - units for the skips (checkboxes).
#     $helper->{'VARS'}->{'POSSIBLE_RESOURCES'}  - has the list of resources. |||
#                                          separated of course.
#  Implicit outputs:
#     $env{'form.extraspace'}
#     $env{'form.extraspace_units'}
#
sub set_form_extraspace {
    my ($helper) = @_;

    # the most convenient way to do this is to drive from the skips arrays/hash.
    # may not be the fastest, but this is once per print request so it's not so
    # speed critical:

    &load_skips($helper);

    my $result = '';

    foreach my $resource (keys(%possible_resources)) {
	my $vskip = $extraspace[$possible_resources{$resource}];
	$result  .= $resource .'=' . $vskip . '|||';
    }

    $env{'form.extraspace'}  = $result;
    $env{'form.extraspace_units'} = $helper->{'VARS'}->{'EXTRASPACE_UNITS'};
    return $result;
    
}

#  Output a sequence (recursively if neeed)
#  from construction space.
# Parameters:
#    url     = URL of the sequence to print.
#    helper  - Reference to the helper hash.
#    form    - Copy of the format hash.
#    LaTeXWidth
# Returns:
#   Text to add to the printout.
#   NOTE if the first element of the outermost sequence
#   is itself a sequence, the outermost caller may need to
#   prefix the latex with the page headers stuff.
#
sub print_construction_sequence {
    my ($currentURL, $helper, %form, $LaTeXwidth) = @_;

    my $result;
    my $rndseed=time;
    if ($helper->{'VARS'}->{'curseed'}) {
	$rndseed=$helper->{'VARS'}->{'curseed'};
    }
    my $errtext=&LONCAPA::map::mapread(&Apache::lonnet::filelocation('',$currentURL));

    # 
    #  These make this all support recursing for subsequences.
    #
    my @order    = @LONCAPA::map::order;
    my @resources = @LONCAPA::map::resources; 

    for (my $member=0;$member<=$#order;$member++) {
	$resources[$order[$member]]=~/^([^:]*):([^:]*):/;
	my $urlp=$2;
	if ($urlp=~/\.(problem|exam|quiz|assess|survey|form|library|xml|html|htm|xhtml|xhtm)$/) {
	    my $texversion='';
	    if ($helper->{'VARS'}->{'ANSWER_TYPE'} ne 'only') {
		$form{'problem_split'}=$parmhash{'problem_stream_switch'};
		$form{'suppress_tries'}=$parmhash{'suppress_tries'};
		$form{'latex_type'}=$helper->{'VARS'}->{'LATEX_TYPE'};
		$form{'rndseed'}=$rndseed;
		$resources_printed .=$urlp.':';
		$texversion=&ssi_with_retries($urlp, $ssi_retry_count, %form);
	    }
	    if((($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'no') ||
		($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'only')) && 
	       ($urlp=~/$LONCAPA::assess_page_re/)) {
		#  Don't permanently modify %$form...
		my %answerform = %form;
		$answerform{'grade_target'}='answer';
		$answerform{'answer_output_mode'}='tex';
		$answerform{'rndseed'}=$rndseed;
		$answerform{'problem_split'}=$parmhash{'problem_stream_switch'};
		if ($urlp=~/\/res\//) {$env{'request.state'}='published';}
		$resources_printed .= $urlp.':';
		my $answer=&ssi_with_retries($urlp, $ssi_retry_count, %answerform);
		if ($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'no') {
		    $texversion=~s/(\\keephidden{ENDOFPROBLEM})/$answer$1/;
		} else {
		    # If necessary, encapsulate answer in minipage:
		    
		    $texversion=&print_latex_header($helper->{'VARS'}->{'LATEX_TYPE'});
		    my $title = &Apache::lonnet::gettitle($helper->{'VARS'}->{'symb'});
		    $title = &Apache::lonxml::latex_special_symbols($title);
		    my $body ='\vskip 0 mm \noindent\textbf{'.$title.'}\vskip 0 mm ';
		    $body.=&path_to_problem($urlp,$LaTeXwidth);
		    $body.='\vskip 1 mm '.$answer.'\end{document}';
		    $body = &encapsulate_minipage($body);
		    $texversion.=$body;
		}
	    }
	    $texversion = &latex_header_footer_remove($texversion);

	    if ($helper->{'VARS'}->{'TABLE_INDEX'} eq 'yes') {
		$texversion=&IndexCreation($texversion,$urlp);
	    }
	    if ($helper->{'VARS'}->{'CONSTR_RESOURSE_URL'} eq 'yes') {
		$texversion=~s/(\\addcontentsline\{toc\}\{subsection\}\{[^\}]*\})/$1 URL: \\verb|$urlp| \\strut\\\\\\strut /;
	    }
	    $result.=$texversion;

	} elsif ($urlp=~/\.(sequence|page)$/) {
 
	    # header:

	    $result.='\strut\newline\noindent Sequence/page '.$urlp.'\strut\newline\noindent\makebox[\textwidth/$number_of_columns][b]{\hrulefill}\newline\noindent ';

	    # IF sequence, recurse:
	    
	    if ($urlp =~ /\.sequence$/) {
		$result .= &print_construction_sequence($urlp, 
							$helper, %form, 
							$LaTeXwidth);
	    }
	}
	elsif ($urlp =~ /\.pdf$/i) {
	    my $texversion;
	    if ($member != 0) {
		$texversion .= '\cleardoublepage';
	    }

	    $texversion .= &include_pdf($urlp);
	    $texversion = &latex_header_footer_remove($texversion);
	    if ($member != $#order) {
		$texversion .= '\\ \cleardoublepage';
	    }
	    
	    $result .= $texversion;
	}
    }
    if ($helper->{VARS}->{'construction'} eq '1') {$result=~s/(\\begin{document})/$1 \\fbox\{RANDOM SEED IS $rndseed\} /;}
    return $result;
}

#
#  Top level for generating print output.
#
#  May call print_resources if multiple resources will be printed.
#
#  The main driver is $selectionmade which reflects the type of print out
#  requested:
#   Value    Print type:
#   1        Print resource that's being looked at.
#   2        Print problems in a map or in a page.
#   3        Print pages in a map or resources in a page.
#   4        Print all problems  or all resources.
#   5        Print problems for seleted students.
#   6        Print selected problems from a folder.
#   7        Print print selected resources from some scope.
#   8        Print resources for selected students.
#
#BZ 5209
#   2        map_incomplete_problems_seq Print incomplete problems from the current
#            folder in student context.
#   5      map_incomplete_problems_people_seq Print incomplete problems from the
#            current folder in privileged context.
#    5      incomplete_problems_selpeople_course Print incomplete problems for
#            selected people from the entire course.
#
#   Item 101 has much the same processing as 8,
#
#  Differences:  Item 101, 102 require per-student filtering of the resource
#  set so that only the incomplete resources are printed.
#  For item 100, filtering was done at the helper level.

sub output_data {

    my ($r,$helper,$rparmhash) = @_;
    my %parmhash = %$rparmhash;
    $ssi_error = 0;		# This will be set nonzero by failing ssi's.
    $resources_printed = '';
    $font_size = $helper->{'VARS'}->{'fontsize'};
    my $print_type = $helper->{'VARS'}->{'PRINT_TYPE'}; # Allows textual simplification.
    my $do_postprocessing = 1;
    my $js = <<ENDPART;
<script type="text/javascript">
    var editbrowser;
    function openbrowser(formname,elementname,only,omit) {
        var url = '/res/?';
        if (editbrowser == null) {
            url += 'launch=1&';
        }
        url += 'catalogmode=interactive&';
        url += 'mode=parmset&';
        url += 'form=' + formname + '&';
        if (only != null) {
            url += 'only=' + only + '&';
        } 
        if (omit != null) {
            url += 'omit=' + omit + '&';
        }
        url += 'element=' + elementname + '';
        var title = 'Browser';
        var options = 'scrollbars=1,resizable=1,menubar=0';
        options += ',width=700,height=600';
        editbrowser = open(url,title,options,'1');
        editbrowser.focus();
    }
</script>
ENDPART


    # Breadcrumbs
    #FIXME: Choose better/different breadcrumbs?!? Links?
    my $brcrum = [{'href' => '',
                   'text' => 'Helper'}, #FIXME: Different origin possible than print out helper?
                  {'href' => '',
                   'text' => 'Preparing Printout'}];

    my $start_page  = &Apache::loncommon::start_page('Preparing Printout',
                                                     $js,
                                                     {'bread_crumbs' => $brcrum,});
    my $msg = &mt('Please stand by while processing your print request, this may take some time ...');

    $r->print($start_page."\n<p>\n$msg\n</p>\n");

    # fetch the pagebreaks and store them in the course environment
    # The page breaks will be pulled into the hash %page_breaks which is
    # indexed by symb and contains 1's for each break.

    $env{'form.pagebreaks'}  = $helper->{'VARS'}->{'FINISHPAGE'};
    &set_form_extraspace($helper);
    $env{'form.lastprinttype'} = $print_type; 
    &Apache::loncommon::store_course_settings('print',
					      {'pagebreaks'    => 'scalar',
					       'extraspace'    => 'scalar',
					       'extraspace_units' => 'scalar',
					       'lastprinttype' => 'scalar'});
    my %page_breaks  = &get_page_breaks($helper);

    my $format_from_helper = $helper->{'VARS'}->{'FORMAT'};
    my ($result,$selectionmade) = ('','');
    my $number_of_columns = 1; #used only for pages to determine the width of the cell
    my @temporary_array=split /\|/,$format_from_helper;
    my ($laystyle,$numberofcolumns,$papersize,$pdfFormFields)=@temporary_array;

    $laystyle = &map_laystyle($laystyle);
    my ($textwidth,$textheight,$oddoffset,$evenoffset) = &page_format($papersize,$laystyle,$numberofcolumns);
    my $assignment =  $env{'form.assignment'};
    my $LaTeXwidth=&recalcto_mm($textwidth); 
    my @print_array=();
    my @student_names=();

     
    #  Common settings for the %form has:
    # In some cases these settings get overriddent by specific cases, but the
    # settings are common enough to make it worthwhile factoring them out
    # here.
    #
    my %form;
    $form{'grade_target'} = 'tex';
    $form{'textwidth'}    = &get_textwidth($helper, $LaTeXwidth);
    $form{'pdfFormFields'} = $pdfFormFields;

    # If form.showallfoils is set, then request all foils be shown:
    # privilege will be enforced both by not allowing the 
    # check box selecting this option to be presnt unless it's ok,
    # and by lonresponse's priv. check.
    # The if is here because lonresponse.pm only cares that
    # showallfoils is defined, not what the value is.

    if ($helper->{'VARS'}->{'showallfoils'} eq "1") { 
	$form{'showallfoils'} = $helper->{'VARS'}->{'showallfoils'};
    }
    
    if ($helper->{'VARS'}->{'style_file'}=~/\w/) {
	&Apache::lonnet::appenv({'construct.style' =>
				$helper->{'VARS'}->{'style_file'}});
    } elsif ($env{'construct.style'}) {
	&Apache::lonnet::delenv('construct.style');
    }

    if ($print_type eq 'current_document') {
      #-- single document - problem, page, html, xml, ...
	my ($currentURL,$cleanURL);

	if ($helper->{'VARS'}->{'construction'} ne '1') {
            #prints published resource
	    $currentURL=$helper->{'VARS'}->{'postdata'};
	    $cleanURL=&Apache::lonenc::check_decrypt($currentURL);
	} else {

            #prints resource from the construction space
	    $currentURL=$helper->{'VARS'}->{'filename'};
	    $cleanURL=$currentURL;
	}
	$selectionmade = 1;
      
	if ($cleanURL!~m|^/adm/|
	    && $cleanURL=~/\.(problem|exam|quiz|assess|survey|form|library|xml|html|htm|xhtml|xhtm)$/) {
	    my $rndseed=time;
	    my $texversion='';
	    if ($helper->{'VARS'}->{'ANSWER_TYPE'} ne 'only') {
		my %moreenv;
		$moreenv{'request.filename'}=$cleanURL;
                if ($helper->{'VARS'}->{'probstatus'} eq 'exam') {$form{'problemtype'}='exam';}
		$form{'problem_split'}=$parmhash{'problem_stream_switch'};
		$form{'suppress_tries'}=$parmhash{'suppress_tries'};
		$form{'latex_type'}=$helper->{'VARS'}->{'LATEX_TYPE'};
		$form{'print_discussions'}=$helper->{'VARS'}->{'PRINT_DISCUSSIONS'};
		$form{'print_annotations'}=$helper->{'VARS'}->{'PRINT_ANNOTATIONS'};
		if (($helper->{'VARS'}->{'PRINT_DISCUSSIONS'} eq 'yes') ||
		    ($helper->{'VARS'}->{'PRINT_ANNOTATIONS'} eq 'yes')) {
		    $form{'problem_split'}='yes';
		}
		if ($helper->{'VARS'}->{'curseed'}) {
		    $rndseed=$helper->{'VARS'}->{'curseed'};
		}
		$form{'rndseed'}=$rndseed;
		&Apache::lonnet::appenv(\%moreenv);

		&Apache::lonxml::clear_problem_counter();

		$resources_printed .= $currentURL.':';
		$texversion.=&ssi_with_retries($currentURL,$ssi_retry_count, %form);

		#  Add annotations if required:
	    
		&Apache::lonxml::clear_problem_counter();

		&Apache::lonnet::delenv('request.filename');
	    }
	    # current document with answers.. no need to encap in minipage
	    #  since there's only one answer.

	    if(($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'no') ||
	       ($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'only')) {

		$form{'problem_split'}=$parmhash{'problem_stream_switch'};
		$form{'grade_target'}='answer';
		$form{'answer_output_mode'}='tex';
		$form{'rndseed'}=$rndseed;
                if ($helper->{'VARS'}->{'probstatus'} eq 'exam') {
		    $form{'problemtype'}='exam';
		}
		$resources_printed .= $currentURL.':';
		my $answer=&ssi_with_retries($currentURL,$ssi_retry_count, %form);
		

		if ($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'no') {
		    $texversion=~s/(\\keephidden{ENDOFPROBLEM})/$answer$1/;
		} else {
		    $texversion=&print_latex_header($helper->{'VARS'}->{'LATEX_TYPE'});
		    if ($helper->{'VARS'}->{'construction'} ne '1') {
			my $title = &Apache::lonnet::gettitle($helper->{'VARS'}->{'symb'});
			$title = &Apache::lonxml::latex_special_symbols($title);
			$texversion.='\vskip 0 mm \noindent\textbf{'.$title.'}\vskip 0 mm ';
			$texversion.=&path_to_problem($cleanURL,$LaTeXwidth);
		    } else {
			$texversion.='\vskip 0 mm \noindent\textbf{'.
                        &mt("Printing from Authoring Space: No Title").'}\vskip 0 mm ';

			$texversion.=&path_to_problem($cleanURL,$LaTeXwidth);
		    }
		    $texversion.='\vskip 1 mm '.$answer.'\end{document}';
		}


		

	    
	    }
	    # Print annotations.


	    if ($helper->{'VARS'}->{'PRINT_ANNOTATIONS'} eq 'yes') {
		my $annotation .= &annotate($currentURL);
		$texversion =~ s/(\\keephidden{ENDOFPROBLEM})/$annotation$1/;
	    }


	    if ($helper->{'VARS'}->{'TABLE_INDEX'} eq 'yes') {
		$texversion=&IndexCreation($texversion,$currentURL);
	    }
	    if ($helper->{'VARS'}->{'CONSTR_RESOURSE_URL'} eq 'yes') {
		$texversion=~s/(\\addcontentsline\{toc\}\{subsection\}\{[^\}]*\})/$1 URL: \\verb|$currentURL| \\strut\\\\\\strut /;

	    }
	    $result .= $texversion;
	    if ($currentURL=~m/\.page\s*$/) {
		($result,$number_of_columns) = &page_cleanup($result);
	    }
        } elsif ($cleanURL!~m|^/adm/|
		 && $currentURL=~/\.(sequence|page)$/ && $helper->{'VARS'}->{'construction'} eq '1') {
	    $result .= &print_construction_sequence($currentURL, $helper, %form,
						    $LaTeXwidth);
	    $result .= '\end{document}';  
	    if (!($result =~ /\\begin\{document\}/)) {
		$result = &print_latex_header() . $result;
	    }
	    # End construction space sequence.
	} elsif ($cleanURL=~/\/(smppg|syllabus|aboutme|bulletinboard)$/) { 
		$form{'latex_type'}=$helper->{'VARS'}->{'LATEX_TYPE'};
		if ($currentURL=~/\/syllabus$/) {$currentURL=~s/\/res//;}
		$resources_printed .= $currentURL.':';
		my $texversion = &ssi_with_retries($currentURL, $ssi_retry_count, %form);
		if ($helper->{'VARS'}->{'PRINT_ANNOTATIONS'} eq 'yes') {
		    my $annotation = &annotate($currentURL);
		    $texversion    =~ s/(\\end{document})/$annotation$1/;
		}
		$result .= $texversion;
	} elsif ($cleanURL =~/\.tex$/) {
	    # For this sort of print of a single LaTeX file,
	    # We can just print the LaTeX file as it is uninterpreted in any way:
	    #

	    $result = &fetch_raw_resource($currentURL);
	    if ($helper->{'VARS'}->{'PRINT_ANNOTATIONS'} eq 'yes') {
		my $annotation = &annotate($currentURL);
		$result =~ s/(\\end{document})/$annotation$1/;
	    }

	    $do_postprocessing = 0; # Don't massage the result.

	} elsif ($cleanURL =~ /\.pdf$/i) {
	    $result .= &include_pdf($cleanURL);
	    $result .= '\end{document}';
	} elsif ($cleanURL =~ /\.page$/i) { #  Print page in non construction space contexts.

	    # Determine the set of resources in the map of the page:

	    my $navmap         =  Apache::lonnavmaps::navmap->new();
	    my @page_resources =  $navmap->retrieveResources($cleanURL);
	    $result           .=  &print_page_in_course($helper, $rparmhash,
							$cleanURL, \@page_resources);

       
	} else {
	    $result.=&unsupported($currentURL,$helper->{'VARS'}->{'LATEX_TYPE'},
				  $helper->{'VARS'}->{'symb'});
	}
    } elsif (($print_type eq 'map_problems')          or
	     ($print_type eq 'map_problems_in_page')  or
	     ($print_type eq 'map_resources_in_page') or
             ($print_type eq 'map_problems_pages')    or
             ($print_type eq 'all_problems')          or
	     ($print_type eq 'all_resources')         or # BUGBUG
	     ($print_type eq 'select_sequences')      or
	     ($print_type eq 'map_incomplete_problems_seq')
	     ) {
 
        #-- produce an output string
	if (($print_type eq 'map_problems')                or
	    ($print_type eq 'map_incomplete_problems_seq') or
	    ($print_type eq 'map_problems_in_page') ) {
	    $selectionmade = 2;
	} elsif (($print_type eq 'map_problems_pages') or
		 ($print_type eq 'map_resources_in_page'))
	{
	    $selectionmade = 3;
	} elsif (($print_type eq 'all_problems') 
		 ) {
	    $selectionmade = 4;
	} elsif ($print_type eq 'all_resources') {  #BUGBUG
	    $selectionmade = 4;
	} elsif ($print_type eq 'select_sequences') {
	    $selectionmade = 7;
	}

	$form{'problem_split'}=$parmhash{'problem_stream_switch'};
	$form{'suppress_tries'}=$parmhash{'suppress_tries'};
	$form{'latex_type'}=$helper->{'VARS'}->{'LATEX_TYPE'};
	$form{'print_discussions'}=$helper->{'VARS'}->{'PRINT_DISCUSSIONS'};
	$form{'print_annotations'} = $helper->{'VARS'}->{'PRINT_ANNOTATIONS'};
	if (($helper->{'VARS'}->{'PRINT_DISCUSSIONS'} eq 'yes')   ||
	    ($helper->{'VARS'}->{'PRINT_ANNOTATIONS'} eq 'yes') ) {
	    $form{'problem_split'}='yes';
	}
	my $flag_latex_header_remove = 'NO';
	my $flag_page_in_sequence = 'NO';
	my @master_seq=split /\|\|\|/, $helper->{'VARS'}->{'RESOURCES'};
	my $prevassignment='';

	&Apache::lonxml::clear_problem_counter();

	my $pbreakresources = keys %page_breaks;
	for (my $i=0;$i<=$#master_seq;$i++) {

	    &Apache::lonenc::reset_enc();


	    # Note due to document structure, not allowed to put \newpage
	    # prior to the first resource

	    if (defined $page_breaks{$master_seq[$i]}) {
		if($i != 0) {
		    $result.="\\newpage\n";
		}
	    }
	    $result .= &get_extra_vspaces($helper, $master_seq[$i]);
	    my ($sequence,$middle_thingy,$urlp)=&Apache::lonnet::decode_symb($master_seq[$i]);
	    $urlp=&Apache::lonnet::clutter($urlp);
	    $form{'symb'}=$master_seq[$i];

	    my $assignment=&Apache::lonxml::latex_special_symbols(&Apache::lonnet::gettitle($sequence),'header'); #title of the assignment which contains this problem

	    if ($selectionmade==7) {$helper->{VARS}->{'assignment'}=$assignment;}
	    if ($i==0) {$prevassignment=$assignment;}
	    my $texversion='';
	    if ($urlp!~m|^/adm/|
		&& $urlp=~/\.(problem|exam|quiz|assess|survey|form|library|page|xml|html|htm|xhtml|xhtm)$/) {
		$resources_printed .= $urlp.':';
		&Apache::lonxml::remember_problem_counter();
		if ($flag_latex_header_remove eq 'NO') {
		    $texversion.=&print_latex_header($helper->{'VARS'}->{'LATEX_TYPE'});  # RF
                    unless (($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'only') ||
                            (($i==0) &&
                             (($urlp=~/\.page$/) ||
                              ($print_type eq 'map_problems_in_page') ||
                              ($print_type eq 'map_resources_in_page')))) {
                        $flag_latex_header_remove = 'YES';
                    }
		}
		$texversion.=&ssi_with_retries($urlp, $ssi_retry_count, %form);
		if ($urlp=~/\.page$/) {
		    ($texversion,my $number_of_columns_page) = &page_cleanup($texversion);
		    if ($number_of_columns_page > $number_of_columns) {$number_of_columns=$number_of_columns_page;} 
		    $texversion =~ s/\\end{document}\d*/\\end{document}/;
		    $flag_page_in_sequence = 'YES';
		}

		if(($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'no') ||
		   ($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'only')) {
		    #  Don't permanently pervert the %form hash
		    my %answerform = %form;
		    $answerform{'grade_target'}='answer';
		    $answerform{'answer_output_mode'}='tex';
		    $resources_printed .= $urlp.':';

		    &Apache::lonxml::restore_problem_counter();
		    my $answer=&ssi_with_retries($urlp, $ssi_retry_count, %answerform);
                    if ($urlp =~ /\.page$/) {
                        $answer =~ s/\\end{document}(\d*)$//;
                    }
		    if ($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'no') {
                        if ($urlp =~ /\.page$/) {
                            my @probs = split(/\\keephidden{ENDOFPROBLEM}/,$texversion);
                            my $lastprob = pop(@probs);
                            $texversion = join('\keephidden{ENDOFPROBLEM}',@probs).
                            $answer.'\keephidden{ENDOFPROBLEM}'.$lastprob;
                        } else {
                            $texversion=~s/(\\keephidden{ENDOFPROBLEM})/$answer$1/;
                        }
		    } else {
			if ($urlp=~/$LONCAPA::assess_page_re/) {
			    $texversion=&print_latex_header($helper->{'VARS'}->{'LATEX_TYPE'});
#			    $texversion =~ s/\\begin{document}//; # FIXME
			    my $title = &Apache::lonnet::gettitle($master_seq[$i]);
			    $title = &Apache::lonxml::latex_special_symbols($title);
			    my $body ='\vskip 0 mm \noindent\textbf{'.$title.'}\vskip 0 mm ';
			    $body   .= &path_to_problem ($urlp,$LaTeXwidth);
			    $body   .='\vskip 1 mm '.$answer;
			    $body    = &encapsulate_minipage($body);
			    $texversion .= $body;
			} else {
			    $texversion='';
			}
		    }

		}
		if ($helper->{'VARS'}->{'PRINT_ANNOTATIONS'} eq 'yes') {
		    my $annotation .= &annotate($urlp);
		    $texversion =~ s/(\\keephidden{ENDOFPROBLEM})/$annotation$1/;
		}

		if ($flag_latex_header_remove ne 'NO') {
		    $texversion = &latex_header_footer_remove($texversion);
		} else {
		    $texversion =~ s/\\end{document}//;
		}
		if ($helper->{'VARS'}->{'TABLE_INDEX'} eq 'yes') {
		    $texversion=&IndexCreation($texversion,$urlp);
		}
		if (($selectionmade == 4) and ($assignment ne $prevassignment)) {
		    my $name = &get_name();
		    my $courseidinfo = &get_course();
		    $prevassignment=$assignment;
		    my $header_text = $parmhash{'print_header_format'};
		    $header_text    = &format_page_header($textwidth, $header_text,
							  $assignment, 
							  $courseidinfo, 
							  $name);
		    if ($numberofcolumns eq '1') {
			$result .='\newpage \noindent\parbox{\minipagewidth}{\noindent\\lhead{'.$header_text.'}} \vskip 5 mm ';
		    } else {
			$result .='\newpage \noindent\parbox{\minipagewidth}{\noindent\\fancyhead[LO]{'.$header_text.'}} \vskip 5 mm ';
		    }			
		}
		$result .= $texversion;
		$flag_latex_header_remove = 'YES';   
	    } elsif ($urlp=~/\/(smppg|syllabus|aboutme|bulletinboard)$/) { 
		$form{'latex_type'}=$helper->{'VARS'}->{'LATEX_TYPE'};
		if ($urlp=~/\/syllabus$/) {$urlp=~s/\/res//;}
		$resources_printed .= $urlp.':';
		my $texversion = &ssi_with_retries($urlp, $ssi_retry_count, %form);
		if ($helper->{'VARS'}->{'PRINT_ANNOTATIONS'} eq 'yes') {
		    my $annotation = &annotate($urlp);
		    $texversion =~ s/(\\end{document)/$annotation$1/;
		}

		if ($flag_latex_header_remove ne 'NO') {
		    $texversion = &latex_header_footer_remove($texversion);
		} else {	
		    $texversion =~ s/\\end{document}/\\vskip 0\.5mm\\noindent\\makebox\[\\textwidth\/\$number_of_columns\]\[b\]\{\\hrulefill\}/;
		}
		$result .= $texversion;
		$flag_latex_header_remove = 'YES'; 
	    } elsif ($urlp=~ /\.pdf$/i) {
		if ($i > 0) {
		    $result .= '\cleardoublepage';
		}
                my $texfrompdf = &include_pdf($urlp);
                if ($flag_latex_header_remove ne 'NO') {
                    $texfrompdf = &latex_header_footer_remove($texfrompdf);
                }
                $result .= $texfrompdf;
		if ($i != $#master_seq) {
		    if ($numberofcolumns eq '1') {
			$result .= '\newpage';
		    } else {
			# the \\'s seem to be needed to let LaTeX know there's something
			# on the page since LaTeX seems to not like to clear an empty page.
			#
			$result .= '\\ \cleardoublepage';
		    }
		}
		$flag_latex_header_remove = 'YES';

	    } else {
		$texversion=&unsupported($urlp,$helper->{'VARS'}->{'LATEX_TYPE'},
					 $master_seq[$i]);
		if ($flag_latex_header_remove ne 'NO') {
		    $texversion = &latex_header_footer_remove($texversion);
		} else {
		    $texversion =~ s/\\end{document}//;
		}
		$result .= $texversion;
		$flag_latex_header_remove = 'YES';   
	    }
	    if (&Apache::loncommon::connection_aborted($r)) { 
		last; 
	    }
	}
	&Apache::lonxml::clear_problem_counter();
	if ($flag_page_in_sequence eq 'YES') {
	    $result =~ s/\\usepackage{calc}/\\usepackage{calc}\\usepackage{longtable}/;
	}	
	$result .= '\end{document}';
     } elsif (($print_type eq 'problems_for_students')           ||
	      ($print_type eq 'problems_for_students_from_page') ||
	      ($print_type eq 'all_problems_students')           ||
	      ($print_type eq 'resources_for_students')          ||
	      ($print_type eq 'incomplete_problems_selpeople_course') ||
	      ($print_type eq 'map_incomplete_problems_people_seq')){


     #-- prints assignments for whole class or for selected students  
	 my $type;
	 if (($print_type eq 'problems_for_students')           ||
	     ($print_type eq 'problems_for_students_from_page') ||
	     ($print_type eq 'all_problems_students')           ||
	     ($print_type eq 'incomplete_problems_selpeople_course') ||
	     ($print_type eq 'map_incomplete_problems_people_seq')) {
	     $selectionmade=5;
	     $type='problems';
	 } elsif ($print_type eq 'resources_for_students') {
	     $selectionmade=8;
	     $type='resources';
	 }
	 my @students=split /\|\|\|/, $helper->{'VARS'}->{'STUDENTS'};
	 #   The normal sort order is by section then by students within the
	 #   section. If the helper var student_sort is 1, then the user has elected
	 #   to override this and output the students by name.
	 #    Each element of the students array is of the form:
	 #       username:domain:section:last, first:status
	 #    
	 #  Note that student sort is not compatible with printing 
	 #  1 section per pdf...so that setting overrides.
	 #   
	 if (($helper->{'VARS'}->{'student_sort'}    eq 1)  && 
	     ($helper->{'VARS'}->{'SPLIT_PDFS'} ne "sections")) {
	     @students = sort compare_names  @students;
	 } else {
	     @students = sort compare_sections @students; 
	 }
	 &adjust_number_to_print($helper);

         if ($helper->{'VARS'}->{'NUMBER_TO_PRINT'} eq '0' ||
	     $helper->{'VARS'}->{'NUMBER_TO_PRINT'} eq 'all' ) {
	     $helper->{'VARS'}->{'NUMBER_TO_PRINT'}=$#students+1;
	 }
	 # If we are splitting on section boundaries, we need 
	 # to remember that in split_on_sections and 
	 # print all of the students in the list.
	 #
	 my $split_on_sections = 0;
	 if ($helper->{'VARS'}->{'NUMBER_TO_PRINT'} eq 'section') {
	     $split_on_sections = 1;
	     $helper->{'VARS'}->{'NUMBER_TO_PRINT'} = $#students+1;
	 }
	 my @master_seq=split /\|\|\|/, $helper->{'VARS'}->{'RESOURCES'};

         my $map;
         if ($helper->{VARS}->{'symb'}) {
             ($map, my $id, my $resource) =
                 &Apache::lonnet::decode_symb($helper->{VARS}->{'symb'});
         }

	 #loop over students

 	 my $flag_latex_header_remove = 'NO';
	 my %moreenv;
         $moreenv{'instructor_comments'}='hide';
	 $moreenv{'textwidth'}=&get_textwidth($helper,$LaTeXwidth);
	 $moreenv{'print_discussions'}=$helper->{'VARS'}->{'PRINT_DISCUSSIONS'};
	 $moreenv{'print_annotations'} = $helper->{'VARS'}->{'PRINT_ANNOTATIONS'};
	 $moreenv{'problem_split'}    = $parmhash{'problem_stream_switch'};
	 $moreenv{'suppress_tries'}   = $parmhash{'suppress_tries'};
	 if (($helper->{'VARS'}->{'PRINT_DISCUSSIONS'} eq 'yes')  ||
	     ($helper->{'VARS'}->{'PRINT_ANNOTATIONS'} eq 'yes')) {
	     $moreenv{'problem_split'}='yes';
	 }
	 my %prog_state=&Apache::lonhtmlcommon::Create_PrgWin($r,$#students+1);
	 my $student_counter=-1;
	 my $i = 0;
	 my $last_section = (split(/:/,$students[0]))[2];
	 foreach my $person (@students) {
             my $duefile="/home/httpd/prtspool/$env{'user.name'}_$env{'user.domain'}_printout.due";
	     if (-e $duefile) {
		 my $temp_file = Apache::File->new('>>'.$duefile);
		 print $temp_file "1969\n";
	     }
	     $student_counter++;
	     if ($split_on_sections) {
		 my $this_section = (split(/:/,$person))[2];
		 if ($this_section ne $last_section) {
		     $i++;
		     $last_section = $this_section;
		 }
	     } else {
		 $i=int($student_counter/$helper->{'VARS'}{'NUMBER_TO_PRINT'});
	     }
	     my $actual_seq = master_seq_to_person_seq($map, \@master_seq,
                                                       $person, undef, 1);
	     my ($output,$fullname, $printed)=&print_resources($r,$helper,
						     $person,$type,
						     \%moreenv,  $actual_seq,
						     $flag_latex_header_remove,
						     $LaTeXwidth);
	     $resources_printed .= ":";
	     $print_array[$i].=$output;
	     $student_names[$i].=$person.':'.$fullname.'_END_';
#	     &Apache::lonhtmlcommon::Increment_PrgWin($r,\%prog_state,&mt('last student').' '.$fullname);
	     &Apache::lonhtmlcommon::Increment_PrgWin($r,\%prog_state,'last student');
	     $flag_latex_header_remove = 'YES';
	     if (&Apache::loncommon::connection_aborted($r)) { last; }
	 }
	 &Apache::lonhtmlcommon::Close_PrgWin($r,\%prog_state);
	 $result .= $print_array[0].'  \end{document}';
     } elsif (($print_type eq 'problems_for_anon')      ||
	      ($print_type eq 'problems_for_anon_page') ||
	      ($print_type eq 'resources_for_anon')  ) { 
	 my $cdom =$env{'course.'.$env{'request.course.id'}.'.domain'};
	 my $cnum =$env{'course.'.$env{'request.course.id'}.'.num'};
	 my $num_todo=$helper->{'VARS'}->{'NUMBER_TO_PRINT_TOTAL'};
	 my $code_name=$helper->{'VARS'}->{'ANON_CODE_STORAGE_NAME'};
	 my $old_name=$helper->{'VARS'}->{'REUSE_OLD_CODES'};
	 my $single_code = $helper->{'VARS'}->{'SINGLE_CODE'};
	 my $selected_code = $helper->{'VARS'}->{'CODE_SELECTED_FROM_LIST'};
	 my $code_option=$helper->{'VARS'}->{'CODE_OPTION'};
         my @lines = &Apache::grades::get_scantronformat_file();
	 my ($code_type,$code_length,$bubbles_per_row)=('letter',6,10);
	 foreach my $line (@lines) {
             chomp($line);
	     my ($name,$type,$length,$bubbles_per_item) = 
                 (split(/:/,$line))[0,2,4,17];
	     if ($name eq $code_option) {
		 $code_length=$length;
		 if ($type eq 'number') { $code_type = 'number'; }
                 chomp($bubbles_per_item); 
                 if (($bubbles_per_item ne '') && ($bubbles_per_item > 0)) {
                     $bubbles_per_row = $bubbles_per_item; 
                 }
	     }
	 }
         my ($randomorder,$randompick,$map);
         if ($helper->{VARS}{'symb'}) {
             ($map, my $id, my $resource) =
                 &Apache::lonnet::decode_symb($helper->{VARS}{'symb'});
             my $navmap = Apache::lonnavmaps::navmap->new();
             if (defined($navmap)) {
                 if ($map) {
                     my $mapres = $navmap->getResourceByUrl($map);
                     $randomorder = $mapres->randomorder();
                     $randompick = $mapres->randompick();
                 }
             }
         }
	 my %moreenv = ('textwidth' => &get_textwidth($helper,$LaTeXwidth));
	 $moreenv{'problem_split'}    = $parmhash{'problem_stream_switch'};
         $moreenv{'instructor_comments'}='hide';
         $moreenv{'bubbles_per_row'} = $bubbles_per_row;
	 my $seed=time+($$<<16)+($$);
	 my @allcodes;
	 if ($old_name) {
	     my %result=&Apache::lonnet::get('CODEs',
					     [$old_name,"type\0$old_name"],
					     $cdom,$cnum);
	     $code_type=$result{"type\0$old_name"};
	     @allcodes=split(',',$result{$old_name});
	     $num_todo=scalar(@allcodes);
	 } elsif ($selected_code) { # Selection value is always numeric.
	     $num_todo = 1;
	     @allcodes = ($selected_code);
	 } elsif ($single_code) {

	     $num_todo    = 1;	# Unconditionally one code to do.
	     # If an alpha code have to convert to numbers so it can be
	     # converted back to letters again :-)
	     #
	     if ($code_type ne 'number') {
		 $single_code = &letters_to_num($single_code);
	     }
	     @allcodes = ($single_code);
	 } else {
	     my %allcodes;
	     srand($seed);
	     for (my $i=0;$i<$num_todo;$i++) {
		 $moreenv{'CODE'}=&get_CODE(\%allcodes,$i,$seed,$code_length,
					    $code_type);
	     }
	     if ($code_name) {
		 &Apache::lonnet::put('CODEs',
				      {
					$code_name =>join(',',keys(%allcodes)),
					"type\0$code_name" => $code_type
				      },
				      $cdom,$cnum);
	     }
	     @allcodes=keys(%allcodes);
	 }
	 my @master_seq=split /\|\|\|/, $helper->{'VARS'}->{'RESOURCES'};
	 my ($type) = split(/_/,$print_type);
	 &adjust_number_to_print($helper);
	 my $number_per_page=$helper->{'VARS'}->{'NUMBER_TO_PRINT'};
	 if ($number_per_page eq '0' || $number_per_page eq 'all'
	     || $number_per_page eq 'section') {
	     $number_per_page=$num_todo > 0 ? $num_todo : 1;
	 }
	 my $flag_latex_header_remove = 'NO'; 
	 my %prog_state=&Apache::lonhtmlcommon::Create_PrgWin($r,$num_todo);
	 my $count=0;
	 foreach my $code (sort(@allcodes)) {
	     my $file_num=int($count/$number_per_page);
	     if ($code_type eq 'number') { 
		 $moreenv{'CODE'}=$code;
	     } else {
		 $moreenv{'CODE'}=&num_to_letters($code);
	     }
             my $actual_seq = \@master_seq;
             if ($randomorder || $randompick) {
                 $env{'form.CODE'} = $moreenv{'CODE'};
                 $actual_seq = master_seq_to_person_seq($map, \@master_seq,
                                                        undef,
                                                        $moreenv{'CODE'}, 1);
                 delete($env{'form.CODE'});
             }
	     my ($output,$fullname, $printed)=
		 &print_resources($r,$helper,'anonymous',$type,\%moreenv,
				  $actual_seq,$flag_latex_header_remove,
				  $LaTeXwidth);
	     $resources_printed .= ":";
	     $print_array[$file_num].=$output;
	     &Apache::lonhtmlcommon::Increment_PrgWin($r,\%prog_state,
				       &mt('last assignment').' '.$fullname);
	     $flag_latex_header_remove = 'YES';
	     $count++;
	     if (&Apache::loncommon::connection_aborted($r)) { last; }
	 }
	 &Apache::lonhtmlcommon::Close_PrgWin($r,\%prog_state);
	 $result .= $print_array[0].'  \end{document}';
     } elsif ($print_type eq 'problems_from_directory') {      
    #prints selected problems from the subdirectory 
	$selectionmade = 6;
        my @list_of_files=split /\|\|\|/, $helper->{'VARS'}->{'FILES'};
	@list_of_files=sort @list_of_files;
	my $flag_latex_header_remove = 'NO'; 
	my $rndseed=time;
	if ($helper->{'VARS'}->{'curseed'}) {
	    $rndseed=$helper->{'VARS'}->{'curseed'};
	}
	for (my $i=0;$i<=$#list_of_files;$i++) {

	    &Apache::lonenc::reset_enc();

	    my $urlp = $list_of_files[$i];
	    $urlp=~s|//|/|;
	    if ($urlp=~/\//) {
		$form{'problem_split'}=$parmhash{'problem_stream_switch'};
		$form{'rndseed'}=$rndseed;
		$urlp =~ s|^$Apache::lonnet::perlvar{'lonDocRoot'}||;
		$resources_printed .= $urlp.':';
		my $texversion=&ssi_with_retries($urlp, $ssi_retry_count, %form);
		if(($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'no') ||
		   ($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'only')) {
		    #  Don't permanently pervert %form:
		    my %answerform = %form;
		    $answerform{'grade_target'}='answer';
		    $answerform{'answer_output_mode'}='tex';
		    $answerform{'latex_type'}=$helper->{'VARS'}->{'LATEX_TYPE'};
		    $answerform{'rndseed'}=$rndseed;
		    $resources_printed .= $urlp.':';
		    my $answer=&ssi_with_retries($urlp, $ssi_retry_count, %answerform);
		    if ($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'no') {
			$texversion=~s/(\\keephidden{ENDOFPROBLEM})/$answer$1/;
		    } else {
			$texversion=&print_latex_header($helper->{'VARS'}->{'LATEX_TYPE'});
			if ($helper->{'VARS'}->{'construction'} ne '1') {
			    $texversion.='\vskip 0 mm \noindent ';
			    $texversion.=&path_to_problem ($urlp,$LaTeXwidth);
			} else {
			    $texversion.='\vskip 0 mm \noindent\textbf{'.
                                         &mt("Printing from Authoring Space: No Title").'}\vskip 0 mm ';
			    $texversion.=&path_to_problem ($urlp,$LaTeXwidth);
			}
			$texversion.='\vskip 1 mm '.$answer.'\end{document}';
		    }
		}
                #this chunk is responsible for printing the path to problem

		my $newurlp=&path_to_problem($urlp,$LaTeXwidth);
		$texversion =~ s/(\\begin{minipage}{\\textwidth})/$1 $newurlp/;
		if ($flag_latex_header_remove ne 'NO') {
		    $texversion = &latex_header_footer_remove($texversion);
		} else {
		    $texversion =~ s/\\end{document}//;
		}
		if ($helper->{'VARS'}->{'TABLE_INDEX'} eq 'yes') {
		    $texversion=&IndexCreation($texversion,$urlp);
		}
		if ($helper->{'VARS'}->{'CONSTR_RESOURSE_URL'} eq 'yes') {
		    $texversion=~s/(\\addcontentsline\{toc\}\{subsection\}\{[^\}]*\})/$1 URL: \\verb|$urlp| \\strut\\\\\\strut /;
		    
		}
		$result .= $texversion;
	    }
	    $flag_latex_header_remove = 'YES';  
	}
	if ($helper->{VARS}->{'construction'} eq '1') {$result=~s/(\\typeout)/ RANDOM SEED IS $rndseed $1/;}
	$result .= '\end{document}';      	
    }
#-------------------------------------------------------- corrections for the different page formats

    # Only post process if that has not been turned off e.g. by a raw latex resource.

    if ($do_postprocessing) {
	$result = &page_format_transformation($papersize,
					      $laystyle,$numberofcolumns,
					      $print_type,$result,
					      $helper->{VARS}->{'assignment'},
					      $helper->{'VARS'}->{'TABLE_CONTENTS'},
					      $helper->{'VARS'}->{'TABLE_INDEX'},
					      $selectionmade);
	$result = &latex_corrections($number_of_columns,$result,$selectionmade,
				     $helper->{'VARS'}->{'ANSWER_TYPE'});
	#if ($numberofcolumns == 1) {
	$result =~ s/\\textwidth\s*=\s*-?\d*\.?\d*\s*(cm|mm|in)/\\textwidth= $helper->{'VARS'}->{'pagesize.width'} $helper->{'VARS'}->{'pagesize.widthunit'} /;
	$result =~ s/\\textheight\s*=?\s*-?\d*\.?\d*\s*(cm|mm|in)/\\textheight $helper->{'VARS'}->{'pagesize.height'} $helper->{'VARS'}->{'pagesize.heightunit'} /;
	$result =~ s/\\evensidemargin\s*=\s*-?\d*\.?\d*\s*(cm|mm|in)/\\evensidemargin= $helper->{'VARS'}->{'pagesize.lmargin'} $helper->{'VARS'}->{'pagesize.lmarginunit'} /;
	$result =~ s/\\oddsidemargin\s*=\s*-?\d*\.?\d*\s*(cm|mm|in)/\\oddsidemargin= $helper->{'VARS'}->{'pagesize.lmargin'} $helper->{'VARS'}->{'pagesize.lmarginunit'} /;
	#}
    }

    # Set URLback if this is a construction space print so we can provide
    # a link to the resource being edited.
    #

    my $URLback=''; #link to original document
    if ($helper->{'VARS'}->{'construction'} eq '1') {
	$URLback=$helper->{'VARS'}->{'filename'};
    }
    #
    # Final adjustment of the font size:
    #

    $result = set_font_size($result);

    # Insert any babel headers required.

    $result       = &collect_languages($result);


#-- writing .tex file in prtspool 
    my $temp_file;
    my $identifier = &Apache::loncommon::get_cgi_id();
    my $filename = "/home/httpd/prtspool/$env{'user.name'}_$env{'user.domain'}_printout_$identifier.tex";
    if (!($#print_array>0)) { 
       unless ($temp_file = Apache::File->new('>'.$filename)) {
	  $r->log_error("Couldn't open $filename for output $!");
	  return SERVER_ERROR; 
       }
       print $temp_file $result;
       my $begin=index($result,'\begin{document}',0);
       my $inc=substr($result,0,$begin+16); 
    } else {
       my $begin=index($result,'\begin{document}',0);
       my $inc=substr($result,0,$begin+16);
       for (my $i=0;$i<=$#print_array;$i++) {
	  if ($i==0) {
	      $print_array[$i]=$result;
	  } else {
	      $print_array[$i].='\end{document}';
	      $print_array[$i] = 
		&latex_corrections($number_of_columns,$print_array[$i],
				   $selectionmade, 
				   $helper->{'VARS'}->{'ANSWER_TYPE'});
	    
	      my $anobegin=index($print_array[$i],'\setcounter{page}',0);
	      substr($print_array[$i],0,$anobegin)='';
	      $print_array[$i]=$inc.$print_array[$i];
	  }
	  my $temp_file;
	  my $newfilename=$filename;
	  my $num=$i+1;
	  $newfilename =~s/\.tex$//; 
	  $newfilename=sprintf("%s_%03d.tex",$newfilename, $num);
	  unless ($temp_file = Apache::File->new('>'.$newfilename)) {
	      $r->log_error("Couldn't open $newfilename for output $!");
	      return SERVER_ERROR; 
	  }
	  print $temp_file $print_array[$i];
       }
    }
    my $student_names='';
    if ($#print_array>0) {
        for (my $i=0;$i<=$#print_array;$i++) {
  	  $student_names.=$student_names[$i].'_ENDPERSON_';
	}
    } else {
	if ($#student_names>-1) {
	   $student_names=$student_names[0].'_ENDPERSON_';
	} else {
           my $fullname = &get_name($env{'user.name'},$env{'user.domain'});
	   $student_names=join(':',$env{'user.name'},$env{'user.domain'},
				    $env{'request.course.sec'},$fullname).
					'_ENDPERSON_'.'_END_';
	}
     }
	
     # logic for now is too complex to trace if this has been defined
     #  yet.
     my $cnum = $env{'course.'.$env{'request.course.id'}.'.num'};
     my $cdom = $env{'course.'.$env{'request.course.id'}.'.domain'};
     &Apache::lonnet::appenv({'cgi.'.$identifier.'.file'   => $filename,
				'cgi.'.$identifier.'.layout'  => $laystyle,
				'cgi.'.$identifier.'.numcol'  => $numberofcolumns,
				'cgi.'.$identifier.'.paper'  => $papersize,
				'cgi.'.$identifier.'.selection' => $selectionmade,
				'cgi.'.$identifier.'.tableofcontents' => $helper->{'VARS'}->{'TABLE_CONTENTS'},
				'cgi.'.$identifier.'.tableofindex' => $helper->{'VARS'}->{'TABLE_INDEX'},
				'cgi.'.$identifier.'.role' => $perm{'pav'},
				'cgi.'.$identifier.'.numberoffiles' => $#print_array,
				'cgi.'.$identifier.'.studentnames' => $student_names,
				'cgi.'.$identifier.'.backref' => $URLback,});
    &Apache::lonnet::appenv({"cgi.$identifier.user"    => $env{'user.name'},
				"cgi.$identifier.domain"  => $env{'user.domain'},
				"cgi.$identifier.courseid" => $cnum, 
				"cgi.$identifier.coursedom" => $cdom, 
				"cgi.$identifier.resources" => $resources_printed});
	
    my $end_page = &Apache::loncommon::end_page();
    my $continue_text = &mt('Continue');
    # If there's been an unrecoverable SSI error, report it to the user
    if ($ssi_error) {
        my $helpurl = &Apache::loncommon::top_nav_help('Helpdesk');
        $r->print('<br /><p class="LC_error">'.&mt('An unrecoverable network error occurred:').'</p><p>'.
                  &mt('At least one of the resources you chose to print could not be rendered due to an unrecoverable error when communicating with a server:').
                  '<br />'.$ssi_last_error_resource.'<br />'.$ssi_last_error.
                  '</p><p>'.&mt('You can continue using the link provided below, but make sure to carefully inspect your output file! The errors will be marked in the file.').'<br />'.
                  &mt('You may be able to reprint the individual resources for which this error occurred, as the issue may be temporary.').
                  '<br />'.&mt('If the error persists, please contact the [_1] for assistance.',$helpurl).'</p><p>'.
                  &mt('We apologize for the inconvenience.').'</p>'.
                  '<a href="/cgi-bin/printout.pl?'.$identifier.'">'.$continue_text.'</a>'.$end_page);
    } else {
	$r->print(<<FINALEND);
<br />
<meta http-equiv="Refresh" content="0; url=/cgi-bin/printout.pl?$identifier" />
<a href="/cgi-bin/printout.pl?$identifier">$continue_text</a>
$end_page
FINALEND
    }                                     # endif ssi errors.
}


sub get_CODE {
    my ($all_codes,$num,$seed,$size,$type)=@_;
    my $max='1'.'0'x$size;
    my $newcode;
    while(1) {
	$newcode=sprintf("%0".$size."d",int(rand($max)));
	if (!exists($$all_codes{$newcode})) {
	    $$all_codes{$newcode}=1;
	    if ($type eq 'number' ) {
		return $newcode;
	    } else {
		return &num_to_letters($newcode);
	    }
	}
    }
}

sub print_resources {
    my ($r,$helper,$person,$type,$moreenv,$master_seq,$remove_latex_header,
	$LaTeXwidth)=@_;
    my $current_output = ''; 
    my $printed = '';
    my ($username,$userdomain,$usersection) = split /:/,$person;
    my $fullname = &get_name($username,$userdomain);
    my $namepostfix = "\\\\";	# Both anon and not anon should get the same vspace.


    #
    # Figure out if we need to filter the output by
    # the incomplete problems for that person
    #
    my $print_type = $helper->{'VARS'}->{'PRINT_TYPE'};
    my $print_incomplete = 0;
    if (($print_type eq 'map_incomplete_problems_people_seq')   ||
	($print_type eq 'incomplete_problems_selpeople_course')) {
	$print_incomplete = 1;
    }
    if ($person eq 'anonymous') {
	$namepostfix .=&mt('Name:')." ";
	$fullname = "CODE - ".$moreenv->{'CODE'};
    }

    #  Fullname may have special latex characters that need \ prefixing:
    #

    my $i           = 0;
    my $actually_printed = 0;	# Count of resources printed.
    #goes through all resources, checks if they are available for 
    #current student, and produces output   

    &Apache::lonxml::clear_problem_counter();
    my %page_breaks  = &get_page_breaks($helper);
    my $columns_in_format = (split(/\|/,$helper->{'VARS'}->{'FORMAT'}))[1];
    #
    #   end each student with a 
    #   Special that allows the post processor to even out the page
    #   counts later.  Nasty problem this... it would be really
    #   nice to put the special in as a postscript comment
    #   e.g. \special{ps:\ENDOFSTUDENTSTAMP}  unfortunately,
    #   The special gets passed the \ and dvips puts it in the output file
    #   so we will just rely on prntout.pl to strip  ENDOFSTUDENTSTAMP from the
    #   postscript.  Each ENDOFSTUDENTSTAMP will go on a line by itself.
    #

    my $syllabus_first = 0;
    my $assessment_first = 0;
    my $current_assignment = "";
    my $assignment;
    my $courseidinfo = &get_course();

    foreach my $curresline (@{$master_seq})  {
	if (defined $page_breaks{$curresline}) {
	    if($i != 0) {
		$current_output.= "\\newpage\n";
	    }
	}
	$current_output .= &get_extra_vspaces($helper, $curresline);
	$i++;
	my ($map,$id,$res_url) = &Apache::lonnet::decode_symb($curresline);

	# See if we need to emit a new header:

	if ( !($type eq 'problems' && 
	       ($curresline!~ m/$LONCAPA::assess_page_re/)) ) {
	    if ($print_incomplete && !&incomplete($username, $userdomain, $res_url)) {
		next;
	    }
            if ((!$actually_printed) && ($curresline =~ m/$LONCAPA::assess_re/)) {
                $assessment_first = 1;
            }
	    $actually_printed++; # we're going to print one.

	    if (&Apache::lonnet::allowed('bre',$res_url)) {
		if ($res_url!~m|^ext/|
		    && $res_url=~/\.(problem|exam|quiz|assess|survey|form|library|page|xml|html|htm|xhtml|xhtm)$/) {
		    $printed .= $curresline.':';
		    &Apache::lonxml::remember_problem_counter();    

		    my $rendered = &get_student_view_with_retries($curresline,$ssi_retry_count,$username,$userdomain,$env{'request.course.id'},'tex',$moreenv);
                    if ($res_url =~ /\.page$/) {
                        if ($remove_latex_header eq 'NO') {
                            if (!($rendered =~ /\\begin\{document\}/)) {
                                $rendered = &print_latex_header().$rendered;
                            }
                        }
;
                        if ($remove_latex_header eq 'YES') {
                            $rendered = &latex_header_footer_remove($rendered);
                        } else {
                            $rendered =~ s/\\end{document}\d*//;
                        }
                    }
		    if(($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'no') ||
		       ($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'only')) {
			#   Use a copy of the hash so we don't pervert it on future loop passes.
			my %answerenv = %{$moreenv};
			$answerenv{'answer_output_mode'}='tex';


			$answerenv{'latex_type'}=$helper->{'VARS'}->{'LATEX_TYPE'};
			
			&Apache::lonxml::restore_problem_counter();

			my $ansrendered = &Apache::loncommon::get_student_answers($curresline,$username,$userdomain,$env{'request.course.id'},%answerenv);

			if ($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'no') {
			    $rendered=~s/(\\keephidden{ENDOFPROBLEM})/$ansrendered$1/;
			} else {

			    
			    my $header =&print_latex_header($helper->{'VARS'}->{'LATEX_TYPE'});
                            unless ($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'only') {
                                $header =~ s/\\begin{document}//;     #<<<<<
                            }
			    my $title = &Apache::lonnet::gettitle($curresline);
			    $title = &Apache::lonxml::latex_special_symbols($title);
			    my $body   ='\vskip 0 mm \noindent\textbf{'.$title.'}\vskip 0 mm ';
			    $body     .=&path_to_problem($res_url,$LaTeXwidth);
			    $body     .='\vskip 1 mm '.$ansrendered;
			    $body     = &encapsulate_minipage($body);
			    $rendered = $header.$body;
			}
		    }
		    if ($helper->{'VARS'}->{'PRINT_ANNOTATIONS'} eq 'yes') {
			my $url = &Apache::lonnet::clutter($res_url);
			my $annotation = &annotate($url);
			$rendered =~  s/(\\keephidden{ENDOFPROBLEM})/$annotation$1/;
		    }
		    my $junk;
		    if ($remove_latex_header eq 'YES') {
			$rendered = &latex_header_footer_remove($rendered);
		    } else {
			$rendered =~ s/\\end{document}//;
		    }
		    $current_output .= $rendered;		    
		} elsif ($res_url=~/\/(smppg|syllabus|aboutme|bulletinboard)$/) {
		    if ($i == 1) {
			$syllabus_first = 1;
		    }
		    $printed .= $curresline.':';
		    my $rendered = &get_student_view_with_retries($curresline,$ssi_retry_count,$username,$userdomain,$env{'request.course.id'},'tex',$moreenv);
		    if ($helper->{'VARS'}->{'PRINT_ANNOTATIONS'} eq 'yes') {
			my $url = &Apache::lonnet::clutter($res_url);
			my $annotation = &annotate($url);
			$annotation    =~ s/(\\end{document})/$annotation$1/;
		    }
		    if ($remove_latex_header eq 'YES') {
			$rendered = &latex_header_footer_remove($rendered);
		    } else {
			$rendered =~ s/\\end{document}//;
		    }
		    $current_output .= $rendered.'\vskip 0.5mm\noindent\makebox[\textwidth/$number_of_columns][b]{\hrulefill}\strut \vskip 0 mm \strut ';
		} elsif($res_url = ~/\.pdf$/) {
		    my $url = &Apache::lonnet::clutter($res_url);
		    my $rendered  = &include_pdf($url);
		    if ($remove_latex_header ne 'NO') {
			$rendered = &latex_header_footer_remove($rendered);
		    }
		    $current_output .= $rendered;
		} else {
		    my $rendered = &unsupported($res_url,$helper->{'VARS'}->{'LATEX_TYPE'},$curresline);
		    if ($remove_latex_header ne 'NO') {
			$rendered = &latex_header_footer_remove($rendered);
		    } else {
			$rendered =~ s/\\end{document}//;
		    }
		    $current_output .= $rendered;
		}
	    }
	    $remove_latex_header = 'YES';
	}
	$assignment = &Apache::lonxml::latex_special_symbols(
	    &Apache::lonnet::gettitle($map), 'header');
	if (($assignment ne $current_assignment) && ($assignment ne "")) {
	    my $header_line = &format_page_header($LaTeXwidth, $parmhash{'print_header_format'},
						  $assignment, $courseidinfo, 
						  $fullname, $usersection);
	    my $header_start = ($columns_in_format == 1) ? '\lhead'
		: '\fancyhead[LO]';
	    $header_line = $header_start.'{'.$header_line.'}';
	    $current_output = $current_output . $header_line;
	    $current_assignment = $assignment;
	}

	if (&Apache::loncommon::connection_aborted($r)) { last; }
    }
    # If we are printing incomplete it's possible we don't have
    # anything to print.  The print subsystem is not so good at handling
    # that so we're going to generate a stub that says there are no
    # incomplete resources for the person.
    #

    if ($actually_printed == 0) {
	$current_output  = &encapsulate_minipage("\\vskip -10mm \nNo incomplete resources\n \\vskip 100 mm { }\n");
	if ($remove_latex_header eq "NO") {
	    $current_output = &print_latex_header() . $current_output;
	} else {
	    $current_output = &latex_header_footer_remove($current_output);
	}
    }

    if ($syllabus_first) {
        $current_output =~ s/\\\\ Last updated:/Last updated:/
    }
    my $newheader;
    unless ($assessment_first) {
	my $currentassignment=&Apache::lonxml::latex_special_symbols($helper->{VARS}->{'assignment'},'header');
	my $header_line =
	    &format_page_header($LaTeXwidth, $parmhash{'print_header_format'},
				$currentassignment, $courseidinfo, $fullname, $usersection);
	my $header_start = ($columns_in_format == 1) ? '\lhead'
	    : '\fancyhead[LO]';
	$newheader = $header_start.'{'.$header_line.'}';
    }
    if ($current_output=~/\\documentclass/) {
	$current_output =~ s/\\begin{document}/\\setlength{\\topmargin}{1cm} \\begin{document}\\noindent\\parbox{\\minipagewidth}{\\noindent$newheader$namepostfix}\\vskip 5 mm /;

    } else {
	my $blankpages = 
	    '\clearpage\strut\clearpage'x$helper->{'VARS'}->{'EMPTY_PAGES'};
	
	$current_output = '\strut\vspace*{-6 mm}\\newline'.
	    &copyright_line().' \newpage '.$blankpages.$end_of_student.
	    '\setcounter{page}{1}\noindent\parbox{\minipagewidth}{\noindent'.
	    $newheader.$namepostfix. '} \vskip 5 mm '.$current_output;

    }
    #
    #  Close the student bracketing.
    #
    return ($current_output,$fullname, $printed);

}

sub printing_blocked {
    my ($r,$blocktext) = @_;
    my $title = &mt('Preparing Printout');
    &Apache::lonhtmlcommon::clear_breadcrumbs();
    &Apache::lonhtmlcommon::add_breadcrumb({href=>'/adm/printout',
                                            text=> $title});
    my $breadcrumbs = &Apache::lonhtmlcommon::breadcrumbs($title);
    &Apache::loncommon::content_type($r,'text/html');
    &Apache::loncommon::no_cache($r);
    $r->send_http_header;
    $r->print(&Apache::loncommon::start_page('Preparing Printout').
              $breadcrumbs.
              $blocktext.
              &Apache::loncommon::end_page());
    return;
}

sub handler {

    my $r = shift;

    if ($env{'request.course.id'}) {
        my $cdom = $env{'course.'.$env{'request.course.id'}.'.domain'};
        my $cnum = $env{'course.'.$env{'request.course.id'}.'.num'};
        my ($blocked,$blocktext) = 
            &Apache::loncommon::blocking_status('printout',$cnum,$cdom);
        if ($blocked) {
            my $checkrole = "cm./$cdom/$cnum";
            if ($env{'request.course.sec'} ne '') {
                $checkrole .= "/$env{'request.course.sec'}";
            }
            unless ((&Apache::lonnet::allowed('evb',undef,undef,$checkrole)) && 
                    ($env{'request.role'} !~ m{^st\./$cdom/$cnum})) {
                &printing_blocked($r,$blocktext);
                return OK;
            }
        }
    }
    
    &init_perm();
    my $helper = printHelper($r);
    if (!ref($helper)) {
	return $helper;
    }
   

    %parmhash=&Apache::lonnet::coursedescription($env{'request.course.id'});
 



    #  If a figure conversion queue file exists for this user.domain
    # we delete it since it can only be bad (if it were good, printout.pl
    # would have deleted it the last time around.

    my $conversion_queuefile = "/home/httpd/prtspool/$env{'user.name'}_$env{'user.domain'}_printout.dat";
    if(-e $conversion_queuefile) {
	unlink $conversion_queuefile;
    }
    

    &output_data($r,$helper,\%parmhash);
    return OK;
}

use Apache::lonhelper;

sub addMessage {
    my $text = shift;
    my $paramHash = Apache::lonhelper::getParamHash();
    $paramHash->{MESSAGE_TEXT} = $text;
    Apache::lonhelper::message->new();
}



sub init_perm {
    undef(%perm);
    $perm{'pav'}=&Apache::lonnet::allowed('pav',$env{'request.course.id'});
    if (!$perm{'pav'}) {
	$perm{'pav'}=&Apache::lonnet::allowed('pav',
		  $env{'request.course.id'}.'/'.$env{'request.course.sec'});
    }
    $perm{'pfo'}=&Apache::lonnet::allowed('pfo',$env{'request.course.id'});
    if (!$perm{'pfo'}) {
	$perm{'pfo'}=&Apache::lonnet::allowed('pfo',
		  $env{'request.course.id'}.'/'.$env{'request.course.sec'});
    }
    $perm{'vgr'}=&Apache::lonnet::allowed('vgr',$env{'request.course.id'});
    if (!$perm{'vgr'}) {
        $perm{'vgr'}=&Apache::lonnet::allowed('vgr',
                   $env{'request.course.id'}.'/'.$env{'request.course.sec'});
    }
}

sub get_randomly_ordered_warning {
    my ($helper,$map) = @_;

    my $message;

    my $postdata = $env{'form.postdata'} || $helper->{VARS}{'postdata'};
    my $navmap = Apache::lonnavmaps::navmap->new();
    if (defined($navmap)) {
        my $res = $navmap->getResourceByUrl($map);
        if ($res) {
	    my $func = 
	        sub { return ($_[0]->is_map() && $_[0]->randomorder); };
	    my @matches = $navmap->retrieveResources($res, $func,1,1,1);

        }
    } else {
        $message = "Retrieval of information about ordering of resources failed."; 
        return '<message type="warning">'.$message.'</message>';
    }
    return;
}

sub printHelper {
    my $r = shift;

    if ($r->header_only) {
        if ($env{'browser.mathml'}) {
            &Apache::loncommon::content_type($r,'text/xml');
        } else {
            &Apache::loncommon::content_type($r,'text/html');
        }
        $r->send_http_header;
        return OK;
    }

    # Send header, nocache
    if ($env{'browser.mathml'}) {
        &Apache::loncommon::content_type($r,'text/xml');
    } else {
        &Apache::loncommon::content_type($r,'text/html');
    }
    &Apache::loncommon::no_cache($r);
    $r->send_http_header;
    $r->rflush();

    # Unfortunately, this helper is so complicated we have to
    # write it by hand

    Apache::loncommon::get_unprocessed_cgi($ENV{QUERY_STRING});
    
    my $helper = Apache::lonhelper::helper->new("Printing Helper");
    $helper->declareVar('symb');
    $helper->declareVar('postdata');    
    $helper->declareVar('curseed'); 
    $helper->declareVar('probstatus');   
    $helper->declareVar('filename');
    $helper->declareVar('construction');
    $helper->declareVar('assignment');
    $helper->declareVar('style_file');
    $helper->declareVar('student_sort');
    $helper->declareVar('FINISHPAGE');
    $helper->declareVar('PRINT_TYPE');
    $helper->declareVar("showallfoils");
    $helper->declareVar("STUDENTS");
    $helper->declareVar("EXTRASPACE");

   


    #  The page breaks and extra spaces
    #  can get loaded initially from the course environment:
    # But we only do this in the initial state so that they are allowed to change.
    #

    
    &Apache::loncommon::restore_course_settings('print',
						{'pagebreaks'  => 'scalar',
						 'extraspace'  => 'scalar',
						 'extraspace_units' => 'scalar',
					         'lastprinttype' => 'scalar'});
    
    # This will persistently load in the data we want from the
    # very first screen.
    
    if($helper->{VARS}->{PRINT_TYPE} eq $env{'form.lastprinttype'}) {
	if (!defined ($env{"form.CURRENT_STATE"})) {
	    
	    $helper->{VARS}->{FINISHPAGE} = $env{'form.pagebreaks'};
	    $helper->{VARS}->{EXTRASPACE} = $env{'form.extraspace'};
	    $helper->{VARS}->{EXTRASPACE_UNITS} = $env{'form.extraspace_units'};
	} else {
	    my $state = $env{"form.CURRENT_STATE"};
	    if ($state eq "START") {
		$helper->{VARS}->{FINISHPAGE} = $env{'form.pagebreaks'};
		$helper->{VARS}->{EXTRASPACE} = $env{'form.extraspace'};
		$helper->{VARS}->{EXTRASPACE_UNITS} = $env{'form.extraspace_units'};
		
	    }
	}
	
    }

    # Detect whether we're coming from construction space
    if ($env{'form.postdata'}=~m{^/priv}) {
        $helper->{VARS}->{'filename'} = $env{'form.postdata'};
        $helper->{VARS}->{'construction'} = 1;
    } else {
        if ($env{'form.postdata'}) {
            $helper->{VARS}->{'symb'} = &Apache::lonnet::symbread($env{'form.postdata'});
	    if ( $helper->{VARS}->{'symb'} eq '') {
		$helper->{VARS}->{'postdata'} = $env{'form.postdata'};
	    }
        }
        if ($env{'form.symb'}) {
            $helper->{VARS}->{'symb'} = $env{'form.symb'};
        }
        if ($env{'form.url'}) {
            $helper->{VARS}->{'symb'} = &Apache::lonnet::symbread($helper->{VARS}->{'postdata'});
        }

    }

    if ($env{'form.symb'}) {
        $helper->{VARS}->{'symb'} = $env{'form.symb'};
    }
    if ($env{'form.url'}) {
        $helper->{VARS}->{'symb'} = &Apache::lonnet::symbread($helper->{VARS}->{'postdata'});

    }
    $helper->{VARS}->{'symb'}=
	&Apache::lonenc::check_encrypt($helper->{VARS}->{'symb'});
    my ($resourceTitle,$sequenceTitle,$mapTitle) = &details_for_menu($helper);
    if ($sequenceTitle ne '') {$helper->{VARS}->{'assignment'}=$sequenceTitle;}

    
    # Extract map
    my $symb = $helper->{VARS}->{'symb'};
    my ($map, $id, $url);
    my $subdir;
    my $is_published=0;		# True when printing from resource space.
    my $res_printable = 1;	# By default the current resource is printable.    
    my $userCanPrint = ($perm{'pav'} || $perm{'pfo'});
    my $res_printstartdate;
    my $res_printenddate;
    my $map_open = 0;
    my $map_close = 0xffffffff;
    my $course_open = 0;
    my $course_close = 0xffffffff;

    # Get the resource name from construction space
    if ($helper->{VARS}->{'construction'}) {
        $resourceTitle = substr($helper->{VARS}->{'filename'}, 
                                rindex($helper->{VARS}->{'filename'}, '/')+1);
        $subdir = substr($helper->{VARS}->{'filename'},
                         0, rindex($helper->{VARS}->{'filename'}, '/') + 1);
    } else {
	# From course space:

	if ($symb ne '') {
	    ($map, $id, $url) = &Apache::lonnet::decode_symb($symb);
	    $helper->{VARS}->{'postdata'} = 
		&Apache::lonenc::check_encrypt(&Apache::lonnet::clutter($url));
	    my $navmap = Apache::lonnavmaps::navmap->new();
	    my $res   = $navmap->getBySymb($symb);
	    $res_printable  = $res->resprintable() || $userCanPrint; #printability in course context
	    ($res_printstartdate, $res_printenddate) = 	&get_print_dates($res);
	    ($course_open, $course_close) = &course_print_dates($res);
	    ($map_open, $map_close)       = &map_print_dates($res);

	} else {
	    # Resource space.

	    $url = $helper->{VARS}->{'postdata'};
	    $is_published=1;	# From resource space.
	}
	$url = &Apache::lonnet::clutter($url);
        if (!$resourceTitle) { # if the resource doesn't have a title, use the filename
            my $postdata = $helper->{VARS}->{'postdata'};
            $resourceTitle = substr($postdata, rindex($postdata, '/') + 1);
        }
        $subdir = &Apache::lonnet::filelocation("", $url);


    }
    if (!$helper->{VARS}->{'curseed'} && $env{'form.curseed'}) {
	$helper->{VARS}->{'curseed'}=$env{'form.curseed'};
    }

    if (!$helper->{VARS}->{'probstatus'} && $env{'form.problemtype'}) {
	$helper->{VARS}->{'probstatus'}=$env{'form.problemstatus'};
    }

    my $userCanSeeHidden = Apache::lonnavmaps::advancedUser();

    Apache::lonhelper::registerHelperTags();

    # "Delete everything after the last slash."
    $subdir =~ s|/[^/]+$||;

    # What can be printed is a very dynamic decision based on
    # lots of factors. So we need to dynamically build this list.
    # To prevent security leaks, states are only added to the wizard
    # if they can be reached, which ensures manipulating the form input
    # won't allow anyone to reach states they shouldn't have permission
    # to reach.

    # printChoices is tracking the kind of printing the user can
    # do, and will be used in a choices construction later.
    # In the meantime we will be adding states and elements to
    # the helper by hand.
    my $printChoices = [];
    my $paramHash;

    # If there is a current resource and it is printable
    # Give that as a choice.

    if ($resourceTitle && $res_printable) {
        push @{$printChoices}, ["<b><i>$resourceTitle</i></b> (".&mt('the resource you just saw on the screen').")", 'current_document', 'PAGESIZE'];
    } 

    # Useful filter strings

    my $isPrintable = ' && $res->resprintable()';

    my $isProblem = '(($res->is_problem()||$res->contains_problem() ||$res->is_practice()))';
    $isProblem .= $isPrintable unless $userCanPrint;
    $isProblem .= ' && !$res->randomout()' if !$userCanSeeHidden;
    my $isProblemOrMap = '($res->is_problem() || $res->contains_problem() || $res->is_sequence() || $res->is_practice())';
    $isProblemOrMap .= $isPrintable unless $userCanPrint;
    my $isNotMap = '(!$res->is_sequence())';
    $isNotMap .= $isPrintable unless $userCanPrint;
    $isNotMap .= ' && !$res->randomout()' if !$userCanSeeHidden;
    my $isMap = '$res->is_map()';
    $isMap .= $isPrintable unless $userCanPrint;
    my $symbFilter = '$res->shown_symb() ';
    my $urlValue = '$res->link()';

    $helper->declareVar('SEQUENCE');

    # If we're in a sequence...

    my $start_new_option;
    if ($perm{'pav'}) {
	$start_new_option = 
	    "<option text='".&mt('Start new page[_1]before selected','<br />').
	    "' variable='FINISHPAGE' />".
	    "<option text='".&mt('Extra space[_1]before selected','<br />').
	    "' variable='EXTRASPACE' type='text' />" .
	    "<option " .
	    "' variable='POSSIBLE_RESOURCES' type='hidden' />".
	    "<option text='".&mt('Space units[_1]check for mm','<br />').
	    "' variable='EXTRASPACE_UNITS' type='checkbox' />"
	    ;
	    

    }

    # If not construction space user can print the components of a page:

    my $page_ispage;
    my $page_title;
    if (!$helper->{VARS}->{'construction'}) {
	my $varspostdata = $helper->{VARS}->{'postdata'};
	my $varsassignment = $helper->{VARS}->{'assignment'};
	my $page_navmap         = Apache::lonnavmaps::navmap->new();
	if (defined($page_navmap)) {
	    my @page_resources      = $page_navmap->retrieveResources($url);
	    if(defined($page_resources[0])) {
		$page_ispage       = $page_resources[0]->is_page();
		$page_title     = $page_resources[0]->title();
		my $resourcesymb   = $page_resources[0]->symb();
		my ($pagemap, $pageid, $pageurl) = &Apache::lonnet::decode_symb($symb);
		if ($page_ispage) {
		    push @{$printChoices}, 
		    [&mt('Selected [_1]Problems[_2] from page [_3]', '<b>', '</b>', '<b><i>'.$page_title.'</i></b>'), 
		     'map_problems_in_page', 
		     'CHOOSE_PROBLEMS_PAGE'];
		    push @{$printChoices}, 
		    [&mt('Selected [_1]Resources[_2] from page [_3]', '<b>', '</b>', '<b><i>'.$page_title.'</i></b>'), 
		     'map_resources_in_page', 
		     'CHOOSE_RESOURCES_PAGE'];
		}
        my $helperFragment = &generate_resource_chooser('CHOOSE_PROBLEMS_PAGE',
							'Select Problem(s) to print',
							"multichoice='1' toponly='1' addstatus='1' closeallpages='1'",
							'RESOURCES',
							'PAGESIZE',
							$url,
							$isProblem, '',  $symbFilter,
							$start_new_option);


      $helperFragment .= &generate_resource_chooser('CHOOSE_RESOURCES_PAGE',
						    'Select Resource(s) to print',
						    'multichoice="1" toponly="1" addstatus="1" closeallpages="1"',
						    'RESOURCES',
						    'PAGESIZE',
						    $url,
						    $isNotMap, '', $symbFilter,
						    $start_new_option);

						    



	&Apache::lonxml::xmlparse($r, 'helper', $helperFragment);
	
	    }
	}
    }

    if (($helper->{'VAR'}->{'construction'} ne '1' ) &&
	$helper->{VARS}->{'postdata'} &&
	$helper->{VARS}->{'assignment'}) {

	# BZ 5209 - Print incomplete problems from sequence:
	# the exact form of this depends on whether or not we are privileged or a mere
	# plebe of s student:

	my $printSelector = 'map_incomplete_problems_seq';
	my $nextState     = 'CHOOSE_INCOMPLETE_SEQ';
	my $textSuffix    = '';

	if ($userCanPrint)  {
	    $printSelector = 'map_incomplete_problems_people_seq';
	    $nextState     = 'CHOOSE_INCOMPLETE_PEOPLE_SEQ';
	    $textSuffix    = ' for selected students';
	    my $helperStates =
		&create_incomplete_folder_selstud_helper($helper, $map); 
	    &Apache::lonxml::xmlparse($r, 'helper', $helperStates);
	} else {
	    if (&printable($map_open, $map_close)) {
		my $helperStates = &create_incomplete_folder_helper($helper, $map); # Create needed states for student.
		&Apache::lonxml::xmlparse($r, 'helper', $helperStates);
	    } else {
		# TODO: Figure out how to break the news...this folder is not printable.
	    }
	}

	if ($userCanPrint || &printable($map_open, $map_close)) {
	    push(@{$printChoices},
		 [&mt('Selected  [_1]Incomplete Problems[_2] from folder [_3]' . $textSuffix,
		      '<b>', '</b>',
		      '<b><i>'. $sequenceTitle . '</b></i>'),
		  $printSelector,
		  $nextState]);
	}
        # Allow problems from sequence
	if ($userCanPrint || &printable($map_open, $map_close)) {
	    push @{$printChoices}, 
	    [&mt('Selected [_1]Problems[_2] from folder [_3]','<b>','</b>','<b><i>'.$sequenceTitle.'</i></b>'), 
	     'map_problems', 
	     'CHOOSE_PROBLEMS'];
	    # Allow all resources from sequence
	    push @{$printChoices}, [&mt('Selected [_1]Resources[_2] from folder [_3]','<b>','</b>','<b><i>'.$sequenceTitle.'</i></b>'), 
				    'map_problems_pages', 
				    'CHOOSE_PROBLEMS_HTML'];
	    my $helperFragment = &generate_resource_chooser('CHOOSE_PROBLEMS',
							    'Select Problem(s) to print',
							    'multichoice="1" toponly="1" addstatus="1" closeallpages="1"',
							    'RESOURCES',
							    'PAGESIZE',
							    $map,
							    $isProblem, '',
							    $symbFilter,
							    $start_new_option);
	    $helperFragment .= &generate_resource_chooser('CHOOSE_PROBLEMS_HTML',
							  'Select Resource(s) to print',
							  'multichoice="1" toponly="1" addstatus="1" closeallpages="1"',
							  'RESOURCES',
							  'PAGESIZE',
							  $map,
							  $isNotMap, '',
							  $symbFilter,
							  $start_new_option);
	    
	    &Apache::lonxml::xmlparse($r, 'helper', $helperFragment);
	} else {
	    # TODO: Figure out how to tell them the folder is not printable.
	}
    }
	# If the user has pfo (print for others) allow them to print all 
	# problems and resources  in the entire course, optionally for selected students
	my $post_data = $helper->{VARS}->{'postdata'};
    
    if ($perm{'pfo'} &&  !$is_published  &&
        ($post_data=~/\/res\// || $post_data =~/\/(syllabus|smppg|aboutme|bulletinboard)$/)) { 

	# BZ 5209 - incomplete problems from entire course:

	push(@{$printChoices},
	     [&mtn('Selected <b>Incomplete Problems</b> from <b>entire course</b> for selected people'),
	      'incomplete_problems_selpeople_course', 'INCOMPLETE_PROBLEMS_COURSE_RESOURCES']);
	my $helperFragment = &create_incomplete_course_helper($helper); # Create needed states.

	&Apache::lonxml::xmlparse($r, 'helper', $helperFragment);

	#  Selected problems/resources from entire course:

        push @{$printChoices}, [&mtn('Selected <b>Problems</b> from <b>entire course</b>'), 'all_problems', 'ALL_PROBLEMS'];
	push @{$printChoices}, [&mtn('Selected <b>Resources</b> from <b>entire course</b>'), 'all_resources', 'ALL_RESOURCES'];
	push @{$printChoices}, [&mtn('Selected <b>Problems</b> from <b>entire course</b> for <b>selected people</b>'), 'all_problems_students', 'ALL_PROBLEMS_STUDENTS'];
my $suffixXml = <<ALL_PROBLEMS;
  <state name="STUDENTS1" title="Select People">
      <message><b>Select sorting order of printout</b> </message>
    <choices variable='student_sort'>
      <choice computer='0'>Sort by section then student</choice>
      <choice computer='1'>Sort by students across sections.</choice>
    </choices>
      <message><br /><hr /><br /> </message>
      <student multichoice='1' variable="STUDENTS" nextstate="PRINT_FORMATTING" coursepersonnel="1"/>
  </state>
ALL_PROBLEMS
         &Apache::lonxml::xmlparse($r, 'helper', 
				   &generate_resource_chooser('ALL_PROBLEMS',
							      'Select Problem(s) to print',
							      'multichoice="1" suppressEmptySequences="0" addstatus="1" closeallpages="1"',
							      'RESOURCES',
							      'PAGESIZE',
							      '',
							      $isProblemOrMap, $isNotMap,
							      $symbFilter,
							      $start_new_option) .
				   &generate_resource_chooser('ALL_RESOURCES',
							      'Select Resource(s) to print',
							      " toponly='0' multichoice='1' suppressEmptySequences='0' addstatus='1' closeallpages='1'",
							      'RESOURCES',
							      'PAGESIZE',
							      '',
							      $isNotMap,'',$symbFilter,
							      $start_new_option) .
				   &generate_resource_chooser('ALL_PROBLEMS_STUDENTS',
							      'Select Problem(s) to print',
							      'toponly="0" multichoice="1" suppressEmptySequences="0" addstatus="1" closeallpages="1"',
							      'RESOURCES',
							      'STUDENTS1',
							      '',
							      $isProblemOrMap,'' , $symbFilter,
							      $start_new_option) .
				     $suffixXml
				   );

	if ($helper->{VARS}->{'assignment'}) {

	    # If we were looking at a page, allow a selection of problems from the page
	    # either for selected students or for coded assignments.

	    if ($page_ispage) {
		push @{$printChoices}, [&mt('Selected [_1]Problems[_2] from page [_3] for [_4]selected people[_5]',
					    '<b>', '</b>', '<b><i>'.$page_title.'</i></b>', '<b>', '</b>'),
					'problems_for_students_from_page', 'CHOOSE_TGT_STUDENTS_PAGE'];
		push @{$printChoices}, [&mt('Selected [_1]Problems[_2] from page [_3] for [_4]CODEd assignments[_5]',
					    '<b>', '</b>', '<b><i>'.$page_title.'</i></b>', '<b>', '</b>'),
					'problems_for_anon_page', 'CHOOSE_ANON1_PAGE'];
	    }
	    push @{$printChoices}, [&mt('Selected [_1]Problems[_2] from folder [_3] for [_4]selected people[_5]',
					'<b>','</b>','<b><i>'.$sequenceTitle.'</i></b>','<b>','</b>'), 
				    'problems_for_students', 'CHOOSE_STUDENTS'];
	    push @{$printChoices}, [&mt('Selected [_1]Problems[_2] from folder [_3] for [_4]CODEd assignments[_5]',
					'<b>','</b>','<b><i>'.$sequenceTitle.'</i></b>','<b>','</b>'), 
				    'problems_for_anon', 'CHOOSE_ANON1'];
	}

	my $randomly_ordered_warning = 
            &get_randomly_ordered_warning($helper, $map);

	# resource_selector will hold a few states that:
	#   - Allow resources to be selected for printing.
	#   - Determine pagination between assignments.
	#   - Determine how many assignments should be bundled into a single PDF.
        # TODO:
	#    Probably good to do things like separate this up into several vars, each
	#    with one state, and use REGEXPs at inclusion time to set state names
	#    and next states for better mix and match capability
	#
	my $resource_selector= &generate_resource_chooser('SELECT_PROBLEMS',
							  'Select resources to print',
							  'multichoice="1" addstatus="1" closeallpages="1"',
							  'RESOURCES', 
							  'PRINT_FORMATTING',
							  $map,
							  $isProblem, '', $symbFilter,
							  $start_new_option);
	$resource_selector .=  &generate_format_selector($helper,
                                                         'How should results be printed?',
                                                         'PRINT_FORMATTING').
                               &generate_resource_chooser('CHOOSE_STUDENTS_PAGE',
							'Select Problem(s) to print',
							"multichoice='1' addstatus='1' closeallpages ='1'",
							'RESOURCES',
							'PRINT_FORMATTING',
							$url,
							$isProblem, '',  $symbFilter,
							$start_new_option);


# Generate student choosers.



        &Apache::lonxml::xmlparse($r, 'helper',
				  &generate_student_chooser('CHOOSE_TGT_STUDENTS_PAGE',
							    'student_sort',
							    'STUDENTS',
							    'CHOOSE_STUDENTS_PAGE'));
	&Apache::lonxml::xmlparse($r, 'helper', 
				  &generate_student_chooser('CHOOSE_STUDENTS',
							    'student_sort',
							    'STUDENTS',
							    'SELECT_PROBLEMS'));
	&Apache::lonxml::xmlparse($r, 'helper', $resource_selector);

	my $cdom = $env{'course.'.$env{'request.course.id'}.'.domain'};
	my $cnum = $env{'course.'.$env{'request.course.id'}.'.num'};
        my @names=&Apache::lonnet::getkeys('CODEs',$cdom,$cnum);
	my $namechoice='<choice></choice>';
	foreach my $name (sort {uc($a) cmp uc($b)} @names) {
	    if ($name =~ /^error: 2 /) { next; }
	    if ($name =~ /^type\0/) { next; }
	    $namechoice.='<choice computer="'.$name.'">'.$name.'</choice>';
	}


	my %code_values;
	my %codes_to_print;
	foreach my $key (@names) {
	    %code_values = &Apache::grades::get_codes($key, $cdom, $cnum);
	    foreach my $key (keys(%code_values)) {
		$codes_to_print{$key} = 1;
	    }
	}

	my $code_selection;
	foreach my $code (sort {uc($a) cmp uc($b)} (keys(%codes_to_print))) {
	    my $choice  = $code;
	    if ($code =~ /^[A-Z]+$/) { # Alpha code
		$choice = &letters_to_num($code);
	    }
	    push(@{$helper->{DATA}{ALL_CODE_CHOICES}},[$code,$choice]);
	}
	if (%codes_to_print) {
	    $code_selection .='   
	    <message><b>Choose single CODE from list:</b></message>
		<message></td><td></message>
		<dropdown variable="CODE_SELECTED_FROM_LIST" multichoice="0" allowempty="0">
                  <choice></choice>
                  <exec>
                     push(@{$state->{CHOICES}},@{$helper->{DATA}{ALL_CODE_CHOICES}});
                  </exec>
		</dropdown>
	    <message></td></tr><tr><td></message>
            '.$/;

	}

        my @lines = &Apache::grades::get_scantronformat_file();
	my $codechoice='';
	foreach my $line (@lines) {
            next if (($line =~ /^\#/) || ($line eq ''));
	    my ($name,$description,$code_type,$code_length)=
		(split(/:/,$line))[0,1,2,4];
	    if ($code_length > 0 && 
		$code_type =~/^(letter|number|-1)/) {
		$codechoice.='<choice computer="'.$name.'">'.$description.'</choice>';
	    }
	}
	if ($codechoice eq '') {
	    $codechoice='<choice computer="default">Default</choice>';
	}
	my $anon1 = &generate_code_selector($helper, 
					    'CHOOSE_ANON1',
					    'SELECT_PROBLEMS',
					    $codechoice,
					    $code_selection,
					    $namechoice) . $resource_selector;
					    
					    
        &Apache::lonxml::xmlparse($r, 'helper',$anon1);

	my $anon_page = &generate_code_selector($helper,
						'CHOOSE_ANON1_PAGE',
						'SELECT_PROBLEMS_PAGE',
						$codechoice,
						$code_selection,
						$namechoice) .
			&generate_resource_chooser('SELECT_PROBLEMS_PAGE',
						   'Select Problem(s) to print',
						   "multichoice='1' addstatus='1' closeallpages ='1'",
						   'RESOURCES',
						   'PRINT_FORMATTING',
						   $url,
						   $isProblem, '',  $symbFilter,
						   $start_new_option);
	&Apache::lonxml::xmlparse($r, 'helper', $anon_page);


	if ($helper->{VARS}->{'assignment'}) {

	    # Assignment printing:

	    push @{$printChoices}, [&mt('Selected [_1]Resources[_2] from folder [_3] for [_4]selected people[_5]','<b>','</b>','<b><i>'.$sequenceTitle.'</i></b>','<b>','</b>'), 'resources_for_students', 'CHOOSE_STUDENTS1'];
	    push @{$printChoices}, [&mt('Selected [_1]Resources[_2] from folder [_3] for [_4]CODEd assignments[_5]','<b>','</b>','<b><i>'.$sequenceTitle.'</i></b>','<b>','</b>'), 'resources_for_anon', 'CHOOSE_ANON2'];
	}
	    

	$resource_selector=<<RESOURCE_SELECTOR;
    <state name="SELECT_RESOURCES" title="Select Resources">
    $randomly_ordered_warning
    <nextstate>PRINT_FORMATTING</nextstate>
    <message><br /><big><i><b>Select resources for the assignment</b></i></big><br /></message>
    <resource variable="RESOURCES" multichoice="1" addstatus="1" 
              closeallpages="1">
      <filterfunc>return $isNotMap;</filterfunc>
      <mapurl>$map</mapurl>
      <valuefunc>return $symbFilter;</valuefunc>
      $start_new_option
      </resource>
    </state>
RESOURCE_SELECTOR

        $resource_selector .= &generate_format_selector($helper,
                                                        'Format of the print job',
                                                        'PRINT_FORMATTING');
	&Apache::lonxml::xmlparse($r, 'helper', <<CHOOSE_STUDENTS1);
  <state name="CHOOSE_STUDENTS1" title="Select Students and Resources">
    <choices variable='student_sort'>
      <choice computer='0'>Sort by section then student</choice>
      <choice computer='1'>Sort by students across sections.</choice>
    </choices>
    <message><br /><hr /><br /></message>
    <student multichoice='1' variable="STUDENTS" nextstate="SELECT_RESOURCES" coursepersonnel="1" />

    </state>
    $resource_selector
CHOOSE_STUDENTS1

	&Apache::lonxml::xmlparse($r, 'helper', <<CHOOSE_ANON2);
  <state name="CHOOSE_ANON2" title="Select CODEd Assignments">
    <nextstate>SELECT_RESOURCES</nextstate>
    <message><h4>Fill out one of the forms below</h4></message>
    <message><br /><hr /> <br /></message>
    <message><h3>Generate new CODEd Assignments</h3></message>
    <message><table><tr><td><b>Number of CODEd assignments to print:</b></td><td></message>
    <string variable="NUMBER_TO_PRINT_TOTAL" maxlength="5" size="5"  noproceed="1">
       <validator>
	if (((\$helper->{'VARS'}{'NUMBER_TO_PRINT_TOTAL'}+0) < 1) &&
	    !\$helper->{'VARS'}{'REUSE_OLD_CODES'}                &&
	    !\$helper->{'VARS'}{'SINGLE_CODE'}                   &&
	    !\$helper->{'VARS'}{'CODE_SELECTED_FROM_LIST'}) {
	    return "You need to specify the number of assignments to print";
	}
        if (((\$helper->{'VARS'}{'NUMBER_TO_PRINT_TOTAL'}+0) >= 1)  &&
             (\$helper->{'VARS'}{'SINGLE_CODE'} ne '') ) {
            return 'Specifying number of codes to print and a specific code is not compatible';
        }
	return undef;
       </validator>
    </string>
    <message></td></tr><tr><td></message>
    <message><b>Names to save the CODEs under for later:</b></message>
    <message></td><td></message>
    <string variable="ANON_CODE_STORAGE_NAME" maxlength="50" size="20" />
    <message></td></tr><tr><td></message>
    <message><b>Bubblesheet type:</b></message>
    <message></td><td></message>
    <dropdown variable="CODE_OPTION" multichoice="0" allowempty="0">
    $codechoice
    </dropdown>
    <message></td></tr><tr><td></table></message>
    <message><br /><hr /><h3>Print a Specific CODE </h3><br /><table></message>
    <message><tr><td><b>Enter a CODE to print:</b></td><td></message>
    <string variable="SINGLE_CODE" size="10">
        <validator>
	   if(!\$helper->{'VARS'}{'NUMBER_TO_PRINT_TOTAL'}           &&
	      !\$helper->{'VARS'}{'REUSE_OLD_CODES'}                 &&
	      !\$helper->{'VARS'}{'CODE_SELECTED_FROM_LIST'}) {
	      return &Apache::lonprintout::is_code_valid(\$helper->{'VARS'}{'SINGLE_CODE'},
						      \$helper->{'VARS'}{'CODE_OPTION'});
	  } elsif (\$helper->{'VARS'}{'SINGLE_CODE'} ne ''){
	      return 'Specifying a code name is incompatible specifying number of codes.';
	   } else {
	       return undef;	# Other forces control us.
	   }
        </validator>
    </string>
    <message></td></tr><tr><td></message>
        $code_selection
    <message></td></tr></table></message>
    <message><hr /><h3>Reprint a Set of Saved CODEs</h3><table><tr><td></message>
    <message><b>Select saved CODEs:</b></message>
    <message></td><td></message>
    <dropdown variable="REUSE_OLD_CODES">
        $namechoice
    </dropdown>
    <message></td></tr></table></message>
  </state>
    $resource_selector
CHOOSE_ANON2
    }

    # FIXME: That RE should come from a library somewhere.
    if (($perm{'pav'} 
	&& $subdir ne $Apache::lonnet::perlvar{'lonDocRoot'}.'/res/'
	&& (defined($helper->{'VARS'}->{'construction'})
	    ||
	    (&Apache::lonnet::allowed('bre',$subdir) eq 'F'
	     && 
	     $helper->{VARS}->{'postdata'}=~/\.(problem|exam|quiz|assess|survey|form|library|page|xml|html|htm|xhtml|xhtm)/)
	    )) 
	&& $helper->{VARS}->{'assignment'} eq ""
	) {
	my $pretty_dir = &Apache::lonnet::hreflocation($subdir);
        push @{$printChoices}, [&mt('Selected [_1]Problems[_2] from current subdirectory [_3]','<b>','</b>','<b><i>'.$pretty_dir.'</i></b>','<b>','</b>'), 'problems_from_directory', 'CHOOSE_FROM_SUBDIR'];
        my $xmlfrag = <<CHOOSE_FROM_SUBDIR;
  <state name="CHOOSE_FROM_SUBDIR" title="Select File(s) from <b><small>$pretty_dir</small></b> to print">

    <files variable="FILES" multichoice='1'>
      <nextstate>PAGESIZE</nextstate>
      <filechoice>return '$subdir';</filechoice>
CHOOSE_FROM_SUBDIR
        
        # this is broken up because I really want interpolation above,
        # and I really DON'T want it below
        $xmlfrag .= <<'CHOOSE_FROM_SUBDIR';
      <filefilter>return Apache::lonhelper::files::not_old_version($filename) &&
	  $filename =~ m/\.(problem|exam|quiz|assess|survey|form|library)$/;
      </filefilter>
      </files>
    </state>
CHOOSE_FROM_SUBDIR
        &Apache::lonxml::xmlparse($r, 'helper', $xmlfrag);
    }

    # Allow the user to select any sequence in the course, feed it to
    # another resource selector for that sequence
    if (!$helper->{VARS}->{'construction'} && !$is_published) {
	push @$printChoices, [&mtn("Selected <b>Resources</b> from <b>selected folder</b> in course"),
			      'select_sequences', 'CHOOSE_SEQUENCE'];
	my $escapedSequenceName = $helper->{VARS}->{'SEQUENCE'};
	#Escape apostrophes and backslashes for Perl
	$escapedSequenceName =~ s/\\/\\\\/g;
	$escapedSequenceName =~ s/'/\\'/g;
	&Apache::lonxml::xmlparse($r, 'helper', <<CHOOSE_FROM_ANY_SEQUENCE);
  <state name="CHOOSE_SEQUENCE" title="Select Sequence To Print From">
    <message>Select the sequence to print resources from:</message>
    <resource variable="SEQUENCE">
      <nextstate>CHOOSE_FROM_ANY_SEQUENCE</nextstate>
      <filterfunc>return &Apache::lonprintout::printable_sequence(\$res);</filterfunc>
      <valuefunc>return $urlValue;</valuefunc>
      <choicefunc>return \$res->hasResource(\$res,sub { return !\$_[0]->is_sequence() },0,0);
	</choicefunc>
      </resource>
    </state>
  <state name="CHOOSE_FROM_ANY_SEQUENCE" title="Select Resources To Print">
    <message>(mark desired resources then click "next" button) <br /></message>
    <resource variable="RESOURCES" multichoice="1" toponly='1' addstatus="1"
              closeallpages="1">
      <nextstate>PAGESIZE</nextstate>
      <filterfunc>return $isNotMap</filterfunc>
      <mapurl evaluate='1'>return '$escapedSequenceName';</mapurl>
      <valuefunc>return $symbFilter;</valuefunc>
      $start_new_option
      </resource>
    </state>
CHOOSE_FROM_ANY_SEQUENCE
}

    # Generate the first state, to select which resources get printed.
    Apache::lonhelper::state->new("START", "Select Printing Options:");
    if (!$res_printable) {
        my $now = time;
        my $shownprintstart = &Apache::lonlocal::locallocaltime($res_printstartdate);
        my $shownprintend = &Apache::lonlocal::locallocaltime($res_printenddate);
        my $noprintmsg;
        if (($res_printenddate) && ($res_printenddate < $now)) {
                $noprintmsg = &mt('Printing for current resource no longer available (ended: [_1])',
                                  $shownprintend);
        } else {
            if (($res_printstartdate) && ($res_printstartdate > $now)) {
                if (($res_printenddate) && ($res_printenddate > $now) && ($res_printenddate > $res_printstartdate)) {
                    $noprintmsg = &mt('Printing for current resource is only possible between [_1] and [_2]',
                                  $shownprintstart,$shownprintend);
                } elsif (!$res_printenddate) {
                    $noprintmsg = &mt('Printing for current resource will only be possible starting [_1]',
                                      $shownprintstart);
                } else {
                    $noprintmsg = &mt('Printing for current resource is unavailable');
                }
            }
        }

        if ($noprintmsg) {
            $paramHash = Apache::lonhelper::getParamHash();
	    $paramHash->{MESSAGE_TEXT} = 
                '<p class="LC_info">'.$noprintmsg.'</p>';
	    Apache::lonhelper::message->new();
        }
    }
    $paramHash = Apache::lonhelper::getParamHash();
    $paramHash = Apache::lonhelper::getParamHash();
    $paramHash->{MESSAGE_TEXT} = "";
    Apache::lonhelper::message->new();
    $paramHash = Apache::lonhelper::getParamHash();
    $paramHash->{'variable'} = 'PRINT_TYPE';
    $paramHash->{CHOICES} = $printChoices;
    Apache::lonhelper::choices->new();

    my $startedTable = 0; # have we started an HTML table yet? (need
                          # to close it later)

    if (($perm{'pav'} and $perm{'vgr'}) or 
	($helper->{VARS}->{'construction'} eq '1')) {
	&addMessage('<br />'
                   .'<h3>'.&mt('Print Options').'</h3>'
                   .&Apache::lonhtmlcommon::start_pick_box()
                   .&Apache::lonhtmlcommon::row_title(
                       '<label for="ANSWER_TYPE_forminput">'
                      .&mt('Print Answers')
                      .'</label>'
                    )
        );
        $paramHash = Apache::lonhelper::getParamHash();
	$paramHash->{'variable'} = 'ANSWER_TYPE';   
	$helper->declareVar('ANSWER_TYPE');         
        $paramHash->{CHOICES} = [
                                   ['Without Answers', 'yes'],
                                   ['With Answers', 'no'],
                                   ['Only Answers', 'only']
                                ];
        Apache::lonhelper::dropdown->new();
	&addMessage(&Apache::lonhtmlcommon::row_closure());
	$startedTable = 1;

#
#  Select font size.
#

            $helper->declareVar('fontsize');
            &addMessage(&Apache::lonhtmlcommon::row_title(&mt('Font Size')));
            my $xmlfrag = << "FONT_SELECTION";

          
            <dropdown variable='fontsize' multichoice='0', allowempty='0'>
            <defaultvalue>
		  return 'normalsize';
            </defaultvalue>
            <choice computer='tiny'>Tiny</choice>
            <choice computer='sub/superscriptsize'>Script Size</choice>
            <choice computer='footnotesize'>Footnote Size</choice>
            <choice computer='small'>Small</choice>
            <choice computer='normalsize'>Normal (default)</choice>
            <choice computer='large'>larger than normal</choice>
            <choice computer='Large'>Even larger than normal</choice>
            <choice computer='LARGE'>Still larger than normal</choice>
            <choice computer='huge'>huge font size</choice>
            <choice computer='Huge'>Largest possible size</choice>
            </dropdown>
FONT_SELECTION
            &Apache::lonxml::xmlparse($r, 'helper', $xmlfrag);
            &addMessage(&Apache::lonhtmlcommon::row_closure(1));
    }

    if ($perm{'pav'}) {
	if (!$startedTable) {
	    addMessage("<hr width='33%' /><table><tr><td align='right'>".
                       '<label for="LATEX_TYPE_forminput">'.
                       &mt('LaTeX mode').
                       "</label>: </td><td>");
	    $startedTable = 1;
	} else {
	    &addMessage(&Apache::lonhtmlcommon::row_title(
                           '<label for="LATEX_TYPE_forminput">'
                           .&mt('LaTeX mode')
                           .'</label>'
                        )
            );
	}
        $paramHash = Apache::lonhelper::getParamHash();
	$paramHash->{'variable'} = 'LATEX_TYPE';   
	$helper->declareVar('LATEX_TYPE');  
	if ($helper->{VARS}->{'construction'} eq '1') {       
	    $paramHash->{CHOICES} = [
				     ['standard LaTeX mode', 'standard'], 
				     ['LaTeX batchmode', 'batchmode'], ];
	} else {
	    $paramHash->{CHOICES} = [
				     ['LaTeX batchmode', 'batchmode'],
				     ['standard LaTeX mode', 'standard'] ];
	}
        Apache::lonhelper::dropdown->new();
 
	&addMessage(&Apache::lonhtmlcommon::row_closure()
                   .&Apache::lonhtmlcommon::row_title(
                        '<label for="TABLE_CONTENTS_forminput">'
                       .&mt('Print Table of Contents')
                       .'</label>'
                    )
        );
        $paramHash = Apache::lonhelper::getParamHash();
	$paramHash->{'variable'} = 'TABLE_CONTENTS';   
	$helper->declareVar('TABLE_CONTENTS');         
        $paramHash->{CHOICES} = [
                                   ['No', 'no'],
                                   ['Yes', 'yes'] ];
        Apache::lonhelper::dropdown->new();
	&addMessage(&Apache::lonhtmlcommon::row_closure());
        
	if (not $helper->{VARS}->{'construction'}) {
	    &addMessage(&Apache::lonhtmlcommon::row_title(
                            '<label for="TABLE_INDEX_forminput">'
                           .&mt('Print Index')
                           .'</label>'
                        )
            );
	    $paramHash = Apache::lonhelper::getParamHash();
	    $paramHash->{'variable'} = 'TABLE_INDEX';   
	    $helper->declareVar('TABLE_INDEX');         
	    $paramHash->{CHOICES} = [
				     ['No', 'no'],
				     ['Yes', 'yes'] ];
	    Apache::lonhelper::dropdown->new();
            &addMessage(&Apache::lonhtmlcommon::row_closure());
            &addMessage(&Apache::lonhtmlcommon::row_title(
                            '<label for="PRINT_DISCUSSIONS_forminput">'
                           .&mt('Print Discussions')
                           .'</label>'
                        )
            );
	    $paramHash = Apache::lonhelper::getParamHash();
	    $paramHash->{'variable'} = 'PRINT_DISCUSSIONS';   
	    $helper->declareVar('PRINT_DISCUSSIONS');         
	    $paramHash->{CHOICES} = [
				     ['No', 'no'],
				     ['Yes', 'yes'] ];
	    Apache::lonhelper::dropdown->new();
            &addMessage(&Apache::lonhtmlcommon::row_closure());

	    # Prompt for printing annotations too.
		
	    &addMessage(&Apache::lonhtmlcommon::row_title(
                            '<label for="PRINT_ANNOTATIONS_forminput">'
                           .&mt('Print Annotations')
                           .'</label>'
                        )
            );
	    $paramHash = Apache::lonhelper::getParamHash();
	    $paramHash->{'variable'} = "PRINT_ANNOTATIONS";
	    $helper->declareVar("PRINT_ANNOTATIONS");
	    $paramHash->{CHOICES} = [
				     ['No', 'no'],
				     ['Yes', 'yes']];
	    Apache::lonhelper::dropdown->new();
            &addMessage(&Apache::lonhtmlcommon::row_closure());

            &addMessage(&Apache::lonhtmlcommon::row_title(&mt('Foils')));
	    $paramHash = Apache::lonhelper::getParamHash();
	    $paramHash->{'multichoice'} = "true";
	    $paramHash->{'allowempty'}  = "true";
	    $paramHash->{'variable'}   = "showallfoils";
	    $paramHash->{'CHOICES'} = [ [&mt('Show All Foils'), "1"] ];
	    Apache::lonhelper::choices->new();
            &addMessage(&Apache::lonhtmlcommon::row_closure(1));
	}

	if ($helper->{'VARS'}->{'construction'}) { 
	    my $stylevalue='$Apache::lonnet::env{"construct.style"}';
            my $randseedtext=&mt("Use random seed");
            my $stylefiletext=&mt("Use style file");
            my $selectfiletext=&mt("Select style file");

	    my $xmlfrag .= '<message>'
            .&Apache::lonhtmlcommon::row_title('<label for="curseed_forminput">'
                                              .$randseedtext
                                              .'</label>'
             )
            .'</message>
            <string variable="curseed" size="15" maxlength="15">
                <defaultvalue>
                   return '.$helper->{VARS}->{'curseed'}.';
                </defaultvalue>'
            .'</string>'
            .'<message>'
            .&Apache::lonhtmlcommon::row_closure()
            .&Apache::lonhtmlcommon::row_title('<label for="style_file">'
                                              .$stylefiletext
                                              .'</label>'
             )
            .'</message>
             <string variable="style_file" size="40">
                <defaultvalue>
                    return '.$stylevalue.';
                </defaultvalue>
             </string><message>&nbsp;'
.qq|<a href="javascript:openbrowser('helpform','style_file_forminput','sty')">|
.$selectfiletext.'</a>'
            .&Apache::lonhtmlcommon::row_closure()
            .&Apache::lonhtmlcommon::row_title(&mt('Show All Foils'))
            .'</message>
	     <choices allowempty="1" multichoice="true" variable="showallfoils">
                <choice computer="1">&nbsp;</choice>
             </choices>'
	    .'<message>'
            .&Apache::lonhtmlcommon::row_closure()
            .'</message>';
            &Apache::lonxml::xmlparse($r, 'helper', $xmlfrag);


            &addMessage(&Apache::lonhtmlcommon::row_title(&mt('Problem Type')));
	    #
	    # Initial value from construction space:
	    #
	    if (!$helper->{VARS}->{'probstatus'} && $env{'form.problemtype'}) {
		$helper->{VARS}->{'probstatus'} = $env{'form.problemtype'};	# initial value
	    }
	    $xmlfrag = << "PROBTYPE";
		<dropdown variable="probstatus" multichoice="0" allowempty="0">
		   <defaultvalue>
		      return "$helper->{VARS}->{'probstatus'}";
                   </defaultvalue>
		   <choice computer="problem">Homework Problem</choice>
		   <choice computer="exam">Bubblesheet Exam Problem</choice>
		   <choice computer="survey">Survey question</choice>
                   ,choice computer="anonsurvey"Anonymous survey question</choice>
		</dropdown>
PROBTYPE
            &Apache::lonxml::xmlparse($r, 'helper', $xmlfrag);
            &addMessage(&Apache::lonhtmlcommon::row_closure(1));



        }
    }




    if ($startedTable) {
        &addMessage(&Apache::lonhtmlcommon::end_pick_box());
    }

    Apache::lonprintout::page_format_state->new("FORMAT");

    # Generate the PAGESIZE state which will offer the user the margin
    # choices if they select one column
    Apache::lonhelper::state->new("PAGESIZE", "Set Margins");
    Apache::lonprintout::page_size_state->new('pagesize', 'FORMAT', 'FINAL');


    $helper->process();


    # MANUAL BAILOUT CONDITION:
    # If we're in the "final" state, bailout and return to handler
    if ($helper->{STATE} eq 'FINAL') {
        return $helper;
    }    

    my $footer;
    if ($helper->{STATE} eq 'START') {
        my $prtspool=$r->dir_config('lonPrtDir'); 
	$footer = &recently_generated($prtspool);
    }
    $r->print($helper->display($footer));
    &Apache::lonhelper::unregisterHelperTags();

    return OK;
}


1;

package Apache::lonprintout::page_format_state;

=pod

=head1 Helper element: page_format_state

See lonhelper.pm documentation for discussion of the helper framework.

Apache::lonprintout::page_format_state is an element that gives the 
user an opportunity to select the page layout they wish to print 
with: Number of columns, portrait/landscape, and paper size. If you 
want to change the paper size choices, change the @paperSize array 
contents in this package.

page_format_state is always directly invoked in lonprintout.pm, so there
is no tag interface. You actually pass parameters to the constructor.

=over 4

=item * B<new>(varName): varName is where the print information will be stored in the format FIXME.

=back

=cut

use Apache::lonhelper;

no strict;
@ISA = ("Apache::lonhelper::element");
use strict;
use Apache::lonlocal;
use Apache::lonnet;

my $maxColumns = 2;
# it'd be nice if these all worked
#my @paperSize = ("letter [8 1/2x11 in]", "legal [8 1/2x14 in]", 
#                 "tabloid (ledger) [11x17 in]", "executive [7 1/2x10 in]",
#                 "a2 [420x594 mm]", "a3 [297x420 mm]", "a4 [210x297 mm]", 
#                 "a5 [148x210 mm]", "a6 [105x148 mm]" );
my @paperSize = ("letter [8 1/2x11 in]", "legal [8 1/2x14 in]", 
		 "a4 [210x297 mm]");

# Tentative format: Orientation (L = Landscape, P = portrait) | Colnum |
#                   Paper type

sub new { 
    my $self = Apache::lonhelper::element->new();

    shift;

    $self->{'variable'} = shift;
    my $helper = Apache::lonhelper::getHelper();
    $helper->declareVar($self->{'variable'});
    bless($self);
    return $self;
}

sub render {
    my $self = shift;
    my $helper = Apache::lonhelper::getHelper();
    my $result = '';
    my $var = $self->{'variable'};
    my $PageLayout=&mt('Page layout');
    my $NumberOfColumns=&mt('Number of columns');
    my $PaperType=&mt('Paper type');
    my $landscape=&mt('Landscape');
    my $portrait=&mt('Portrait');
    my $pdfFormLabel=&mt('PDF-Formfields');
    my $with=&mt('with Formfields');
    my $without=&mt('without Formfields');
    

    $result.='<h3>'.&mt('Layout Options').'</h3>'
            .&Apache::loncommon::start_data_table()
            .&Apache::loncommon::start_data_table_header_row()
            .'<th>'.$PageLayout.'</th>'
            .'<th>'.$NumberOfColumns.'</th>'
            .'<th>'.$PaperType.'</th>'
            .'<th>'.$pdfFormLabel.'</th>'
            .&Apache::loncommon::end_data_table_header_row()
            .&Apache::loncommon::start_data_table_row()
    .'<td>'
    .'<label><input type="radio" name="'.${var}.'.layout" value="L" />'.$landscape.'</label><br />'
    .'<label><input type="radio" name="'.${var}.'.layout" value="P" checked="checked" />'.$portrait.'</label>'
    .'</td>';

    $result.='<td align="center">'
            .'<select name="'.${var}.'.cols">';

    my $i;
    for ($i = 1; $i <= $maxColumns; $i++) {
        if ($i == 2) {
            $result .= '<option value="'.$i.'" selected="selected">'.$i.'</option>'."\n";
        } else {
            $result .= '<option value="'.$i.'">'.$i.'</option>'."\n";
        }
    }

    $result .= "</select></td><td>\n";
    $result .= "<select name='${var}.paper'>\n";

    my %parmhash=&Apache::lonnet::coursedescription($env{'request.course.id'});
    my $DefaultPaperSize=lc($parmhash{'default_paper_size'});
    $DefaultPaperSize=~s/\s//g;
    if ($DefaultPaperSize eq '') {$DefaultPaperSize='letter';}
    $i = 0;
    foreach (@paperSize) {
	$_=~/(\w+)/;
	my $papersize=$1;
        if ($paperSize[$i]=~/$DefaultPaperSize/) {
            $result .= '<option selected="selected" value="'.$papersize.'">'.$paperSize[$i].'</option>'."\n";
        } else {
            $result .= '<option value="'.$papersize.'">'.$paperSize[$i].'</option>'."\n";
        }
        $i++;
    }
    $result .= <<HTML;
        </select>
    </td>
    <td align='center'>
        <select name='${var}.pdfFormFields'>
            <option selected="selected" value="no">$without</option>
            <option value="yes">$with</option>
        </select>
    </td>
HTML
    $result.=&Apache::loncommon::end_data_table_row()
            .&Apache::loncommon::end_data_table();

    return $result;
}

sub postprocess {
    my $self = shift;

    my $var = $self->{'variable'};
    my $helper = Apache::lonhelper->getHelper();
    $helper->{VARS}->{$var} = 
        $env{"form.$var.layout"} . '|' . $env{"form.$var.cols"} . '|' .
        $env{"form.$var.paper"} . '|' . $env{"form.$var.pdfFormFields"};
    return 1;
}

1;

package Apache::lonprintout::page_size_state;

=pod

=head1 Helper element: page_size_state

See lonhelper.pm documentation for discussion of the helper framework.

Apache::lonprintout::page_size_state is an element that gives the 
user the opportunity to further refine the page settings if they
select a single-column page.

page_size_state is always directly invoked in lonprintout.pm, so there
is no tag interface. You actually pass parameters to the constructor.

=over 4

=item * B<new>(varName): varName is where the print information will be stored in the format FIXME.

=back

=cut

use Apache::lonhelper;
use Apache::lonnet;
no strict;
@ISA = ("Apache::lonhelper::element");
use strict;



sub new { 
    my $self = Apache::lonhelper::element->new();

    shift; # disturbs me (probably prevents subclassing) but works (drops
           # package descriptor)... - Jeremy

    $self->{'variable'} = shift;
    my $helper = Apache::lonhelper::getHelper();
    $helper->declareVar($self->{'variable'});

    # The variable name of the format element, so we can look into 
    # $helper->{VARS} to figure out whether the columns are one or two
    $self->{'formatvar'} = shift;


    $self->{NEXTSTATE} = shift;
    bless($self);

    return $self;
}

sub render {
    my $self = shift;
    my $helper = Apache::lonhelper::getHelper();
    my $result = '';
    my $var = $self->{'variable'};



    if (defined $self->{ERROR_MSG}) {
        $result .= '<br /><span class="LC_error">' . $self->{ERROR_MSG} . '</span><br />';
    }

    my $format = $helper->{VARS}->{$self->{'formatvar'}};

    # Use format to get sensible defaults for the margins:


    my ($laystyle, $cols, $papersize) = split(/\|/, $format);
    ($papersize)                      = split(/ /, $papersize);

    $laystyle = &Apache::lonprintout::map_laystyle($laystyle);



    my %size;
    ($size{'width_and_units'},
     $size{'height_and_units'},
     $size{'margin_and_units'})=
	 &Apache::lonprintout::page_format($papersize, $laystyle, $cols);
    
    foreach my $dimension ('width','height','margin') {
	($size{$dimension},$size{$dimension.'_unit'}) =
	    split(/ +/, $size{$dimension.'_and_units'},2);
       	
	foreach my $unit ('cm','in') {
	    $size{$dimension.'_options'} .= '<option ';
	    if ($size{$dimension.'_unit'} eq $unit) {
		$size{$dimension.'_options'} .= 'selected="selected" ';
	    }
	    $size{$dimension.'_options'} .= '>'.$unit.'</option>';
	}
    }

    # Adjust margin for LaTeX margin: .. requires units == cm or in.

    if ($size{'margin_unit'} eq 'in') {
	$size{'margin'} += 1;
    }  else {
	$size{'margin'} += 2.54;
    }
    my %lt = &Apache::lonlocal::texthash(
        'format' => 'How should each column be formatted?',
        'width'  => 'Width',
        'height' => 'Height',
        'margin' => 'Left Margin'
    );

    $result .= '<p>'.$lt{'format'}.'</p>'
              .&Apache::lonhtmlcommon::start_pick_box()
              .&Apache::lonhtmlcommon::row_title($lt{'width'})
              .'<input type="text" name="'.$var.'.width" value="'.$size{'width'}.'" size="4" />'
              .'<select name="'.$var.'.widthunit">'
              .$size{'width_options'}
              .'</select>'
              .&Apache::lonhtmlcommon::row_closure()
              .&Apache::lonhtmlcommon::row_title($lt{'height'})
              .'<input type="text" name="'.$var.'.height" value="'.$size{'height'}.'" size="4" />'
              .'<select name="'.$var.'.heightunit">'
              .$size{'height_options'}
              .'</select>'
              .&Apache::lonhtmlcommon::row_closure()
              .&Apache::lonhtmlcommon::row_title($lt{'margin'})
              .'<input type="text" name="'.$var.'.lmargin" value="'.$size{'margin'}.'" size="4" />'
              .'<select name="'.$var.'.lmarginunit">'
              .$size{'margin_options'}
              .'</select>'
              .&Apache::lonhtmlcommon::row_closure(1)
              .&Apache::lonhtmlcommon::end_pick_box();
    # <p>Hint: Some instructors like to leave scratch space for the student by
    # making the width much smaller than the width of the page.</p>

    return $result;
}


sub preprocess {
    my $self = shift;
    my $helper = Apache::lonhelper::getHelper();

    my $format = $helper->{VARS}->{$self->{'formatvar'}};

    #  If the user does not have 'pav' privilege, set default widths and
    #  on to the next state right away.
    #
    if (!$perm{'pav'}) {
	my $var = $self->{'variable'};
	my $format = $helper->{VARS}->{$self->{'formatvar'}};
	
	my ($laystyle, $cols, $papersize) = split(/\|/, $format);
	($papersize)                      = split(/ /, $papersize);
	
	
	$laystyle = &Apache::lonprintout::map_laystyle($laystyle);

	#  Figure out some good defaults for the print out and set them:
	
	my %size;
	($size{'width'},
	 $size{'height'},
	 $size{'lmargin'})=
	     &Apache::lonprintout::page_format($papersize, $laystyle, $cols);
	
	foreach my $dim ('width', 'height', 'lmargin') {
	    my ($value, $units) = split(/ /, $size{$dim});
	    	    
	    $helper->{VARS}->{"$var.".$dim}      = $value;
	    $helper->{VARS}->{"$var.".$dim.'unit'} = $units;
	    
	}
	

	# Transition to the next state

	$helper->changeState($self->{NEXTSTATE});
    }
   
    return 1;
}

sub postprocess {
    my $self = shift;

    my $var = $self->{'variable'};
    my $helper = Apache::lonhelper->getHelper();
    my $width = $helper->{VARS}->{$var .'.width'} = $env{"form.${var}.width"}; 
    my $height = $helper->{VARS}->{$var .'.height'} = $env{"form.${var}.height"}; 
    my $lmargin = $helper->{VARS}->{$var .'.lmargin'} = $env{"form.${var}.lmargin"}; 
    $helper->{VARS}->{$var .'.widthunit'} = $env{"form.${var}.widthunit"}; 
    $helper->{VARS}->{$var .'.heightunit'} = $env{"form.${var}.heightunit"}; 
    $helper->{VARS}->{$var .'.lmarginunit'} = $env{"form.${var}.lmarginunit"}; 

    my $error = '';

    # /^-?[0-9]+(\.[0-9]*)?$/ -> optional minus, at least on digit, followed 
    # by an optional period, followed by digits, ending the string

    if ($width !~  /^-?[0-9]*(\.[0-9]*)?$/) {
        $error .= "Invalid width; please type only a number.<br />\n";
    }
    if ($height !~  /^-?[0-9]*(\.[0-9]*)?$/) {
        $error .= "Invalid height; please type only a number.<br />\n";
    }
    if ($lmargin !~  /^-?[0-9]*(\.[0-9]*)?$/) {
        $error .= "Invalid left margin; please type only a number.<br />\n";
    } else {
	# Adjust for LaTeX 1.0 inch margin:

	if ($env{"form.${var}.lmarginunit"} eq "in") {
	    $helper->{VARS}->{$var.'.lmargin'} = $lmargin - 1;
	} else {
	    $helper->{VARS}->{$var.'.lmargin'} = $lmargin - 2.54;
	}
    }

    if (!$error) {
        Apache::lonhelper::getHelper()->changeState($self->{NEXTSTATE});
        return 1;
    } else {
        $self->{ERROR_MSG} = $error;
        return 0;
    }
}

__END__


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