We relaunched the TWiki.org project with an expanded TWiki charter, and we invite you to participate! The TWiki.org Code of Conduct agreement took effect on 27 Oct 2008. We ask existing twiki.org users to opt-in. You need to opt-in to participate in the Blog, Codev, Plugins and TWiki webs. -- PeterThoeny - 27 Oct 2008
You are here: TWiki> Plugins Web>JavaDocPlugin (12 Mar 2007, DuncanKinnear)
Tags:
development1Add my vote for this tag documentation1Add my vote for this tag create new tag
, view all tags

JavaDocPlugin

Write links to javadoc classes

Syntax Rules

  • Write the command %JAVADOC{source:fullclassname}% anywhere in your topics. It will be replaced by a link to the javadoc page.
  • The source refers to a preference variable setting the URL to the javadoc root
  • You can omit the source and write %JAVADOC{fullclassname}%, in this case a default source is used (see settings below)

Examples

You type... You should see... If installed...
%JAVADOC{L4J:org.apache.log4j.Logger}% Logger %JAVADOC{L4J:org.apache.log4j.Logger}%
%JAVADOC{java.lang.String}% String %JAVADOC{java.lang.String}%
%JAVADOC{IO:BufferedOutputStream}% BufferedOutputStream %JAVADOC{IO:BufferedOutputStream}%

In the last example, the source contain the package, so you need only to write the class name.

JavaDocPlugin Global Settings

Plugin settings are stored as preferences variables. To reference a plugin setting write %<plugin>_<setting>%, i.e. %INTERWIKIPLUGIN_SHORTDESCRIPTION%

  • One line description, is shown in the TextFormattingRules topic:
    • Set SHORTDESCRIPTION = Write links to javadoc classes

  • Debug plugin: (See output in data/debug.txt)
    • Set DEBUG = 0

Plugin Installation Instructions

Note: You do not need to install anything on the browser to use this plugin. The following instructions are for the administrator who installs the plugin on the server where TWiki is running.

  • Download the ZIP file from the Plugin web (see below)
  • Unzip JavaDocPlugin.zip in your twiki installation directory. Content:
File: Description:
data/TWiki/JavaDocPlugin.txt Plugin topic
data/TWiki/JavaDocPlugin.txt,v Plugin topic repository
lib/TWiki/Plugins/JavaDocPlugin.pm Plugin Perl module
  • Test if the installation was successful:
    • %JAVADOC{java.lang.String}%

Plugin Info

Plugin Author: TWiki:Main/LaurentBovet
Plugin Version: 04 Apr 2003 (V1.000)
Change History:  
04 Apr 2003: Initial version
CPAN Dependencies: none
Other Dependencies: none
Perl Version: 5.005
Plugin Home: http://TWiki.org/cgi-bin/view/Plugins/JavaDocPlugin
Feedback: http://TWiki.org/cgi-bin/view/Plugins/JavaDocPluginDev

Related Topics: TWikiPreferences, TWikiPlugins

-- TWiki:Main/LaurentBovet - 04 Apr 2003

Topic attachments
I Attachment Action Size Date Who Comment
ziptgz JavaDocPlugin.tgz manage 3.1 K 08 Nov 2006 - 18:59 HolgerHellmuth bugfix update for 4.0.4
zipzip JavaDocPlugin.zip manage 3.8 K 08 Nov 2006 - 20:41 PeterThoeny bugfix update for 4.0.4
Topic revision: r6 - 12 Mar 2007 - 21:17:49 - DuncanKinnear
 
TWIKI.NET
This site is powered by the TWiki collaboration platformCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback