Author: milamber
Date: Sat Apr 16 14:36:00 2016
New Revision: 1739469
URL: http://svn.apache.org/viewvc?rev=1739469&view=rev
Log:
Prepare next release 3.0: update docs tree and overview (RC1)
Added:
jmeter/trunk/docs/devguide-dashboard.html (with props)
jmeter/trunk/docs/images/apple-touch-icon.png (with props)
jmeter/trunk/docs/images/asf-logo.svg (with props)
jmeter/trunk/docs/images/favicon.png (with props)
jmeter/trunk/docs/images/logo.svg (with props)
jmeter/trunk/docs/images/mstile-144x144.png (with props)
jmeter/trunk/docs/images/screenshots/http-config/auth-manager-example1a.png
(with props)
jmeter/trunk/docs/images/screenshots/http-config/header-manager-example1a.png
(with props)
jmeter/trunk/docs/images/screenshots/http-config/http-request-defaults-advanced-tab.png
(with props)
jmeter/trunk/docs/images/screenshots/http-request-advanced-tab.png (with
props)
jmeter/trunk/docs/usermanual/generating-dashboard.html (with props)
Removed:
jmeter/trunk/docs/images/asf-logo.gif
jmeter/trunk/docs/images/asf-logo.png
jmeter/trunk/docs/images/jakarta-logo.gif
jmeter/trunk/docs/images/logo-small.jpg
jmeter/trunk/docs/images/logo.jpg
jmeter/trunk/docs/images/screenshots/class_diagram.gif
jmeter/trunk/docs/images/screenshots/graphfullresults.png
jmeter/trunk/docs/images/screenshots/http-config/auth-manager-example1a.gif
jmeter/trunk/docs/images/screenshots/http-config/header-manager-example1a.gif
jmeter/trunk/docs/images/screenshots/icons-22x22.jpg
jmeter/trunk/docs/images/screenshots/icons-32x32.jpg
jmeter/trunk/docs/images/screenshots/icons-48x48.jpg
jmeter/trunk/docs/images/screenshots/jms/jms_config.png
jmeter/trunk/docs/images/screenshots/jms/jms_messaging.png
jmeter/trunk/docs/images/screenshots/url_rewrite_example_b.gif
jmeter/trunk/docs/images/screenshots/user_param_modifier.gif
Modified:
jmeter/trunk/docs/building.html
jmeter/trunk/docs/changes.html
jmeter/trunk/docs/changes_history.html
jmeter/trunk/docs/css/new-style.css
jmeter/trunk/docs/css/style.css
jmeter/trunk/docs/download_jmeter.html
jmeter/trunk/docs/images/screenshots/accesslogsampler.png
jmeter/trunk/docs/images/screenshots/assertion/HTMLAssertion.png
jmeter/trunk/docs/images/screenshots/assertion/MD5HexAssertion.png
jmeter/trunk/docs/images/screenshots/assertion/compare.png
jmeter/trunk/docs/images/screenshots/assertion/example1a.png
jmeter/trunk/docs/images/screenshots/comparison_assertion_visualizer.png
jmeter/trunk/docs/images/screenshots/ftptest/ftp-defaults.png
jmeter/trunk/docs/images/screenshots/ftptest/ftp-defaults2.png
jmeter/trunk/docs/images/screenshots/ftptest/ftp-request.png
jmeter/trunk/docs/images/screenshots/ftptest/ftp-request2.png
jmeter/trunk/docs/images/screenshots/ftptest/ftp-results.png
jmeter/trunk/docs/images/screenshots/ftptest/threadgroup2.png
jmeter/trunk/docs/images/screenshots/html_link_parser.png
jmeter/trunk/docs/images/screenshots/http-config/http-config-example.png
jmeter/trunk/docs/images/screenshots/http-config/http-cookie-manager.png
jmeter/trunk/docs/images/screenshots/http-config/http-request-defaults.png
jmeter/trunk/docs/images/screenshots/http-request.png
jmeter/trunk/docs/images/screenshots/java_request.png
jmeter/trunk/docs/images/screenshots/jdbctest/JDBCRequest.png
jmeter/trunk/docs/images/screenshots/jdbctest/JDBCRequest2.png
jmeter/trunk/docs/images/screenshots/jdbctest/JDBCRequest3.png
jmeter/trunk/docs/images/screenshots/jdbctest/jdbc-config.png
jmeter/trunk/docs/images/screenshots/jdbctest/jdbc-request.png
jmeter/trunk/docs/images/screenshots/jdbctest/jdbc-results.png
jmeter/trunk/docs/images/screenshots/jdbctest/threadgroup1.png
jmeter/trunk/docs/images/screenshots/jdbctest/threadgroup2.png
jmeter/trunk/docs/images/screenshots/jmssubscriber.png
jmeter/trunk/docs/images/screenshots/jsr223-sampler.png
jmeter/trunk/docs/images/screenshots/ldaptest/add.png
jmeter/trunk/docs/images/screenshots/ldaptest/delete.png
jmeter/trunk/docs/images/screenshots/ldaptest/extadd.png
jmeter/trunk/docs/images/screenshots/ldaptest/extcompare.png
jmeter/trunk/docs/images/screenshots/ldaptest/extdel.png
jmeter/trunk/docs/images/screenshots/ldaptest/extmod.png
jmeter/trunk/docs/images/screenshots/ldaptest/extmoddn.png
jmeter/trunk/docs/images/screenshots/ldaptest/extrequestdefaults.png
jmeter/trunk/docs/images/screenshots/ldaptest/extsbind.png
jmeter/trunk/docs/images/screenshots/ldaptest/extsearch.png
jmeter/trunk/docs/images/screenshots/ldaptest/extthreadbind.png
jmeter/trunk/docs/images/screenshots/ldaptest/extthreadgroup.png
jmeter/trunk/docs/images/screenshots/ldaptest/extthreadunbind.png
jmeter/trunk/docs/images/screenshots/ldaptest/extviewtree.png
jmeter/trunk/docs/images/screenshots/ldaptest/login-config-element.png
jmeter/trunk/docs/images/screenshots/ldaptest/modify.png
jmeter/trunk/docs/images/screenshots/ldaptest/requestdefaults.png
jmeter/trunk/docs/images/screenshots/ldaptest/responseassertion.png
jmeter/trunk/docs/images/screenshots/ldaptest/search.png
jmeter/trunk/docs/images/screenshots/ldaptest/threadgroup.png
jmeter/trunk/docs/images/screenshots/ldaptest/viewtable.png
jmeter/trunk/docs/images/screenshots/logic-controller/critical-section-controller-tp.png
jmeter/trunk/docs/images/screenshots/logic-controller/foreach-example.png
jmeter/trunk/docs/images/screenshots/logic-controller/foreach-example2.png
jmeter/trunk/docs/images/screenshots/logic-controller/interleave.png
jmeter/trunk/docs/images/screenshots/logic-controller/interleave2.png
jmeter/trunk/docs/images/screenshots/logic-controller/interleave3.png
jmeter/trunk/docs/images/screenshots/logic-controller/loop-example.png
jmeter/trunk/docs/images/screenshots/logic-controller/once-only-example.png
jmeter/trunk/docs/images/screenshots/logic-controller/simple-example.png
jmeter/trunk/docs/images/screenshots/login-config.png
jmeter/trunk/docs/images/screenshots/mirrorserver.png
jmeter/trunk/docs/images/screenshots/modification.png
jmeter/trunk/docs/images/screenshots/module_controller.png
jmeter/trunk/docs/images/screenshots/proxy_control.png
jmeter/trunk/docs/images/screenshots/regex_extractor.png
jmeter/trunk/docs/images/screenshots/sample_result_config.png
jmeter/trunk/docs/images/screenshots/scoping1.png
jmeter/trunk/docs/images/screenshots/scoping2.png
jmeter/trunk/docs/images/screenshots/scoping3.png
jmeter/trunk/docs/images/screenshots/searching/raw-search-result.png
jmeter/trunk/docs/images/screenshots/searching/raw-search.png
jmeter/trunk/docs/images/screenshots/searching/regexp-search-result.png
jmeter/trunk/docs/images/screenshots/searching/regexp-search.png
jmeter/trunk/docs/images/screenshots/setup_thread_group.png
jmeter/trunk/docs/images/screenshots/simple_config_element.png
jmeter/trunk/docs/images/screenshots/summary.png
jmeter/trunk/docs/images/screenshots/tear_down_on_shutdown.png
jmeter/trunk/docs/images/screenshots/teardown_thread_group.png
jmeter/trunk/docs/images/screenshots/threadgroup.png
jmeter/trunk/docs/images/screenshots/url_rewrite_example_a.png
jmeter/trunk/docs/images/screenshots/url_rewrite_example_b.png
jmeter/trunk/docs/images/screenshots/view_results_tree.png
jmeter/trunk/docs/images/screenshots/view_results_tree_document.png
jmeter/trunk/docs/images/screenshots/view_results_tree_regex.png
jmeter/trunk/docs/images/screenshots/view_results_tree_xml.png
jmeter/trunk/docs/images/screenshots/webtest/http-defaults1.png
jmeter/trunk/docs/images/screenshots/webtest/http-defaults2.png
jmeter/trunk/docs/images/screenshots/webtest/http-request1.png
jmeter/trunk/docs/images/screenshots/webtest/http-request2.png
jmeter/trunk/docs/images/screenshots/webtest/http_login.png
jmeter/trunk/docs/images/screenshots/webtest/threadgroup.png
jmeter/trunk/docs/images/screenshots/webtest/threadgroup2.png
jmeter/trunk/docs/images/screenshots/ws_header.png
jmeter/trunk/docs/index.html
jmeter/trunk/docs/issues.html
jmeter/trunk/docs/jmeter_irc.html
jmeter/trunk/docs/localising/index.html
jmeter/trunk/docs/mail.html
jmeter/trunk/docs/mail2.html
jmeter/trunk/docs/nightly.html
jmeter/trunk/docs/svnindex.html
jmeter/trunk/docs/usermanual/best-practices.html
jmeter/trunk/docs/usermanual/boss.html
jmeter/trunk/docs/usermanual/build-adv-web-test-plan.html
jmeter/trunk/docs/usermanual/build-db-test-plan.html
jmeter/trunk/docs/usermanual/build-ftp-test-plan.html
jmeter/trunk/docs/usermanual/build-jms-point-to-point-test-plan.html
jmeter/trunk/docs/usermanual/build-jms-topic-test-plan.html
jmeter/trunk/docs/usermanual/build-ldap-test-plan.html
jmeter/trunk/docs/usermanual/build-ldapext-test-plan.html
jmeter/trunk/docs/usermanual/build-monitor-test-plan.html
jmeter/trunk/docs/usermanual/build-test-plan.html
jmeter/trunk/docs/usermanual/build-web-test-plan.html
jmeter/trunk/docs/usermanual/build-ws-test-plan.html
jmeter/trunk/docs/usermanual/component_reference.html
jmeter/trunk/docs/usermanual/functions.html
jmeter/trunk/docs/usermanual/get-started.html
jmeter/trunk/docs/usermanual/glossary.html
jmeter/trunk/docs/usermanual/hints_and_tips.html
jmeter/trunk/docs/usermanual/index.html
jmeter/trunk/docs/usermanual/intro.html
jmeter/trunk/docs/usermanual/ldapanswer_xml.html
jmeter/trunk/docs/usermanual/ldapops_tutor.html
jmeter/trunk/docs/usermanual/listeners.html
jmeter/trunk/docs/usermanual/realtime-results.html
jmeter/trunk/docs/usermanual/regular_expressions.html
jmeter/trunk/docs/usermanual/remote-test.html
jmeter/trunk/docs/usermanual/test_plan.html
jmeter/trunk/src/core/org/apache/jmeter/util/JMeterVersion.java
jmeter/trunk/xdocs/download_jmeter.xml
jmeter/trunk/xdocs/overview.html
Modified: jmeter/trunk/docs/building.html
URL:
http://svn.apache.org/viewvc/jmeter/trunk/docs/building.html?rev=1739469&r1=1739468&r2=1739469&view=diff
==============================================================================
--- jmeter/trunk/docs/building.html (original)
+++ jmeter/trunk/docs/building.html Sat Apr 16 14:36:00 2016
@@ -1,23 +1,12 @@
<!DOCTYPE html SYSTEM "about:legacy-compat">
<html lang="en"><head><META http-equiv="Content-Type" content="text/html;
charset=iso-8859-15"><title>Apache JMeter
-
- Building JMeter and Add-Ons</title><meta name="viewport"
content="width=device-width, initial-scale=1"><link
href="http://fonts.googleapis.com/css?family=Merriweather:400normal"
rel="stylesheet" type="text/css"><link rel="stylesheet" type="text/css"
href="./css/new-style.css"></head><body role="document"><a href="#content"
class="hidden">Main content</a><div class="header"><!--
+ Building and Contributing to JMeter</title><meta name="viewport"
content="width=device-width, initial-scale=1"><link
href="http://fonts.googleapis.com/css?family=Merriweather:400normal"
rel="stylesheet" type="text/css"><link rel="stylesheet" type="text/css"
href="./css/new-style.css"><link rel="apple-touch-icon-precomposed"
href="./images/apple-touch-icon.png"><link rel="icon"
href="./images/favicon.png"><meta name="msapplication-TileColor"
content="#ffffff"><meta name="msapplication-TileImage"
content="./images/mstile-144x144.png"><meta name="theme-color"
content="#ffffff"></head><body role="document"><a href="#content"
class="hidden">Main content</a><div class="header"><!--
APACHE LOGO
- --><div><a href="http://www.apache.org"><img title="Apache Software
Foundation" width="290" height="75" src="./images/asf-logo.png" alt="Logo
ASF"></a></div><!--
+ --><div><a href="http://www.apache.org"><img title="Apache Software
Foundation" class="logo" src="./images/asf-logo.svg" alt="Logo
ASF"></a></div><!--
PROJECT LOGO
- --><div><a href="http://jmeter.apache.org/"><img
src="./images/logo.jpg" alt="Apache JMeter"></a></div><div
class="twitter"><div><a href="https://twitter.com/share"
class="twitter-share-button" data-text="Powerful Load Testing with Apache
#JMeter" data-via="ApacheJMeter" data-lang="en-gb"
data-size="large">Tweet</a><script>
- (function(d,s,id){
- var js,
- fjs=d.getElementsByTagName(s)[0],
- p=/^http:/.test(d.location)?'http':'https';
- if (!d.getElementById(id)) {
- js=d.createElement(s);
- js.id=id;
- js.src=p+'://platform.twitter.com/widgets.js';
- fjs.parentNode.insertBefore(js,fjs);
- }
- })(document, 'script', 'twitter-wjs');
- </script></div><div><a href="https://twitter.com/ApacheJMeter"
class="twitter-follow-button" data-show-count="false" data-lang="en-gb"
data-size="large">Follow</a><script>(function(d,s,id){
+ --><div><a href="http://jmeter.apache.org/"><img class="logo"
src="./images/logo.svg" alt="Apache JMeter"></a></div><div
class="banner"><iframe src="http://www.apache.org/ads/bannerbar.html"
style="border-width:0;" frameborder="0" scrolling="no"></iframe><div
class="clear"></div></div></div><div class="nav"><div class="social
menu"><div><a href="https://twitter.com/share" class="twitter-share-button"
data-text="Powerful Load Testing with Apache #JMeter" data-via="ApacheJMeter"
data-lang="en-gb" data-size="large">Tweet</a><script>
+ (function(d,s,id){
var js,
fjs=d.getElementsByTagName(s)[0],
p=/^http:/.test(d.location)?'http':'https';
@@ -27,62 +16,120 @@
js.src=p+'://platform.twitter.com/widgets.js';
fjs.parentNode.insertBefore(js,fjs);
}
- })(document, 'script', 'twitter-wjs');
- </script></div></div><div class="banner"><iframe
src="http://www.apache.org/ads/bannerbar.html" style="border-width:0;"
frameborder="0" scrolling="no"></iframe><div
class="clear"></div></div></div><div class="nav"><ul class="menu"><li><div
class="menu-title">About</div><ul><li><a
href="./index.html">Overview</a></li><li><a
href="http://twitter.com/ApacheJMeter">JMeter on Twitter<img
src="./images/twitter.png" alt="Icon for JMeter on Twitter"></a></li><li><a
href="./issues.html">Issue Tracking</a></li><li><a
href="http://projects.apache.org/feeds/rss/jmeter.xml">Subscribe to What's
New</a></li><li><a
href="http://www.apache.org/licenses/">License</a></li></ul></li></ul><ul
class="menu"><li><div class="menu-title">Download</div><ul><li><a
href="./download_jmeter.cgi">Download Releases</a></li><li><a
href="./nightly.html">Developer (Nightly) Builds</a></li></ul></li></ul><ul
class="menu"><li><div class="menu-title">Documentation</div><ul><li><a
href="./changes.html">Chang
es per version</a></li><li><a href="./usermanual/get-started.html">Get
Started</a></li><li><a href="./usermanual/index.html">User
Manual</a></li><li><a href="./usermanual/best-practices.html">Best
Practices</a></li><li><a href="./usermanual/component_reference.html">Component
Reference</a></li><li><a href="./usermanual/functions.html">Functions
Reference</a></li><li><a href="./api/index.html">Javadocs</a></li><li><a
href="./building.html">Building JMeter and Add-Ons</a></li><li><a
href="http://wiki.apache.org/jmeter">JMeter Wiki</a></li><li><a
href="http://wiki.apache.org/jmeter/JMeterFAQ">FAQ
(Wiki)</a></li></ul></li></ul><ul class="menu"><li><div
class="menu-title">Tutorials (PDF format)</div><ul><li><a
href="./usermanual/jmeter_distributed_testing_step_by_step.pdf">Distributed
Testing</a></li><li><a
href="./usermanual/jmeter_proxy_step_by_step.pdf">Recording
Tests</a></li><li><a href="./usermanual/junitsampler_tutorial.pdf">JUnit
Sampler</a></li><li><a href="./usermanual/jmeter_a
ccesslog_sampler_step_by_step.pdf">Access Log Sampler</a></li><li><a
href="./extending/jmeter_tutorial.pdf">Extending
JMeter</a></li></ul></li></ul><ul class="menu"><li><div
class="menu-title">Community</div><ul><li><a
href="http://wiki.apache.org/jmeter/JMeterCommitters">Contributors</a></li><li><a
href="./mail.html">Mailing Lists</a></li><li><a href="./svnindex.html">SVN
Repositories</a></li></ul></li></ul><ul class="menu"><li><div
class="menu-title">Foundation</div><ul><li><a
href="http://www.apache.org/">ASF</a></li><li><a
href="http://www.apache.org/foundation/getinvolved.html">Get Involved in the
ASF</a></li><li><a
href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li><li><a
href="http://www.apache.org/foundation/thanks.html">Thanks</a></li></ul></li></ul></div><div
class="main" id="content"><div class="section"><h1>Building JMeter and
Add-Ons</h1>
-<font color="red"><strong>
-Note to developers:
-This is a very brief overview.
-There is more infomation on the JMeter Wiki or in eclipse.readme in root
folder of sources.
-</strong></font>
-<h2>Building Add-Ons</h2>
+ })(document, 'script', 'twitter-wjs');
+ </script></div><div><a href="https://twitter.com/ApacheJMeter"
class="twitter-follow-button" data-show-count="false" data-lang="en-gb"
data-size="large">Follow</a><script>(function(d,s,id){
+ var js,
+ fjs=d.getElementsByTagName(s)[0],
+ p=/^http:/.test(d.location)?'http':'https';
+ if (!d.getElementById(id)) {
+ js=d.createElement(s);
+ js.id=id;
+ js.src=p+'://platform.twitter.com/widgets.js';
+ fjs.parentNode.insertBefore(js,fjs);
+ }
+ })(document, 'script', 'twitter-wjs');
+ </script></div><div><a
href="https://github.com/apache/jmeter"><img alt="star this repo"
src="http://githubbadges.com/star.svg?user=apache&repo=jmeter&style=default"></a></div><div><a
href="https://github.com/apache/jmeter/fork"><img alt="fork this repo"
src="http://githubbadges.com/fork.svg?user=apache&repo=jmeter&style=default"></a></div><div><a
href="https://maven-badges.herokuapp.com/maven-central/org.apache.jmeter/ApacheJMeter"><img
alt="Maven Central"
src="https://maven-badges.herokuapp.com/maven-central/org.apache.jmeter/ApacheJMeter/badge.png"></a></div></div><ul
class="menu"><li onClick="return true"><div
class="menu-title">About</div><ul><li><a
href="./index.html">Overview</a></li><li><a
href="http://www.apache.org/licenses/">License</a></li></ul></li></ul><ul
class="menu"><li onClick="return true"><div
class="menu-title">Download</div><ul><li><a
href="./download_jmeter.cgi">Download Releases</a></li><li><a
href="./nightly.html">Developer (N
ightly) Builds</a></li></ul></li></ul><ul class="menu"><li onClick="return
true"><div class="menu-title">Documentation</div><ul><li><a
href="./changes.html">Changes per version</a></li><li><a
href="./usermanual/get-started.html">Get Started</a></li><li><a
href="./usermanual/index.html">User Manual</a></li><li><a
href="./usermanual/best-practices.html">Best Practices</a></li><li><a
href="./usermanual/component_reference.html">Component Reference</a></li><li><a
href="./usermanual/functions.html">Functions Reference</a></li><li><a
href="./api/index.html">Javadocs</a></li><li><a href="./building.html">Building
JMeter and Add-Ons</a></li><li><a href="http://wiki.apache.org/jmeter">JMeter
Wiki</a></li><li><a href="http://wiki.apache.org/jmeter/JMeterFAQ">FAQ
(Wiki)</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div
class="menu-title">Tutorials (PDF format)</div><ul><li><a
href="./usermanual/jmeter_distributed_testing_step_by_step.pdf">Distributed
Testing</a></li><li><a
href="./usermanual/jmeter_proxy_step_by_step.pdf">Recording
Tests</a></li><li><a href="./usermanual/junitsampler_tutorial.pdf">JUnit
Sampler</a></li><li><a
href="./usermanual/jmeter_accesslog_sampler_step_by_step.pdf">Access Log
Sampler</a></li><li><a href="./extending/jmeter_tutorial.pdf">Extending
JMeter</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div
class="menu-title">Community</div><ul><li><a href="./issues.html">Issue
Tracking</a></li><li><a href="./mail.html">Mailing Lists</a></li><li><a
href="./svnindex.html">Source Repositories</a></li><li><a
href="./building.html">Building and Contributing</a></li><li><a
href="https://projects.apache.org/project.html?jmeter">Project info at
Apache</a></li><li><a
href="http://wiki.apache.org/jmeter/JMeterCommitters">Contributors</a></li></ul></li></ul><ul
class="menu"><li onClick="return true"><div
class="menu-title">Foundation</div><ul><li><a
href="http://www.apache.org/">ASF</a></li><li><a href="http://www.apache.o
rg/foundation/getinvolved.html">Get Involved in the ASF</a></li><li><a
href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li><li><a
href="http://www.apache.org/foundation/thanks.html">Thanks</a></li></ul></li></ul></div><div
class="main" id="content"><div class="section"><h1>Building JMeter</h1>
+<h3>Acquiring the source</h3>
+<p>The full source is distributed alongside the binary, and you can also find
source repositories <a href="./svnindex.html">here</a> .</p>
<p>
-There is no need to build JMeter if you just want to build an add-on.
-Just download the binary archive and add the jars to the classpath or use
Maven artifacts to build your add-ons.
-You may want to also download the source so it can be used by the IDE.
+The source archive, SVN and GIT do not contain any of the required library
files.
-</p>
-<p>See the extras/addons* files in the source tree for some suggestions</p>
+<h3>Compiling and packaging JMeter using Eclipse</h3>
+<h4>Option 1 : Setting up Eclipse project with Ant task</h4>
+Once you have downloaded the sources using git or svn, you can setup the
Eclipse project by running:
-<h2>Building JMeter</h2>
-<h3>Acquiring the source</h3>
-<p>The full source is distributed alongside the binary, it can also be
downloaded from SVN or found on <a target="_blank"
href="https://github.com/apache/jmeter">Apache JMeter Github Mirror</a> .</p>
-<p>
-The source archive and SVN do not contain any of the required library files.
-These need to be downloaded by running the Ant command:
-<pre>
+<pre class="source">ant setup-eclipse-project</pre>
+
+You can then import the project using
+<span class="menuchoice"><span
class="guimenuitem">File</span> → <span
class="guimenuitem">Import</span> → <span
class="guimenuitem">Existing projects into Workspace</span></span> and select
the folder containing JMeter sources.
+
+<h4>Option 2 : Setting up Eclipse project manually</h4>
+The first step is to download dependencies by running the Ant command:</p>
+<pre class="source">
ant download_jars
</pre>
-</p>
<p>Or you can download the binary distribution archive for a release and
unpack it into the same directory structure as the source.
-This will ensure that the lib/ directory contains the jar files needed for
running JMeter.
+This will ensure that the <span class="code">lib/</span> directory contains
the jar files needed for running JMeter.
There are a few additional jars that are needed to build JMeter, download
these using:
-<pre>
+</p>
+<pre class="source">
ant download_jars
</pre>
+<p>
This will retrieve any missing jars.
</p>
+
+<p>
+Once you have downloaded the source from SVN or the release archives and run
the ant <span class="code">download_jars</span> target to
+install the dependent jars, you can configure Eclipse. The easiest way to do
this is to replace the Eclipse <span class="code">.classpath</span>
+file with the <span class="code">eclipse.classpath</span> file provided with
JMeter. This will set up the source-paths and most of the libraries.
+</p>
+<p>
+Ensure you read <span class="code">eclipse.readme</span> for project
configuration.
+</p>
+
+
<h3>Compiling and packaging JMeter using Ant</h3>
<p>
JMeter can be built entirely using Ant.
-The basic command is:
-<pre>
+The basic command is:</p>
+<pre class="source">
ant [install]
</pre>
-See build.xml for the other targets that can be used.
-</p>
-<h3>Compiling and packaging JMeter using Eclipse</h3>
-<p>
-Once you have downloaded the source from SVN or the release archives and run
the ant download_jars target to
-install the dependent jars, you can configure Eclipse. The easiest way to do
this is to replace the Eclipse .classpath
-file with the eclipse.classpath file provided with JMeter. This will set up
the source-paths and most of the libraries.
+See <span class="code">build.xml</span> (or call <span class="code">ant
-p</span>) for the other targets that can be used.
+
+</div><div class="section"><h1>Contributing to JMeter</h1>
+<h2>We love contribution</h2>
+We are very grateful to you if you take some time to contribute to the project.
+If you have some time to spend on the project you can pick existing
enhancement or bug from <a target="_blank" href="issues.html">Issues page</a>.
+
+<h2>Submitting a patch</h2>
+
+If you want to contribute to JMeter for a bug fix or enhancement, here is the
procedure to follow:
+
+<h3>Check your patch</h3>
+Before submitting your patch ensure you do the following:<br>
+
+Check that patch compiles and follows Tab space policy by running:
+<pre class="source">ant package-and-check</pre>
+
+Check that patch does not break JUnit tests by running:
+<pre class="source">ant test</pre>
+
+<h3>Create a PR using GIT</h3>
+<ul>
+ <li>Open a bugzilla issue, see <a target="_blank"
href="issues.html">Issues page</a></li>
+ <li>Fork <a href="https://www.github.com/apache/jmeter">Apache JMeter
mirror</a></li>
+ <li>Clone your forked repository locally : <pre class="source">git clone
https://github.com/yourid/jmeter/</pre></li>
+ <li>Create a branch using for example bugzilla id: <pre class="source">git
branch BUGID</pre></li>
+ <li>Checkout the new branch : <pre class="source">git checkout
BUGID</pre></li>
+ <li>commit your fix there : <pre class="source">git commit -m 'Fix to
BUGID' list of files</pre></li>
+ <li>Add JMeter repository as upstream : <pre class="source">git remote add
upstream http://www.github.com/apache/jmeter</pre></li>
+ <li>push it : <pre class="source">git push origin BUGID</pre></li>
+ <li>Create a PR and link it in the bugzilla issue</li>
+</ul>
+
+<h3>Create a PR using Patch</h3>
+<ul>
+ <li>Open a bugzilla issue, see <a target="_blank"
href="issues.html">Issues page</a></li>
+ <li>Checkout Apache JMeter source</li>
+ <li>Code your fix</li>
+ <li>Create your patch by Right clicking on Eclipse project and select
+ <span class="menuchoice"><span
class="guimenuitem">Team</span> → <span
class="guimenuitem">Create Patch …</span></span></li>
+ <li>Attach your patch to the bugzilla issue</li>
+</ul>
+</div><div class="section"><h1>Building Add-Ons</h1>
+<h2>Building Add-Ons</h2>
<p>
-Ensure your read eclipse.readme for project configuration.
-</p>
+There is no need to build JMeter if you just want to build an add-on.
+Just download the binary archive and add the jars to the classpath or use
Maven artifacts to build your add-ons.
+You may want to also download the source so it can be used by the IDE.
</p>
+<p>See the <span class="code">extras/addons*</span> files in the source tree
for some suggestions</p>
</div></div><div class="footer"><div class="copyright">
Copyright ©
1999 –
- 2015
+ 2016
, Apache Software Foundation
</div><div class="trademarks">Apache, Apache JMeter, JMeter, the
Apache
feather, and the Apache JMeter logo are