/* gnu.classpath.tools.taglets.AuthorTaglet
Copyright (C) 2001 Free Software Foundation, Inc.
This file is part of GNU Classpath.
GNU Classpath 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.
GNU Classpath 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 GNU Classpath; see the file COPYING. If not, write to the
Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
02111-1307 USA. */
package gnu.classpath.tools.taglets;
import java.util.Map;
import java.util.regex.Pattern;
import java.util.regex.Matcher;
import com.sun.tools.doclets.Taglet;
import com.sun.javadoc.Tag;
/**
* The default Taglet which handles Author information.
*
* @author Julian Scheid (julian@sektor37.de)
*/
public class AuthorTaglet implements Taglet {
/**
* Enum class which denotes whether and how to replace email
* addresses in author tags.
*/
public static class EmailReplacement {
private EmailReplacement() {}
/**
* Specifies that email addresses should not be replaced.
*/
public static final EmailReplacement NO_REPLACEMENT = new EmailReplacement();
/**
* Specifies that author tag text matching "Real Name
* (user@domain.tld)" is converted to "<a
* href="mailto:user@domain.tld">Real Name</a>.
*/
public static final EmailReplacement MAILTO_NAME = new EmailReplacement();
/**
* Specifies that author tag text matching "Real Name
* (user@domain.tld)" is converted to "Real Name (<a
* href="mailto:user@domain.tld">user@domain.tld</a>).
*/
public static final EmailReplacement NAME_MAILTO_ADDRESS = new EmailReplacement();
/**
* Specifies that author tag text matching "Real Name
* (user@domain.tld)" is converted to "Real Name (user AT
* domain DOT tld)", where the "AT" and "DOT" replacement are
* specified by AuthorTaglet.emailAtReplacement and
* AuthorTaglet.emailDotReplacement.
*/
public static final EmailReplacement NAME_MANGLED_ADDRESS = new EmailReplacement();
}
private static EmailReplacement emailReplacementType = EmailReplacement.NO_REPLACEMENT;
private static String atReplacement = " at ";
private static String dotReplacement = " dot ";
private static final String NAME = "author";
private static final String SINGLE_HEADER = "Author:";
private static final String MULTI_HEADER = "Authors:";
/**
* Matches .
(dot).
*/
private static final Pattern dotPattern = Pattern.compile("[.]");
/**
* Matches @
(at sign).
*/
private static final Pattern atPattern = Pattern.compile("[@]");
/**
* Matches Real Name (user@domain.tld)
.
*/
private static final Pattern authorEmailPattern
= Pattern.compile("^"
+ "\\s*" // optional whitespace
+ "(" // group #1 start (real name)
+ "[^\t\r\n (]+" // first name
+ "(?:\\s+[^\t\r\n (]+)" // additional names
+ ")" // group #1 end
+ "\\s*" // optional whitespace
+ "[(<]" // opening paren
+ "\\s*" // optional whitespace
+ "(" // group #2 start (email address)
+ "(" // group #3 start (email user)
+ "[A-z0-9_\\-\\.]+" // username
+ ")" // group #3 end
+ "[@]" // at sign
+ "[A-z0-9_\\-]+(?:[.][A-z0-9_\\-]+)+[A-z]" // domain
+ ")" // group #2 end
+ "\\s*" // optional whitespace
+ "[)>]" // closing paren
+ "$");
public String getName() {
return NAME;
}
public boolean inField() {
return true;
}
public boolean inConstructor() {
return true;
}
public boolean inMethod() {
return true;
}
public boolean inOverview() {
return true;
}
public boolean inPackage() {
return true;
}
public boolean inType() {
return true;
}
public boolean isInlineTag() {
return false;
}
public static void register(Map tagletMap) {
AuthorTaglet authorTaglet = new AuthorTaglet();
tagletMap.put(authorTaglet.getName(), authorTaglet);
}
public String toString(Tag tag) {
return toString(new Tag[] { tag });
}
public String toString(Tag[] tags) {
if (tags.length == 0) {
return null;
}
else {
StringBuffer result = new StringBuffer();
result.append("
@
(at sign) in email
* addresses should be replaced if the email replacement type is
* NAME_MANGLED_ADDRESS
.
*/
public static void setAtReplacement(String atReplacement)
{
AuthorTaglet.atReplacement = atReplacement;
}
/**
* Set the HTML text by which the .
(dot) in email
* addresses should be replaced if the email replacement type is
* NAME_MANGLED_ADDRESS
.
*/
public static void setDotReplacement(String dotReplacement)
{
AuthorTaglet.dotReplacement = dotReplacement;
}
}