pmd/pmd-jedit/PMDPlugin/jedit.html

72 lines
3.7 KiB
HTML
Raw Normal View History

<html><head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>
PMD-JEdit Plug-in Users' Guide
</title>
<body>
<h1>PMD-JEdit Plug-in Users' Guide</h1>
<hr>
<p>PMD is a Java source code analyzer - it finds unused variables, questionable design decisions, empty catch blocks, and so forth.
You can read much more about PMD here - http://pmd.sf.net/.</p>
<h3>Installation</h3>
<ul>
<li>Uninstall any old PMD-JEdit plugins
<li>Unzip the PMD-JEdit-bin-2.3.zip file into your JEdit directory; it'll put a couple of jar files into your jars directory.
<li>Restart JEdit and you'll be ready to go.
</ul>
<h3>Integration</h3>
<p>There's a new 'PMD' menu item in the Plugins menu. This has several submenu options</p>
<ul>
<li>"Check current file" checks your currently displayed Java code</li>
<li>"Check all files in current directory" does just that</li>
<li>"Check directory recursively" does just that, too! </li>
<li>Detect Duplicate Code
<ul>
<li>"In current file" checks your currently displayed Java code for duplicates</li>
<li>"Check all files in current directory" same thing for the directory</li>
<li>"Check directory recursively" same thing for the directory, recursively</li>
</ul>
</ul>
<p>"Current directory" means "the directory which is displayed in the file system browser". So, for
example, if you wanted to run PMD on your whole source tree, and your top level
source directory is named "src", you would 1) double-click on the "src" directory and
then 2) select the "PMD->Check directory recursively" menu option.</p>
<p>All those options put any errors into the ErrorList so you can then go jumping around your project fixing stuff.
<p>There's a section in the Utilities->Global Options->Plugins configuration panel that lets you pick which rule sets you want to use.</p>
<p>Note that the configuration panel also contains the minimum tile size for CPD to turn up a duplicate chunk.
<p>Starting 2.1, you can now add Custom Defined Rulesets with PMD plugin. Previously, if you want to use your own rulesets with the PMD plugin, you had to unjar the pmd.jar file & add your ruleset defination in the jar file & re-jar it & use it. But this procedure had to be repeated whenever a new PMD is out. But not anymore. Now you can simply point PMD plugin to your custom rulesets.xml file & drop your custom ruleset jars in either of jEdit jars directory(either system or user). Once this is done, you will be able to manipulate your Custom Rulesets just the way like the built-in ones.</p>
<p>PMD jEdit 2.2 adds updates PMD plugin to the latest and the greatest PMD release, updates to Dynamic class loading feature of jEdit and adds PMD to jEdit's File System Browser for easy access.</p>
<h2>Release Notes</h2>
<h3>2.4</h3>
<ol>
<li>Optimized usage of ErrorSource for faster Error Highlighting.</li>
</ol>
<h3>2.3</h3>
<ol>
<li>Updated to PMD 1.3</li>
</ol>
<h3>2.2</h3>
<ol>
<li>Updated to PMD 1.2.1</li>
<li>Updated to jEdit 4.2 API changes</li>
<li>Added PMD in jEdit's File System Browser Plugins Menu.</li>
</ol>
<h3>2.1</h3>
<ol>
<li>Added "clear ErrorList" option.</li>
<li>Added "check all open buffers" option.</li>
<li>Added support to define Custom RuleSets thereby facilitating integration of Custom Rulesets with built-in rulesets & their independent development.</li>
<li>Added C/C++, PHP support to Copy/Paste Detector. Now you can find out duplicate code in your C/C++ & PHP code besides the usual Java code.</li>
</ol>
<h3>2.0</h3>
<ol>
<li>Integrated Copy/Paste Detector(CPD) in jEdit.</li>
<li>Updated to use pmd-1.05</li>
</ol>
<h3>License</h3>
<p>The PMD-JEdit plugin is free software released under the Apache license.</p>
</body>
</html>