#! @PERL@

# Convert S documentation to R documentation format
# Usage:  Sd2Rd [-x] file
# The option `-x' makes the program greedily interpret all single-quoted
# names intended as code names.

# Copyright (C) 1997 Kurt Hornik
#
# This document 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, or (at your option)
# any later version.
#
# This program 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.
#
# A copy of the GNU General Public License is available via WWW at
# http://www.gnu.org/copyleft/gpl.html.  You can also obtain it by
# writing to the Free Software Foundation, Inc., 675 Mass Ave,
# Cambridge, MA 02139, USA.

# Bug reports to Kurt.Hornik@ci.tuwien.ac.at

$VERSION = "0.2-a2";
($NAME = $0) =~ s|.*/||;

$\ = "\n";

$braceLevel = 0;
$inVerbatim = 0;
$inSeeAlso = 0;
$doprint = 1;
$needArg = 1;
$needVal = 0;
$output = "";

use Getopt::Long;
GetOptions(("x")) || &usage();

while (<>) {
  chop;
  &substitute unless /^\./;
  @word = split;

  if (/^\s*$/) { &output("\n"); }
  if (/^[^.]/) { &output($_); }

  if (/^\.AG/) {
    if ($needArg) {
      &section(0, "\\arguments\{");
      $needArg = 0;
    }
    &section(1, "\\item\{$word[1]\}\{");
  }
  if (/^\.CS/) {
    &section(0, "\\usage\{");
    $inVerbatim = 1;
  }
  if (/^\.DN/) { $doprint = 0; }
  if (/^\.DT/) { &section(0, "\\description\{"); }
  if (/^\.EX/) {
    &section(0, "\\examples\{");
    $inVerbatim = 1;	
  }
  if (/^\.FN/) { $fun = $word[1]; }
  if (/^\.(IP|PP)/) { &output("\n"); }
  if (/^\.KW/) { 
    if ($braceLevel > 0) {
      &section(0, "");
      $braceLevel = 0;
    }
    &output("\\keyword\{$word[1]\}");
  }
  if (/^\.RC/) {
    if ($needVal) {
      $needVal = 0;	    
      &section(0, "\\value\{\n$output\n");
      $doprint = 1;
    }
    &section(1, "\\item\{$word[1]\}\{");
  }
  if (/^\.RT/) {
    $needVal = 1;
    $doprint = 0;
    $output = "";
  }
  if (/^\.SA/) {
    &section(0, "\\seealso\{");
    $inSeeAlso = 1;
  }
  if (/^\.SE/) { &section(0, "\\section\{Side Effects\}\{"); }
  if (/^\.SH/) {
    if ($word[1] =~ /REFERENCE/) {
      &section(0, "\\references\{");
    } else {
      &section(0, "\\section\{$word[1]\}\{");
    }
  }
  if (/^\.sp/) { output("\n"); }
  if (/^\.TL/) { &section(0, "\\name\{$fun\}\n\\title\{"); }
  if (/^\.WR/) {
    &section(0, "");
    print("% Converted by $NAME version $VERSION.");
  }
  
  if (/^\.AO/) {
    output("Arguments for function \\code\{$word[1]()\} can also be");
    output("supplied to this function.");
  }
  if (/^\.GE/) {
    output("This is a generic function.");
    output("Functions with names beginning in \\code\{$fun.\} will be");
    output("methods for this function.");
  }
  if (/^\.GR/) {
    output("Graphical parameters (see \\code\{\\link\{par\}\}) may also");
    output("be supplied as arguments to this function.");
  }
  if (/^\.ME/) {
    output("This function is a method for the generic function");
    output("\\code\{$word[1]()\} for class \\code\{$word[2]\}.");
    output("It can be invoked by calling \\code\{$word[1](x)\} for an");
    output("object \\code\{x\} of the appropriate class, or directly by");
    output("calling \\code\{$word[1].$word[2](x)\} regardless of the");
    output("class of the object.");
  }
  if (/^\.NA/) { output("Missing values (\\code\{NA\}s) are allowed."); }
  if (/^\.Tl/) {
    output("In addition, the high-level graphics control arguments");
    output("described under \\code\{\\link\{par\}\} and the arguments to");
    output("\\code\{\\link\{title\}\} may be supplied to this function.");
  }
}

sub substitute {
  if (!$inVerbatim) {
    s/\{/\\\{/g;
    s/\}/\\\}/g;
    s/&/\\&/g;
  }
  s/\.\.\./\dots\{\}/g;    
  s/\\fB/\\textbf\{/g;
  s/\\fR/\}/g;
  s/\%/\\%/g;
  s/\\/\\\\/g;
  s/\\\.(.*)$/# $1)/g;
  if ($inSeeAlso) {
    if ($opt_x) {
      s/\`?([\.\w]*\w+)\'?/\\code{\\link{$1}}/g;
    } else {
      s/\`([^\']*)\'/\\code{\\link{$1}}/g;
    }
  } else {
    s/\`([^\']*)\'/\\code{$1}/g;
  }
}

sub section {
  local($level, $text) = @_;
  $n = $braceLevel - $level;
  print("\}" x $n) if ($n > 0);
  if ($needVal) {
    print("\\value\{\n$output\n\}");
    $needVal = 0;
  }
  print("$text") if $text;    
  $braceLevel = $level + 1;
  $inVerbatim = 0;
  $inSeeAlso = 0;
  $doprint = 1;    
}

sub paragraph {
  local($name) = @_;
  &output("\n\textbf\{$name.\} ");
}
    
sub output {
  local($text) = @_;
  if ($doprint) {
    print($text);
  } elsif ($output) {
    $output .= "\n$text";
  } else {
    $output = $text;
  }
}

sub usage {
  print("\n$NAME version $VERSION\n\nusage:  $NAME [-x] file\n");
  exit;
}

### Local Variables: ***
### perl-indent-level: 2 ***
### End: ***