Repository: yetus
Updated Branches:
  refs/heads/asf-site f25b5e829 -> b2e6ae5a9


http://git-wip-us.apache.org/repos/asf/yetus/blob/b2e6ae5a/documentation/in-progress/audience-annotations-apidocs/overview-tree.html
----------------------------------------------------------------------
diff --git 
a/documentation/in-progress/audience-annotations-apidocs/overview-tree.html 
b/documentation/in-progress/audience-annotations-apidocs/overview-tree.html
index e6f4185..101c378 100644
--- a/documentation/in-progress/audience-annotations-apidocs/overview-tree.html
+++ b/documentation/in-progress/audience-annotations-apidocs/overview-tree.html
@@ -2,16 +2,21 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (version 1.7.0_45) on Tue Apr 19 16:33:41 PDT 2016 
-->
-<meta http-equiv="Content-Type" content="text/html" charset="UTF-8">
-<title>Class Hierarchy (Apache Yetus - Audience Annotations Component 
0.3.0-SNAPSHOT API)</title>
-<meta name="date" content="2016-04-19">
+<!-- Generated by javadoc (1.8.0_92) on Wed Sep 07 06:04:38 PDT 2016 -->
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>Class Hierarchy (Apache Yetus - Audience Annotations Component 
0.4.0-SNAPSHOT API)</title>
+<meta name="date" content="2016-09-07">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
+<script type="text/javascript" src="script.js"></script>
 </head>
 <body>
 <script type="text/javascript"><!--
-    if (location.href.indexOf('is-external=true') == -1) {
-        parent.document.title="Class Hierarchy (Apache Yetus - Audience 
Annotations Component 0.3.0-SNAPSHOT API)";
+    try {
+        if (location.href.indexOf('is-external=true') == -1) {
+            parent.document.title="Class Hierarchy (Apache Yetus - Audience 
Annotations Component 0.4.0-SNAPSHOT API)";
+        }
+    }
+    catch(err) {
     }
 //-->
 </script>
@@ -19,9 +24,11 @@
 <div>JavaScript is disabled on your browser.</div>
 </noscript>
 <!-- ========= START OF TOP NAVBAR ======= -->
-<div class="topNav"><a name="navbar_top">
+<div class="topNav"><a name="navbar.top">
 <!--   -->
-</a><a href="#skip-navbar_top" title="Skip navigation links"></a><a 
name="navbar_top_firstrow">
+</a>
+<div class="skipNav"><a href="#skip.navbar.top" title="Skip navigation 
links">Skip navigation links</a></div>
+<a name="navbar.top.firstrow">
 <!--   -->
 </a>
 <ul class="navList" title="Navigation">
@@ -42,10 +49,10 @@
 </ul>
 <ul class="navList">
 <li><a href="index.html?overview-tree.html" target="_top">Frames</a></li>
-<li><a href="overview-tree.html" target="_top">No Frames</a></li>
+<li><a href="overview-tree.html" target="_top">No&nbsp;Frames</a></li>
 </ul>
 <ul class="navList" id="allclasses_navbar_top">
-<li><a href="allclasses-noframe.html">All Classes</a></li>
+<li><a href="allclasses-noframe.html">All&nbsp;Classes</a></li>
 </ul>
 <div>
 <script type="text/javascript"><!--
@@ -59,13 +66,13 @@
   //-->
 </script>
 </div>
-<a name="skip-navbar_top">
+<a name="skip.navbar.top">
 <!--   -->
 </a></div>
 <!-- ========= END OF TOP NAVBAR ========= -->
 <div class="header">
 <h1 class="title">Hierarchy For All Packages</h1>
-<span class="strong">Package Hierarchies:</span>
+<span class="packageHierarchyLabel">Package Hierarchies:</span>
 <ul class="horizontal">
 <li><a 
href="org/apache/yetus/audience/package-tree.html">org.apache.yetus.audience</a>,
 </li>
 <li><a 
href="org/apache/yetus/audience/tools/package-tree.html">org.apache.yetus.audience.tools</a></li>
@@ -74,30 +81,32 @@
 <div class="contentContainer">
 <h2 title="Class Hierarchy">Class Hierarchy</h2>
 <ul>
-<li type="circle">java.lang.<a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true";
 title="class or interface in java.lang"><span class="strong">Object</span></a>
+<li type="circle">java.lang.<a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true";
 title="class or interface in java.lang"><span 
class="typeNameLink">Object</span></a>
 <ul>
-<li type="circle">org.apache.yetus.audience.tools.<a 
href="org/apache/yetus/audience/tools/ExcludePrivateAnnotationsJDiffDoclet.html"
 title="class in org.apache.yetus.audience.tools"><span 
class="strong">ExcludePrivateAnnotationsJDiffDoclet</span></a></li>
-<li type="circle">org.apache.yetus.audience.tools.<a 
href="org/apache/yetus/audience/tools/ExcludePrivateAnnotationsStandardDoclet.html"
 title="class in org.apache.yetus.audience.tools"><span 
class="strong">ExcludePrivateAnnotationsStandardDoclet</span></a></li>
-<li type="circle">org.apache.yetus.audience.tools.<a 
href="org/apache/yetus/audience/tools/IncludePublicAnnotationsStandardDoclet.html"
 title="class in org.apache.yetus.audience.tools"><span 
