distrib > Mageia > 7 > i586 > media > core-release > by-pkgid > 153ba4f922480f6ff5c2f77936d5ea02 > files > 39


<title>Contributing to FindBugs</title>
<link rel="stylesheet" type="text/css" href="findbugs.css">


<table width="100%"><tr>

<td bgcolor="#b9b9fe" valign="top" align="left" width="20%"> 
<table width="100%" cellspacing="0" border="0"> 
<tr><td><a class="sidebar" href="index.html"><img src="umdFindbugs.png" alt="FindBugs"></a></td></tr> 


<tr><td><b>Docs and Info</b></td></tr> 
<tr><td><font size="-1">&nbsp;<a class="sidebar" href="findbugs2.html">FindBugs 2.0</a></font></td></tr> 
<tr><td><font size="-1">&nbsp;<a class="sidebar" href="demo.html">Demo and data</a></font></td></tr> 
<tr><td><font size="-1">&nbsp;<a class="sidebar" href="users.html">Users and supporters</a></font></td></tr> 
<tr><td><font size="-1">&nbsp;<a class="sidebar" href="">FindBugs blog</a></font></td></tr> 
<tr><td><font size="-1">&nbsp;<a class="sidebar" href="factSheet.html">Fact sheet</a></font></td></tr> 
<tr><td><font size="-1">&nbsp;<a class="sidebar" href="manual/index.html">Manual</a></font></td></tr> 
<tr><td><font size="-1">&nbsp;<a class="sidebar" href="ja/manual/index.html">Manual(ja/&#26085;&#26412;&#35486;)</a></font></td></tr> 
<tr><td><font size="-1">&nbsp;<a class="sidebar" href="FAQ.html">FAQ</a></font></td></tr> 
<tr><td><font size="-1">&nbsp;<a class="sidebar" href="bugDescriptions.html">Bug descriptions</a></font></td></tr> 
<tr><td><font size="-1">&nbsp;<a class="sidebar" href="bugDescriptions_ja.html">Bug descriptions(ja/&#26085;&#26412;&#35486;)</a></font></td></tr> 
<tr><td><font size="-1">&nbsp;<a class="sidebar" href="bugDescriptions_fr.html">Bug descriptions(fr)</a></font></td></tr> 
<tr><td><font size="-1">&nbsp;<a class="sidebar" href="mailingLists.html">Mailing lists</a></font></td></tr> 
<tr><td><font size="-1">&nbsp;<a class="sidebar" href="publications.html">Documents and Publications</a></font></td></tr> 
<tr><td><font size="-1">&nbsp;<a class="sidebar" href="links.html">Links</a></font></td></tr> 


<tr><td><a class="sidebar" href="downloads.html"><b>Downloads</b></a></td></tr> 


<tr><td><a class="sidebar" href=""><b>FindBugs Swag</b></a></td></tr>


<tr><td><font size="-1">&nbsp;<a class="sidebar" href="">Open bugs</a></font></td></tr> 
<tr><td><font size="-1">&nbsp;<a class="sidebar" href="reportingBugs.html">Reporting bugs</a></font></td></tr> 
<tr><td><font size="-1">&nbsp;<a class="sidebar" href="contributing.html">Contributing</a></font></td></tr> 
<tr><td><font size="-1">&nbsp;<a class="sidebar" href="team.html">Dev team</a></font></td></tr> 
<tr><td><font size="-1">&nbsp;<a class="sidebar" href="api/index.html">API</a> <a class="sidebar" href="api/overview-summary.html">[no frames]</a></font></td></tr> 
<tr><td><font size="-1">&nbsp;<a class="sidebar" href="Changes.html">Change log</a></font></td></tr> 
<tr><td><font size="-1">&nbsp;<a class="sidebar" href="">SF project page</a></font></td></tr> 
<tr><td><font size="-1">&nbsp;<a class="sidebar" href="">Browse source</a></font></td></tr> 
<tr><td><font size="-1">&nbsp;<a class="sidebar" href="">Latest code changes</a></font></td></tr> 

<td align="left" valign="top">

<h1>Contributing to FindBugs</h1>

<p> If you have a bug fix or feature enhancement you would like to contribute,
we would be happy to consider it for inclusion.</p>

<h2>Import FindBugs code as Eclipse projects</h2>

<p>The preferred way to get the FindBugs source code and create the patch is to use Eclipse + Git.
You can easily import FindBugs code into Eclipse by following the steps described
here: <a href="">Import Eclipse projects</a>

<h2>Preparing a patch</h2>

<p> The best way to create a patch is to clone FindBugs Git repository here:
 <a href=""></a>,
 commit changes with descriptive commit messages (small commits are better) and
 create a new <a href="">bug</a>
 or <a href="">feature request</a>
 with the "[patch]" prefix in the title and link to your repository in the description.

<p> Please follow these guidelines when preparing your patch:</p>
<li> <b>Use the same indentation style as the source file(s) you
     are modifying</b>. In particular, please use spaces
     to indent your code; four spaces per indent level.
<li> If at all possible, avoid making whitespace modifications.
<li> Small patches/changesets are appreciated.
<li> If you have lot of changes, try to group them by small commits with descriptive messages.
<li> If you have multiple patches, create <b>branch per patch</b>.
<li> All new files should contain proper license header (<a href="">Lesser GNU Public License</a>).
<li> If you are submitting a new bug detector, please submit a small
     standalone source file that contains an instance of the
     kind of bug the detector looks for. The file should be placed at
     <a href="">findbugsTestCases/src/java/sfBugsNew</a>
     package and named after the bug or feature you are addressing.

<p> Following these guidelines makes it much easier for us
to incorporate new code.

<h2>Where to submit a patch</h2>

<p> Patches may be submitted through the
<a href="">bug</a>
 or <a href="">feature request</a> trackers on the
<a href="">sourceforge project page</a>.

<hr> <p> 
<script language="JavaScript" type="text/javascript"> 
<!---//hide script from old browsers 
document.write( "Last updated "+ document.lastModified + "." ); 
//end hiding contents ---> 
<p> Send comments to <a class="sidebar" href=""></a> 
<a href=""><img src=";type=5" width="210" height="62" border="0" alt="FindBugs on" /></a>