[BACK]Return to inputtags.pm CVS log [TXT] [DIR] Up to [LON-CAPA] / loncom / homework

Diff for /loncom/homework/inputtags.pm between versions 1.27 and 1.42

version 1.27, 2001/02/19 20:34:20 version 1.42, 2001/08/06 18:00:34
Line 1 Line 1
 # The LearningOnline Network with CAPA  # The LON-CAPA input tags
 # input  definitons  #
   # Input definitions.
   #
   # YEAR=2000
   # 7/25,9/11,9/19,10/2,10/11,11/21,11/28,12/1,12/4,12/8,12/11 Guy Albertelli
   # 12/12 Guy Albertelli
   # 12/12 Gerd Kortemeyer
   # 12/12,12/15,12/21 Guy Albertelli
   # YEAR=2001
   # 1/4,1/5,1/6,1/10,1/15,1/24,2/19 Guy Albertelli
   # 8/6 Scott Harrison
   
 package Apache::inputtags;  package Apache::inputtags;
 use strict;  use strict;
   
   # ======================================================================= BEGIN
 sub BEGIN {  sub BEGIN {
   &Apache::lonxml::register('Apache::inputtags',('textarea','textline','datasubmission'));      &Apache::lonxml::register('Apache::inputtags',
         ('textarea','textline','datasubmission'));
 }  }
   
   # ======================================================= Initialize input tags
 sub initialize_inputtags {  sub initialize_inputtags {
   @Apache::inputtags::input=();      # list of current input ids
   @Apache::inputtags::inputlist=();      @Apache::inputtags::input = ();
   @Apache::inputtags::response=();      # list of all input ids seen in this problem
   @Apache::inputtags::responselist=();      @Apache::inputtags::inputlist = ();
   @Apache::inputtags::answergroup=();      # list of all current response ids
   $Apache::inputtags::part='';      @Apache::inputtags::response = ();
   @Apache::inputtags::status=();      # list of all response ids seen in this problem
   %Apache::inputtags::params=();      @Apache::inputtags::responselist = ();
       # list of whether or not a specific response was previously used
       @Apache::inputtags::previous = ();
       # id of current part, 0 means no part is current (inside <problem> only
       $Apache::inputtags::part = '';
       # list of problem date statuses, the first element is for <problem> 
       #if there is a second element it is for the current <part>
       @Apache::inputtags::status = ();
       #hash of defined params for the current response
       %Apache::inputtags::params = ();
 }  }
   
   # ========================================== Start input (return scalar string)
 sub start_input {  sub start_input {
   my ($parstack,$safeeval)=@_;      my ($parstack,$safeeval) = @_;
   my $args ='';      my $id = &Apache::lonxml::get_param('id',$parstack,$safeeval);
   if ( $#$parstack > -1 ) { $args=$$parstack[$#$parstack]; }      if ($id eq '') { $id = $Apache::lonxml::curdepth; }
   my $id = &Apache::run::run("{$args;".'return $id}',$safeeval);      push (@Apache::inputtags::input,$id);
   push (@Apache::inputtags::input,$id);      push (@Apache::inputtags::inputlist,$id);
   push (@Apache::inputtags::inputlist,$id);      return $id;
   return $id;  
 }  }
   
   # =================================================================== End input
 sub end_input {  sub end_input {
   pop @Apache::inputtags::input;      pop @Apache::inputtags::input;
   return '';      return '';
 }  }
   
   # ====================================== Start text area (return scalar string)
 sub start_textarea {  sub start_textarea {
   my ($target,$token,$parstack,$parser,$safeeval)=@_;      my ($target,$token,$tagstack,$parstack,$parser,$safeeval)=@_;
   my $result = "";      my $result = "";
   my $id = &start_input($parstack,$safeeval);      my $id = &start_input($parstack,$safeeval);
   if ($target eq 'web') {      if ($target eq 'web') {
     $result= '<textarea name="HWVAL'.$id.'" value="">';   my $oldresponse = $Apache::lonhomework::history{'resource.'.
   }    $Apache::inputtags::part.'.'.
   return $result;    $Apache::inputtags::response['-1'].'.submission'};
    my $cols = &Apache::lonxml::get_param('cols',$parstack,$safeeval);
    if ( $cols eq '') { $cols = 80; }
    my $rows = &Apache::lonxml::get_param('rows',$parstack,$safeeval);
    if ( $rows eq '') { $rows = 10; }
    $result= '<textarea name="HWVAL'.$Apache::inputtags::response['-1'].
       '" '."rows=\"$rows\" cols=\"$cols\">".$oldresponse;
    if ($oldresponse ne '') {
       #get rid of any startup text if the user has already responded
       &Apache::lonxml::get_all_text("/textarea",$$parser[$#$parser]);
    }
       }
       return $result;
 }  }
   
   # ======================================== End text area (return scalar string)
 sub end_textarea {  sub end_textarea {
   my ($target,$token,$parstack,$parser,$safeeval)=@_;      my ($target,$token,$tagstack,$parstack,$parser,$safeeval)=@_;
   if ($target eq 'web') {      if ($target eq 'web') {
     return "</textarea>";   return "</textarea>";
   }       } 
   &end_input;      &end_input;
   return '';      return '';
 }  }
   
   # ====================================== Start text line (return scalar string)
 sub start_textline {  sub start_textline {
   my ($target,$token,$parstack,$parser,$safeeval)=@_;      my ($target,$token,$tagstack,$parstack,$parser,$safeeval)=@_;
   my $result = "";      my $result = "";
   if ($target eq 'web') {      if ($target eq 'web') {
     my $args ='';   my $size = &Apache::lonxml::get_param('size',$parstack,$safeeval);
     if ( $#$parstack > -1 ) { $args=$$parstack[$#$parstack]; }   if ($size eq '') { $size=20; }
     my $size = &Apache::run::run("{$args;".'return $size}',$safeeval);   my $oldresponse = $Apache::lonhomework::history{'resource.'.
     if ($size eq '') { $size=20; }    $Apache::inputtags::part.'.'.
     my $oldresponse = $Apache::lonhomework::history{"resource.$Apache::inputtags::part.$Apache::inputtags::response['-1'].submission"};    $Apache::inputtags::response['-1'].'.submission'};
     $result= '<input type="text" name="HWVAL'.$Apache::inputtags::response['-1'].'" value="'.$oldresponse.'" size="'.$size.'">';   $result = '<input type="text" name="HWVAL'.
   }            $Apache::inputtags::response['-1'].
   return $result;    '" value="'.$oldresponse.'" size="'.$size.'" />';
       }
       if ($target eq 'edit') {
    $result .= &Apache::edit::tag_start($target,$token,
    &Apache::lonxml::description($token));
    $result .= &Apache::edit::text_arg('Size:','size',$token,'5').
              '</td></tr>';
    $result .= &Apache::edit::end_table;
       }
       if ($target eq 'modified') {
    my $constructtag = &Apache::edit::get_new_args($token,$parstack,
          $safeeval,'size');
    if ($constructtag) { $result = &Apache::edit::rebuild_tag($token); }
       }
       return $result;
 }  }
   
   # =============================================================== End text line
 sub end_textline {  sub end_textline {
   my ($target,$token,$parstack,$parser,$safeeval)=@_;      my ($target,$token,$tagstack,$parstack,$parser,$safeeval) = @_;
   return "";      if ($target eq 'edit') { return ('','no'); }
       return "";
 }  }
   
 #answergroup is deprecated  # ======================================================= Start data submission
 #sub start_answergroup {  
 #  my ($target,$token,$parstack,$parser,$safeeval)=@_;  
 #  my $args ='';  
 #  if ( $#$parstack > -1 ) { $args=$$parstack[$#$parstack]; }  
 #  my $id = &Apache::run::run("{$args;".'return $id}',$safeeval);  
 #  push (@Apache::inputtags::answergroup,$id);  
 #  if ($target == 'web') {  
 #      
 #  }  
 #  return '';  
 #}  
 #  
 #sub end_answergroup {  
 #  my ($target,$token,$parstack,$parser,$safeeval)=@_;  
 #  return ''; # <answergroup> has ben deprecated  
 #  my $args ='';  
 #  if ( $#$parstack > -1 ) { $args=$$parstack[$#$parstack]; }  
 #  my $id = &Apache::run::run("{$args;".'return $id}',$safeeval);  
 #  push (@Apache::inputtags::answergroup,$id);  
 #  my $result='';  
 #  my $button='<input type="submit" name="submit" value="Submit All Answers">';  
 #  my $showbutton='1';  
 #  my $usedtry='1';  
 #  my $response='';  
 #  if ( $target == 'web' ) {  
 #    if ( defined $ENV{'form.submitted'}) {  
 #    }  
 #    if ($showbutton > 0) { $result.=$button }  
 #  }  
 #  pop @Apache::inputtags::answergroup;  
 #  return $result;  
 #}  
   
   
 sub start_datasubmission {  sub start_datasubmission {
       return '';
 }  }
   
   # ========================================================= End data submission
 sub end_datasubmission {  sub end_datasubmission {
   my ($target,$token,$parstack,$parser,$safeeval)=@_;      my ($target,$token,$tagstack,$parstack,$parser,$safeeval)=@_;
   if ( $target == 'web' ) {      if ( $target == 'web' ) {
     return '<input type="submit" name="submit" value="Submit All Data">';   return '<input type="submit" name="submit" value="Submit All Data" />';
   }      }
   return '';      return '';
 }  }
   
   # ============================================================= Finalize awards
 sub finalizeawards {  sub finalizeawards {
   my $result='';      my $result='';
   my $award;      my $award;
   if ($#_ == '-1') { $result = "NO_RESPONSE"; }      if ($#_ == '-1') { $result = "NO_RESPONSE"; }
   if ($result eq '' ) {      if ($result eq '' ) {
     foreach $award (@_) { if ($award eq '') {$result='MISSING_ANSWER'; last;}}   foreach $award (@_) { if ($award eq '') {$result='MISSING_ANSWER';
   }   last;}}
   if ($result eq '' ) {      }
     foreach $award (@_) { if ($award eq 'ERROR') {$result='ERROR'; last;}}      if ($result eq '' ) {
   }   foreach $award (@_) { if ($award eq 'ERROR') {$result='ERROR'; last;}}
       }
   if ($result eq '' ) {      if ($result eq '' ) {
     foreach $award (@_) {    foreach $award (@_) { if ($award eq 'NO_RESPONSE') {
       if ($award eq 'UNIT_FAIL' ||      $result='NO_RESPONSE'; last;} }
   $award eq 'NO_UNIT' ||      }
   $award eq 'UNIT_NOTNEEDED') {      if ($result eq '' ) {
  $result=$award; last;   foreach $award (@_) { 
       }      if ($award eq 'UNIT_FAIL' ||
     }   $award eq 'NO_UNIT' ||
   }   $award eq 'UNIT_NOTNEEDED') {
   if ($result eq '' ) {   $result=$award; last;
     foreach $award (@_) {       }
       if ($award eq 'WANTED_NUMERIC' ||    }
   $award eq 'BAD_FORMULA') {$result=$award; last;}      }
     }      if ($result eq '' ) {
   }   foreach $award (@_) { 
   if ($result eq '' ) {      if ($award eq 'WANTED_NUMERIC' || 
     foreach $award (@_) { if ($award eq 'SIG_FAIL') {$result=$award; last;} }   $award eq 'BAD_FORMULA') {$result=$award; last;}
   }   }
   if ($result eq '' ) {      }
     foreach $award (@_) { if ($award eq 'INCORRECT') {$result=$award; last;} }      if ($result eq '' ) {
   }   foreach $award (@_) { if ($award eq 'SIG_FAIL') {
   if ($result eq '' ) {      $result=$award; last;} }
     foreach $award (@_) { if ($award eq 'APPROX_ANS') {$result=$award; last;} }      }
   }      if ($result eq '' ) {
   if ($result eq '' ) { $result='EXACT_ANS'; }   foreach $award (@_) { if ($award eq 'INCORRECT') {$result=$award;
   return $result    last;} }
       }
       if ($result eq '' ) {
    foreach $award (@_) { if ($award eq 'SUBMITTED') {$result=$award;
     last;} }
       }
       if ($result eq '' ) {
    foreach $award (@_) { if ($award eq 'APPROX_ANS') {$result=$award;
      last;} }
       }
       if ($result eq '' ) { $result='EXACT_ANS'; }
       return $result;
 }  }
   
   # ====================================== Decide output (return 3 element array)
 sub decideoutput {  sub decideoutput {
   my ($award)=@_;      my ($award,$solved,$previous)=@_;
   my $message='';      my $message='';
   my $button=0;      my $button=0;
   if      ($award eq 'EXACT_ANS' || $award eq 'APPROX_ANS' ) {      my $previousmsg;
     $message = "<b>You are correct.</b> Your receipt is ".&Apache::lonnet::receipt;      
     $button=0;      if ($previous) { $previousmsg='You have entered that answer before'; }
   } elsif ($award eq 'NO_RESPONSE') {      
     $message = '';      if      ($solved =~ /^correct/) {
     $button=1;   $message = "<b>You are correct.</b> Your receipt is ".
   } elsif ($award eq 'MISSING_ANSWER') {      &Apache::lonnet::receipt;
     $message = 'Some parts were not submitted';   $button=0;
     $button = 1;   $previousmsg='';
   } elsif ($award eq 'WANTED_NUMERIC') {      } elsif ($solved =~ /^excused/) {
     $message = "This question expects a numeric answer";   $message = "<b>You are excused from the problem.</b>";
     $button=1;   $button=0;
   } elsif ($award eq 'SIG_FAIL') {   $previousmsg='';
     $message = "Please adjust significant figures.";# you provided %s significant figures";      } elsif ($award eq 'EXACT_ANS' || $award eq 'APPROX_ANS' ) {
     $button=1;   if ($solved =~ /^incorrect/ || $solved eq '') {
   } elsif ($award eq 'UNIT_FAIL') {      $message = "Incorrect";
     $message = "Units incorrect."; #Computer reads units as %s";      $button=1;
     $button=1;   } else {
   } elsif ($award eq 'UNIT_NOTNEEDED') {      $message = "<b>You are correct.</b> Your receipt is ".
     $message = "Only a number required.";# Computer reads units of %s";   &Apache::lonnet::receipt;
     $button=1;      $button=0;
   } elsif ($award eq 'NO_UNIT') {      $previousmsg='';
     $message = "Units required";   }
     $button=1;      } elsif ($award eq 'NO_RESPONSE') {
   } elsif ($award eq 'BAD_FORMULA') {   $message = '';
     $message = "Unable to understand formula";   $button=1;
     $button=1;      } elsif ($award eq 'MISSING_ANSWER') {
   } elsif ($award eq 'INCORRECT') {   $message = 'Some parts were not submitted';
     $message = "Incorrect";   $button = 1;
     $button=1;      } elsif ($award eq 'WANTED_NUMERIC') {
   } else {   $message = "This question expects a numeric answer";
     $message = "Unknown message: $award";   $button=1;
     $button=1;      } elsif ($award eq 'SIG_FAIL') {
   }   $message = "Please adjust significant figures.";# you provided %s significant figures";
   return ($button,$message);   $button=1;
       } elsif ($award eq 'UNIT_FAIL') {
    $message = "Units incorrect."; #Computer reads units as %s";
    $button=1;
       } elsif ($award eq 'UNIT_NOTNEEDED') {
    $message = "Only a number required.";# Computer reads units of %s";
    $button=1;
       } elsif ($award eq 'NO_UNIT') {
    $message = "Units required";
    $button=1;
       } elsif ($award eq 'BAD_FORMULA') {
    $message = "Unable to understand formula";
    $button=1;
       } elsif ($award eq 'INCORRECT') {
    $message = "Incorrect";
    $button=1;
       } elsif ($award eq 'SUBMITTED') {
    $message = "Your submission has been recorded.";
    $button=1;
       } else {
    $message = "Unknown message: $award";
    $button=1;
       }
       return ($button,$message,$previousmsg);
 }  }
   
   # ============================================================== Set grade data
 sub setgradedata {  sub setgradedata {
   my ($award,$id) = @_;      my ($award,$id,$previously_used) = @_;
   if ( $award eq 'APPROX_ANS' || $award eq 'EXACT_ANS' ) {      # if the student already has it correct, don't modify the status
     $Apache::lonhomework::results{"resource.$id.tries"} =      if ( $Apache::lonhomework::history{"resource.$id.solved"} !~ /^correct/ ) {
       $Apache::lonhomework::history{"resource.$id.tries"} + 1;   #handle assignment of tries and solved status
     $Apache::lonhomework::results{"resource.$id.solved"} =   if ( $award eq 'APPROX_ANS' || $award eq 'EXACT_ANS' ) {
       'correct_by_student';      $Apache::lonhomework::results{"resource.$id.tries"} =
     $Apache::lonhomework::results{"resource.$id.awarded"} = '1';   $Apache::lonhomework::history{"resource.$id.tries"} + 1;
   } elsif ( $award eq 'INCORRECT' ) {      $Apache::lonhomework::results{"resource.$id.solved"} =
     $Apache::lonhomework::results{"resource.$id.tries"} =   'correct_by_student';
       $Apache::lonhomework::history{"resource.$id.tries"} + 1;      $Apache::lonhomework::results{"resource.$id.awarded"} = '1';
     $Apache::lonhomework::results{"resource.$id.solved"} =   } elsif ( $award eq 'INCORRECT' ) {
       'incorrect_attempted';      $Apache::lonhomework::results{"resource.$id.tries"} =
   } else {   $Apache::lonhomework::history{"resource.$id.tries"} + 1;
     $Apache::lonhomework::results{"resource.$id.solved"} =      $Apache::lonhomework::results{"resource.$id.solved"} =
       'incorrect_attempted';   'incorrect_attempted';
   }   } elsif ( $award eq 'SUBMITTED' ) {
   $Apache::lonhomework::results{"resource.$id.award"} = $award;      $Apache::lonhomework::results{"resource.$id.tries"} =
    $Apache::lonhomework::history{"resource.$id.tries"} + 1;
       $Apache::lonhomework::results{"resource.$id.solved"} =
    'ungraded_attempted';
    } elsif ( $award eq 'NO_RESPONSE' ) {
       return '';
    } else {
       $Apache::lonhomework::results{"resource.$id.solved"} =
    'incorrect_attempted';
    }
   
    # check if this was a previous submission if it was delete the
    # unneeded data and update the previously_used attribute
    if ( $previously_used eq 'PREVIOUSLY_USED') {
       delete($Apache::lonhomework::results{"resource.$id.tries"});
       $Apache::lonhomework::results{"resource.$id.previous"} = '1';
    } elsif ( $previously_used eq 'PREVIOUSLY_LAST') {
       #delete all data as they student didn't do anything
       foreach my $key (keys(%Apache::lonhomework::results)) {
    if ($key =~ /^resource\.$id\./) {
       &Apache::lonxml::debug("Removing $key");
       delete($Apache::lonhomework::results{$key});
    }
       }
       #and since they didn't do anything we were never here
       return '';
    } else {
       $Apache::lonhomework::results{"resource.$id.previous"} = '0';
    }
       }
       $Apache::lonhomework::results{"resource.$id.award"} = $award;
 }  }
   
   # ======================================================================= Grade
 sub grade {  sub grade {
   my ($target) = @_;      my ($target) = @_;
   my $id = $Apache::inputtags::part;      my $id = $Apache::inputtags::part;
 #  my $result='';      my $response = '';
   my $response='';  
   if ( $target == 'web' ) {  
     if ( defined $ENV{'form.submitted'}) {      if ( defined $ENV{'form.submitted'}) {
       my @awards = ();   my @awards = ();
       &Apache::lonxml::debug("$#Apache::inputtags::responselist");   foreach $response (@Apache::inputtags::responselist) {
       foreach $response (@Apache::inputtags::responselist) {      &Apache::lonxml::debug("looking for response.$id.$response.".
  &Apache::lonxml::debug("looking for response.$id.$response.awarddetail");     "awarddetail");
  my $value=$Apache::lonhomework::results{"resource.$id.$response.awarddetail"};      my $value=$Apache::lonhomework::results{"resource.$id.$response.".
  if ( $value ne '' ) {      "awarddetail"};
   &Apache::lonxml::debug("keep ing $value from $response for $id");      if ( $value ne '' ) {
   push (@awards,$value);   &Apache::lonxml::debug("keeping $value from $response for".
  } else {         " $id");
   &Apache::lonxml::debug("skipping $value from $response for $id");   push (@awards,$value);
       } else {
    &Apache::lonxml::debug("skipping $value from $response for".
          " $id");
       }
    }
    my $finalaward = &finalizeawards(@awards);
    my $previously_used;
    if ( $#Apache::inputtags::previous eq $#awards ) {
       $previously_used = 'PREVIOUSLY_LAST';
       foreach my $value (@Apache::inputtags::previous) {
    if ($value eq 'PREVIOUSLY_USED' ) {
       $previously_used = $value;
       last;
    }
       }
  }   }
       }   &Apache::lonxml::debug("final award $finalaward, $previously_used");
       my $finalaward = &finalizeawards(@awards);   &setgradedata($finalaward,$id,$previously_used);
       &Apache::lonxml::debug("final award $finalaward");  
       &setgradedata($finalaward,$id);  
     }      }
   }      return '';
   return '';  
 }  }
   
   # ========================================= Grade status (return scalar string)
 sub gradestatus {  sub gradestatus {
   my ($id) = @_;      my ($id) = @_;
   my $showbutton = 1;      my $showbutton = 1;
   my $message = '';      my $message = '';
   my $trystr='';      my $trystr = '';
   my $button='';      my $button = '';
         my $previousmsg = '';
   my $status = $Apache::inputtags::status['-1'];      
   &Apache::lonxml::debug("gradestatus has :$status:");      my $status = $Apache::inputtags::status['-1'];
   if ( $status ne 'CLOSED' ) {        &Apache::lonxml::debug("gradestatus has :$status:");
     my $award = $Apache::lonhomework::history{"resource.$id.award"};      if ( $status ne 'CLOSED' ) {  
     &Apache::lonxml::debug("Found Award |$award|");   my $award = $Apache::lonhomework::history{"resource.$id.award"};
     if ( $award ne '' ) {   my $solved = $Apache::lonhomework::history{"resource.$id.solved"};
       &Apache::lonxml::debug('Getting message');   my $previous = $Apache::lonhomework::history{"resource.$id.previous"};
       ($showbutton,$message) = &decideoutput($award);   &Apache::lonxml::debug("Found Award |$award|$solved|");
       $message="<br /><table bgcolor=\"#aaffaa\"><tr><td>$message</td></tr></table>";   if ( $award ne '' ) {
     }      &Apache::lonxml::debug('Getting message');
     my $tries = $Apache::lonhomework::history{"resource.$id.tries"};      ($showbutton,$message,$previousmsg) =
     my $maxtries = &Apache::lonnet::EXT("resource.$id.maxtries");   &decideoutput($award,$solved,$previous);
     &Apache::lonxml::debug("got maxtries of :$maxtries:");      $message = "<td bgcolor=\"#aaffaa\">$message</td>";
     if ( $tries eq '' ) { $tries = '0'; }      if ($previousmsg) {
     if ( $maxtries eq '' ) { $maxtries = '2'; }    $previousmsg = "<td bgcolor=\"#ffaaaa\">$previousmsg</td>";
     if ( $maxtries eq 'con_lost' ) { $maxtries = '0'; }       }
     if ( $showbutton ) {   }
       $trystr = "<br />Tries $tries/$maxtries";   my $tries = $Apache::lonhomework::history{"resource.$id.tries"};
     }   my $maxtries = &Apache::lonnet::EXT("resource.$id.maxtries");
     if ( $status eq 'SHOW_ANSWER' || $status eq 'CANNOT_ANSWER') {$showbutton = 0;}   &Apache::lonxml::debug("got maxtries of :$maxtries:");
     if ( $showbutton ) {    if ( $tries eq '' ) { $tries = '0'; }
       $button = '<br /><input type="submit" name="submit" value="Submit All Answers" />';   if ( $maxtries eq '' ) { $maxtries = '2'; } 
    if ( $maxtries eq 'con_lost' ) { $maxtries = '0'; } 
    if ( $showbutton ) {
       $trystr = "<td>Tries $tries/$maxtries</td>";
    }
    if ( $status eq 'SHOW_ANSWER' || $status eq 'CANNOT_ANSWER') {
       $showbutton = 0;}
    if ( $showbutton ) { 
       $button = '<br /><input type="submit" name="submit" value='.
         '"Submit All Answers" />';
    }
       }
       my $output= $previousmsg.$message.$trystr;
       if ($output =~ /^\s*$/) {
    return $button;
       } else {
    return $button.'<table><tr>'.$previousmsg.$message.$trystr.
          '</tr></table>';
     }      }
   }  
   return $button.$message.$trystr;  
 }  }
   
 1;  1;
   
 __END__  __END__
    
Removed from v.1.27  
changed lines
  Added in v.1.42

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