class="strong">IncludePublicAnnotationsStandardDoclet</span></a></li>
-<li type="circle">org.apache.yetus.audience.<a 
href="org/apache/yetus/audience/InterfaceAudience.html" title="class in 
org.apache.yetus.audience"><span 
class="strong">InterfaceAudience</span></a></li>
-<li type="circle">org.apache.yetus.audience.<a 
href="org/apache/yetus/audience/InterfaceStability.html" title="class in 
org.apache.yetus.audience"><span 
class="strong">InterfaceStability</span></a></li>
+<li type="circle">org.apache.yetus.audience.tools.<a 
href="org/apache/yetus/audience/tools/ExcludePrivateAnnotationsJDiffDoclet.html"
 title="class in org.apache.yetus.audience.tools"><span 
class="typeNameLink">ExcludePrivateAnnotationsJDiffDoclet</span></a></li>
+<li type="circle">org.apache.yetus.audience.tools.<a 
href="org/apache/yetus/audience/tools/ExcludePrivateAnnotationsStandardDoclet.html"
 title="class in org.apache.yetus.audience.tools"><span 
class="typeNameLink">ExcludePrivateAnnotationsStandardDoclet</span></a></li>
+<li type="circle">org.apache.yetus.audience.tools.<a 
href="org/apache/yetus/audience/tools/IncludePublicAnnotationsStandardDoclet.html"
 title="class in org.apache.yetus.audience.tools"><span 
class="typeNameLink">IncludePublicAnnotationsStandardDoclet</span></a></li>
+<li type="circle">org.apache.yetus.audience.<a 
href="org/apache/yetus/audience/InterfaceAudience.html" title="class in 
org.apache.yetus.audience"><span 
class="typeNameLink">InterfaceAudience</span></a></li>
+<li type="circle">org.apache.yetus.audience.<a 
href="org/apache/yetus/audience/InterfaceStability.html" title="class in 
org.apache.yetus.audience"><span 
class="typeNameLink">InterfaceStability</span></a></li>
 </ul>
 </li>
 </ul>
 <h2 title="Annotation Type Hierarchy">Annotation Type Hierarchy</h2>
 <ul>
-<li type="circle">org.apache.yetus.audience.<a 
href="org/apache/yetus/audience/InterfaceStability.Stable.html" 
title="annotation in org.apache.yetus.audience"><span 
class="strong">InterfaceStability.Stable</span></a> (implements 
java.lang.annotation.<a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/annotation/Annotation.html?is-external=true";
 title="class or interface in java.lang.annotation">Annotation</a>)</li>
-<li type="circle">org.apache.yetus.audience.<a 
href="org/apache/yetus/audience/InterfaceStability.Evolving.html" 
title="annotation in org.apache.yetus.audience"><span 
class="strong">InterfaceStability.Evolving</span></a> (implements 
java.lang.annotation.<a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/annotation/Annotation.html?is-external=true";
 title="class or interface in java.lang.annotation">Annotation</a>)</li>
-<li type="circle">org.apache.yetus.audience.<a 
href="org/apache/yetus/audience/InterfaceStability.Unstable.html" 
title="annotation in org.apache.yetus.audience"><span 
class="strong">InterfaceStability.Unstable</span></a> (implements 
java.lang.annotation.<a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/annotation/Annotation.html?is-external=true";
 title="class or interface in java.lang.annotation">Annotation</a>)</li>
-<li type="circle">org.apache.yetus.audience.<a 
href="org/apache/yetus/audience/InterfaceAudience.Public.html" 
title="annotation in org.apache.yetus.audience"><span 
class="strong">InterfaceAudience.Public</span></a> (implements 
java.lang.annotation.<a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/annotation/Annotation.html?is-external=true";
 title="class or interface in java.lang.annotation">Annotation</a>)</li>
-<li type="circle">org.apache.yetus.audience.<a 
href="org/apache/yetus/audience/InterfaceAudience.LimitedPrivate.html" 
title="annotation in org.apache.yetus.audience"><span 
class="strong">InterfaceAudience.LimitedPrivate</span></a> (implements 
java.lang.annotation.<a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/annotation/Annotation.html?is-external=true";
 title="class or interface in java.lang.annotation">Annotation</a>)</li>
-<li type="circle">org.apache.yetus.audience.<a 
href="org/apache/yetus/audience/InterfaceAudience.Private.html" 
title="annotation in org.apache.yetus.audience"><span 
class="strong">InterfaceAudience.Private</span></a> (implements 
java.lang.annotation.<a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/annotation/Annotation.html?is-external=true";
 title="class or interface in java.lang.annotation">Annotation</a>)</li>
+<li type="circle">org.apache.yetus.audience.<a 
href="org/apache/yetus/audience/InterfaceStability.Stable.html" 
title="annotation in org.apache.yetus.audience"><span 
class="typeNameLink">InterfaceStability.Stable</span></a> (implements 
java.lang.annotation.<a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/annotation/Annotation.html?is-external=true";
 title="class or interface in java.lang.annotation">Annotation</a>)</li>
+<li type="circle">org.apache.yetus.audience.<a 
href="org/apache/yetus/audience/InterfaceStability.Evolving.html" 
title="annotation in org.apache.yetus.audience"><span 
class="typeNameLink">InterfaceStability.Evolving</span></a> (implements 
java.lang.annotation.<a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/annotation/Annotation.html?is-external=true";
 title="class or interface in java.lang.annotation">Annotation</a>)</li>
