From: Markus Koschany Date: Thu, 3 May 2018 21:10:17 +0200 Subject: java10 --- src/build.xml | 10 +- src/resources/HtmlTaglet.java | 240 ------------------------------------------ 2 files changed, 3 insertions(+), 247 deletions(-) delete mode 100644 src/resources/HtmlTaglet.java diff --git a/src/build.xml b/src/build.xml index 79d34b5..b69e532 100644 --- a/src/build.xml +++ b/src/build.xml @@ -446,7 +446,7 @@ Update the Web Site - @@ -471,7 +471,6 @@ Update the Web Site
${javadoc.header}
${javadoc.bottom}
${javadoc.footer}
- @@ -486,21 +485,19 @@ Update the Web Site - - - - diff --git a/src/resources/HtmlTaglet.java b/src/resources/HtmlTaglet.java deleted file mode 100644 index ab1fc15..0000000 --- a/src/resources/HtmlTaglet.java +++ /dev/null @@ -1,240 +0,0 @@ -// HTMLParser Library $Name: v1_6 $ - A java-based parser for HTML -// http://sourceforge.org/projects/htmlparser -// Copyright (C) 2003 Derrick Oswald -// -// Revision Control Information -// -// $Source: /cvsroot/htmlparser/htmlparser/resources/HtmlTaglet.java,v $ -// $Author: derrickoswald $ -// $Date: 2003/12/16 02:29:56 $ -// $Revision: 1.1 $ -// -// This library is free software; you can redistribute it and/or -// modify it under the terms of the GNU Lesser General Public -// License as published by the Free Software Foundation; either -// version 2.1 of the License, or (at your option) any later version. -// -// This library 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 -// Lesser General Public License for more details. -// -// You should have received a copy of the GNU Lesser General Public -// License along with this library; if not, write to the Free Software -// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -// - -import com.sun.tools.doclets.Taglet; -import com.sun.javadoc.*; -import java.util.Map; -import org.htmlparser.util.Translate; - -/** - * A JavaDoc Taglet that encodes HTML. - * This inline taglet - * converts HTML into character references for embedding into - * Javadocs. - * For example, it converts <html> into &lt;html&gt;. - * Typical usage is to embed an example stream of html into the javadoc for - * a class or method: - * 

- * /**
- *  * Gather DIV elements.
- *  * This method takes {@.html <div></div>} pairs and
- *  * constructs nested ...
- *
- * This is useful so that the documentation is readable while coding and when - * presented in the generated javadocs. Normally, embedding HTML in the - * javadoc documentation requires the use of character entity references, - * otherwise the HTML is interpreted by the javadoc tool and is stripped out. - * The programmer can manually embed the character translations to pass the - * HTML through, but the resultant comment is extremely hard to read and - * understand when editing the code directly. Plus there is the added - * possibility of an incorrect encoding because of the manual step.

- * The use of this taglet requires a 1.4.x or higher JDK, but it is not - * expected that users with older JDKs will be generating javadocs when they - * are provided in the distribution.

- * The name was supposed to be "html", but a warning message is generated - * by the javadoc tool if a custom tag name doesn't contain any dots. So the - * next best name ".html" is used instead, with a passing resemblance to - * directives in nroff. - */ -public class HtmlTaglet implements Taglet -{ - private static final String NAME = ".html"; - - /** - * Construct a taglet for encoding HTML in doc comments. - */ - public HtmlTaglet () - { - } - - /** - * Return the name of this custom taglet. - */ - public String getName () - { - return (NAME); - } - - /** - * Will return true since {@.html} - * can be used in field documentation. - * @return true since {@.html} - * can be used in field documentation. - */ - public boolean inField () - { - return (true); - } - - /** - * Will return true since {@.html} - * can be used in constructor documentation. - * @return true since {@.html} - * can be used in constructor documentation. - */ - public boolean inConstructor () - { - return (true); - } - - /** - * Will return true since {@.html} - * can be used in method documentation. - * @return true since {@.html} - * can be used in method documentation. - */ - public boolean inMethod () - { - return (true); - } - - /** - * Will return true since {@.html} - * can be used in method documentation. - * @return true since {@.html} - * can be used in overview documentation. - */ - public boolean inOverview () - { - return (true); - } - - /** - * Will return true since {@.html} - * can be used in package documentation. - * @return true since {@.html} - * can be used in package documentation. - */ - public boolean inPackage () - { - return (true); - } - - /** - * Will return true since {@.html} - * can be used in type documentation (classes or interfaces). - * @return true since {@.html} - * can be used in type documentation. - */ - public boolean inType () - { - return (true); - } - - /** - * Will return true since {@.html} - * is an inline tag. - * @return true since {@.html} - * is an inline tag. - */ - - public boolean isInlineTag () - { - return (true); - } - - /** - * Register this Taglet. - * @param tagletMap the map to register this tag to. - */ - public static void register (Map tagletMap) - { - HtmlTaglet tag = new HtmlTaglet (); - tagletMap.put (tag.getName (), tag); - } - - /** - * Format the given string to appear "as is" within a JavaDoc comment. - * This method is more complicated than it needs to be, since you might - * say why not just use PRE tags surrounding the text. Unfortunately, PRE - * is a block level tag that breaks the flow of text, preventing inline - * operation. Instead we manually format the whitespace (actually just - * spaces and newlines) within the string to preserve the format. - */ - protected String format (String s) - { - int base; - int offset; - StringBuffer ret; - - ret = new StringBuffer (512); - - base = 0; - offset = 0; - while (-1 != (offset = s.indexOf ('\n', base))) - { - ret.append (Translate.encode (s.substring (base, offset))); - ret.append ("
\n"); - base = offset + 1; - } - if (base != s.length ()) - ret.append (Translate.encode (s.substring (base))); - - s = ret.toString (); - ret.setLength (0); - for (int i = 0; i < s.length (); i++) - if (' ' == s.charAt (i)) - ret.append (" "); - else - ret.append (s.charAt (i)); - - return (ret.toString ()); - } - - /** - * Given the Tag representation of this custom - * tag, return its string representation. - * @param tag the Tag representation of this custom tag. - */ - public String toString (Tag tag) - { - return (format (tag.text ())); - } - - /** - * Given an array of Tags representing this custom - * tag, return its string representation. - * @param tags the array of Tags representing of this custom tag. - */ - public String toString(Tag[] tags) - { - StringBuffer ret; - - if (0 == tags.length) - return (null); - else - { - ret = new StringBuffer (512); - for (int i = 0; i < tags.length; i++) - { - if (i > 0) - ret.append ("
\n"); - ret.append (format (tags[i].text())); - } - return (ret.toString ()); - } - } -} \ No newline at end of file