http://git-wip-us.apache.org/repos/asf/yetus/blob/6ca1d766/documentation/0.1.0/precommit-bugsystems/index.html ---------------------------------------------------------------------- diff --git a/documentation/0.1.0/precommit-bugsystems/index.html b/documentation/0.1.0/precommit-bugsystems/index.html deleted file mode 100644 index 821258f..0000000 --- a/documentation/0.1.0/precommit-bugsystems/index.html +++ /dev/null @@ -1,214 +0,0 @@ -<!--- - Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> - -<html> - <head> - <meta charset="utf-8"> - <title>Apache Yetus</title> - <meta name="viewport" content="width=device-width, initial-scale=1.0"> - <meta name="description" content=""> - <meta name="author" content=""> - - <link href="/assets/css/bootstrap.css" rel="stylesheet"> - <link href="/assets/css/bootstrap-theme.css" rel="stylesheet"> - <link href="/assets/css/font-awesome.css" rel="stylesheet"> - - <!-- JS --> - <script type="text/javascript" src="/assets/js/jquery-2.1.4.min.js"></script> - <script type="text/javascript" src="/assets/js/bootstrap.js"></script> - </head> - <body> - <div class="navbar navbar-inverse navbar-static-top" role="navigation"> - <div class="container"> - <div class="navbar-header"> - <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse"> - <span class="sr-only">Toggle navigation</span> - <span class="icon-bar"></span> - <span class="icon-bar"></span> - <span class="icon-bar"></span> - </button> - <a class="img-responsive pull-left" href="/"> - <img style="max-height: 40px; margin-top: 5px; margin-bottom: 5px;" src="/assets/img/yetus_logo.png" alt="Apache Yetus logo" /> - </a> - </div> - <div class="navbar-collapse collapse"> - <ul class="nav navbar-nav"> - <li><a href="/downloads/">Downloads</a> - <li class="dropdown"> - <a class="dropdown-toggle" data-toggle="dropdown" href="#">Documentation <span class="caret"></span></a> - <ul class="dropdown-menu" role="menu"> - <li><a href="/documentation/0.1.0/">Docs for v0.1.0</a></li> - <li><a href="/documentation/0.2.0/">Docs for v0.2.0</a></li> - <li><a href="/documentation/0.2.1/">Docs for v0.2.1</a></li> - <li><a href="/documentation/0.3.0/">Docs for v0.3.0</a></li> - <li><a href="/documentation/0.4.0/">Docs for v0.4.0</a></li> - <li><a href="/documentation/in-progress/">In Progress Docs for Contributors</a> - </li> - </ul> - </li> - <li class="dropdown"> - <a class="dropdown-toggle" data-toggle="dropdown" href="#">Get Involved <span class="caret"></span></a> - <ul class="dropdown-menu" role="menu" aria-labelledby="drop1"> - <li role="presentation"><a role="menuitem" tabindex="-1" href="/mailinglists"><i class="fa fa-commenting"></i> Mailing Lists</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="http://issues.apache.org/jira/browse/YETUS";><i class="fa fa-bug"></i> JIRA (Bugs)</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="https://git-wip-us.apache.org/repos/asf?s=yetus";><i class="fa fa-code"></i> Source (Apache)</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="https://github.com/apache/yetus";><i class="fa fa-github-alt"></i> Source (GitHub)</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="/contribute/"><i class="fa fa-code-fork"></i> Contributing</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="https://twitter.com/ApacheYetus";><i class="fa fa-twitter"></i> @ApacheYetus</a> - </li> - </ul> - </li> - <li> - <li class="dropdown"> - <a class="dropdown-toggle" data-toggle="dropdown" href="#">Apache Software Foundation <b class="caret"></b></a> - <ul class="dropdown-menu" role="menu"> - <li><a href="http://www.apache.org";>Apache Homepage</a> - </li> - <li><a href="http://www.apache.org/licenses/";>Apache License</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> - <li><a href="http://www.apache.org/security/";>Security</a> - </li> - </ul> - </li> - </li> - </ul> - </div> - <!--/.nav-collapse --> - </div> -</div> - - <div class="container"> - <!--- - Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> - -<h1 id="bug-system-support">Bug System Support</h1> - -<p>test-patch has the ability to support multiple bug systems. Bug tools have some extra hooks to fetch patches, line-level reporting, and posting a final report. Every bug system plug-in must have one line in order to be recognized:</p> -<pre class="highlight shell"><code>add_bugsystem <pluginname> -</code></pre> -<ul> -<li><p>pluginname_locate_patch</p> - -<ul> -<li>Given input from the user, download the patch if possible.</li> -</ul></li> -<li><p>pluginname_determine_branch</p> - -<ul> -<li>Using any heuristics available, return the branch to process, if possible.</li> -</ul></li> -<li><p>pluginname_determine_issue</p> - -<ul> -<li>Using any heuristics available, set the issue, bug number, etc, for this bug system, if possible. This is typically used to fill in supplementary information in the final output table.</li> -</ul></li> -<li><p>pluginname_write_comment</p> - -<ul> -<li>Given text input, write this output to the bug system as a comment. NOTE: It is the bug system’s responsibility to format appropriately.</li> -</ul></li> -<li><p>pluginname_linecomments</p> - -<ul> -<li>This function allows for the system to write specific comments on specific lines if the bug system supports code review comments.</li> -</ul></li> -<li><p>pluginname_finalreport</p> - -<ul> -<li>Write the final result table to the bug system.</li> -</ul></li> -</ul> - -<h1 id="bugzilla-specific">Bugzilla Specific</h1> - -<p>Currently, Bugzilla support is read-only. To use it, the Bug ID must be preferenced with ‘BZ:’. For example:</p> -<pre class="highlight shell"><code><span class="gp">$ </span><span class="nb">test</span>-patch.sh <span class="o">(</span>other options<span class="o">)</span> BZ:4 -</code></pre> -<p>… will pull down Bugzilla ID #4.</p> - -<p>Using the <code>--bugzilla-base-url</code> on the command line or BUGZILLA_BASE_URL in a project’s personality will define the location of the Bugzilla instance. By default, it is <a href="https://bz.apache.org/bugzilla";>https://bz.apache.org/bugzilla</a> .</p> - -<h1 id="github-specific">GitHub Specific</h1> - -<p>GitHub supports the full range of functionality, including putting comments on individual lines. Be aware, however, that test-patch.sh will require that GitHub PRs be fully rebased (i.e., a single commit) in many circumstances.</p> - -<p>By default, the GitHub plug-in assumes that <a href="https://github.com";>https://github.com</a> is the base URL for GitHub. Enterprise users may override this with the <code>--github-base-url</code> for the normal web user interface and <code>--github-api-url</code> for the API URL. Personalities may use GITHUB_API_URL and GITHUB_BASE_URL.</p> - -<p>The specific repository on GitHub is defined with either <code>--github-repo</code> on the command line or GITHUB_REPO in a personality. It should take the form of <q>user/repo</q>.</p> - -<p>In order to comment on issues or, depending upon the security setup of the repo, authentication credentials. The GitHub plug-in supports two types:</p> - -<ul> -<li><p>Token-based: <code>--github-token</code> or GITHUB_TOKEN</p></li> -<li><p>Username/password: <code>--github-user</code>/ GITHUB_USER , <code>--github-password</code> / GITHUB_PASSWD</p></li> -</ul> - -<p>Pull requests that are made off of a specific branch will switch the test repo to that branch, if permitted. If the pull request references a JIRA issue that matches the given JIRA issue regexp in the Subject, the JIRA plug-in will also be invoked as needed.</p> - -<h1 id="jira-specific">JIRA Specific</h1> - -<p>JIRA support allows both patch downloads and summary writes. It also supports branch detection-based upon the name of the attached patch file.</p> - -<p>JIRA issues are invoked by matching the command line option to a specific regular expression as given by the <code>--jira-issue-re</code> option or via the JIRA_ISSUE_RE personality variable. By default, the plug-in uses <a href="https://issues.apache.org/jira";>https://issues.apache.org/jira</a> as the JIRA instance to use. However that may be overwritten via the <code>--jira-base-url</code> option or personalities may define via JIRA_URL.</p> - -<p>In order to write information on the issue, JIRA requires username and password authentication using the <code>--jira-user</code>/<code>--jira-password</code> options or the JIRA_USER and JIRA_PASSWORD variables in a personality.</p> - - </div> - <div class="container"> - <hr> - <footer class="footer"> - <div class="row-fluid"> - <div class="span12 text-left"> - <div class="span12"> - Copyright 2008-2017 <a href="http://www.apache.org/";>Apache Software Foundation</a>. Licensed under the <a href="http://www.apache.org/licenses/";>Apache License v2.0</a>. Apache Yetus and the Apache feather logo are trademarks of The Apache Software Foundation. - </div> - </div> - - </div> - - </footer> -</div> - - </body> -</html>
http://git-wip-us.apache.org/repos/asf/yetus/blob/6ca1d766/documentation/0.1.0/precommit-buildtools/index.html ---------------------------------------------------------------------- diff --git a/documentation/0.1.0/precommit-buildtools/index.html b/documentation/0.1.0/precommit-buildtools/index.html deleted file mode 100644 index 06970bd..0000000 --- a/documentation/0.1.0/precommit-buildtools/index.html +++ /dev/null @@ -1,274 +0,0 @@ -<!--- - Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> - -<html> - <head> - <meta charset="utf-8"> - <title>Apache Yetus</title> - <meta name="viewport" content="width=device-width, initial-scale=1.0"> - <meta name="description" content=""> - <meta name="author" content=""> - - <link href="/assets/css/bootstrap.css" rel="stylesheet"> - <link href="/assets/css/bootstrap-theme.css" rel="stylesheet"> - <link href="/assets/css/font-awesome.css" rel="stylesheet"> - - <!-- JS --> - <script type="text/javascript" src="/assets/js/jquery-2.1.4.min.js"></script> - <script type="text/javascript" src="/assets/js/bootstrap.js"></script> - </head> - <body> - <div class="navbar navbar-inverse navbar-static-top" role="navigation"> - <div class="container"> - <div class="navbar-header"> - <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse"> - <span class="sr-only">Toggle navigation</span> - <span class="icon-bar"></span> - <span class="icon-bar"></span> - <span class="icon-bar"></span> - </button> - <a class="img-responsive pull-left" href="/"> - <img style="max-height: 40px; margin-top: 5px; margin-bottom: 5px;" src="/assets/img/yetus_logo.png" alt="Apache Yetus logo" /> - </a> - </div> - <div class="navbar-collapse collapse"> - <ul class="nav navbar-nav"> - <li><a href="/downloads/">Downloads</a> - <li class="dropdown"> - <a class="dropdown-toggle" data-toggle="dropdown" href="#">Documentation <span class="caret"></span></a> - <ul class="dropdown-menu" role="menu"> - <li><a href="/documentation/0.1.0/">Docs for v0.1.0</a></li> - <li><a href="/documentation/0.2.0/">Docs for v0.2.0</a></li> - <li><a href="/documentation/0.2.1/">Docs for v0.2.1</a></li> - <li><a href="/documentation/0.3.0/">Docs for v0.3.0</a></li> - <li><a href="/documentation/0.4.0/">Docs for v0.4.0</a></li> - <li><a href="/documentation/in-progress/">In Progress Docs for Contributors</a> - </li> - </ul> - </li> - <li class="dropdown"> - <a class="dropdown-toggle" data-toggle="dropdown" href="#">Get Involved <span class="caret"></span></a> - <ul class="dropdown-menu" role="menu" aria-labelledby="drop1"> - <li role="presentation"><a role="menuitem" tabindex="-1" href="/mailinglists"><i class="fa fa-commenting"></i> Mailing Lists</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="http://issues.apache.org/jira/browse/YETUS";><i class="fa fa-bug"></i> JIRA (Bugs)</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="https://git-wip-us.apache.org/repos/asf?s=yetus";><i class="fa fa-code"></i> Source (Apache)</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="https://github.com/apache/yetus";><i class="fa fa-github-alt"></i> Source (GitHub)</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="/contribute/"><i class="fa fa-code-fork"></i> Contributing</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="https://twitter.com/ApacheYetus";><i class="fa fa-twitter"></i> @ApacheYetus</a> - </li> - </ul> - </li> - <li> - <li class="dropdown"> - <a class="dropdown-toggle" data-toggle="dropdown" href="#">Apache Software Foundation <b class="caret"></b></a> - <ul class="dropdown-menu" role="menu"> - <li><a href="http://www.apache.org";>Apache Homepage</a> - </li> - <li><a href="http://www.apache.org/licenses/";>Apache License</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> - <li><a href="http://www.apache.org/security/";>Security</a> - </li> - </ul> - </li> - </li> - </ul> - </div> - <!--/.nav-collapse --> - </div> -</div> - - <div class="container"> - <!--- - Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> - -<h1 id="build-tool-support">Build Tool Support</h1> - -<p>test-patch has the ability to support multiple build tools. Build tool plug-ins have some extra hooks to do source and object maintenance at key points. Every build tool plug-in must have one line in order to be recognized:</p> -<pre class="highlight shell"><code>add_build_tool <pluginname> -</code></pre> -<h1 id="global-variables">Global Variables</h1> - -<ul> -<li><p>BUILDTOOLCWD</p> - -<ul> -<li>If the build tool does not always run from the ${BASEDIR} and instead needs to change the current working directory to work on a specific module, then set this to true. The default is false.</li> -</ul></li> -<li><p>UNSUPPORTED_TEST</p> - -<ul> -<li>If pluginname_modules_worker is given a test type that is not supported by the build system, set UNSUPPORTED_TEST=true. If it is supported, set UNSUPPORTED_TEST=false.</li> -</ul></li> -</ul> - -<p>For example, the gradle build tool does not have a standard way to execute checkstyle. So when checkstyle is requested, gradle_modules_worker sets UNSUPPORTED_TEST to true and returns out of the routine.</p> - -<h1 id="required-functions">Required Functions</h1> - -<ul> -<li><p>pluginname_buildfile</p> - -<ul> -<li>This should be an echo of the file that controls the build system. This is used for module determination. If the build system wishes to disable module determination, it should echo with no args.</li> -</ul></li> -<li><p>pluginname_executor</p> - -<ul> -<li>This should be an echo of how to run the build tool, any extra arguments, etc.</li> -</ul></li> -<li><p>pluginname_modules_worker</p> - -<ul> -<li>Input is the branch and the test being run. This should call <code>modules_workers</code> with the generic parts to run that test on the build system. For example, if it is convention to use ‘test’ to trigger ‘unit’ tests, then <code>module_workers</code> should be called with ‘test’ appended onto its normal parameters.</li> -</ul></li> -<li><p>pluginname_builtin_personality_modules</p> - -<ul> -<li>Default method to determine how to enqueue modules for processing. Note that personalities may override this function.</li> -</ul></li> -<li><p>pluginname_builtin_personality_file_tests</p> - -<ul> -<li>Default method to determine which tests to trigger. Note that personalities may override this function.</li> -</ul></li> -</ul> - -<h1 id="optional-functions">Optional Functions</h1> - -<ul> -<li><p>pluginname_postapply_install</p> - -<ul> -<li>After the install step, this allows the build tool plug-in to do extra work.</li> -</ul></li> -<li><p>pluginname_parse_args</p> - -<ul> -<li>executed prior to any other above functions except for pluginname_usage. This is useful for parsing the arguments passed from the user and setting up the execution environment.</li> -</ul></li> -<li><p>pluginname_initialize</p> - -<ul> -<li>After argument parsing and prior to any other work, the initialize step allows a plug-in to do any precursor work, set internal defaults, etc.</li> -</ul></li> -<li><p>pluginname_count_(test)_probs</p> - -<ul> -<li>Certain language test plug-ins require assistance from the build tool to count problems in the compile log due to some tools having custom handling for those languages. The test plug-in name should be in the (test) part of the function name.</li> -</ul></li> -<li><p>pluginname_docker_support</p> - -<ul> -<li>If this build tool requires extra settings on the <code>docker run</code> command line, this function should be defined and write those options into a file called <code>${PATCH_DIR}/buildtool-docker-params.txt</code>. This is particularly useful for things like mounting volumes for repository caches.</li> -</ul> - -<p><strong>WARNING</strong>: Be aware that directories that do not exist MAY be created by root by Docker itself under certain conditions. It is HIGHLY recommend that <code>pluginname_initialize</code> be used to create the necessary directories prior to be used in the <code>docker run</code> command.</p></li> -</ul> - -<h1 id="ant-specific">Ant Specific</h1> - -<h2 id="command-arguments">Command Arguments</h2> - -<p>test-patch always passes -noinput to Ant. This forces ant to be non-interactive.</p> - -<h2 id="docker-mode">Docker Mode</h2> - -<p>In Docker mode, the <code>${HOME}/.ivy2</code> directory is shared amongst all invocations.</p> - -<h1 id="gradle-specific">Gradle Specific</h1> - -<p>The gradle plug-in always rebuilds the gradlew file and uses gradlew as the method to execute commands.</p> - -<p>In Docker mode, the <code>${HOME}/.gradle</code> directory is shared amongst all invocations.</p> - -<h1 id="maven-specific">Maven Specific</h1> - -<h2 id="command-arguments">Command Arguments</h2> - -<p>test-patch always passes –batch-mode to maven to force it into non-interactive mode. Additionally, some tests will also force -fae in order to get all of messages/errors during that mode. Some tests are executed with -DskipTests. Additional arguments should be handled via the personality.</p> - -<h2 id="per-instance-repositories">Per-instance Repositories</h2> - -<p>Under many common configurations, maven (as of 3.3.3 and lower) may not properly handle being executed by multiple processes simultaneously, especially given that some tests require the <code>mvn install</code> command to be used.</p> - -<p>To assist, <code>test-patch</code> supports a <code>--mvn-custom-repo</code> option to set the <code>-Dmaven.repo.local</code> value to a per-instance repository directory keyed to the project and branch being used for the test. If the <code>--jenkins</code> flag is also passed, the instance will be tied to the Jenkins <code>${EXECUTOR_NUMBER}</code> value. Otherwise, the instance value will be randomly generated via <code>${RANDOM}</code>. If the repository has not been used in 30 days, it will be automatically deleted when any test run for that project (regardless of branch!).</p> - -<p>By default, <code>test-patch</code> uses <code>${HOME}/yetus-m2</code> as the base directory to store these custom maven repositories. That location may be changed via the <code>--mvn-custom-repos-dir</code> option.</p> - -<p>The location of the <code>settings.xml</code> may be changed via the <code>--mvn-settings</code> option.</p> - -<h2 id="docker-mode">Docker Mode</h2> - -<p>In Docker mode, <code>${HOME}/.m2</code> is shared amongst all invocations. If <code>--mvn-custom-repos</code> is used, all of <code>--mvn-custom-repos-dir</code> is shared with all invocations. The per-instance directory will be calculated and configured after Docker has launched.</p> - -<h2 id="test-profile">Test Profile</h2> - -<p>By default, test-patch will pass -Ptest-patch to Maven. This will allow you to configure special actions that should only happen when running underneath test-patch.</p> - -<h2 id="custom-maven-tests">Custom Maven Tests</h2> - -<ul> -<li>Maven will trigger a maven install as part of the precompile.</li> -<li>Maven will test eclipse integration as part of the postcompile.</li> -<li>If src/site is modified, maven site tests are executed.</li> -</ul> - - </div> - <div class="container"> - <hr> - <footer class="footer"> - <div class="row-fluid"> - <div class="span12 text-left"> - <div class="span12"> - Copyright 2008-2017 <a href="http://www.apache.org/";>Apache Software Foundation</a>. Licensed under the <a href="http://www.apache.org/licenses/";>Apache License v2.0</a>. Apache Yetus and the Apache feather logo are trademarks of The Apache Software Foundation. - </div> - </div> - - </div> - - </footer> -</div> - - </body> -</html> http://git-wip-us.apache.org/repos/asf/yetus/blob/6ca1d766/documentation/0.1.0/precommit-glossary/index.html ---------------------------------------------------------------------- diff --git a/documentation/0.1.0/precommit-glossary/index.html b/documentation/0.1.0/precommit-glossary/index.html deleted file mode 100644 index 6c03621..0000000 --- a/documentation/0.1.0/precommit-glossary/index.html +++ /dev/null @@ -1,174 +0,0 @@ -<!--- - Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> - -<html> - <head> - <meta charset="utf-8"> - <title>Apache Yetus</title> - <meta name="viewport" content="width=device-width, initial-scale=1.0"> - <meta name="description" content=""> - <meta name="author" content=""> - - <link href="/assets/css/bootstrap.css" rel="stylesheet"> - <link href="/assets/css/bootstrap-theme.css" rel="stylesheet"> - <link href="/assets/css/font-awesome.css" rel="stylesheet"> - - <!-- JS --> - <script type="text/javascript" src="/assets/js/jquery-2.1.4.min.js"></script> - <script type="text/javascript" src="/assets/js/bootstrap.js"></script> - </head> - <body> - <div class="navbar navbar-inverse navbar-static-top" role="navigation"> - <div class="container"> - <div class="navbar-header"> - <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse"> - <span class="sr-only">Toggle navigation</span> - <span class="icon-bar"></span> - <span class="icon-bar"></span> - <span class="icon-bar"></span> - </button> - <a class="img-responsive pull-left" href="/"> - <img style="max-height: 40px; margin-top: 5px; margin-bottom: 5px;" src="/assets/img/yetus_logo.png" alt="Apache Yetus logo" /> - </a> - </div> - <div class="navbar-collapse collapse"> - <ul class="nav navbar-nav"> - <li><a href="/downloads/">Downloads</a> - <li class="dropdown"> - <a class="dropdown-toggle" data-toggle="dropdown" href="#">Documentation <span class="caret"></span></a> - <ul class="dropdown-menu" role="menu"> - <li><a href="/documentation/0.1.0/">Docs for v0.1.0</a></li> - <li><a href="/documentation/0.2.0/">Docs for v0.2.0</a></li> - <li><a href="/documentation/0.2.1/">Docs for v0.2.1</a></li> - <li><a href="/documentation/0.3.0/">Docs for v0.3.0</a></li> - <li><a href="/documentation/0.4.0/">Docs for v0.4.0</a></li> - <li><a href="/documentation/in-progress/">In Progress Docs for Contributors</a> - </li> - </ul> - </li> - <li class="dropdown"> - <a class="dropdown-toggle" data-toggle="dropdown" href="#">Get Involved <span class="caret"></span></a> - <ul class="dropdown-menu" role="menu" aria-labelledby="drop1"> - <li role="presentation"><a role="menuitem" tabindex="-1" href="/mailinglists"><i class="fa fa-commenting"></i> Mailing Lists</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="http://issues.apache.org/jira/browse/YETUS";><i class="fa fa-bug"></i> JIRA (Bugs)</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="https://git-wip-us.apache.org/repos/asf?s=yetus";><i class="fa fa-code"></i> Source (Apache)</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="https://github.com/apache/yetus";><i class="fa fa-github-alt"></i> Source (GitHub)</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="/contribute/"><i class="fa fa-code-fork"></i> Contributing</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="https://twitter.com/ApacheYetus";><i class="fa fa-twitter"></i> @ApacheYetus</a> - </li> - </ul> - </li> - <li> - <li class="dropdown"> - <a class="dropdown-toggle" data-toggle="dropdown" href="#">Apache Software Foundation <b class="caret"></b></a> - <ul class="dropdown-menu" role="menu"> - <li><a href="http://www.apache.org";>Apache Homepage</a> - </li> - <li><a href="http://www.apache.org/licenses/";>Apache License</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> - <li><a href="http://www.apache.org/security/";>Security</a> - </li> - </ul> - </li> - </li> - </ul> - </div> - <!--/.nav-collapse --> - </div> -</div> - - <div class="container"> - <!--- - Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> - -<h1 id="glossary">Glossary</h1> - -<h2 id="generic-outside-definitions">Generic/outside definitions:</h2> - -<p>Apache’s <a href="https://community.apache.org/contributors/";>new contributor documentation</a> and Maven’s <a href="https://maven.apache.org/glossary.html";>glossary</a> are great places to start if you are new to Apache or Maven.</p> - -<ul> -<li>Module</li> -</ul> - -<p>Almost the same meaning as <q>sub-project</q> on Maven.</p> - -<h2 id="test-patch-specific">test-patch specific</h2> - -<ul> -<li>Personality</li> -</ul> - -<p>A chunk of shell code that tells test-patch this particular project’s needs and special requirements</p> - -<ul> -<li>Plug-ins</li> -</ul> - -<p>Shell code snippets that define new, not built-in test types.</p> - -<ul> -<li>Precommit</li> -</ul> - -<p>An automated process that verifies a patch is <q>good</q> prior to a committer looking at it.</p> - - </div> - <div class="container"> - <hr> - <footer class="footer"> - <div class="row-fluid"> - <div class="span12 text-left"> - <div class="span12"> - Copyright 2008-2017 <a href="http://www.apache.org/";>Apache Software Foundation</a>. Licensed under the <a href="http://www.apache.org/licenses/";>Apache License v2.0</a>. Apache Yetus and the Apache feather logo are trademarks of The Apache Software Foundation. - </div> - </div> - - </div> - - </footer> -</div> - - </body> -</html> http://git-wip-us.apache.org/repos/asf/yetus/blob/6ca1d766/documentation/0.1.0/precommit-patchnames/index.html ---------------------------------------------------------------------- diff --git a/documentation/0.1.0/precommit-patchnames/index.html b/documentation/0.1.0/precommit-patchnames/index.html deleted file mode 100644 index d53df5a..0000000 --- a/documentation/0.1.0/precommit-patchnames/index.html +++ /dev/null @@ -1,163 +0,0 @@ -<!--- - Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> - -<html> - <head> - <meta charset="utf-8"> - <title>Apache Yetus</title> - <meta name="viewport" content="width=device-width, initial-scale=1.0"> - <meta name="description" content=""> - <meta name="author" content=""> - - <link href="/assets/css/bootstrap.css" rel="stylesheet"> - <link href="/assets/css/bootstrap-theme.css" rel="stylesheet"> - <link href="/assets/css/font-awesome.css" rel="stylesheet"> - - <!-- JS --> - <script type="text/javascript" src="/assets/js/jquery-2.1.4.min.js"></script> - <script type="text/javascript" src="/assets/js/bootstrap.js"></script> - </head> - <body> - <div class="navbar navbar-inverse navbar-static-top" role="navigation"> - <div class="container"> - <div class="navbar-header"> - <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse"> - <span class="sr-only">Toggle navigation</span> - <span class="icon-bar"></span> - <span class="icon-bar"></span> - <span class="icon-bar"></span> - </button> - <a class="img-responsive pull-left" href="/"> - <img style="max-height: 40px; margin-top: 5px; margin-bottom: 5px;" src="/assets/img/yetus_logo.png" alt="Apache Yetus logo" /> - </a> - </div> - <div class="navbar-collapse collapse"> - <ul class="nav navbar-nav"> - <li><a href="/downloads/">Downloads</a> - <li class="dropdown"> - <a class="dropdown-toggle" data-toggle="dropdown" href="#">Documentation <span class="caret"></span></a> - <ul class="dropdown-menu" role="menu"> - <li><a href="/documentation/0.1.0/">Docs for v0.1.0</a></li> - <li><a href="/documentation/0.2.0/">Docs for v0.2.0</a></li> - <li><a href="/documentation/0.2.1/">Docs for v0.2.1</a></li> - <li><a href="/documentation/0.3.0/">Docs for v0.3.0</a></li> - <li><a href="/documentation/0.4.0/">Docs for v0.4.0</a></li> - <li><a href="/documentation/in-progress/">In Progress Docs for Contributors</a> - </li> - </ul> - </li> - <li class="dropdown"> - <a class="dropdown-toggle" data-toggle="dropdown" href="#">Get Involved <span class="caret"></span></a> - <ul class="dropdown-menu" role="menu" aria-labelledby="drop1"> - <li role="presentation"><a role="menuitem" tabindex="-1" href="/mailinglists"><i class="fa fa-commenting"></i> Mailing Lists</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="http://issues.apache.org/jira/browse/YETUS";><i class="fa fa-bug"></i> JIRA (Bugs)</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="https://git-wip-us.apache.org/repos/asf?s=yetus";><i class="fa fa-code"></i> Source (Apache)</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="https://github.com/apache/yetus";><i class="fa fa-github-alt"></i> Source (GitHub)</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="/contribute/"><i class="fa fa-code-fork"></i> Contributing</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="https://twitter.com/ApacheYetus";><i class="fa fa-twitter"></i> @ApacheYetus</a> - </li> - </ul> - </li> - <li> - <li class="dropdown"> - <a class="dropdown-toggle" data-toggle="dropdown" href="#">Apache Software Foundation <b class="caret"></b></a> - <ul class="dropdown-menu" role="menu"> - <li><a href="http://www.apache.org";>Apache Homepage</a> - </li> - <li><a href="http://www.apache.org/licenses/";>Apache License</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> - <li><a href="http://www.apache.org/security/";>Security</a> - </li> - </ul> - </li> - </li> - </ul> - </div> - <!--/.nav-collapse --> - </div> -</div> - - <div class="container"> - <!--- - Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> - -<p>We use Apache Yetus to process your patch. It supports the following patterns and -procedures for patch file names:</p> - -<p>JIRA:</p> - -<p>If JIRA support is configured, attach the patch to the given ISSUE and -click ‘Submit Patch’. The patch file should be named one of:</p> - -<ul> -<li>ISSUE.patch</li> -<li>ISSUE.###.patch</li> -<li>ISSUE.branch.###.patch</li> -<li>ISSUE-branch-###.patch</li> -<li>ISSUE.##.branch.patch</li> -<li>ISSUE-branch.##.patch</li> -</ul> - -<p>If Github support is also configured, a comment that contains a link to a Pull Request’s -patch file (e.g., <a href="https://github.com/user/repo/pull/1.patch";>https://github.com/user/repo/pull/1.patch</a>) will pull the patch from -the given Github PR.</p> - - </div> - <div class="container"> - <hr> - <footer class="footer"> - <div class="row-fluid"> - <div class="span12 text-left"> - <div class="span12"> - Copyright 2008-2017 <a href="http://www.apache.org/";>Apache Software Foundation</a>. Licensed under the <a href="http://www.apache.org/licenses/";>Apache License v2.0</a>. Apache Yetus and the Apache feather logo are trademarks of The Apache Software Foundation. - </div> - </div> - - </div> - - </footer> -</div> - - </body> -</html> http://git-wip-us.apache.org/repos/asf/yetus/blob/6ca1d766/documentation/0.1.0/precommit-smart-apply-patch/index.html ---------------------------------------------------------------------- diff --git a/documentation/0.1.0/precommit-smart-apply-patch/index.html b/documentation/0.1.0/precommit-smart-apply-patch/index.html deleted file mode 100644 index 35756be..0000000 --- a/documentation/0.1.0/precommit-smart-apply-patch/index.html +++ /dev/null @@ -1,167 +0,0 @@ -<!--- - Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> - -<html> - <head> - <meta charset="utf-8"> - <title>Apache Yetus</title> - <meta name="viewport" content="width=device-width, initial-scale=1.0"> - <meta name="description" content=""> - <meta name="author" content=""> - - <link href="/assets/css/bootstrap.css" rel="stylesheet"> - <link href="/assets/css/bootstrap-theme.css" rel="stylesheet"> - <link href="/assets/css/font-awesome.css" rel="stylesheet"> - - <!-- JS --> - <script type="text/javascript" src="/assets/js/jquery-2.1.4.min.js"></script> - <script type="text/javascript" src="/assets/js/bootstrap.js"></script> - </head> - <body> - <div class="navbar navbar-inverse navbar-static-top" role="navigation"> - <div class="container"> - <div class="navbar-header"> - <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse"> - <span class="sr-only">Toggle navigation</span> - <span class="icon-bar"></span> - <span class="icon-bar"></span> - <span class="icon-bar"></span> - </button> - <a class="img-responsive pull-left" href="/"> - <img style="max-height: 40px; margin-top: 5px; margin-bottom: 5px;" src="/assets/img/yetus_logo.png" alt="Apache Yetus logo" /> - </a> - </div> - <div class="navbar-collapse collapse"> - <ul class="nav navbar-nav"> - <li><a href="/downloads/">Downloads</a> - <li class="dropdown"> - <a class="dropdown-toggle" data-toggle="dropdown" href="#">Documentation <span class="caret"></span></a> - <ul class="dropdown-menu" role="menu"> - <li><a href="/documentation/0.1.0/">Docs for v0.1.0</a></li> - <li><a href="/documentation/0.2.0/">Docs for v0.2.0</a></li> - <li><a href="/documentation/0.2.1/">Docs for v0.2.1</a></li> - <li><a href="/documentation/0.3.0/">Docs for v0.3.0</a></li> - <li><a href="/documentation/0.4.0/">Docs for v0.4.0</a></li> - <li><a href="/documentation/in-progress/">In Progress Docs for Contributors</a> - </li> - </ul> - </li> - <li class="dropdown"> - <a class="dropdown-toggle" data-toggle="dropdown" href="#">Get Involved <span class="caret"></span></a> - <ul class="dropdown-menu" role="menu" aria-labelledby="drop1"> - <li role="presentation"><a role="menuitem" tabindex="-1" href="/mailinglists"><i class="fa fa-commenting"></i> Mailing Lists</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="http://issues.apache.org/jira/browse/YETUS";><i class="fa fa-bug"></i> JIRA (Bugs)</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="https://git-wip-us.apache.org/repos/asf?s=yetus";><i class="fa fa-code"></i> Source (Apache)</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="https://github.com/apache/yetus";><i class="fa fa-github-alt"></i> Source (GitHub)</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="/contribute/"><i class="fa fa-code-fork"></i> Contributing</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="https://twitter.com/ApacheYetus";><i class="fa fa-twitter"></i> @ApacheYetus</a> - </li> - </ul> - </li> - <li> - <li class="dropdown"> - <a class="dropdown-toggle" data-toggle="dropdown" href="#">Apache Software Foundation <b class="caret"></b></a> - <ul class="dropdown-menu" role="menu"> - <li><a href="http://www.apache.org";>Apache Homepage</a> - </li> - <li><a href="http://www.apache.org/licenses/";>Apache License</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> - <li><a href="http://www.apache.org/security/";>Security</a> - </li> - </ul> - </li> - </li> - </ul> - </div> - <!--/.nav-collapse --> - </div> -</div> - - <div class="container"> - <!--- - Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> - -<h1 id="smart-apply-patch">smart-apply-patch</h1> - -<p><code>smart-apply-patch</code> is a command to help apply patches easily. It uses the same plug-ins and many of the same options as test-patch. This means that it can, for example, fetch patches from JIRA and apply them to a local source tree.</p> - -<h1 id="usage">Usage</h1> - -<p>Its simpliest form is used when a patch is stored in a local file:</p> -<pre class="highlight shell"><code><span class="gp">$ </span>smart-apply-patch patch -</code></pre> -<p>This will cause the command to run through various ways to verify and then apply the patch to the current repo, including deducing a patch level.</p> - -<p>Perhaps you just want to see if the patch even applies without changing your local repo. The <code>--dry-run</code> option will just test for applicability:</p> -<pre class="highlight shell"><code><span class="gp">$ </span>smart-apply-patch --dry-run patch -</code></pre> -<p>For committers of projects, there is a special mode:</p> -<pre class="highlight shell"><code><span class="gp">$ </span>smart-apply-patch --committer patch -</code></pre> -<p>that in addition to applying the patch will also attempt to:</p> - -<ul> -<li>use <code>--whitespace=fix</code> mode</li> -<li>add all newly created files in the repo</li> -<li>use <code>--signoff</code> and commit the change via git-am</li> -</ul> - - </div> - <div class="container"> - <hr> - <footer class="footer"> - <div class="row-fluid"> - <div class="span12 text-left"> - <div class="span12"> - Copyright 2008-2017 <a href="http://www.apache.org/";>Apache Software Foundation</a>. Licensed under the <a href="http://www.apache.org/licenses/";>Apache License v2.0</a>. Apache Yetus and the Apache feather logo are trademarks of The Apache Software Foundation. - </div> - </div> - - </div> - - </footer> -</div> - - </body> -</html> http://git-wip-us.apache.org/repos/asf/yetus/blob/6ca1d766/documentation/0.1.0/precommit-testformats/index.html ---------------------------------------------------------------------- diff --git a/documentation/0.1.0/precommit-testformats/index.html b/documentation/0.1.0/precommit-testformats/index.html deleted file mode 100644 index 667b1c0..0000000 --- a/documentation/0.1.0/precommit-testformats/index.html +++ /dev/null @@ -1,160 +0,0 @@ -<!--- - Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> - -<html> - <head> - <meta charset="utf-8"> - <title>Apache Yetus</title> - <meta name="viewport" content="width=device-width, initial-scale=1.0"> - <meta name="description" content=""> - <meta name="author" content=""> - - <link href="/assets/css/bootstrap.css" rel="stylesheet"> - <link href="/assets/css/bootstrap-theme.css" rel="stylesheet"> - <link href="/assets/css/font-awesome.css" rel="stylesheet"> - - <!-- JS --> - <script type="text/javascript" src="/assets/js/jquery-2.1.4.min.js"></script> - <script type="text/javascript" src="/assets/js/bootstrap.js"></script> - </head> - <body> - <div class="navbar navbar-inverse navbar-static-top" role="navigation"> - <div class="container"> - <div class="navbar-header"> - <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse"> - <span class="sr-only">Toggle navigation</span> - <span class="icon-bar"></span> - <span class="icon-bar"></span> - <span class="icon-bar"></span> - </button> - <a class="img-responsive pull-left" href="/"> - <img style="max-height: 40px; margin-top: 5px; margin-bottom: 5px;" src="/assets/img/yetus_logo.png" alt="Apache Yetus logo" /> - </a> - </div> - <div class="navbar-collapse collapse"> - <ul class="nav navbar-nav"> - <li><a href="/downloads/">Downloads</a> - <li class="dropdown"> - <a class="dropdown-toggle" data-toggle="dropdown" href="#">Documentation <span class="caret"></span></a> - <ul class="dropdown-menu" role="menu"> - <li><a href="/documentation/0.1.0/">Docs for v0.1.0</a></li> - <li><a href="/documentation/0.2.0/">Docs for v0.2.0</a></li> - <li><a href="/documentation/0.2.1/">Docs for v0.2.1</a></li> - <li><a href="/documentation/0.3.0/">Docs for v0.3.0</a></li> - <li><a href="/documentation/0.4.0/">Docs for v0.4.0</a></li> - <li><a href="/documentation/in-progress/">In Progress Docs for Contributors</a> - </li> - </ul> - </li> - <li class="dropdown"> - <a class="dropdown-toggle" data-toggle="dropdown" href="#">Get Involved <span class="caret"></span></a> - <ul class="dropdown-menu" role="menu" aria-labelledby="drop1"> - <li role="presentation"><a role="menuitem" tabindex="-1" href="/mailinglists"><i class="fa fa-commenting"></i> Mailing Lists</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="http://issues.apache.org/jira/browse/YETUS";><i class="fa fa-bug"></i> JIRA (Bugs)</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="https://git-wip-us.apache.org/repos/asf?s=yetus";><i class="fa fa-code"></i> Source (Apache)</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="https://github.com/apache/yetus";><i class="fa fa-github-alt"></i> Source (GitHub)</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="/contribute/"><i class="fa fa-code-fork"></i> Contributing</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="https://twitter.com/ApacheYetus";><i class="fa fa-twitter"></i> @ApacheYetus</a> - </li> - </ul> - </li> - <li> - <li class="dropdown"> - <a class="dropdown-toggle" data-toggle="dropdown" href="#">Apache Software Foundation <b class="caret"></b></a> - <ul class="dropdown-menu" role="menu"> - <li><a href="http://www.apache.org";>Apache Homepage</a> - </li> - <li><a href="http://www.apache.org/licenses/";>Apache License</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> - <li><a href="http://www.apache.org/security/";>Security</a> - </li> - </ul> - </li> - </li> - </ul> - </div> - <!--/.nav-collapse --> - </div> -</div> - - <div class="container"> - <!--- - Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> - -<h1 id="test-format-support">Test Format Support</h1> - -<p>test-patch has the ability to support multiple test formats. Test formats have some extra hooks to process the output of test tools and write the results to some tables. Every test format plug-in must have one line in order to be recognized:</p> -<pre class="highlight shell"><code>add_test_format <pluginname> -</code></pre> -<ul> -<li><p>pluginname_process_tests</p> - -<ul> -<li>Given a path to the log file and tested module name, parse that file and store the test result into global variables and/or files.</li> -</ul></li> -<li><p>pluginname_finalize_results</p> - -<ul> -<li>Using the results stored by pluginname_process_tests, write them to the test result table and/or the footer table for reporting.</li> -</ul></li> -</ul> - - </div> - <div class="container"> - <hr> - <footer class="footer"> - <div class="row-fluid"> - <div class="span12 text-left"> - <div class="span12"> - Copyright 2008-2017 <a href="http://www.apache.org/";>Apache Software Foundation</a>. Licensed under the <a href="http://www.apache.org/licenses/";>Apache License v2.0</a>. Apache Yetus and the Apache feather logo are trademarks of The Apache Software Foundation. - </div> - </div> - - </div> - - </footer> -</div> - - </body> -</html> http://git-wip-us.apache.org/repos/asf/yetus/blob/6ca1d766/documentation/0.1.0/releasedocmaker/index.html ---------------------------------------------------------------------- diff --git a/documentation/0.1.0/releasedocmaker/index.html b/documentation/0.1.0/releasedocmaker/index.html deleted file mode 100644 index 5477ad9..0000000 --- a/documentation/0.1.0/releasedocmaker/index.html +++ /dev/null @@ -1,242 +0,0 @@ -<!--- - Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> - -<html> - <head> - <meta charset="utf-8"> - <title>Apache Yetus</title> - <meta name="viewport" content="width=device-width, initial-scale=1.0"> - <meta name="description" content=""> - <meta name="author" content=""> - - <link href="/assets/css/bootstrap.css" rel="stylesheet"> - <link href="/assets/css/bootstrap-theme.css" rel="stylesheet"> - <link href="/assets/css/font-awesome.css" rel="stylesheet"> - - <!-- JS --> - <script type="text/javascript" src="/assets/js/jquery-2.1.4.min.js"></script> - <script type="text/javascript" src="/assets/js/bootstrap.js"></script> - </head> - <body> - <div class="navbar navbar-inverse navbar-static-top" role="navigation"> - <div class="container"> - <div class="navbar-header"> - <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse"> - <span class="sr-only">Toggle navigation</span> - <span class="icon-bar"></span> - <span class="icon-bar"></span> - <span class="icon-bar"></span> - </button> - <a class="img-responsive pull-left" href="/"> - <img style="max-height: 40px; margin-top: 5px; margin-bottom: 5px;" src="/assets/img/yetus_logo.png" alt="Apache Yetus logo" /> - </a> - </div> - <div class="navbar-collapse collapse"> - <ul class="nav navbar-nav"> - <li><a href="/downloads/">Downloads</a> - <li class="dropdown"> - <a class="dropdown-toggle" data-toggle="dropdown" href="#">Documentation <span class="caret"></span></a> - <ul class="dropdown-menu" role="menu"> - <li><a href="/documentation/0.1.0/">Docs for v0.1.0</a></li> - <li><a href="/documentation/0.2.0/">Docs for v0.2.0</a></li> - <li><a href="/documentation/0.2.1/">Docs for v0.2.1</a></li> - <li><a href="/documentation/0.3.0/">Docs for v0.3.0</a></li> - <li><a href="/documentation/0.4.0/">Docs for v0.4.0</a></li> - <li><a href="/documentation/in-progress/">In Progress Docs for Contributors</a> - </li> - </ul> - </li> - <li class="dropdown"> - <a class="dropdown-toggle" data-toggle="dropdown" href="#">Get Involved <span class="caret"></span></a> - <ul class="dropdown-menu" role="menu" aria-labelledby="drop1"> - <li role="presentation"><a role="menuitem" tabindex="-1" href="/mailinglists"><i class="fa fa-commenting"></i> Mailing Lists</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="http://issues.apache.org/jira/browse/YETUS";><i class="fa fa-bug"></i> JIRA (Bugs)</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="https://git-wip-us.apache.org/repos/asf?s=yetus";><i class="fa fa-code"></i> Source (Apache)</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="https://github.com/apache/yetus";><i class="fa fa-github-alt"></i> Source (GitHub)</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="/contribute/"><i class="fa fa-code-fork"></i> Contributing</a> - </li> - <li role="presentation"><a role="menuitem" tabindex="-1" href="https://twitter.com/ApacheYetus";><i class="fa fa-twitter"></i> @ApacheYetus</a> - </li> - </ul> - </li> - <li> - <li class="dropdown"> - <a class="dropdown-toggle" data-toggle="dropdown" href="#">Apache Software Foundation <b class="caret"></b></a> - <ul class="dropdown-menu" role="menu"> - <li><a href="http://www.apache.org";>Apache Homepage</a> - </li> - <li><a href="http://www.apache.org/licenses/";>Apache License</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> - <li><a href="http://www.apache.org/security/";>Security</a> - </li> - </ul> - </li> - </li> - </ul> - </div> - <!--/.nav-collapse --> - </div> -</div> - - <div class="container"> - <!--- - Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> - -<h1 id="releasedocmaker">releasedocmaker</h1> - -<ul> -<li><a href="#Purpose">Purpose</a></li> -<li><a href="#Basic_Usage">Basic Usage</a></li> -<li><a href="#Changing_the_Header">Changing the Header</a></li> -<li><a href="#Multiple_Versions">Multiple Versions</a></li> -<li><a href="#Unreleased_Dates">Unreleased Dates</a></li> -<li><a href="#Lint_Mode">Lint Mode</a></li> -<li><a href="#Index_Mode">Index Mode</a></li> -</ul> - -<h1 id="purpose">Purpose</h1> - -<p>Building changelog information in a form that is human digestible but still containing as much useful information is difficult. Many attempts over the years have resulted in a variety of methods that projects use to solve this problem:</p> - -<ul> -<li>JIRA-generated release notes from the <q>Release Notes</q> button</li> -<li>Manually modified CHANGES file</li> -<li>Processing git log information</li> -</ul> - -<p>All of these methods have their pros and cons. Some have issues with accuracy. Some have issues with lack of details. None of these methods seem to cover all of the needs of many projects and are full of potential pitfalls.</p> - -<p>In order to solve these problems, releasedocmaker was written to automatically generate a changelog and release notes by querying Apache’s JIRA instance.</p> - -<h1 id="basic-usage">Basic Usage</h1> - -<p>Minimally, the name of the JIRA project and a version registered in JIRA must be provided:</p> -<pre class="highlight shell"><code><span class="gp">$ </span>releasedocmaker.py --project <span class="o">(</span>project<span class="o">)</span> --version <span class="o">(</span>version<span class="o">)</span> -</code></pre> -<p>This will query Apache JIRA, generating two files in a directory named after the given version in an extended markdown format which can be processed by both mvn site and GitHub.</p> - -<ul> -<li>CHANGES.(version).md</li> -</ul> - -<p>This is similar to the JIRA <q>Release Notes</q> button but is in tabular format and includes the priority, component, reporter, and contributor fields. It also highlights Incompatible Changes so that readers know what to look out for when upgrading. The top of the file also includes the date that the version was marked as released in JIRA.</p> - -<ul> -<li>RELEASENOTES.(version).md</li> -</ul> - -<p>If your JIRA project supports the release note field, this will contain any JIRA mentioned in the CHANGES log that is either an incompatible change or has a release note associated with it. If your JIRA project does not support the release notes field, this will be the description field.</p> - -<p>For example, to build the release documentation for HBase v1.2.0…</p> -<pre class="highlight shell"><code><span class="gp">$ </span>releasedocmaker.py --project HBASE --version 1.2.0 -</code></pre> -<p>… will create a 1.2.0 directory and inside that directory will be CHANGES.1.2.0.md and RELEASENOTES.1.2.0.md .</p> - -<p>By default, release notes are expected to be in plain text. However, you can write them in markdown if you include a header at the top of your release note:</p> -<pre class="highlight xml"><code><span class="c"><!-- markdown --></span> -remaining text -</code></pre> -<h1 id="changing-the-header">Changing the Header</h1> - -<p>By default, it will use a header that matches the project name. But that is kind of ugly and the case may be wrong. Luckily, the title can be changed:</p> -<pre class="highlight shell"><code><span class="gp">$ </span>releasedocmaker.py --project HBASE --version 1.2.0 --projecttitle <span class="s2">"Apache HBase"</span> -</code></pre> -<p>Now instead of <q>HBASE</q>, it will use <q>Apache HBASE</q> for some titles and headers.</p> - -<h1 id="multiple-versions">Multiple Versions</h1> - -<p>The script can also generate multiple versions at once, by</p> -<pre class="highlight shell"><code><span class="gp">$ </span>releasedocmaker.py --project HBASE --version 1.0.0 --version 1.2.0 -</code></pre> -<p>This will create the files for versions 1.0.0 and versions 1.2.0 in their own directories.</p> - -<p>But what if the version numbers are not known? releasedocmaker can also generate version data based upon ranges:</p> -<pre class="highlight shell"><code><span class="gp">$ </span>releasedocmaker.py --project HBASE --version 1.0.0 --version 1.2.0 --range -</code></pre> -<p>In this form, releasedocmaker will query JIRA, discover all versions that alphabetically appear to be between 1.0.0 and 1.2.0, inclusive, and generate all of the relative release documents. This is especially useful when bootstrapping an existing project.</p> - -<h1 id="unreleased-dates">Unreleased Dates</h1> - -<p>For released versions, releasedocmaker will pull the date of the release from JIRA. However, for unreleased versions it marks the release as <q>Unreleased</q>. This can be inconvenient when actually building a release and wanting to include it inside the source package.</p> - -<p>The –usetoday option can be used to signify that instead of using Unreleased, releasedocmaker should use today’s date.</p> -<pre class="highlight shell"><code><span class="gp">$ </span>releasedocmaker.py --project HBASE --version 1.0.0 --usetoday -</code></pre> -<p>After using this option and release, don’t forget to change JIRA’s release date to match!</p> - -<h1 id="lint-mode">Lint Mode</h1> - -<p>In order to ensure proper formatting while using mvn site, releasedocmaker puts in periods (.) for fields that are empty or unassigned. This can be unsightly and not proper for any given project. There are also other things, such as missing release notes for incompatible changes, that are less than desirable.</p> - -<p>In order to help release managers from having to scan through potentially large documents, releasedocmaker features a lint mode, triggered via –lint:</p> -<pre class="highlight shell"><code><span class="gp">$ </span>releasedocmaker.py --project HBASE --version 1.0.0 --lint -</code></pre> -<p>This will do the normal JIRA querying, looking for items it considers problematic. It will print the information to the screen and then exit with either success or failure, depending upon if any issues were discovered.</p> - -<h1 id="index-mode">Index Mode</h1> - -<p>There is basic support for an autoindexer. It will create two files that contain links to all directories that have a major.minor.micro-style version numbering system, where all fields are numeric.</p> - -<ul> -<li>index.md: a file suitable for conversion to HTML via mvn site</li> -<li>README.md: a file suitable for display on Github and other Markdown rendering websites</li> -</ul> - - </div> - <div class="container"> - <hr> - <footer class="footer"> - <div class="row-fluid"> - <div class="span12 text-left"> - <div class="span12"> - Copyright 2008-2017 <a href="http://www.apache.org/";>Apache Software Foundation</a>. Licensed under the <a href="http://www.apache.org/licenses/";>Apache License v2.0</a>. Apache Yetus and the Apache feather logo are trademarks of The Apache Software Foundation. - </div> - </div> - - </div> - - </footer> -</div> - - </body> -</html>