+<li type="circle">org.apache.yetus.audience.<a 
href="org/apache/yetus/audience/InterfaceStability.Unstable.html" 
title="annotation in org.apache.yetus.audience"><span 
class="typeNameLink">InterfaceStability.Unstable</span></a> (implements 
java.lang.annotation.<a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/annotation/Annotation.html?is-external=true";
 title="class or interface in java.lang.annotation">Annotation</a>)</li>
+<li type="circle">org.apache.yetus.audience.<a 
href="org/apache/yetus/audience/InterfaceAudience.Public.html" 
title="annotation in org.apache.yetus.audience"><span 
class="typeNameLink">InterfaceAudience.Public</span></a> (implements 
java.lang.annotation.<a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/annotation/Annotation.html?is-external=true";
 title="class or interface in java.lang.annotation">Annotation</a>)</li>
+<li type="circle">org.apache.yetus.audience.<a 
href="org/apache/yetus/audience/InterfaceAudience.LimitedPrivate.html" 
title="annotation in org.apache.yetus.audience"><span 
class="typeNameLink">InterfaceAudience.LimitedPrivate</span></a> (implements 
java.lang.annotation.<a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/annotation/Annotation.html?is-external=true";
 title="class or interface in java.lang.annotation">Annotation</a>)</li>
+<li type="circle">org.apache.yetus.audience.<a 
href="org/apache/yetus/audience/InterfaceAudience.Private.html" 
title="annotation in org.apache.yetus.audience"><span 
class="typeNameLink">InterfaceAudience.Private</span></a> (implements 
java.lang.annotation.<a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/annotation/Annotation.html?is-external=true";
 title="class or interface in java.lang.annotation">Annotation</a>)</li>
 </ul>
 </div>
 <!-- ======= START OF BOTTOM NAVBAR ====== -->
-<div class="bottomNav"><a name="navbar_bottom">
+<div class="bottomNav"><a name="navbar.bottom">
 <!--   -->
-</a><a href="#skip-navbar_bottom" title="Skip navigation links"></a><a 
name="navbar_bottom_firstrow">
+</a>
+<div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation 
links">Skip navigation links</a></div>
+<a name="navbar.bottom.firstrow">
 <!--   -->
 </a>
 <ul class="navList" title="Navigation">
@@ -118,10 +127,10 @@
 </ul>
 <ul class="navList">
 <li><a href="index.html?overview-tree.html" target="_top">Frames</a></li>
-<li><a href="overview-tree.html" target="_top">No Frames</a></li>
+<li><a href="overview-tree.html" target="_top">No&nbsp;Frames</a></li>
 </ul>
 <ul class="navList" id="allclasses_navbar_bottom">
-<li><a href="allclasses-noframe.html">All Classes</a></li>
+<li><a href="allclasses-noframe.html">All&nbsp;Classes</a></li>
 </ul>
 <div>
 <script type="text/javascript"><!--
@@ -135,7 +144,7 @@
   //-->
 </script>
 </div>
-<a name="skip-navbar_bottom">
+<a name="skip.navbar.bottom">
 <!--   -->
 </a></div>
 <!-- ======== END OF BOTTOM NAVBAR ======= -->

http://git-wip-us.apache.org/repos/asf/yetus/blob/b2e6ae5a/documentation/in-progress/index.html
----------------------------------------------------------------------
diff --git a/documentation/in-progress/index.html 
b/documentation/in-progress/index.html
index a79aec3..9a52d6f 100644
--- a/documentation/in-progress/index.html
+++ b/documentation/in-progress/index.html
@@ -157,11 +157,12 @@ Options:
   --skipprnorep         Skip Private &amp; Not Replaceable
 </code></pre>
 
-<h1 id="yetus-audience-annotations">Yetus Audience Annotations</h1>
+<p>You can mark a file to be ignored by shelldocs by adding 
<q>SHELLDOC-IGNORE</q> as a comment in its own line.</p>
 
-<p>Audience Annotations allows you to use Java Annotations to denote which 
parts of your Java library is publicly consumable and which parts are reserved 
for a more restricted use. It also provides doclets and examples for generating 
javadocs limited by audience.</p>
+<h1 id="yetus-audience-annotations">Yetus Audience Annotations</h1>
 
-<p>See <a href="audience-annotations-apidocs/">the javadocs</a> for 
details.</p>
+<p>Audience Annotations allows you to use Java Annotations to denote which 
parts of your Java library is publicly consumable and which parts are reserved 
for a more restricted use. It also provides doclets and examples for generating 
javadocs limited by audience.
+You can refer the user documentation <a 
href="interface-classification">here</a> and the javadocs <a 
href="audience-annotations-apidocs/">here</a>.</p>
 
     </div>
       <div class="container">

http://git-wip-us.apache.org/repos/asf/yetus/blob/b2e6ae5a/documentation/in-progress/interface-classification/index.html
----------------------------------------------------------------------
diff --git a/documentation/in-progress/interface-classification/index.html 
b/documentation/in-progress/interface-classification/index.html
new file mode 100644
index 0000000..477f010
--- /dev/null
+++ b/documentation/in-progress/interface-classification/index.html
@@ -0,0 +1,345 @@
+<!---
+  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/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 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. See accompanying LICENSE file.
+-->
+
+<h1 
id="apache-yetus-interface-taxonomy-audience-and-stability-classification">Apache
 Yetus Interface Taxonomy: Audience and Stability Classification</h1>
