toolchain/gcc/libjava/scripts/TexinfoDoclet.java

   1 /* Copyright (C) 2001  Free Software Foundation
   2
   3    This file is part of libgcj.
   4
   5 This software is copyrighted work licensed under the terms of the
   6 Libgcj License.  Please consult the file "LIBGCJ_LICENSE" for
   7 details.  */
   8
   9 import java.io.*;
  10 import com.sun.javadoc.*;
  11
  12 public class TexinfoDoclet
  13 {
  14   static PrintStream outfile;
  15
  16   public static int optionLength(String option)
  17   {
  18     if (option.equals("-outfile"))
  19       return 2;
  20     return 0;
  21   }
  22
  23   private static String replace (String s, String text, String replacement)
  24   {
  25     int i = s.indexOf (text);
  26     while (i != -1)
  27       {
  28         s = s.substring(0, i) + replacement + s.substring(i+text.length());
  29         i = s.indexOf (text);
  30       }
  31
  32     return s;
  33   }
  34
  35   private static String texify (String s)
  36   {
  37     if (s.indexOf('<') == -1)
  38       return s;
  39
  40     s = replace (s, "<code>", "@code{");
  41     s = replace (s, "</code>", "}");
  42     s = replace (s, "<ol>", "\n@itemize @bullet\n");
  43     s = replace (s, "</ol>", "\n@end itemize\n");
  44     s = replace (s, "<ul>", "\n@itemize @bullet\n");
  45     s = replace (s, "</ul>", "\n@end itemize\n");
  46     s = replace (s, "<li>", "\n@item\n");
  47     s = replace (s, "</li>", "\n");
  48     s = replace (s, "<p>", "\n\n");
  49
  50     s = replace (s, "<CODE>", "@code{");
  51     s = replace (s, "</CODE>", "}");
  52     s = replace (s, "<OL>", "\n@itemize @bullet\n");
  53     s = replace (s, "</OL>", "\n@end itemize\n");
  54     s = replace (s, "<UL>", "\n@itemize @bullet\n");
  55     s = replace (s, "</UL>", "\n@end itemize\n");
  56     s = replace (s, "<LI>", "\n@item\n");
  57     s = replace (s, "</LI>", "\n");
  58     s = replace (s, "<P>", "\n\n");
  59
  60     return s;
  61   }
  62
  63   private static void emitMethod (ClassDoc c, MethodDoc m)
  64   {
  65     outfile.print ("@deftypemethod " + c.typeName()
  66                    + " {" + m.modifiers()
  67                    + " " + m.returnType().typeName()
  68                    + "} " + m.name());
  69
  70     outfile.print (" (");
  71     Parameter p[] = m.parameters();
  72     boolean first = true;
  73
  74     for (int i = 0; i < p.length; i++)
  75       {
  76         if (!first)
  77           outfile.print (", ");
  78         outfile.print (p[i].typeName()
  79                        + "@w{ }@var{"
  80                        + p[i].name()
  81                        + "}");
  82         first = false;
  83       }
  84     outfile.print (") ");
  85
  86     ClassDoc exceptions[] = m.thrownExceptions();
  87     if (exceptions.length > 0)
  88       {
  89         outfile.print ("@*throws ");
  90         first = true;
  91         for (int i = 0; i < exceptions.length; i++)
  92           {
  93             if (!first)
  94               outfile.print (", ");
  95             outfile.print (exceptions[i].typeName());
  96             first = false;
  97           }
  98       }
  99     outfile.println ("");
 100
 101     outfile.println (texify (m.commentText()));
 102
 103     outfile.println ("@end deftypemethod");
 104   }
 105
 106   private static void emitClass (ClassDoc c)
 107   {
 108     MethodDoc[] methods = c.methods();
 109     for (int i = 0; i < methods.length; i++)
 110       {
 111         emitMethod (c, methods[i]);
 112       }
 113   }
 114
 115   public static boolean start (RootDoc root)
 116   {
 117     String options[][] = root.options ();
 118
 119     for (int i = 0; i < options.length; i++)
 120       {
 121         try
 122           {
 123             if (options[i][0].equals ("-outfile"))
 124               {
 125                 outfile = new PrintStream (new FileOutputStream (options[i][1]));
 126               }
 127           } catch (java.io.IOException e) {
 128             System.err.println ("Can't write to file " + options[i][1]);
 129             return false;
 130           }
 131       }
 132
 133     ClassDoc[] classes = root.classes();
 134     for (int i = 0; i < classes.length; i++)
 135       {
 136         emitClass (classes[i]);
 137       }
 138     return true;
 139   }
 140 }