+
+<h2 id="motivation">Motivation</h2>
+
+<p>The interface taxonomy classification provided by Apache Yetus annotations 
is for guidance to
+developers and users of interfaces. The classification guides a developer to
+declare the targeted audience or users of an interface and also its 
stability.</p>
+
+<ul>
+<li><p>Benefits to the user of an interface: Knows which interfaces to use or 
not use and their stability.</p></li>
+<li><p>Benefits to the developer: to prevent accidental changes of interfaces 
and
+hence accidental impact on users or other components or system. This is
+particularly useful in large systems with many developers who may not all have
+a shared state/history of the project.</p></li>
+</ul>
+
+<h2 id="interface-classification">Interface Classification</h2>
+
+<p>Yetus provides the following interface classification, derived from the
+<a 
href="http://web.archive.org/web/20061013114610/http://opensolaris.org/os/community/arc/policies/interface-taxonomy/";>OpenSolaris
 taxonomy</a>
+and, to some extent, from taxonomy used inside Yahoo.
+Interfaces have two main attributes: Audience and Stability</p>
+
+<h3 id="audience">Audience</h3>
+
+<p>Audience denotes the potential consumers of the interface. While many 
interfaces
+are internal/private to the implementation, others are public/external 
interfaces
+and are meant for wider consumption by applications and/or clients. For 
example,
+POSIX definitions in libc are external, while large parts of the kernel are 
internal or private interfaces.
+Also, some interfaces are targeted towards other specific subsystems.</p>
+
+<p>Identifying the audience of an interface helps define the impact of breaking
+it. For instance, it might be okay to break the compatibility of an interface
+whose audience is a small number of specific subsystems. On the other hand, it
+is probably not okay to break a protocol interfaces that millions of Internet
+users depend on.</p>
+
+<p>Yetus uses the following kinds of audience in order of increasing/wider 
visibility:</p>
+
+<h4 id="private">Private</h4>
+
+<p>The interface is for internal use within a project(such as Apache Hadoop)
+and should not be used by applications or by other projects. It is subject to
+change at anytime without notice. Most interfaces of a project are Private 
(also
+referred to as project-private).</p>
+
+<h4 id="limited-private">Limited-Private</h4>
+
+<p>The interface is used by a specified set of projects or systems (typically
+closely related projects). Other projects or systems should not use the
+interface. Changes to the interface will be communicated/ negotiated with the
+specified projects. For example, in the Apache Hadoop project, some interfaces 
are
+LimitedPrivate{HDFS, MapReduce} in that they are private to the HDFS and
+MapReduce subprojects.</p>
+
+<h4 id="public">Public</h4>
+
+<p>The interface is for general use by any application.</p>
+
+<h3 id="stability">Stability</h3>
+
+<p>Stability denotes how stable an interface is, as in when incompatible 
changes to
+the interface are allowed. Yetus provides the following levels of 
stability.</p>
+
+<h4 id="stable">Stable</h4>
+
+<p>Can evolve while retaining compatibility for minor release boundaries; in 
other
+words, incompatible changes to APIs marked Stable are generally  only allowed
+at major releases (i.e. at m.0).</p>
+
+<h4 id="evolving">Evolving</h4>
+
+<p>Evolving, but incompatible changes are allowed at minor release (i.e. m 
.x)</p>
+
+<h4 id="unstable">Unstable</h4>
+
+<p>Incompatible changes to Unstable APIs are allowed any time. This usually 
makes
+sense for only private interfaces.</p>
+
+<p>However one may call this out for a supposedly public interface to highlight
+that it should not be used as an interface; for public interfaces, labeling it
+as Not-an-interface is probably more appropriate than <q>Unstable</q>.</p>
+
+<p>Examples of publicly visible interfaces that are unstable
+(i.e. not-an-interface): GUI, CLIs whose output format will change</p>
+
+<h4 id="deprecated">Deprecated</h4>
+
+<p>APIs that could potentially be removed in the future and should not be 
used.</p>
+
+<h2 id="how-are-the-classifications-recorded">How are the Classifications 
Recorded</h2>
+
+<p>How should the classification be recorded for the annotated APIs?</p>
+
+<ul>
+<li><p>Each interface or class will have the audience and stability recorded 
using
+annotations in org.apache.yetus.classification package.</p></li>
+<li><p>The javadoc generated by the maven target javadoc:javadoc lists only 
the public API.</p></li>
+<li><p>One can derive the audience of java classes and java interfaces by the
+audience of the package in which they are contained. Hence it is useful to
+declare the audience of each java package as public or private (along with the
+private audience variations).</p></li>
+</ul>
+
+<h2 id="faq">FAQ</h2>
+
+<ul>
+<li><p>Why aren&rsquo;t the java scopes (private, package private and public) 
good enough?</p>
+
+<ul>
+<li>Java&rsquo;s scoping is not very complete. One is often forced to make a 
class
+public in order for other internal components to use it. It does not have
+friends or sub-package-private like C++.</li>
+</ul></li>
+<li><p>But I can easily access a private implementation interface if it is 
Java public.
+Where is the protection and control?</p>
+
+<ul>
+<li>The purpose of this is not providing absolute access control. Its purpose
+is to communicate to users and developers. One can access private
+implementation functions in libc; however if they change the internal
+implementation details, your application will break and you will have
+little sympathy from the folks who are supplying libc. If you use a
+non-public interface you understand the risks.</li>
+</ul></li>
+<li><p>Why bother declaring the stability of a private interface?
+Aren&rsquo;t private interfaces always unstable?</p>
+
+<ul>
+<li>Private interfaces are not always unstable. In the cases where they are
+stable they capture internal properties of the system and can communicate
+these properties to its internal users and to developers of the interface.
+
+<ul>
+<li>e.g. In HDFS, NN-DN protocol is private but stable and can help
+implement rolling upgrades. It communicates that this interface should
+not be changed in incompatible ways even though it is private.</li>
+<li>e.g. In HDFS, FSImage stability can help provide more flexible roll 
backs.</li>
+</ul></li>
+</ul></li>
+<li><p>What is the harm in applications using a private interface that is 
stable? How
+is it different than a public stable interface?</p>
+
+<ul>
+<li>While a private interface marked as stable is targeted to change only at
+major releases, it may break at other times if the providers of that
+interface are willing to changes the internal users of that
+interface. Further, a public stable interface is less likely to break even
+at major releases (even though it is allowed to break compatibility)
+because the impact of the change is larger. If you use a private interface
+(regardless of its stability) you run the risk of incompatibility.</li>
+</ul></li>
+<li><p>Why bother with Limited-private? Isn&rsquo;t it giving special 
treatment to some projects?
+That is not fair.</p>
+
+<ul>
+<li>First, most interfaces should be public or private; actually let us state
+it even stronger: make it private unless you really want to expose it to
+public for general use.</li>
+<li>Limited-private is for interfaces that are not intended for general
+use. They are exposed to related projects that need special hooks. Such a
+classification has a cost to both the supplier and consumer of the limited
+interface. Both will have to work together if ever there is a need to
+break the interface in the future; for example the supplier and the
+consumers will have to work together to get coordinated releases of their
+respective projects. This should not be taken lightly - if you can get
+away with private then do so; if the interface is really for general use
+for all applications then you should consider making it public. But remember
+that making an interface public has huge responsibility. Sometimes
+Limited-private is just right.</li>
+<li>A good example of a limited-private interface is BlockLocations in the 
Apache
+Hadoop Project, This is fairly low-level interface that they are willing to
+expose to MR and perhaps HBase. They are likely to change it down the road
+and at that time they will have to get a coordinated effort with the MR
+team to release matching releases. While MR and HDFS are always released
+in sync today, they may change down the road.</li>
+<li>If you have a limited-private interface with many projects listed then you
+are fooling yourself. It is practically public.</li>
+<li>It might be worth declaring a special audience classification called
+{YourProjectName}-Private for your closely related projects.</li>
+</ul></li>
+<li><p>Can&rsquo;t a private interface be treated as project-private also? For 
example what is
+the harm in projects in the Apache Hadoop extended ecosystem, having access to
+private classes?</p>
+
+<ul>
+<li>Do we want MR accessing class files that are implementation details inside
+HDFS? There used to be many such layer violations in the Apache Hadoop
+project that they have been cleaning up over the last few years. It is highly
+undesirable for such layer violations to creep back in by no separation
+between the major components like HDFS and MR.</li>
+</ul></li>
+<li><p>Aren&rsquo;t all public interfaces stable?</p>
+
+<ul>
+<li>One may mark a public interface as evolving in its early days. Here one is
+promising to make an effort to make compatible changes but may need to
+break it at minor releases.</li>
+<li>One example of a public interface that is unstable is where one is
+providing an implementation of a standards-body based interface that is
+still under development. For example, many companies, in an attempt to be
+first to market, have provided implementations of a new NFS protocol even
+when the protocol was not fully completed by IETF. The implementor cannot
+evolve the interface in a fashion that causes least disruption because
+the stability is controlled by the standards body. Hence it is appropriate
+to label the interface as unstable.</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-2016 <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/b2e6ae5a/documentation/in-progress/precommit-advanced/index.html
----------------------------------------------------------------------
diff --git a/documentation/in-progress/precommit-advanced/index.html 
b/documentation/in-progress/precommit-advanced/index.html
index 4262af8..9592e1f 100644
--- a/documentation/in-progress/precommit-advanced/index.html
+++ b/documentation/in-progress/precommit-advanced/index.html
@@ -156,7 +156,7 @@
 
 <h1 id="plug-ins">Plug-ins</h1>
 
-<p>test-patch allows one to add to its basic feature set via plug-ins.  There 
is a directory called test-patch.d off of the directory where test-patch.sh 
lives.  Inside this directory one may place some bash shell fragments that, if 
setup with proper functions, will allow for test-patch to call it as necessary. 
 Different plug-ins have specific functions for that particular functionality.  
In this document, the common functions available to all/most plug-ins are 
covered.  Test plugins are covered below. See other documentation for pertinent 
information for the other plug-in types.</p>
+<p>test-patch allows one to add to its basic feature set via plug-ins.  There 
is a directory called test-patch.d inside the directory where test-patch.sh 
lives.  Inside this directory one may place some bash shell fragments that, if 
setup with proper functions, will allow for test-patch to call it as necessary. 
 Different plug-ins have specific functions for that particular functionality.  
In this document, the common functions available to all/most plug-ins are 
covered.  Test plugins are covered below. See other documentation for pertinent 
information for the other plug-in types.</p>
 
 <h2 id="common-plug-in-functions">Common Plug-in Functions</h2>
 
@@ -227,7 +227,7 @@
 <p>Plug-ins are imported from several key directories:</p>
 
 <ul>
-<li><p>core.d is an internal-to-Yetus directory that first loads the basic 
Yetus library, followed by the common routines used by all of the precommit 
shell code.  This order is dictated by prefixing the plug-in files with a 
number.  Other files in this directory are loaded in shell collated 
order.</p></li>
+<li><p>core.d is an internal-to-Yetus directory that first loads the basic 
Apache Yetus library, followed by the common routines used by all of the 
precommit shell code.  This order is dictated by prefixing the plug-in files 
with a number.  Other files in this directory are loaded in shell collated 
order.</p></li>
 <li><p>personality contains bundled personalities for various projects.  These 
will be imported individually based upon either a project name or if 
specifically identified with the <code>--personality</code> flag.</p></li>
 <li><p>test-patch.d contains all of the optional, bundled plug-ins.  These are 
imported last and in shell collated order.</p></li>
 </ul>
@@ -244,7 +244,7 @@
 <li><p>pluginname_filefilter</p>
 
 <ul>
-<li>executed while determine which files trigger which tests.  This function 
should use <code>add_test pluginname</code> to add the plug-in to the test 
list.</li>
+<li>executed while determining which files trigger which tests.  This function 
should use <code>add_test pluginname</code> to add the plug-in to the test 
list.</li>
 </ul></li>
 <li><p>pluginname_compile</p>
 
@@ -288,7 +288,7 @@
 <h2 id="global-definitions">Global Definitions</h2>
 
 <p>Globals for personalities should be defined in the 
<code>personality_globals</code> function.  This function is called 
<em>after</em> the other plug-ins have been imported.  This allows one to 
configure any settings for plug-ins that have been imported safely:</p>
-<pre class="highlight shell"><code>funciton personality_globals
+<pre class="highlight shell"><code><span class="k">function 
</span>personality_globals
 <span class="o">{</span>
   <span class="nv">PATCH_BRANCH_DEFAULT</span><span class="o">=</span>master
   <span class="nv">GITHUB_REPO</span><span class="o">=</span><span 
class="s2">"apache/yetus"</span>

http://git-wip-us.apache.org/repos/asf/yetus/blob/b2e6ae5a/documentation/in-progress/precommit-apidocs/core/index.html
----------------------------------------------------------------------
diff --git a/documentation/in-progress/precommit-apidocs/core/index.html 
b/documentation/in-progress/precommit-apidocs/core/index.html
index ab53dfc..0a85007 100644
--- a/documentation/in-progress/precommit-apidocs/core/index.html
+++ b/documentation/in-progress/precommit-apidocs/core/index.html
@@ -165,8 +165,6 @@
 
 <ul>
 <li><a href="#docker_version">docker_version</a></li>
-<li><a href="#personality_file_tests">personality_file_tests</a></li>
-<li><a href="#personality_modules">personality_modules</a></li>
 </ul></li>
 </ul>
 
@@ -1230,78 +1228,6 @@
 <td style="text-align: left">No</td>
 </tr>
 </tbody></table>
-<h3 id="personality_file_tests"><code>personality_file_tests</code></h3>
-
-<ul>
-<li>Synopsis</li>
-</ul>
-<pre class="highlight plaintext"><code>personality_file_tests
-</code></pre>
-
-<ul>
-<li>Description</li>
-</ul>
-
-<p>None</p>
-
-<ul>
-<li>Returns</li>
-</ul>
-
-<p>Nothing</p>
-<table class='table table-bordered table-striped'><thead><tr>
-<th style="text-align: left">Classification</th>
-<th style="text-align: left">Level</th>
-</tr>
-</thead><tbody><tr>
-<td style="text-align: left">Audience</td>
-<td style="text-align: left">None</td>
-</tr>
-<tr>
-<td style="text-align: left">Stability</td>
-<td style="text-align: left">None</td>
-</tr>
-<tr>
-<td style="text-align: left">Replaceable</td>
-<td style="text-align: left">No</td>
-</tr>
-</tbody></table>
-<h3 id="personality_modules"><code>personality_modules</code></h3>
-
-<ul>
-<li>Synopsis</li>
-</ul>
-<pre class="highlight plaintext"><code>personality_modules
-</code></pre>
-
-<ul>
-<li>Description</li>
-</ul>
-
-<p>None</p>
-
-<ul>
-<li>Returns</li>
-</ul>
-
-<p>Nothing</p>
-<table class='table table-bordered table-striped'><thead><tr>
-<th style="text-align: left">Classification</th>
-<th style="text-align: left">Level</th>
-</tr>
-</thead><tbody><tr>
-<td style="text-align: left">Audience</td>
-<td style="text-align: left">None</td>
-</tr>
-<tr>
-<td style="text-align: left">Stability</td>
-<td style="text-align: left">None</td>
-</tr>
-<tr>
-<td style="text-align: left">Replaceable</td>
-<td style="text-align: left">No</td>
-</tr>
-</tbody></table>
     </div>
       <div class="container">
     <hr>

http://git-wip-us.apache.org/repos/asf/yetus/blob/b2e6ae5a/documentation/in-progress/precommit-apidocs/plugins/index.html
----------------------------------------------------------------------
diff --git a/documentation/in-progress/precommit-apidocs/plugins/index.html 
b/documentation/in-progress/precommit-apidocs/plugins/index.html
index a4be12f..a81dd57 100644
--- a/documentation/in-progress/precommit-apidocs/plugins/index.html
+++ b/documentation/in-progress/precommit-apidocs/plugins/index.html
@@ -130,10 +130,10 @@
 <li>Public/Stable/Not Replaceable
 
 <ul>
-<li><a href="#jira_write_comment">jira_write_comment</a></li>
-<li><a href="#javac_precheck">javac_precheck</a></li>
 <li><a href="#bugzilla_write_comment">bugzilla_write_comment</a></li>
 <li><a href="#github_write_comment">github_write_comment</a></li>
+<li><a href="#javac_precheck">javac_precheck</a></li>
+<li><a href="#jira_write_comment">jira_write_comment</a></li>
 </ul></li>
 <li>None/None/Not Replaceable
 
@@ -352,25 +352,25 @@
 </tbody></table>
 <h2 id="public-stable-not-replaceable">Public/Stable/Not Replaceable</h2>
 
-<h3 id="jira_write_comment"><code>jira_write_comment</code></h3>
+<h3 id="bugzilla_write_comment"><code>bugzilla_write_comment</code></h3>
 
 <ul>
 <li>Synopsis</li>
 </ul>
-<pre class="highlight plaintext"><code>jira_write_comment filename
+<pre class="highlight plaintext"><code>bugzilla_write_comment filename
 </code></pre>
 
 <ul>
 <li>Description</li>
 </ul>
 
-<p>Write the contents of a file to JIRA</p>
+<p>Write the contents of a file to Bugzilla</p>
 
 <ul>
 <li>Returns</li>
 </ul>
 
-<p>exit code from posting to jira</p>
+<p>Nothing</p>
 <table class='table table-bordered table-striped'><thead><tr>
 <th style="text-align: left">Classification</th>
 <th style="text-align: left">Level</th>
@@ -388,27 +388,25 @@
 <td style="text-align: left">No</td>
 </tr>
 </tbody></table>
-<h3 id="javac_precheck"><code>javac_precheck</code></h3>
+<h3 id="github_write_comment"><code>github_write_comment</code></h3>
 
 <ul>
 <li>Synopsis</li>
 </ul>
-<pre class="highlight plaintext"><code>javac_precheck
+<pre class="highlight plaintext"><code>github_write_comment filename
 </code></pre>
 
 <ul>
 <li>Description</li>
 </ul>
 
-<p>Verify that ${JAVA_HOME} is defined</p>
+<p>Write the contents of a file to github</p>
 
 <ul>
 <li>Returns</li>
 </ul>
 
-<p>1 - no JAVA_HOME</p>
-
-<p>0 - JAVA_HOME defined</p>
+<p>Nothing</p>
 <table class='table table-bordered table-striped'><thead><tr>
 <th style="text-align: left">Classification</th>
 <th style="text-align: left">Level</th>
@@ -426,25 +424,27 @@
 <td style="text-align: left">No</td>
 </tr>
 </tbody></table>
-<h3 id="bugzilla_write_comment"><code>bugzilla_write_comment</code></h3>
+<h3 id="javac_precheck"><code>javac_precheck</code></h3>
 
 <ul>
 <li>Synopsis</li>
 </ul>
-<pre class="highlight plaintext"><code>bugzilla_write_comment filename
+<pre class="highlight plaintext"><code>javac_precheck
 </code></pre>
 
 <ul>
 <li>Description</li>
 </ul>
 
-<p>Write the contents of a file to Bugzilla</p>
+<p>Verify that ${JAVA_HOME} is defined</p>
 
 <ul>
 <li>Returns</li>
 </ul>
 
-<p>Nothing</p>
+<p>1 - no JAVA_HOME</p>
+
+<p>0 - JAVA_HOME defined</p>
 <table class='table table-bordered table-striped'><thead><tr>
 <th style="text-align: left">Classification</th>
 <th style="text-align: left">Level</th>
@@ -462,25 +462,25 @@
 <td style="text-align: left">No</td>
 </tr>
 </tbody></table>
-<h3 id="github_write_comment"><code>github_write_comment</code></h3>
+<h3 id="jira_write_comment"><code>jira_write_comment</code></h3>
 
 <ul>
 <li>Synopsis</li>
 </ul>
-<pre class="highlight plaintext"><code>github_write_comment filename
+<pre class="highlight plaintext"><code>jira_write_comment filename
 </code></pre>
 
 <ul>
 <li>Description</li>
 </ul>
 
-<p>Write the contents of a file to github</p>
+<p>Write the contents of a file to JIRA</p>
 
 <ul>
 <li>Returns</li>
 </ul>
 
-<p>Nothing</p>
+<p>exit code from posting to jira</p>
 <table class='table table-bordered table-striped'><thead><tr>
 <th style="text-align: left">Classification</th>
 <th style="text-align: left">Level</th>

http://git-wip-us.apache.org/repos/asf/yetus/blob/b2e6ae5a/documentation/in-progress/precommit-basic/index.html
----------------------------------------------------------------------
diff --git a/documentation/in-progress/precommit-basic/index.html 
b/documentation/in-progress/precommit-basic/index.html
index 736f6a7..8740555 100644
--- a/documentation/in-progress/precommit-basic/index.html
+++ b/documentation/in-progress/precommit-basic/index.html
@@ -304,6 +304,9 @@ have a location to look at the output artifacts:</p>
 
 <p>It is a fairly common practice within the Apache community to use 
Apache&rsquo;s JIRA instance to store potential patches.  As a result, 
test-patch supports providing just a JIRA issue number.  test-patch will find 
the <em>last</em> attachment, download it, then process it.</p>
 
+<p><strong>NOTE: test-patch expects the patch files to follow a particular 
naming convention. For complete details
+ on the naming convention please refer to <a 
href="./precommit-patchnames/">patch-naming-conventions</a></strong></p>
+
 <p>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> HADOOP-9905
 </code></pre>
@@ -334,7 +337,7 @@ have a location to look at the output artifacts:</p>
 
 <h2 id="generic-urls">Generic URLs</h2>
 
-<p>Luckily, test-patch supports  provide ways to provide unified diffs via 
URLs.</p>
+<p>Luckily, test-patch supports ways to provide unified diffs via URLs.</p>
 
 <p>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> https://example.com/webserver/file.patch

http://git-wip-us.apache.org/repos/asf/yetus/blob/b2e6ae5a/documentation/in-progress/precommit-buildtools/index.html
----------------------------------------------------------------------
diff --git a/documentation/in-progress/precommit-buildtools/index.html 
b/documentation/in-progress/precommit-buildtools/index.html
index 534f384..a83d6ed 100644
--- a/documentation/in-progress/precommit-buildtools/index.html
+++ b/documentation/in-progress/precommit-buildtools/index.html
@@ -182,12 +182,12 @@
 <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>
+<li>Default method to determine how to enqueue modules for processing.  Note 
that personalities may override this function. Requires two arguments: repo 
status and test desired. For example, in a maven build, values may be 
&#39;branch&rsquo; and &#39;mvninstall&rsquo;.</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>
+<li>Default method to determine which tests to trigger.  Note that 
personalities may override this function. Requires a single argument: the file 
in which the tests exist.</li>
 </ul></li>
 </ul>
 
@@ -288,7 +288,7 @@
 
 <p>Maven will test eclipse and site if maven is being used as the build tool 
and appropriate files trigger them.</p>
 
-<p>Maven will trigger add a maven install test when the 
<code>maven_add_install</code> function has been used and the related tests are 
requierd. Plug-ins that need to run maven before MUST call it as part of their 
respective initialize functions, otherwise maven may fail unexpectedly.  All 
Yetus provided plug-ins that require maven will trigger the maven install 
functionality.</p>
+<p>Maven will trigger add a maven install test when the 
<code>maven_add_install</code> function has been used and the related tests are 
requierd. Plug-ins that need to run maven before MUST call it as part of their 
respective initialize functions, otherwise maven may fail unexpectedly.  All 
Apache Yetus provided plug-ins that require maven will trigger the maven 
install functionality.</p>
 
     </div>
       <div class="container">

http://git-wip-us.apache.org/repos/asf/yetus/blob/b2e6ae5a/documentation/in-progress/precommit-smart-apply-patch/index.html
----------------------------------------------------------------------
diff --git a/documentation/in-progress/precommit-smart-apply-patch/index.html 
b/documentation/in-progress/precommit-smart-apply-patch/index.html
index bf76f8b..205575e 100644
--- a/documentation/in-progress/precommit-smart-apply-patch/index.html
+++ b/documentation/in-progress/precommit-smart-apply-patch/index.html
@@ -127,7 +127,7 @@
 
 <h1 id="usage">Usage</h1>
 
-<p>Its simpliest form is used when a patch is stored in a local file:</p>
+<p>Its simplest 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>
 

http://git-wip-us.apache.org/repos/asf/yetus/blob/b2e6ae5a/documentation/in-progress/precommit-testformats/index.html
----------------------------------------------------------------------
diff --git a/documentation/in-progress/precommit-testformats/index.html 
b/documentation/in-progress/precommit-testformats/index.html
index 5c7ac5e..25e5e81 100644
--- a/documentation/in-progress/precommit-testformats/index.html
+++ b/documentation/in-progress/precommit-testformats/index.html
@@ -127,6 +127,8 @@
 <pre class="highlight shell"><code>add_test_format &lt;pluginname&gt;
 </code></pre>
 
+<p>Test format plugins can provide following two methods, which will be called 
by test-patch if defined.</p>
+
 <ul>
 <li><p>pluginname_process_tests</p>
 
@@ -140,6 +142,8 @@
 </ul></li>
 </ul>
 
+<p>For an example of how to write a test-format plugin, you can look at <a 
href="https://github.com/apache/yetus/blob/master/precommit/test-patch.d/junit.sh";>junit
 plugin</a> bundled in Apache Yetus.</p>
+
     </div>
       <div class="container">
     <hr>

http://git-wip-us.apache.org/repos/asf/yetus/blob/b2e6ae5a/documentation/in-progress/releasedocmaker/index.html
----------------------------------------------------------------------
diff --git a/documentation/in-progress/releasedocmaker/index.html 
b/documentation/in-progress/releasedocmaker/index.html
index 3bbb8a9..c7a4a2d 100644
--- a/documentation/in-progress/releasedocmaker/index.html
+++ b/documentation/in-progress/releasedocmaker/index.html
@@ -276,7 +276,8 @@ default value for this label by using 
&ndash;incompatiblelabel option e.g.</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>
+<p>There is basic support for an autoindexer.  It will create two files that 
contain links to all directories that have a major.minor*-style version 
numbering system.
+For example directories with names like 0.6, 1.2.2, 1.2alpha etc. will all be 
linked.</p>
 
 <ul>
 <li>index.md: a file suitable for conversion to HTML via mvn site</li>

Reply via email to