This is an automated email from the ASF dual-hosted git repository.

jamesbognar pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/juneau.git


The following commit(s) were added to refs/heads/master by this push:
     new 9392ca8  Javadocs.
9392ca8 is described below

commit 9392ca80c4bcd64bc1e8ef771fe2bc40dd1e4032
Author: JamesBognar <jamesbog...@apache.org>
AuthorDate: Wed Dec 19 19:09:10 2018 -0500

    Javadocs.
---
 .../src/main/java/org/apache/juneau/Value.java     |   4 +-
 juneau-doc/.classpath                              |   1 +
 juneau-doc/docs/Fragments/about.html               |  36 ++-
 juneau-doc/docs/ReleaseNotes/8.0.0.html            |  23 +-
 .../Topics/02.juneau-marshall/10.Transforms.html   |  16 +-
 .../10.Transforms/16.InterfaceFilters.html         |   2 +-
 .../10.Transforms/17.StopClasses.html              |   2 +-
 .../02.juneau-marshall/11.BeanDictionaries.html    |   6 +-
 .../02.juneau-marshall/25.OpenApiDetails.html      |  14 +-
 .../docs/Topics/04.juneau-dto/04.SwaggerUI.html    |   2 +-
 .../06.RestMethod/13.RestMethodMatchers.html       |   2 +-
 .../08.OpenApiSchemaPartParsing.html               |  10 +-
 .../09.OpenApiSchemaPartSerializing.html           |   4 +-
 .../10.HttpPartAnnotations.html                    |  28 +-
 .../10.HttpPartAnnotations/01.Body.html            |   2 +-
 .../10.HttpPartAnnotations/02.FormData.html        |   2 +-
 .../10.HttpPartAnnotations/03.HasFormData.html     |   2 +-
 .../10.HttpPartAnnotations/04.Query.html           |   2 +-
 .../10.HttpPartAnnotations/05.HasQuery.html        |   2 +-
 .../10.HttpPartAnnotations/06.Header.html          |   2 +-
 .../10.HttpPartAnnotations/07.Path.html            |   2 +-
 .../10.HttpPartAnnotations/08.Request.html         |   2 +-
 .../10.HttpPartAnnotations/09.Response.html        |   2 +-
 .../10.HttpPartAnnotations/10.ResponseHeader.html  |   2 +-
 .../10.HttpPartAnnotations/11.ResponseStatus.html  |   2 +-
 .../07.juneau-rest-server/13.Serializers.html      |   4 +-
 .../Topics/07.juneau-rest-server/14.Parsers.html   |   4 +-
 .../07.juneau-rest-server/15.Properties.html       |   8 +-
 .../07.juneau-rest-server/16.Transforms.html       |   8 +-
 .../docs/Topics/07.juneau-rest-server/17.URIs.html |   1 -
 .../Topics/07.juneau-rest-server/18.Guards.html    |   4 +-
 .../07.juneau-rest-server/19.Converters.html       |   4 +-
 .../23.ConfigurationFiles.html                     |   4 +-
 .../07.juneau-rest-server/25.ClientVersioning.html |   4 +-
 .../27.Swagger/01.BasicRestServlet.html            |   2 +-
 .../27.Swagger/05.Parameters.html                  |   4 +-
 .../27.Swagger/06.ParameterExamples.html           |   6 +-
 .../27.Swagger/08.ResponseExamples.html            |   2 +-
 .../28.HtmlDocAnnotation.html                      |   4 +-
 .../28.HtmlDocAnnotation/02.Widgets.html           |   2 +-
 .../07.juneau-rest-server/29.DefaultHeaders.html   |   4 +-
 .../10.juneau-rest-client/01.RestProxies.html      |  14 +-
 .../01.RestProxies/03.Body.html                    |   2 +-
 .../01.RestProxies/04.FormData.html                |   2 +-
 .../01.RestProxies/05.Query.html                   |   2 +-
 .../01.RestProxies/06.Header.html                  |   2 +-
 .../01.RestProxies/07.Path.html                    |   2 +-
 .../01.RestProxies/08.Request.html                 |  12 +-
 .../01.RestProxies/09.Response.html                |   8 +-
 .../docs/Topics/11.juneau-microservice-core.html   |  14 +
 .../03.PetStoreResource.html                       |  16 +-
 .../Topics/18.juneau-examples-rest-springboot.html |   2 +-
 .../docs/{overview.html => overview_template.html} |   0
 juneau-doc/juneau-doc.jar                          | Bin 25503 -> 25553 bytes
 .../apache/juneau/doc/internal/DocGenerator.java   |  12 +-
 juneau-doc/src/main/javadoc/overview.html          | 287 ++++++++++++---------
 .../main/javadoc/resources/fragments/about.html    |  36 ++-
 .../src/main/javadoc/resources/juneau-doc.css      |  12 +-
 .../java/org/apache/juneau/rest/RestContext.java   |   2 +-
 59 files changed, 386 insertions(+), 276 deletions(-)

diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/Value.java 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/Value.java
index aefab7c..dcbed9f 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/Value.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/Value.java
@@ -36,7 +36,7 @@ public class Value<T> {
         *      }
         * </p>
         * <p class='bcode w800'>
-        *      Class<?> t = 
Value.<jsm>getValueType</jsm>(A.<jk>class</jk>.getMethod(<js>"doX"</js>, 
Value.<jk>class</jk>));
+        *      Class&lt;?&gt; t = 
Value.<jsm>getValueType</jsm>(A.<jk>class</jk>.getMethod(<js>"doX"</js>, 
Value.<jk>class</jk>));
         *      <jsm>assertTrue</jsm>(t == Foo.<jk>class</jk>);
         * </p>
         *
@@ -59,7 +59,7 @@ public class Value<T> {
                        ParameterizedType pt = (ParameterizedType)t;
                        if (pt.getRawType() == Value.class) {
                                Type[] ta = pt.getActualTypeArguments();
-                               if (ta.length > 0) 
+                               if (ta.length > 0)
                                        return ta[0];
                        }
                } else if (t instanceof Class) {
diff --git a/juneau-doc/.classpath b/juneau-doc/.classpath
index 96c9715..1605ea8 100644
--- a/juneau-doc/.classpath
+++ b/juneau-doc/.classpath
@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <classpath>
        <classpathentry kind="src" path="src/main/javadoc"/>
+       <classpathentry kind="src" path="docs"/>
        <classpathentry kind="src" output="target/classes" path="src/main/java">
                <attributes>
                        <attribute name="optional" value="true"/>
diff --git a/juneau-doc/docs/Fragments/about.html 
b/juneau-doc/docs/Fragments/about.html
index abed929..265c3d5 100644
--- a/juneau-doc/docs/Fragments/about.html
+++ b/juneau-doc/docs/Fragments/about.html
@@ -16,14 +16,34 @@
        Apache Juneau&trade; is a single cohesive Java ecosystem consisting of 
the following parts:
 </p>
 <ul class='spaced-list'>
-       <li><b>juneau-marshall</b><br>A universal toolkit for marshalling POJOs 
to a wide variety of content types using a common framework with no external 
library dependencies.
-       <li><b>juneau-dto</b><br>A variety of predefined DTOs for serializing 
and parsing languages such as HTML5, Swagger and ATOM.
-       <li><b>juneau-svl</b><br>A simple yet powerful variable replacement 
language API.
-       <li><b>juneau-config</b><br>A sophisticated configuration file API.
-       <li><b>juneau-rest-server</b><br>A universal REST server API for 
creating Swagger-based self-documenting REST interfaces using POJOs, simply 
deployed as 
-               one or more top-level servlets in any Servlet 3.1.0+ container 
or Spring Boot.
-       <li><b>juneau-rest-client</b><br>A universal REST client API for 
interacting with Juneau or 3rd-party REST interfaces using POJOs and proxy 
interfaces.
-       <li><b>juneau-microservice</b><br>A REST microservice API that combines 
all the features above as a simple configurable Jetty server for 
+       <li>
+               <b>juneau-marshall</b>
+               <br>A universal toolkit for marshalling POJOs to a wide variety 
of content types using a common framework with no external library dependencies.
+       <li>
+               <b>juneau-dto</b>
+               <br>A variety of predefined DTOs for serializing and parsing 
languages such as HTML5, Swagger and ATOM.
+       <li>
+               <b>juneau-svl</b>
+               <br>A simple yet powerful variable replacement language API.
+       <li>
+               <b>juneau-config</b>
+               <br>A sophisticated configuration API.
+       <li>
+               <b>juneau-rest-server</b>
+               <br>A universal REST server API for creating REST interfaces 
using POJOs simply deployed in any Servlet 3.1.0+ container.
+               <br>Includes auto-generation of Swagger and self-hosting of 
Swagger UI through OPTIONS page requests.
+       <li>
+               <b>juneau-rest-server-springboot</b>
+               <br>Integration support for deploying Juneau-based REST 
resources as Spring beans in a Spring Boot application.
+       <li>
+               <b>juneau-rest-client</b>
+               <br>A universal REST client API for interacting with Juneau or 
3rd-party REST interfaces using POJOs and proxy interfaces.
+       <li>
+               <b>juneau-microservice</b>
+               <br>A builder-based API for creating microservices.
+       <li>
+               <b>juneau-microservice-jetty</b>
+               <br>REST microservice API that combines all the features above 
as a simple configurable Jetty server for 
                creating lightweight standalone REST interfaces that start up 
in milliseconds.
 </ul>
 <p>
diff --git a/juneau-doc/docs/ReleaseNotes/8.0.0.html 
b/juneau-doc/docs/ReleaseNotes/8.0.0.html
index 15a3047..834b458 100644
--- a/juneau-doc/docs/ReleaseNotes/8.0.0.html
+++ b/juneau-doc/docs/ReleaseNotes/8.0.0.html
@@ -87,7 +87,7 @@
                </ul>
 </ul>
 
-<h5 class='topic w800'>juneau-server</h5>
+<h5 class='topic w800'>juneau-rest-server</h5>
 <ul class='spaced-list'>
        <li>
                New methods on {@link oajr.RestServlet}:
@@ -100,6 +100,12 @@
                <br>This allows for any of those instance to be injectable 
beans.
 </ul>
 
+<h5 class='topic w800'>juneau-rest-server-springboot</h5>
+<ul class='spaced-list'>
+       <li>
+               New project containing classes for making it easy to use Juneau 
with Spring Boot.
+</ul>
+
 <h5 class='topic w800'>juneau-microservice-core</h5>
 <ul class='spaced-list'>
        <li>
@@ -125,12 +131,17 @@
                New {@link oaj.microservice.jetty.JettyMicroservice} class 
replaces the previous <code>RestMicroservice</code>.
 </ul>
 
-<h5 class='topic w800'>juneau-examples-rest</h5>
+<h5 class='topic w800'>juneau-my-jetty-microservice</h5>
 <ul class='spaced-list'>
        <li>
-               New <code>org.apache.juneau.examples.rest.spring</code> package 
with code showing how to use Juneau REST
-               with Spring Boot. 
-       <li>
-               New <code>app.json</code> and <code>Procfile</code> files for 
deploying examples into Heroku.
+               New template starter project for Jetty-based microservices.
 </ul>
 
+<h5 class='topic w800'>juneau-my-springboot-microservice</h5>
+<ul class='spaced-list'>
+       <li>
+               Template starter project for Spring-Boot-based microservices.
+       <li>
+               <code>app.json</code> and <code>Procfile</code> files for 
deploying examples into Heroku.
+               <br>Includes instructions.
+</ul>
diff --git a/juneau-doc/docs/Topics/02.juneau-marshall/10.Transforms.html 
b/juneau-doc/docs/Topics/02.juneau-marshall/10.Transforms.html
index f4671ff..1446a02 100644
--- a/juneau-doc/docs/Topics/02.juneau-marshall/10.Transforms.html
+++ b/juneau-doc/docs/Topics/02.juneau-marshall/10.Transforms.html
@@ -47,27 +47,27 @@ Transforms
 </p>
 <ul class='doctree'>
        <li class='ja'>
-               {@link oaj.annotation.Swap @Swap} 
+               {@link oaj.annotation.Swap} 
                - Used to tailor how non-bean POJOs get interpreted by the 
framework.
        <li class='ja'>
-               {@link oaj.annotation.Bean @Bean} 
+               {@link oaj.annotation.Bean} 
                - Used to tailor how beans get interpreted by the framework.
        <li class='ja'>
-               {@link oaj.annotation.BeanConstructor @BeanConstructor} 
+               {@link oaj.annotation.BeanConstructor} 
                - Maps constructor arguments to property names on beans with 
read-only properties.
        <li class='ja'>
-               {@link oaj.annotation.BeanIgnore @BeanIgnore} 
+               {@link oaj.annotation.BeanIgnore} 
                - Ignore classes, fields, and methods from being interpreted as 
bean or bean components.
        <li class='ja'>
-               {@link oaj.annotation.BeanProperty @BeanProperty} 
+               {@link oaj.annotation.BeanProperty} 
                - Used to tailor how bean properties get interpreted by the 
framework.
        <li class='ja'>
-               {@link oaj.annotation.NameProperty @NameProperty} 
+               {@link oaj.annotation.NameProperty} 
                - Identifies a setter as a method for setting the name of a 
POJO as it's known by its parent object.
        <li class='ja'>
-               {@link oaj.annotation.ParentProperty @ParentProperty} 
+               {@link oaj.annotation.ParentProperty} 
                - Identifies a setter as a method for adding a parent reference 
to a child object.
        <li class='ja'>
-               {@link oaj.annotation.URI @URI} 
+               {@link oaj.annotation.URI} 
                - Used to identify a class or bean property as a URI.
 </ul>
diff --git 
a/juneau-doc/docs/Topics/02.juneau-marshall/10.Transforms/16.InterfaceFilters.html
 
b/juneau-doc/docs/Topics/02.juneau-marshall/10.Transforms/16.InterfaceFilters.html
index 5d8ee79..5830509 100644
--- 
a/juneau-doc/docs/Topics/02.juneau-marshall/10.Transforms/16.InterfaceFilters.html
+++ 
b/juneau-doc/docs/Topics/02.juneau-marshall/10.Transforms/16.InterfaceFilters.html
@@ -24,7 +24,7 @@ Interface Filters
 </p>
 <ul>
        <li class='jf'>{@link oaj.BeanContext#BEAN_beanFilters}
-       <li class='ja'>{@link oaj.annotation.Bean#interfaceClass() 
@Bean(interfaceClass)}
+       <li class='ja'>{@link oaj.annotation.Bean#interfaceClass() 
Bean(interfaceClass)}
        <li class='jm'>{@link 
oaj.transform.BeanFilterBuilder#interfaceClass(Class)}
 </ul>
 <p>
diff --git 
a/juneau-doc/docs/Topics/02.juneau-marshall/10.Transforms/17.StopClasses.html 
b/juneau-doc/docs/Topics/02.juneau-marshall/10.Transforms/17.StopClasses.html
index 281a772..e33d17e 100644
--- 
a/juneau-doc/docs/Topics/02.juneau-marshall/10.Transforms/17.StopClasses.html
+++ 
b/juneau-doc/docs/Topics/02.juneau-marshall/10.Transforms/17.StopClasses.html
@@ -23,7 +23,7 @@ Stop Classes
        Stop classes are defined through the following:
 </p>
 <ul>
-       <li class='ja'>{@link oaj.annotation.Bean#stopClass() @Bean(stopClass)}
+       <li class='ja'>{@link oaj.annotation.Bean#stopClass() Bean(stopClass)}
        <li class='jf'>{@link oaj.transform.BeanFilterBuilder#stopClass(Class)}
 </ul>
 <p>
diff --git a/juneau-doc/docs/Topics/02.juneau-marshall/11.BeanDictionaries.html 
b/juneau-doc/docs/Topics/02.juneau-marshall/11.BeanDictionaries.html
index a2b0ef0..5e8d611 100644
--- a/juneau-doc/docs/Topics/02.juneau-marshall/11.BeanDictionaries.html
+++ b/juneau-doc/docs/Topics/02.juneau-marshall/11.BeanDictionaries.html
@@ -86,9 +86,9 @@ Bean Names and Dictionaries
        Bean dictionaries are registered through the following:
 </p>
 <ul>
-       <li class='ja'>{@link oaj.annotation.BeanProperty#beanDictionary() 
@BeanProperty(beanDictionary)} 
+       <li class='ja'>{@link oaj.annotation.BeanProperty#beanDictionary() 
BeanProperty(beanDictionary)} 
                - On individual bean properties through the annotation.
-       <li class='ja'>{@link oaj.annotation.Bean#beanDictionary() 
@Bean(beanDictionary)} 
+       <li class='ja'>{@link oaj.annotation.Bean#beanDictionary() 
Bean(beanDictionary)} 
                - On all properties on a bean and all subclasses.
        <li class='jf'>{@link oaj.BeanContext#BEAN_beanDictionary} 
                - Configuration property on serializers and parsers.
@@ -128,7 +128,7 @@ Bean Names and Dictionaries
        The <js>"_type"</js> property name can be overridden through the 
following:
 </p>
 <ul>
-       <li class='ja'>{@link oaj.annotation.Bean#typePropertyName() 
@Bean(typePropertyName)} 
+       <li class='ja'>{@link oaj.annotation.Bean#typePropertyName() 
Bean(typePropertyName)} 
                - On individual beans through the annotation.
        <li class='jf'>{@link oaj.BeanContext#BEAN_beanTypePropertyName} 
                - Configuration property on serializers and parsers.
diff --git a/juneau-doc/docs/Topics/02.juneau-marshall/25.OpenApiDetails.html 
b/juneau-doc/docs/Topics/02.juneau-marshall/25.OpenApiDetails.html
index abc15dd..8446ef0 100644
--- a/juneau-doc/docs/Topics/02.juneau-marshall/25.OpenApiDetails.html
+++ b/juneau-doc/docs/Topics/02.juneau-marshall/25.OpenApiDetails.html
@@ -37,11 +37,11 @@ OpenAPI Details
        can be applied to method parameters and class types to define the 
schema for various HTTP parts:
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link oaj.http.annotation.Body Body}
-       <li class='ja'>{@link oaj.http.annotation.Header Header}
-       <li class='ja'>{@link oaj.http.annotation.Query Query}
-       <li class='ja'>{@link oaj.http.annotation.FormData FormData}
-       <li class='ja'>{@link oaj.http.annotation.Path Path}
-       <li class='ja'>{@link oaj.http.annotation.Response Response}
-       <li class='ja'>{@link oaj.http.annotation.ResponseHeader ResponseHeader}
+       <li class='ja'>{@link oaj.http.annotation.Body}
+       <li class='ja'>{@link oaj.http.annotation.Header}
+       <li class='ja'>{@link oaj.http.annotation.Query}
+       <li class='ja'>{@link oaj.http.annotation.FormData}
+       <li class='ja'>{@link oaj.http.annotation.Path}
+       <li class='ja'>{@link oaj.http.annotation.Response}
+       <li class='ja'>{@link oaj.http.annotation.ResponseHeader}
 </ul>
diff --git a/juneau-doc/docs/Topics/04.juneau-dto/04.SwaggerUI.html 
b/juneau-doc/docs/Topics/04.juneau-dto/04.SwaggerUI.html
index bd63cc5..56d5e6a 100644
--- a/juneau-doc/docs/Topics/04.juneau-dto/04.SwaggerUI.html
+++ b/juneau-doc/docs/Topics/04.juneau-dto/04.SwaggerUI.html
@@ -80,7 +80,7 @@ Swagger UI
                                <jc>// Override the nav links for the swagger 
page.</jc>
                                navlinks={
                                        <js>"back: servlet:/"</js>,
-                                       <js>"json: 
servlet:/?method=OPTIONS&Accept=text/json&plainText=true"</js>
+                                       <js>"json: 
servlet:/?method=OPTIONS&amp;Accept=text/json&amp;plainText=true"</js>
                                },
                                <jc>// Never show aside contents of page 
inherited from class.</jc>
                                aside="<js>NONE"</js>
diff --git 
a/juneau-doc/docs/Topics/07.juneau-rest-server/06.RestMethod/13.RestMethodMatchers.html
 
b/juneau-doc/docs/Topics/07.juneau-rest-server/06.RestMethod/13.RestMethodMatchers.html
index cab3feb..cd4b48a 100644
--- 
a/juneau-doc/docs/Topics/07.juneau-rest-server/06.RestMethod/13.RestMethodMatchers.html
+++ 
b/juneau-doc/docs/Topics/07.juneau-rest-server/06.RestMethod/13.RestMethodMatchers.html
@@ -66,7 +66,7 @@
 
 <h5 class='section'>See Also:</h5>
 <ul>
-       <li class='ja'>{@link oajr.annotation.RestMethod#matchers}
+       <li class='ja'>{@link oajr.annotation.RestMethod#matchers 
RestMethod(matchers)}
        <li class='jc'>{@link oajr.matchers.MultipartFormDataMatcher}
        <li class='jc'>{@link oajr.matchers.UrlEncodedFormMatcher}
 </ul>
diff --git 
a/juneau-doc/docs/Topics/07.juneau-rest-server/08.OpenApiSchemaPartParsing.html 
b/juneau-doc/docs/Topics/07.juneau-rest-server/08.OpenApiSchemaPartParsing.html
index d5c33ca..b385335 100644
--- 
a/juneau-doc/docs/Topics/07.juneau-rest-server/08.OpenApiSchemaPartParsing.html
+++ 
b/juneau-doc/docs/Topics/07.juneau-rest-server/08.OpenApiSchemaPartParsing.html
@@ -20,11 +20,11 @@ OpenAPI Schema Part Parsing
        therefore support OpenAPI syntax and validation:
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link oaj.http.annotation.Header Header}
-       <li class='ja'>{@link oaj.http.annotation.Query Query}
-       <li class='ja'>{@link oaj.http.annotation.FormData FormData}
-       <li class='ja'>{@link oaj.http.annotation.Path Path}
-       <li class='ja'>{@link oaj.http.annotation.Body Body} 
(<code>Content-Type</code> must match <js>"text/openapi"</js>)
+       <li class='ja'>{@link oaj.http.annotation.Header}
+       <li class='ja'>{@link oaj.http.annotation.Query}
+       <li class='ja'>{@link oaj.http.annotation.FormData}
+       <li class='ja'>{@link oaj.http.annotation.Path}
+       <li class='ja'>{@link oaj.http.annotation.Body} 
(<code>Content-Type</code> must match <js>"text/openapi"</js>)
 </ul>
 <p>
        For example, the following shows how a pipe-delimited list of 
comma-delimited numbers (e.g. <js>"1,2,3|4,5,6|7,8,9"</js>) in a query 
parameter can be converted to a 2-dimensional array of <code>Longs</code>:
diff --git 
a/juneau-doc/docs/Topics/07.juneau-rest-server/09.OpenApiSchemaPartSerializing.html
 
b/juneau-doc/docs/Topics/07.juneau-rest-server/09.OpenApiSchemaPartSerializing.html
index 2c05e2e..38df8b8 100644
--- 
a/juneau-doc/docs/Topics/07.juneau-rest-server/09.OpenApiSchemaPartSerializing.html
+++ 
b/juneau-doc/docs/Topics/07.juneau-rest-server/09.OpenApiSchemaPartSerializing.html
@@ -20,8 +20,8 @@ OpenAPI Schema Part Serializing
        therefore support OpenAPI syntax and validation:
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link oaj.http.annotation.ResponseHeader ResponseHeader}
-       <li class='ja'>{@link oaj.http.annotation.Response Response} 
(<code>Accept</code> must match <js>"text/openapi"</js>)
+       <li class='ja'>{@link oaj.http.annotation.ResponseHeader}
+       <li class='ja'>{@link oaj.http.annotation.Response} 
(<code>Accept</code> must match <js>"text/openapi"</js>)
 </ul>
 <p>
        For example, the following shows how a pipe-delimited list of 
comma-delimited numbers (e.g. <js>"1,2,3|4,5,6|7,8,9"</js>) in a response 
header can be converted to a 2-dimensional array of <code>Longs</code>:
diff --git 
a/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations.html 
b/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations.html
index fee802c..b6e3b68 100644
--- a/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations.html
+++ b/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations.html
@@ -19,30 +19,30 @@ HTTP-Part Annotations
        The annotations used for defining the schema for request HTTP parts are:
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link oaj.http.annotation.Body Body}
-       <li class='ja'>{@link oaj.http.annotation.Header Header}
-       <li class='ja'>{@link oaj.http.annotation.FormData FormData}
-       <li class='ja'>{@link oaj.http.annotation.Query Query}
-       <li class='ja'>{@link oaj.http.annotation.Path Path}
-       <li class='ja'>{@link oaj.http.annotation.HasFormData HasFormData}
-       <li class='ja'>{@link oaj.http.annotation.HasQuery HasQuery}
-       <li class='ja'>{@link oaj.http.annotation.Request Request}
+       <li class='ja'>{@link oaj.http.annotation.Body}
+       <li class='ja'>{@link oaj.http.annotation.Header}
+       <li class='ja'>{@link oaj.http.annotation.FormData}
+       <li class='ja'>{@link oaj.http.annotation.Query}
+       <li class='ja'>{@link oaj.http.annotation.Path}
+       <li class='ja'>{@link oaj.http.annotation.HasFormData}
+       <li class='ja'>{@link oaj.http.annotation.HasQuery}
+       <li class='ja'>{@link oaj.http.annotation.Request}
 </ul>
 <p>
        The annotations used for defining the schema for response HTTP parts 
are:
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link oaj.http.annotation.ResponseBody ResponseBody}
-       <li class='ja'>{@link oaj.http.annotation.ResponseHeader ResponseHeader}
-       <li class='ja'>{@link oaj.http.annotation.ResponseStatus ResponseStatus}
-       <li class='ja'>{@link oaj.http.annotation.Response Response}
+       <li class='ja'>{@link oaj.http.annotation.ResponseBody}
+       <li class='ja'>{@link oaj.http.annotation.ResponseHeader}
+       <li class='ja'>{@link oaj.http.annotation.ResponseStatus}
+       <li class='ja'>{@link oaj.http.annotation.Response}
 </ul>
 <p>
        The sub-annotations used in the annotation above are:
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link oaj.jsonschema.annotation.Schema Schema}
-       <li class='ja'>{@link oaj.jsonschema.annotation.Items Items}
+       <li class='ja'>{@link oaj.jsonschema.annotation.Schema}
+       <li class='ja'>{@link oaj.jsonschema.annotation.Items}
 </ul>
 
 <h5 class='section'>Other Notes:</h5>
diff --git 
a/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/01.Body.html
 
b/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/01.Body.html
index 52463fb..a969766 100644
--- 
a/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/01.Body.html
+++ 
b/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/01.Body.html
@@ -19,7 +19,7 @@
        The {@link oaj.http.annotation.Body @Body} annotation is used to 
identify POJOs to be used as the body of an HTTP request.
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link oaj.http.annotation.Body Body}
+       <li class='ja'>{@link oaj.http.annotation.Body}
        <ul>
                <li class='jf'>{@link oaj.http.annotation.Body#api() api} - 
Free-form Swagger JSON.
                <li class='jf'>{@link oaj.http.annotation.Body#description() 
description} - Description.
diff --git 
a/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/02.FormData.html
 
b/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/02.FormData.html
index d8f4811..8abee3e 100644
--- 
a/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/02.FormData.html
+++ 
b/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/02.FormData.html
@@ -19,7 +19,7 @@
        The {@link oaj.http.annotation.FormData @FormData} annotation is used 
to retrieve request form post entries.
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link oaj.http.annotation.FormData FormData}
+       <li class='ja'>{@link oaj.http.annotation.FormData}
        <ul>
                <li class='jf'>{@link oaj.http.annotation.FormData#_default() 
_default} - Default value if not present.
                <li class='jf'>{@link oaj.http.annotation.FormData#_enum() 
_enum} - Input validation.  Must match one of the values.
diff --git 
a/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/03.HasFormData.html
 
b/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/03.HasFormData.html
index 228ba42..7742af6 100644
--- 
a/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/03.HasFormData.html
+++ 
b/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/03.HasFormData.html
@@ -19,7 +19,7 @@
        This annotation can be used to detect the existence of a parameter when 
it's not set to a particular value.
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link oaj.http.annotation.HasFormData HasFormData}
+       <li class='ja'>{@link oaj.http.annotation.HasFormData}
 </ul>
 
 <h5 class='figure'>Example:</h5>
diff --git 
a/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/04.Query.html
 
b/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/04.Query.html
index 2b9bf0f..24e4a6d 100644
--- 
a/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/04.Query.html
+++ 
b/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/04.Query.html
@@ -20,7 +20,7 @@
        <br>It's identical to {@link oaj.http.annotation.FormData @FormData}, 
but only retrieves the parameter from the URL string, not URL-encoded form 
posts.
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link oaj.http.annotation.Query Query}
+       <li class='ja'>{@link oaj.http.annotation.Query}
        <ul>
                <li class='jf'>{@link oaj.http.annotation.Query#_default() 
_default} - Default value if not present.
                <li class='jf'>{@link oaj.http.annotation.Query#_enum() _enum} 
- Input validation.  Must match one of the values.
diff --git 
a/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/05.HasQuery.html
 
b/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/05.HasQuery.html
index 70f20fb..9f8a3b8 100644
--- 
a/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/05.HasQuery.html
+++ 
b/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/05.HasQuery.html
@@ -20,7 +20,7 @@
        URL-encoded form posts.
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link oaj.http.annotation.HasQuery HasQuery}
+       <li class='ja'>{@link oaj.http.annotation.HasQuery}
 </ul>
 <p>
        Unlike {@link oaj.http.annotation.HasFormData @HasFormData}, using this 
annotation does not result in the servlet reading the contents
diff --git 
a/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/06.Header.html
 
b/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/06.Header.html
index b8023d4..c4b3be0 100644
--- 
a/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/06.Header.html
+++ 
b/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/06.Header.html
@@ -19,7 +19,7 @@
        The {@link oaj.http.annotation.Header @Header} annotation is used to 
retrieve request headers.
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link oaj.http.annotation.Header Header}
+       <li class='ja'>{@link oaj.http.annotation.Header}
        <ul>
                <li class='jf'>{@link oaj.http.annotation.Header#_default() 
_default} - Default value if not present.
                <li class='jf'>{@link oaj.http.annotation.Header#_enum() _enum} 
- Input validation.  Must match one of the values.
diff --git 
a/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/07.Path.html
 
b/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/07.Path.html
index 3a4430f..6ae3810 100644
--- 
a/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/07.Path.html
+++ 
b/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/07.Path.html
@@ -19,7 +19,7 @@
        The {@link oaj.http.annotation.Path @Path} annotation is used to 
retrieve request path parameters.
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link oaj.http.annotation.Path Path}
+       <li class='ja'>{@link oaj.http.annotation.Path}
        <ul>
                <li class='jf'>{@link oaj.http.annotation.Path#_enum() _enum} - 
Input validation.  Must match one of the values.
                <li class='jf'>{@link 
oaj.http.annotation.Path#allowEmptyValue() allowEmptyValue} - Input validation. 
 Allow empty value.
diff --git 
a/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/08.Request.html
 
b/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/08.Request.html
index 7a23d34..e6cbc13 100644
--- 
a/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/08.Request.html
+++ 
b/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/08.Request.html
@@ -20,7 +20,7 @@
        to identify it as an interface for retrieving HTTP parts through a 
bean-like interface.
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link oaj.http.annotation.Request Request}
+       <li class='ja'>{@link oaj.http.annotation.Request}
        <ul>
                <li class='jf'>{@link oaj.http.annotation.Request#partParser() 
partParser} - Override the part parser.
        </ul>
diff --git 
a/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/09.Response.html
 
b/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/09.Response.html
index b9e686d..d306484 100644
--- 
a/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/09.Response.html
+++ 
b/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/09.Response.html
@@ -19,7 +19,7 @@
        The {@link oaj.http.annotation.Response @Response} annotation is used 
to identify schema information about an HTTP response.
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link oaj.http.annotation.Response Response}
+       <li class='ja'>{@link oaj.http.annotation.Response}
        <ul>
                <li class='jf'>{@link oaj.http.annotation.Response#api() api} - 
Free-form Swagger JSON.
                <li class='jf'>{@link oaj.http.annotation.Response#code() code} 
- HTTP status code.
diff --git 
a/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/10.ResponseHeader.html
 
b/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/10.ResponseHeader.html
index d4beec6..f8c08a0 100644
--- 
a/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/10.ResponseHeader.html
+++ 
b/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/10.ResponseHeader.html
@@ -19,7 +19,7 @@
        The {@link oaj.http.annotation.ResponseHeader @ResponseHeader} 
annotation can be applied to <ja>@RestMethod</ja>-annotated parameters to 
denote them as an HTTP response headers.
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link oaj.http.annotation.ResponseHeader ResponseHeader}
+       <li class='ja'>{@link oaj.http.annotation.ResponseHeader}
        <ul>
                <li class='jf'>{@link 
oaj.http.annotation.ResponseHeader#_default() _default} - Default value if not 
present.
                <li class='jf'>{@link 
oaj.http.annotation.ResponseHeader#_enum() _enum} - Output validation.  Must 
match one of the values.
diff --git 
a/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/11.ResponseStatus.html
 
b/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/11.ResponseStatus.html
index da02819..51ba6e8 100644
--- 
a/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/11.ResponseStatus.html
+++ 
b/juneau-doc/docs/Topics/07.juneau-rest-server/10.HttpPartAnnotations/11.ResponseStatus.html
@@ -19,7 +19,7 @@
        The {@link oaj.http.annotation.ResponseStatus @ResponseStatus} 
annotation annotation can be applied to <ja>@RestMethod</ja>-annotated 
parameters to denote them as an HTTP response status codes.
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link oaj.http.annotation.ResponseStatus ResponseStatus}
+       <li class='ja'>{@link oaj.http.annotation.ResponseStatus}
 </ul>
 <p>
        This can only be applied to parameters of the {@link oaj.Value} class 
with an {@link java.lang.Integer} type.
diff --git a/juneau-doc/docs/Topics/07.juneau-rest-server/13.Serializers.html 
b/juneau-doc/docs/Topics/07.juneau-rest-server/13.Serializers.html
index 6bb7693..57b6a1f 100644
--- a/juneau-doc/docs/Topics/07.juneau-rest-server/13.Serializers.html
+++ b/juneau-doc/docs/Topics/07.juneau-rest-server/13.Serializers.html
@@ -28,10 +28,10 @@ Serializers
 </p>
 <ul class='doctree'>
        <li class='ja'>
-               {@link oajr.annotation.RestResource#serializers()} 
+               {@link oajr.annotation.RestResource#serializers() 
RestResource(serializers)} 
                - Annotation on resource Java class.
        <li class='ja'>
-               {@link oajr.annotation.RestMethod#serializers()} 
+               {@link oajr.annotation.RestMethod#serializers() 
RestMethod(serializers)} 
                - Annotation on resource Java method.
        <li class='jf'>
                {@link oajr.RestContext#REST_serializers} 
diff --git a/juneau-doc/docs/Topics/07.juneau-rest-server/14.Parsers.html 
b/juneau-doc/docs/Topics/07.juneau-rest-server/14.Parsers.html
index 5eda460..348fd44 100644
--- a/juneau-doc/docs/Topics/07.juneau-rest-server/14.Parsers.html
+++ b/juneau-doc/docs/Topics/07.juneau-rest-server/14.Parsers.html
@@ -28,10 +28,10 @@ Parsers
 </p>
 <ul class='doctree'>
        <li class='ja'>
-               {@link oajr.annotation.RestResource#parsers()} 
+               {@link oajr.annotation.RestResource#parsers() 
RestResource(parsers)} 
                - Annotation on resource Java class.
        <li class='ja'>
-               {@link oajr.annotation.RestMethod#parsers()} 
+               {@link oajr.annotation.RestMethod#parsers() 
RestMethod(parsers)} 
                - Annotation on resource Java method.
        <li class='jm'>
                {@link oajr.RestContextBuilder#parsers(Class[])} 
diff --git a/juneau-doc/docs/Topics/07.juneau-rest-server/15.Properties.html 
b/juneau-doc/docs/Topics/07.juneau-rest-server/15.Properties.html
index 7148037..717bb57 100644
--- a/juneau-doc/docs/Topics/07.juneau-rest-server/15.Properties.html
+++ b/juneau-doc/docs/Topics/07.juneau-rest-server/15.Properties.html
@@ -23,7 +23,7 @@ Properties
        These properties can be defined for serializers and parsers registered 
on a REST resource via the following:
 </p>
 <ul>
-       <li class='ja'>{@link oajr.annotation.RestResource#properties()} 
+       <li class='ja'>{@link oajr.annotation.RestResource#properties() 
RestResource(properties)} 
        <li class='jc'>{@link oajr.RestContextBuilder} - Various methods on the 
context builder.
 </ul>
 <h5 class='figure'>Example:</h5>
@@ -68,7 +68,7 @@ Properties
        Properties can also be overridden at the Java method level:
 </p>
 <ul>
-       <li class='ja'>{@link oajr.annotation.RestMethod#properties()} 
+       <li class='ja'>{@link oajr.annotation.RestMethod#properties() 
RestMethod(properties)} 
        <li class='jc'>{@link oajr.RequestProperties} 
 </ul>
 <p class='bpcode w800'>
@@ -120,8 +120,8 @@ Properties
 </ul>
 <h5 class='section'>See Also:</h5>
 <ul>
-       <li class='ja'>{@link oajr.annotation.RestResource#flags()} - Shorthand 
for boolean properties.
-       <li class='ja'>{@link oajr.annotation.RestMethod#flags()} - Shorthand 
for boolean properties.
+       <li class='ja'>{@link oajr.annotation.RestResource#flags() 
RestResource(flags)} - Shorthand for boolean properties.
+       <li class='ja'>{@link oajr.annotation.RestMethod#flags() 
RestMethod(flags)} - Shorthand for boolean properties.
        <li class='jc'>{@link oajr.RestContextProperties} 
        <li class='jc'>{@link oajr.RestMethodProperties} 
        <li class='jc'>{@link oajr.RequestProperties} 
diff --git a/juneau-doc/docs/Topics/07.juneau-rest-server/16.Transforms.html 
b/juneau-doc/docs/Topics/07.juneau-rest-server/16.Transforms.html
index 05f96f9..1e270f2 100644
--- a/juneau-doc/docs/Topics/07.juneau-rest-server/16.Transforms.html
+++ b/juneau-doc/docs/Topics/07.juneau-rest-server/16.Transforms.html
@@ -23,10 +23,10 @@ Transforms
        Transforms are associated serializers and parsers registered on a REST 
resource via the following:
 </p>
 <ul>
-       <li class='ja'>{@link oajr.annotation.RestResource#beanFilters()} 
-       <li class='ja'>{@link oajr.annotation.RestResource#pojoSwaps()} 
-       <li class='ja'>{@link oajr.annotation.RestMethod#beanFilters()} 
-       <li class='ja'>{@link oajr.annotation.RestMethod#pojoSwaps()}
+       <li class='ja'>{@link oajr.annotation.RestResource#beanFilters() 
RestResource(beanFilters)} 
+       <li class='ja'>{@link oajr.annotation.RestResource#pojoSwaps() 
RestResource(pojoSwaps)} 
+       <li class='ja'>{@link oajr.annotation.RestMethod#beanFilters() 
RestMethod(beanFilters)} 
+       <li class='ja'>{@link oajr.annotation.RestMethod#pojoSwaps() 
RestMethod(pojoSwaps)}
        <li class='jm'>{@link oajr.RestContextBuilder#beanFilters(Object...)} 
        <li class='jm'>{@link oajr.RestContextBuilder#pojoSwaps(Object...)} 
 </ul>
diff --git a/juneau-doc/docs/Topics/07.juneau-rest-server/17.URIs.html 
b/juneau-doc/docs/Topics/07.juneau-rest-server/17.URIs.html
index b8017ad..d8cd43a 100644
--- a/juneau-doc/docs/Topics/07.juneau-rest-server/17.URIs.html
+++ b/juneau-doc/docs/Topics/07.juneau-rest-server/17.URIs.html
@@ -94,5 +94,4 @@ URIs
 <p>
        URIs are resolved by both regular and part serializers.
 </p>
-</p>
 
diff --git a/juneau-doc/docs/Topics/07.juneau-rest-server/18.Guards.html 
b/juneau-doc/docs/Topics/07.juneau-rest-server/18.Guards.html
index 560305e..06cee32 100644
--- a/juneau-doc/docs/Topics/07.juneau-rest-server/18.Guards.html
+++ b/juneau-doc/docs/Topics/07.juneau-rest-server/18.Guards.html
@@ -22,8 +22,8 @@ Guards
        Guards are associated with resource classes and methods via the 
following:
 </p>
 <ul>
-       <li class='ja'>{@link oajr.annotation.RestResource#guards()} 
-       <li class='ja'>{@link oajr.annotation.RestMethod#guards()} 
+       <li class='ja'>{@link oajr.annotation.RestResource#guards() 
RestResource(guards)} 
+       <li class='ja'>{@link oajr.annotation.RestMethod#guards() 
RestMethod(guards)} 
        <li class='jm'>{@link oajr.RestContextBuilder#guards(Class...)} 
 </ul>
 <p class='bpcode w800'>
diff --git a/juneau-doc/docs/Topics/07.juneau-rest-server/19.Converters.html 
b/juneau-doc/docs/Topics/07.juneau-rest-server/19.Converters.html
index fd64c02..92932bf 100644
--- a/juneau-doc/docs/Topics/07.juneau-rest-server/19.Converters.html
+++ b/juneau-doc/docs/Topics/07.juneau-rest-server/19.Converters.html
@@ -22,8 +22,8 @@ Converters
        Converters are associated with resource classes and methods via the 
following:
 </p>
 <ul>
-       <li class='ja'>{@link oajr.annotation.RestResource#converters()} 
-       <li class='ja'>{@link oajr.annotation.RestMethod#converters()} 
+       <li class='ja'>{@link oajr.annotation.RestResource#converters() 
RestResource(converters)} 
+       <li class='ja'>{@link oajr.annotation.RestMethod#converters() 
RestMethod(converters)} 
        <li class='jm'>{@link oajr.RestContextBuilder#converters(Class...)} 
 </ul>
 <h5 class='figure'>Example:</h5>
diff --git 
a/juneau-doc/docs/Topics/07.juneau-rest-server/23.ConfigurationFiles.html 
b/juneau-doc/docs/Topics/07.juneau-rest-server/23.ConfigurationFiles.html
index d7acff9..dc73b0d 100644
--- a/juneau-doc/docs/Topics/07.juneau-rest-server/23.ConfigurationFiles.html
+++ b/juneau-doc/docs/Topics/07.juneau-rest-server/23.ConfigurationFiles.html
@@ -46,7 +46,7 @@ Configuration Files
        Configuration files are associated with REST resources through the 
following:
 </p>
 <ul>
-       <li class='ja'>{@link oajr.annotation.RestResource#config()}
+       <li class='ja'>{@link oajr.annotation.RestResource#config() 
RestResource(config)}
 </ul>
 
 <h5 class='figure'>Example:</h5>
@@ -177,5 +177,5 @@ Configuration Files
 </p>
 <h5 class='section'>See Also:</h5>
 <ul class='doctree'>
-       {@doc juneau-config}
+       <li>{@doc juneau-config}
 </ul>
diff --git 
a/juneau-doc/docs/Topics/07.juneau-rest-server/25.ClientVersioning.html 
b/juneau-doc/docs/Topics/07.juneau-rest-server/25.ClientVersioning.html
index 4567491..e7c23bc 100644
--- a/juneau-doc/docs/Topics/07.juneau-rest-server/25.ClientVersioning.html
+++ b/juneau-doc/docs/Topics/07.juneau-rest-server/25.ClientVersioning.html
@@ -23,9 +23,9 @@ Client Versioning
        The APIs involved with defining client version headers are:
 </p>
 <ul>
-       <li class='ja'>{@link 
oajr.annotation.RestResource#clientVersionHeader()}
+       <li class='ja'>{@link 
oajr.annotation.RestResource#clientVersionHeader() 
RestResource(clientVersionHeader)}
        <li class='jm'>{@link 
oajr.RestContextBuilder#clientVersionHeader(String)}
-       <li class='ja'>{@link oajr.annotation.RestMethod#clientVersion()}
+       <li class='ja'>{@link oajr.annotation.RestMethod#clientVersion() 
RestMethod(clientVersion)}
 </ul>
 <h5 class='figure'>Example:</h5>
 <p class='bpcode w800'>
diff --git 
a/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/01.BasicRestServlet.html
 
b/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/01.BasicRestServlet.html
index da96905..1075078 100644
--- 
a/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/01.BasicRestServlet.html
+++ 
b/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/01.BasicRestServlet.html
@@ -53,7 +53,7 @@ BasicRestServlet
                                <jc>// Override the nav links for the swagger 
page.</jc>
                                navlinks={
                                        <js>"back: servlet:/"</js>,
-                                       <js>"json: 
servlet:/?method=OPTIONS&Accept=text/json&plainText=true"</js>
+                                       <js>"json: 
servlet:/?method=OPTIONS&amp;Accept=text/json&amp;plainText=true"</js>
                                },
                                <jc>// Never show aside contents of page 
inherited from class.</jc>
                                aside=<js>"NONE"</js>
diff --git 
a/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/05.Parameters.html 
b/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/05.Parameters.html
index 2476124..7a0a950 100644
--- a/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/05.Parameters.html
+++ b/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/05.Parameters.html
@@ -34,7 +34,7 @@ Parameters
                                        <js>"Search."</js>,
                                        <js>"Key/value pairs representing 
column names and search tokens."</js>,
                                        <js>"'*' and '?' can be used as 
meta-characters in string fields."</js>,
-                                       <js>"'>', '>=', '<', and '<=' can be 
used as limits on numeric and date fields."</js>,
+                                       <js>"'&gt;', '&gt;=', '&lt;', and 
'&lt;=' can be used as limits on numeric and date fields."</js>,
                                        <js>"Date fields can be matched with 
partial dates (e.g. '2018' to match any date in the year 2018)."</js>
                                },
                                type=<js>"array"</js>,
@@ -99,7 +99,7 @@ Parameters
                                        + <js>"Search.\n"</js>
                                        + <js>"Key/value pairs representing 
column names and search tokens.\n"</js>
                                        + <js>"\\'*\\' and \\'?\\' can be used 
as meta-characters in string fields.\n"</js>
-                                       + <js>"\\'>\\', \\'>=\\', \\'<\\', and 
\\'<=\\' can be used as limits on numeric and date fields.\n"</js>
+                                       + <js>"\\'&gt;\\', \\'&gt;=\\', 
\\'&lt;\\', and \\'&lt;=\\' can be used as limits on numeric and date 
fields.\n"</js>
                                        + <js>"Date fields can be matched with 
partial dates (e.g. \\'2018\\' to match any date in the year 2018)."</js>
                                + <js>"',"</js>
                                + <js>"type:'array',"</js>
diff --git 
a/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/06.ParameterExamples.html
 
b/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/06.ParameterExamples.html
index 8a28bfb..006218d 100644
--- 
a/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/06.ParameterExamples.html
+++ 
b/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/06.ParameterExamples.html
@@ -33,7 +33,7 @@ Parameter Examples
                                        <js>"Search."</js>,
                                        <js>"Key/value pairs representing 
column names and search tokens."</js>,
                                        <js>"'*' and '?' can be used as 
meta-characters in string fields."</js>,
-                                       <js>"'>', '>=', '<', and '<=' can be 
used as limits on numeric and date fields."</js>,
+                                       <js>"'&gt;', '&gt;=', '&lt;', and 
'&lt;=' can be used as limits on numeric and date fields."</js>,
                                        <js>"Date fields can be matched with 
partial dates (e.g. '2018' to match any date in the year 2018)."</js>
                                },
                                type=<js>"array"</js>,
@@ -141,10 +141,10 @@ Parameter Examples
                                        <jok>"x-examples"</jok>: {
                                                <jok>"application/json"</jok>: 
<jov>"{\n\t\"name\": \"Doggie\",\n\t\"species\": \"Dog\",\n\t\"price\": 
9.99,\n\t\"tags\": [\n..."</jov>,
                                                
<jok>"application/json+simple"</jok>: <jov>"{\n\tname: 'Doggie',\n\tspecies: 
'Dog',\n\tprice: 9.99,\n\ttags: [\n\t\t'friendly..."</jov>,
-                                               <jok>"text/xml"</jok>: 
<jov>"&lt;?xml version=\"1.0\" 
encoding=\"UTF-8\"?&gt;\n&lt;object&gt;\n\t&lt;name&gt;Doggie&lt;/name&..."</jov>,
+                                               <jok>"text/xml"</jok>: 
<jov>"&lt;?xml version=\"1.0\" 
encoding=\"UTF-8\"?&gt;\n&lt;object&gt;\n\t&lt;name&gt;Doggie&lt;/name&amp;..."</jov>,
                                                
<jok>"text/html+stripped"</jok>: 
<jov>"&lt;table&gt;\n\t&lt;tr&gt;\n\t\t&lt;td&gt;name&lt;/td&gt;\n\t\t&lt;td&gt;Doggie&lt;/t..."</jov>,
                                                <jok>"text/uon"</jok>: 
<jov>"(\n\tname=Doggie,\n\tspecies=Dog,\n\tprice=9.99,\n\ttags=@(\n\t\tfriendly,\n\t\tcute\n\t)\n)"</jov>,
-                                               
<jok>"application/x-www-form-urlencoded"</jok>: 
<jov>"name=Doggie\n&species=Dog\n&price=9.99\n&tags=@(\n\tfriendly,\n\tcute\n)"</jov>,
+                                               
<jok>"application/x-www-form-urlencoded"</jok>: 
<jov>"name=Doggie\n&amp;species=Dog\n&amp;price=9.99\n&amp;tags=@(\n\tfriendly,\n\tcute\n)"</jov>,
                                                <jok>"text/openapi"</jok>: 
<jov>"(\n\tname=Doggie,\n\tspecies=Dog,\n\tprice=9.99,\n\ttags=@(\n\t\tfriendly,\n\t\tcute\n\t)\n)"</jov>,
                                                <jok>"octal/msgpack"</jok>: 
<jov>"84 A4 6E 61 6D 65 A6 44 6F 67 67 69 65 A7 73 70 65 63 69 65 73 A3 44 6F 
67 A5 70 72 69 63 6..."</jov>,
                                                <jok>"text/plain"</jok>: 
<jov>"{name:'Doggie',species:'Dog',price:9.99,tags:['friendly','cute']}"</jov>,
diff --git 
a/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/08.ResponseExamples.html
 
b/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/08.ResponseExamples.html
index dfe89c7..a9135f3 100644
--- 
a/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/08.ResponseExamples.html
+++ 
b/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/08.ResponseExamples.html
@@ -52,7 +52,7 @@ Response Examples
                                                <jok>"text/xml"</jok>: 
<jov>"&lt;?xml version=\"1.0\" 
encoding=\"UTF-8\"?&gt;\n&lt;Pet&gt;\n\t&lt;id&gt;123&lt;/id&gt;\n\t&lt;spec..."</jov>,
                                                <jok>"text/xml+schema"</jok>: 
<jov>"&lt;schema xmlns=\"http://www.w3.org/2001/XMLSchema\"; 
targetNamespace=\"http://www.apache.org/...";</jov>,
                                                <jok>"text/uon"</jok>: 
<jov>"(\n\tid=123,\n\tspecies=(\n\t\tname=Dog,\n\t\tid=123\n\t),\n\tname=Doggie,\n\ttags=@(\n\t\t(\n\t\t\tn..."</jov>,
-                                               
<jok>"application/x-www-form-urlencoded"</jok>: 
<jov>"id=123\n&species=(\n\tname=Dog,\n\tid=123\n)\n&name=Doggie\n&tags=@(\n\t(\n\..."</jov>,
+                                               
<jok>"application/x-www-form-urlencoded"</jok>: 
<jov>"id=123\n&amp;species=(\n\tname=Dog,\n\tid=123\n)\n&amp;name=Doggie\n&amp;tags=@(\n\t(\n\..."</jov>,
                                                <jok>"text/openapi"</jok>: 
<jov>"(\n\tid=123,\n\tspecies=(\n\t\tname=Dog,\n\t\tid=123\n\t),\n\tname=Doggie,\n\ttags=@(\n\t\t(\n\t\..."</jov>,
                                                <jok>"octal/msgpack"</jok>: 
<jov>"86 A2 69 64 7B A7 73 70 65 63 69 65 73 82 A4 6E 61 6D 65 A3 44 6F 67 A2 
69 64 7B A4 6E 61 6D 65 ..."</jov>,
                                                <jok>"text/xml+soap"</jok>: 
<jov>"&lt;?xml version=\"1.0\" encoding=\"UTF-8\"?&gt;\n&lt;Envelope 
soap=\"http://www.w3.org/2003/05/...";</jov>,
diff --git 
a/juneau-doc/docs/Topics/07.juneau-rest-server/28.HtmlDocAnnotation.html 
b/juneau-doc/docs/Topics/07.juneau-rest-server/28.HtmlDocAnnotation.html
index 0891556..e3842f0 100644
--- a/juneau-doc/docs/Topics/07.juneau-rest-server/28.HtmlDocAnnotation.html
+++ b/juneau-doc/docs/Topics/07.juneau-rest-server/28.HtmlDocAnnotation.html
@@ -21,8 +21,8 @@
        <br>It's used in the following locations:
 </p>
 <ul>
-       <li class='ja'>{@link oajr.annotation.RestResource#htmldoc()}
-       <li class='ja'>{@link oajr.annotation.RestMethod#htmldoc()}
+       <li class='ja'>{@link oajr.annotation.RestResource#htmldoc() 
RestResource(htmldoc)}
+       <li class='ja'>{@link oajr.annotation.RestMethod#htmldoc() 
RestMethod(htmldoc)}
 </ul>
 <p>
        The annotation itself is just a convenience for setting configuration 
properties set
diff --git 
a/juneau-doc/docs/Topics/07.juneau-rest-server/28.HtmlDocAnnotation/02.Widgets.html
 
b/juneau-doc/docs/Topics/07.juneau-rest-server/28.HtmlDocAnnotation/02.Widgets.html
index acda55c..d0f821b 100644
--- 
a/juneau-doc/docs/Topics/07.juneau-rest-server/28.HtmlDocAnnotation/02.Widgets.html
+++ 
b/juneau-doc/docs/Topics/07.juneau-rest-server/28.HtmlDocAnnotation/02.Widgets.html
@@ -21,7 +21,7 @@ Widgets
 <br>They are registered in the following locations:
 </p>
 <ul>
-       <li class='ja'>{@link oajr.annotation.HtmlDoc#widgets() 
@HtmlDoc.widgets}
+       <li class='ja'>{@link oajr.annotation.HtmlDoc#widgets() 
HtmlDoc(widgets)}
        <li class='jm'>{@link oajr.RestContextBuilder#widgets(Class...)}
        <li class='jm'>{@link oajr.RestContextBuilder#widgets(Widget...)}
        <li class='jf'>{@link oajr.RestContext#REST_widgets}
diff --git 
a/juneau-doc/docs/Topics/07.juneau-rest-server/29.DefaultHeaders.html 
b/juneau-doc/docs/Topics/07.juneau-rest-server/29.DefaultHeaders.html
index 71fda82..c11890b 100644
--- a/juneau-doc/docs/Topics/07.juneau-rest-server/29.DefaultHeaders.html
+++ b/juneau-doc/docs/Topics/07.juneau-rest-server/29.DefaultHeaders.html
@@ -20,10 +20,10 @@ Default Headers
 </p>
 <ul class='doctree'>
        <li class='ja'>
-               {@link oajr.annotation.RestResource#defaultRequestHeaders() 
@RestResource(defaultRequestHeaders)} 
+               {@link oajr.annotation.RestResource#defaultRequestHeaders() 
RestResource(defaultRequestHeaders)} 
                <br>Defines default headers on request when the client doesn't 
specify them.
        <li class='ja'>
-               {@link oajr.annotation.RestResource#defaultResponseHeaders() 
@RestResource(defaultResponseHeaders)}
+               {@link oajr.annotation.RestResource#defaultResponseHeaders() 
RestResource(defaultResponseHeaders)}
                <br>Appends the specified headers if they weren't already set 
programmatically. 
 </ul>          
 
diff --git a/juneau-doc/docs/Topics/10.juneau-rest-client/01.RestProxies.html 
b/juneau-doc/docs/Topics/10.juneau-rest-client/01.RestProxies.html
index a59d97a..92428bc 100644
--- a/juneau-doc/docs/Topics/10.juneau-rest-client/01.RestProxies.html
+++ b/juneau-doc/docs/Topics/10.juneau-rest-client/01.RestProxies.html
@@ -43,13 +43,13 @@ REST Proxies
        </ul>
        <li class='jp'>{@link oaj.http.annotation}
        <ul>
-               <li class='ja'>{@link oaj.http.annotation.Body Body}
-               <li class='ja'>{@link oaj.http.annotation.Header Header}
-               <li class='ja'>{@link oaj.http.annotation.FormData FormData}
-               <li class='ja'>{@link oaj.http.annotation.Query Query}
-               <li class='ja'>{@link oaj.http.annotation.Path Path}
-               <li class='ja'>{@link oaj.http.annotation.Request Request}
-               <li class='ja'>{@link oaj.http.annotation.Response Response}
+               <li class='ja'>{@link oaj.http.annotation.Body}
+               <li class='ja'>{@link oaj.http.annotation.Header}
+               <li class='ja'>{@link oaj.http.annotation.FormData}
+               <li class='ja'>{@link oaj.http.annotation.Query}
+               <li class='ja'>{@link oaj.http.annotation.Path}
+               <li class='ja'>{@link oaj.http.annotation.Request}
+               <li class='ja'>{@link oaj.http.annotation.Response}
        </ul>
 </ul>
 
diff --git 
a/juneau-doc/docs/Topics/10.juneau-rest-client/01.RestProxies/03.Body.html 
b/juneau-doc/docs/Topics/10.juneau-rest-client/01.RestProxies/03.Body.html
index 82146da..d52f532 100644
--- a/juneau-doc/docs/Topics/10.juneau-rest-client/01.RestProxies/03.Body.html
+++ b/juneau-doc/docs/Topics/10.juneau-rest-client/01.RestProxies/03.Body.html
@@ -20,7 +20,7 @@
        to denote that they are the HTTP body of the request.
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link oaj.http.annotation.Body Body}
+       <li class='ja'>{@link oaj.http.annotation.Body}
        <ul>
                <li class='jf'>{@link oaj.http.annotation.Body#required() 
required} - Input validation.  Body must be present.
                <li class='jf'>{@link oaj.http.annotation.Body#schema() schema} 
- Swagger schema.
diff --git 
a/juneau-doc/docs/Topics/10.juneau-rest-client/01.RestProxies/04.FormData.html 
b/juneau-doc/docs/Topics/10.juneau-rest-client/01.RestProxies/04.FormData.html
index 50fcf4b..0a21ecc 100644
--- 
a/juneau-doc/docs/Topics/10.juneau-rest-client/01.RestProxies/04.FormData.html
+++ 
b/juneau-doc/docs/Topics/10.juneau-rest-client/01.RestProxies/04.FormData.html
@@ -20,7 +20,7 @@
        to denote that they are form-data parameters on the request.
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link oaj.http.annotation.FormData FormData}
+       <li class='ja'>{@link oaj.http.annotation.FormData}
        <ul>
                <li class='jf'>{@link oaj.http.annotation.FormData#_default() 
_default} - Default value if not present.
                <li class='jf'>{@link oaj.http.annotation.FormData#_enum() 
_enum} - Input validation.  Must match one of the values.
diff --git 
a/juneau-doc/docs/Topics/10.juneau-rest-client/01.RestProxies/05.Query.html 
b/juneau-doc/docs/Topics/10.juneau-rest-client/01.RestProxies/05.Query.html
index 6ca319c..c61144f 100644
--- a/juneau-doc/docs/Topics/10.juneau-rest-client/01.RestProxies/05.Query.html
+++ b/juneau-doc/docs/Topics/10.juneau-rest-client/01.RestProxies/05.Query.html
@@ -20,7 +20,7 @@
        to denote that they are query parameters on the request.
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link oaj.http.annotation.Query Query}
+       <li class='ja'>{@link oaj.http.annotation.Query}
        <ul>
                <li class='jf'>{@link oaj.http.annotation.Query#_default() 
_default} - Default value if not present.
                <li class='jf'>{@link oaj.http.annotation.Query#_enum() _enum} 
- Input validation.  Must match one of the values.
diff --git 
a/juneau-doc/docs/Topics/10.juneau-rest-client/01.RestProxies/06.Header.html 
b/juneau-doc/docs/Topics/10.juneau-rest-client/01.RestProxies/06.Header.html
index 62aa4e7..47c5efd 100644
--- a/juneau-doc/docs/Topics/10.juneau-rest-client/01.RestProxies/06.Header.html
+++ b/juneau-doc/docs/Topics/10.juneau-rest-client/01.RestProxies/06.Header.html
@@ -20,7 +20,7 @@
        to denote that they are header parameters on the request.
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link oaj.http.annotation.Header Header}
+       <li class='ja'>{@link oaj.http.annotation.Header}
        <ul>
                <li class='jf'>{@link oaj.http.annotation.Header#_default() 
_default} - Default value if not present.
                <li class='jf'>{@link oaj.http.annotation.Header#_enum() _enum} 
- Input validation.  Must match one of the values.
diff --git 
a/juneau-doc/docs/Topics/10.juneau-rest-client/01.RestProxies/07.Path.html 
b/juneau-doc/docs/Topics/10.juneau-rest-client/01.RestProxies/07.Path.html
index 47cab6e..63032bf 100644
--- a/juneau-doc/docs/Topics/10.juneau-rest-client/01.RestProxies/07.Path.html
+++ b/juneau-doc/docs/Topics/10.juneau-rest-client/01.RestProxies/07.Path.html
@@ -20,7 +20,7 @@
        to denote that they are path parameters on the request.
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link oaj.http.annotation.Path Path}
+       <li class='ja'>{@link oaj.http.annotation.Path}
        <ul>
                <li class='jf'>{@link oaj.http.annotation.Path#_enum() _enum} - 
Input validation.  Must match one of the values.
                <li class='jf'>{@link 
oaj.http.annotation.Path#allowEmptyValue() allowEmptyValue} - Input validation. 
 Allow empty value.
diff --git 
a/juneau-doc/docs/Topics/10.juneau-rest-client/01.RestProxies/08.Request.html 
b/juneau-doc/docs/Topics/10.juneau-rest-client/01.RestProxies/08.Request.html
index df114f2..1e9e992 100644
--- 
a/juneau-doc/docs/Topics/10.juneau-rest-client/01.RestProxies/08.Request.html
+++ 
b/juneau-doc/docs/Topics/10.juneau-rest-client/01.RestProxies/08.Request.html
@@ -21,7 +21,7 @@
 </p>
 
 <ul class='doctree'>
-       <li class='ja'>{@link oaj.http.annotation.Request Request}
+       <li class='ja'>{@link oaj.http.annotation.Request}
        <ul>
                <li class='jf'>{@link 
oaj.http.annotation.Request#partSerializer() partSerializer} - Override the 
part serializer.
        </ul>
@@ -79,11 +79,11 @@
        Any of the following annotations can be used on the methods:
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link oaj.http.annotation.Body Body}
-       <li class='ja'>{@link oaj.http.annotation.Header Header}
-       <li class='ja'>{@link oaj.http.annotation.FormData FormData}
-       <li class='ja'>{@link oaj.http.annotation.Query Query}
-       <li class='ja'>{@link oaj.http.annotation.Path Path}
+       <li class='ja'>{@link oaj.http.annotation.Body}
+       <li class='ja'>{@link oaj.http.annotation.Header}
+       <li class='ja'>{@link oaj.http.annotation.FormData}
+       <li class='ja'>{@link oaj.http.annotation.Query}
+       <li class='ja'>{@link oaj.http.annotation.Path}
 </ul>
 <p>
        The behavior and functionality of all of the annotations are the same 
as if they were used on method arguments directly.
diff --git 
a/juneau-doc/docs/Topics/10.juneau-rest-client/01.RestProxies/09.Response.html 
b/juneau-doc/docs/Topics/10.juneau-rest-client/01.RestProxies/09.Response.html
index 24a812e..7cf96f8 100644
--- 
a/juneau-doc/docs/Topics/10.juneau-rest-client/01.RestProxies/09.Response.html
+++ 
b/juneau-doc/docs/Topics/10.juneau-rest-client/01.RestProxies/09.Response.html
@@ -19,7 +19,7 @@
        The {@link oaj.http.annotation.Response @Response} annotation can be 
applied to types returned by <ja>@RemoteMethod</ja>-annotated methods.
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link oaj.http.annotation.Response Response}
+       <li class='ja'>{@link oaj.http.annotation.Response}
        <ul>
                <li class='jf'>{@link oaj.http.annotation.Response#partParser() 
partParser} - Override the part parser.
        </ul>
@@ -65,9 +65,9 @@
        Any of the following annotations can be used on the methods:
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link oaj.http.annotation.ResponseBody ResponseBody}
-       <li class='ja'>{@link oaj.http.annotation.ResponseHeader ResponseHeader}
-       <li class='ja'>{@link oaj.http.annotation.ResponseStatus ResponseStatus}
+       <li class='ja'>{@link oaj.http.annotation.ResponseBody}
+       <li class='ja'>{@link oaj.http.annotation.ResponseHeader}
+       <li class='ja'>{@link oaj.http.annotation.ResponseStatus}
 </ul>
 <p>
        The behavior and functionality of all of the annotations are the same 
as if they were used on method arguments directly. This means full support for 
OpenAPI serialization and validation.
diff --git a/juneau-doc/docs/Topics/11.juneau-microservice-core.html 
b/juneau-doc/docs/Topics/11.juneau-microservice-core.html
index c3f21ee..61dde09 100644
--- a/juneau-doc/docs/Topics/11.juneau-microservice-core.html
+++ b/juneau-doc/docs/Topics/11.juneau-microservice-core.html
@@ -38,3 +38,17 @@
        Juneau Microservice is an API for creating stand-alone executable jars 
with automatic support for
        Juneau configurations and console commands.
 </p>
+
+<p>
+       Features include:
+</p>
+<ul class='spaced-list'>
+       <li>
+               A builder-based API for defining and starting microservices.
+       <li>
+               An extensible API that allows you to hook into various 
lifecycle events.
+       <li>
+               Simple-to-use APIs for accessing manifest file entries, 
command-line arguments, and external configuration 
+               file properties.
+</ul>
+
diff --git 
a/juneau-doc/docs/Topics/16.juneau-examples-rest/03.PetStoreResource.html 
b/juneau-doc/docs/Topics/16.juneau-examples-rest/03.PetStoreResource.html
index 56c2962..0e83192 100644
--- a/juneau-doc/docs/Topics/16.juneau-examples-rest/03.PetStoreResource.html
+++ b/juneau-doc/docs/Topics/16.juneau-examples-rest/03.PetStoreResource.html
@@ -656,7 +656,7 @@
        For example, selecting <l>APPLICATION/JSON+SIMPLE</l> shows us 
simplified JSON:
 </p>
 <p class='bpcode w800'>
-       
http://localhost:10000/petstore/pet?plainText=true&Accept=application%2Fjson%2Bsimple
+       
http://localhost:10000/petstore/pet?plainText=true&amp;Accept=application%2Fjson%2Bsimple
 </p>                   
 <img class='bordered w800' 
src='doc-files/juneau-examples-rest.PetStoreResource.5b.png'>
 <p>
@@ -715,7 +715,7 @@
                <ja>@Override</ja> <jc>/* MenuItemWidget */</jc>
                <jk>public</jk> Div getContent(RestRequest req) {
                        Div div = <jsm>div</jsm>();
-                       Set&lt;MediaType&gt; l = <jk>new</jk> TreeSet<>();
+                       Set&lt;MediaType&gt; l = <jk>new</jk> TreeSet&lt;&gt;();
                        <jk>for</jk> (Serializer s : 
req.getSerializers().getSerializers())
                                l.add(s.getPrimaryMediaType());
                        <jk>for</jk> (MediaType mt : l) {
@@ -761,7 +761,7 @@
        The converter will take the POJOs to be serialized and filter them 
based on the provided query/view/sort/paging attributes:
 </p>
 <p class='bpcode w800'>
-       
http://localhost:10000/petstore/pet?s=name%3DHoppy*&v=species%2Cname&o=name&p=0&l=20
+       
http://localhost:10000/petstore/pet?s=name%3DHoppy*&amp;v=species%2Cname&amp;o=name&amp;p=0&amp;l=20
 </p>                   
 <img class='bordered w800' 
src='doc-files/juneau-examples-rest.PetStoreResource.7b.png'>
 <p>
@@ -963,7 +963,7 @@
        <jk>public class</jk> PhotosResource <jk>extends</jk> BasicRestServlet {
        
                <jd>/** Our cache of photos */</jd>
-               <jk>private</jk> Map&lt;String,Photo&gt; <jf>photos</jf> = 
<jk>new</jk> TreeMap<>();
+               <jk>private</jk> Map&lt;String,Photo&gt; <jf>photos</jf> = 
<jk>new</jk> TreeMap&lt;&gt;();
        
                <jd>/** Our bean class for storing photos */</jd>
                <jk>public static class</jk> Photo {
@@ -1319,15 +1319,15 @@
                        PostInput in
                ) <jk>throws</jk> BadRequest {
 
-               List&lt;Object&gt; results = <jk>new</jk> LinkedList<>();
+               List&lt;Object&gt; results = <jk>new</jk> LinkedList&lt;&gt;();
 
                <jc>// Don't try to submit empty input.</jc>
                <jk>if</jk> (isEmpty(in.<jf>sql</jf>))
                        <jk>return</jk> results;
 
-               <jk>if</jk> (in.<jf>pos</jf> < 1 || in.<jf>pos</jf> > 10000)
+               <jk>if</jk> (in.<jf>pos</jf> &lt; 1 || in.<jf>pos</jf> > 10000)
                        <jk>throw new</jk> BadRequest(<js>"Invalid value for 
position.  Must be between 1-10000"</js>);
-               <jk>if</jk> (in.<jf>limit</jf> < 1 || in.<jf>limit</jf> > 10000)
+               <jk>if</jk> (in.<jf>limit</jf> &lt; 1 || in.<jf>limit</jf> > 
10000)
                        <jk>throw new</jk> BadRequest(<js>"Invalid value for 
limit.  Must be between 1-10000"</js>);
 
                String sql = <jk>null</jk>;
@@ -1341,7 +1341,7 @@
                                        sql = s.trim();
                                        <jk>if</jk> (! sql.isEmpty()) {
                                                Object o = <jk>null</jk>;
-                                               <jk>if</jk> 
(<jf>allowUpdates</jf> || (<jf>allowTempUpdates</jf> && ! 
sql.matches(<js>"(?:i)commit.*"</js>))) {
+                                               <jk>if</jk> 
(<jf>allowUpdates</jf> || (<jf>allowTempUpdates</jf> &amp;&amp; ! 
sql.matches(<js>"(?:i)commit.*"</js>))) {
                                                        <jk>if</jk> 
(st.execute(sql)) {
                                                                <jk>try</jk> 
(ResultSet rs = st.getResultSet()) {
                                                                        o = 
<jk>new</jk> ResultSetList(rs, in.<jf>pos</jf>, in.<jf>limit</jf>, 
<jf>includeRowNums</jf>);
diff --git a/juneau-doc/docs/Topics/18.juneau-examples-rest-springboot.html 
b/juneau-doc/docs/Topics/18.juneau-examples-rest-springboot.html
index 44dbe14..9885f0a 100644
--- a/juneau-doc/docs/Topics/18.juneau-examples-rest-springboot.html
+++ b/juneau-doc/docs/Topics/18.juneau-examples-rest-springboot.html
@@ -21,7 +21,7 @@
 </p>   
 
 <p>
-       The <code>juneau-examples-rest-springboot</code> class contains the 
same examples as <code>juneau-examples-rest</code>
+       The <code>juneau-examples-rest-springboot</code> library contains the 
same examples as <code>juneau-examples-rest</code>
        but also includes the following:
 </p>
 <ul class='spaced-list'>
diff --git a/juneau-doc/docs/overview.html 
b/juneau-doc/docs/overview_template.html
similarity index 100%
rename from juneau-doc/docs/overview.html
rename to juneau-doc/docs/overview_template.html
diff --git a/juneau-doc/juneau-doc.jar b/juneau-doc/juneau-doc.jar
index 7b719c6..feb28d3 100644
Binary files a/juneau-doc/juneau-doc.jar and b/juneau-doc/juneau-doc.jar differ
diff --git 
a/juneau-doc/src/main/java/org/apache/juneau/doc/internal/DocGenerator.java 
b/juneau-doc/src/main/java/org/apache/juneau/doc/internal/DocGenerator.java
index 5fadc78..4019ad7 100644
--- a/juneau-doc/src/main/java/org/apache/juneau/doc/internal/DocGenerator.java
+++ b/juneau-doc/src/main/java/org/apache/juneau/doc/internal/DocGenerator.java
@@ -56,7 +56,7 @@ public class DocGenerator {
                try {
                        long startTime = System.currentTimeMillis();
 
-                       String template = 
IOUtils.readFile("docs/overview.html");
+                       String template = 
IOUtils.readFile("docs/overview_template.html");
 
                        DocStore ds = new DocStore(new File("docs/docs.txt"));
 
@@ -200,10 +200,12 @@ public class DocGenerator {
 
                public Topics(File topicsDir) throws IOException {
                        for (File f : topicsDir.listFiles()) {
-                               if (f.isFile())
-                                       pageFiles.add(new PageFile(null, f, 
docFiles));
-                               else if (f.isDirectory() && 
f.getName().contains("doc-files"))
-                                       
docFiles.addAll(Arrays.asList(f.listFiles()));
+                               if (! f.getName().startsWith(".")) {
+                                       if (f.isFile())
+                                               pageFiles.add(new 
PageFile(null, f, docFiles));
+                                       else if (f.isDirectory() && 
f.getName().contains("doc-files"))
+                                               
docFiles.addAll(Arrays.asList(f.listFiles()));
+                               }
                        }
                }
        }
diff --git a/juneau-doc/src/main/javadoc/overview.html 
b/juneau-doc/src/main/javadoc/overview.html
index 7681f0c..d6cdce4 100644
--- a/juneau-doc/src/main/javadoc/overview.html
+++ b/juneau-doc/src/main/javadoc/overview.html
@@ -1713,28 +1713,28 @@
 </p>
 <ul class='doctree'>
        <li class='ja'>
-               {@link org.apache.juneau.annotation.Swap @Swap} 
+               {@link org.apache.juneau.annotation.Swap} 
                - Used to tailor how non-bean POJOs get interpreted by the 
framework.
        <li class='ja'>
-               {@link org.apache.juneau.annotation.Bean @Bean} 
+               {@link org.apache.juneau.annotation.Bean} 
                - Used to tailor how beans get interpreted by the framework.
        <li class='ja'>
-               {@link org.apache.juneau.annotation.BeanConstructor 
@BeanConstructor} 
+               {@link org.apache.juneau.annotation.BeanConstructor} 
                - Maps constructor arguments to property names on beans with 
read-only properties.
        <li class='ja'>
-               {@link org.apache.juneau.annotation.BeanIgnore @BeanIgnore} 
+               {@link org.apache.juneau.annotation.BeanIgnore} 
                - Ignore classes, fields, and methods from being interpreted as 
bean or bean components.
        <li class='ja'>
-               {@link org.apache.juneau.annotation.BeanProperty @BeanProperty} 
+               {@link org.apache.juneau.annotation.BeanProperty} 
                - Used to tailor how bean properties get interpreted by the 
framework.
        <li class='ja'>
-               {@link org.apache.juneau.annotation.NameProperty @NameProperty} 
+               {@link org.apache.juneau.annotation.NameProperty} 
                - Identifies a setter as a method for setting the name of a 
POJO as it's known by its parent object.
        <li class='ja'>
-               {@link org.apache.juneau.annotation.ParentProperty 
@ParentProperty} 
+               {@link org.apache.juneau.annotation.ParentProperty} 
                - Identifies a setter as a method for adding a parent reference 
to a child object.
        <li class='ja'>
-               {@link org.apache.juneau.annotation.URI @URI} 
+               {@link org.apache.juneau.annotation.URI} 
                - Used to identify a class or bean property as a URI.
 </ul>
 
@@ -3097,7 +3097,7 @@
 </p>
 <ul>
        <li class='jf'>{@link org.apache.juneau.BeanContext#BEAN_beanFilters}
-       <li class='ja'>{@link 
org.apache.juneau.annotation.Bean#interfaceClass() @Bean(interfaceClass)}
+       <li class='ja'>{@link 
org.apache.juneau.annotation.Bean#interfaceClass() Bean(interfaceClass)}
        <li class='jm'>{@link 
org.apache.juneau.transform.BeanFilterBuilder#interfaceClass(Class)}
 </ul>
 <p>
@@ -3200,7 +3200,7 @@
        Stop classes are defined through the following:
 </p>
 <ul>
-       <li class='ja'>{@link org.apache.juneau.annotation.Bean#stopClass() 
@Bean(stopClass)}
+       <li class='ja'>{@link org.apache.juneau.annotation.Bean#stopClass() 
Bean(stopClass)}
        <li class='jf'>{@link 
org.apache.juneau.transform.BeanFilterBuilder#stopClass(Class)}
 </ul>
 <p>
@@ -3359,9 +3359,9 @@
        Bean dictionaries are registered through the following:
 </p>
 <ul>
-       <li class='ja'>{@link 
org.apache.juneau.annotation.BeanProperty#beanDictionary() 
@BeanProperty(beanDictionary)} 
+       <li class='ja'>{@link 
org.apache.juneau.annotation.BeanProperty#beanDictionary() 
BeanProperty(beanDictionary)} 
                - On individual bean properties through the annotation.
-       <li class='ja'>{@link 
org.apache.juneau.annotation.Bean#beanDictionary() @Bean(beanDictionary)} 
+       <li class='ja'>{@link 
org.apache.juneau.annotation.Bean#beanDictionary() Bean(beanDictionary)} 
                - On all properties on a bean and all subclasses.
        <li class='jf'>{@link 
org.apache.juneau.BeanContext#BEAN_beanDictionary} 
                - Configuration property on serializers and parsers.
@@ -3401,7 +3401,7 @@
        The <js>"_type"</js> property name can be overridden through the 
following:
 </p>
 <ul>
-       <li class='ja'>{@link 
org.apache.juneau.annotation.Bean#typePropertyName() @Bean(typePropertyName)} 
+       <li class='ja'>{@link 
org.apache.juneau.annotation.Bean#typePropertyName() Bean(typePropertyName)} 
                - On individual beans through the annotation.
        <li class='jf'>{@link 
org.apache.juneau.BeanContext#BEAN_beanTypePropertyName} 
                - Configuration property on serializers and parsers.
@@ -8710,13 +8710,13 @@
        can be applied to method parameters and class types to define the 
schema for various HTTP parts:
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link org.apache.juneau.http.annotation.Body Body}
-       <li class='ja'>{@link org.apache.juneau.http.annotation.Header Header}
-       <li class='ja'>{@link org.apache.juneau.http.annotation.Query Query}
-       <li class='ja'>{@link org.apache.juneau.http.annotation.FormData 
FormData}
-       <li class='ja'>{@link org.apache.juneau.http.annotation.Path Path}
-       <li class='ja'>{@link org.apache.juneau.http.annotation.Response 
Response}
-       <li class='ja'>{@link org.apache.juneau.http.annotation.ResponseHeader 
ResponseHeader}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.Body}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.Header}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.Query}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.FormData}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.Path}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.Response}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.ResponseHeader}
 </ul>
 
 <!-- 
====================================================================================================
 -->
@@ -10794,7 +10794,7 @@
                                <jc>// Override the nav links for the swagger 
page.</jc>
                                navlinks={
                                        <js>"back: servlet:/"</js>,
-                                       <js>"json: 
servlet:/?method=OPTIONS&Accept=text/json&plainText=true"</js>
+                                       <js>"json: 
servlet:/?method=OPTIONS&amp;Accept=text/json&amp;plainText=true"</js>
                                },
                                <jc>// Never show aside contents of page 
inherited from class.</jc>
                                aside="<js>NONE"</js>
@@ -14519,7 +14519,7 @@
 
 <h5 class='section'>See Also:</h5>
 <ul>
-       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestMethod#matchers}
+       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestMethod#matchers RestMethod(matchers)}
        <li class='jc'>{@link 
org.apache.juneau.rest.matchers.MultipartFormDataMatcher}
        <li class='jc'>{@link 
org.apache.juneau.rest.matchers.UrlEncodedFormMatcher}
 </ul>
@@ -15261,11 +15261,11 @@
        therefore support OpenAPI syntax and validation:
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link org.apache.juneau.http.annotation.Header Header}
-       <li class='ja'>{@link org.apache.juneau.http.annotation.Query Query}
-       <li class='ja'>{@link org.apache.juneau.http.annotation.FormData 
FormData}
-       <li class='ja'>{@link org.apache.juneau.http.annotation.Path Path}
-       <li class='ja'>{@link org.apache.juneau.http.annotation.Body Body} 
(<code>Content-Type</code> must match <js>"text/openapi"</js>)
+       <li class='ja'>{@link org.apache.juneau.http.annotation.Header}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.Query}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.FormData}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.Path}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.Body} 
(<code>Content-Type</code> must match <js>"text/openapi"</js>)
 </ul>
 <p>
        For example, the following shows how a pipe-delimited list of 
comma-delimited numbers (e.g. <js>"1,2,3|4,5,6|7,8,9"</js>) in a query 
parameter can be converted to a 2-dimensional array of <code>Longs</code>:
@@ -15376,8 +15376,8 @@
        therefore support OpenAPI syntax and validation:
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link org.apache.juneau.http.annotation.ResponseHeader 
ResponseHeader}
-       <li class='ja'>{@link org.apache.juneau.http.annotation.Response 
Response} (<code>Accept</code> must match <js>"text/openapi"</js>)
+       <li class='ja'>{@link org.apache.juneau.http.annotation.ResponseHeader}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.Response} 
(<code>Accept</code> must match <js>"text/openapi"</js>)
 </ul>
 <p>
        For example, the following shows how a pipe-delimited list of 
comma-delimited numbers (e.g. <js>"1,2,3|4,5,6|7,8,9"</js>) in a response 
header can be converted to a 2-dimensional array of <code>Longs</code>:
@@ -15447,30 +15447,30 @@
        The annotations used for defining the schema for request HTTP parts are:
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link org.apache.juneau.http.annotation.Body Body}
-       <li class='ja'>{@link org.apache.juneau.http.annotation.Header Header}
-       <li class='ja'>{@link org.apache.juneau.http.annotation.FormData 
FormData}
-       <li class='ja'>{@link org.apache.juneau.http.annotation.Query Query}
-       <li class='ja'>{@link org.apache.juneau.http.annotation.Path Path}
-       <li class='ja'>{@link org.apache.juneau.http.annotation.HasFormData 
HasFormData}
-       <li class='ja'>{@link org.apache.juneau.http.annotation.HasQuery 
HasQuery}
-       <li class='ja'>{@link org.apache.juneau.http.annotation.Request Request}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.Body}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.Header}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.FormData}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.Query}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.Path}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.HasFormData}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.HasQuery}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.Request}
 </ul>
 <p>
        The annotations used for defining the schema for response HTTP parts 
are:
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link org.apache.juneau.http.annotation.ResponseBody 
ResponseBody}
-       <li class='ja'>{@link org.apache.juneau.http.annotation.ResponseHeader 
ResponseHeader}
-       <li class='ja'>{@link org.apache.juneau.http.annotation.ResponseStatus 
ResponseStatus}
-       <li class='ja'>{@link org.apache.juneau.http.annotation.Response 
Response}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.ResponseBody}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.ResponseHeader}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.ResponseStatus}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.Response}
 </ul>
 <p>
        The sub-annotations used in the annotation above are:
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link org.apache.juneau.jsonschema.annotation.Schema 
Schema}
-       <li class='ja'>{@link org.apache.juneau.jsonschema.annotation.Items 
Items}
+       <li class='ja'>{@link org.apache.juneau.jsonschema.annotation.Schema}
+       <li class='ja'>{@link org.apache.juneau.jsonschema.annotation.Items}
 </ul>
 
 <h5 class='section'>Other Notes:</h5>
@@ -15491,7 +15491,7 @@
        The {@link org.apache.juneau.http.annotation.Body @Body} annotation is 
used to identify POJOs to be used as the body of an HTTP request.
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link org.apache.juneau.http.annotation.Body Body}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.Body}
        <ul>
                <li class='jf'>{@link 
org.apache.juneau.http.annotation.Body#api() api} - Free-form Swagger JSON.
                <li class='jf'>{@link 
org.apache.juneau.http.annotation.Body#description() description} - Description.
@@ -15675,7 +15675,7 @@
        The {@link org.apache.juneau.http.annotation.FormData @FormData} 
annotation is used to retrieve request form post entries.
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link org.apache.juneau.http.annotation.FormData 
FormData}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.FormData}
        <ul>
                <li class='jf'>{@link 
org.apache.juneau.http.annotation.FormData#_default() _default} - Default value 
if not present.
                <li class='jf'>{@link 
org.apache.juneau.http.annotation.FormData#_enum() _enum} - Input validation.  
Must match one of the values.
@@ -15849,7 +15849,7 @@
        This annotation can be used to detect the existence of a parameter when 
it's not set to a particular value.
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link org.apache.juneau.http.annotation.HasFormData 
HasFormData}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.HasFormData}
 </ul>
 
 <h5 class='figure'>Example:</h5>
@@ -15922,7 +15922,7 @@
        <br>It's identical to {@link org.apache.juneau.http.annotation.FormData 
@FormData}, but only retrieves the parameter from the URL string, not 
URL-encoded form posts.
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link org.apache.juneau.http.annotation.Query Query}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.Query}
        <ul>
                <li class='jf'>{@link 
org.apache.juneau.http.annotation.Query#_default() _default} - Default value if 
not present.
                <li class='jf'>{@link 
org.apache.juneau.http.annotation.Query#_enum() _enum} - Input validation.  
Must match one of the values.
@@ -16096,7 +16096,7 @@
        URL-encoded form posts.
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link org.apache.juneau.http.annotation.HasQuery 
HasQuery}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.HasQuery}
 </ul>
 <p>
        Unlike {@link org.apache.juneau.http.annotation.HasFormData 
@HasFormData}, using this annotation does not result in the servlet reading the 
contents
@@ -16162,7 +16162,7 @@
        The {@link org.apache.juneau.http.annotation.Header @Header} annotation 
is used to retrieve request headers.
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link org.apache.juneau.http.annotation.Header Header}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.Header}
        <ul>
                <li class='jf'>{@link 
org.apache.juneau.http.annotation.Header#_default() _default} - Default value 
if not present.
                <li class='jf'>{@link 
org.apache.juneau.http.annotation.Header#_enum() _enum} - Input validation.  
Must match one of the values.
@@ -16321,7 +16321,7 @@
        The {@link org.apache.juneau.http.annotation.Path @Path} annotation is 
used to retrieve request path parameters.
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link org.apache.juneau.http.annotation.Path Path}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.Path}
        <ul>
                <li class='jf'>{@link 
org.apache.juneau.http.annotation.Path#_enum() _enum} - Input validation.  Must 
match one of the values.
                <li class='jf'>{@link 
org.apache.juneau.http.annotation.Path#allowEmptyValue() allowEmptyValue} - 
Input validation.  Allow empty value.
@@ -16486,7 +16486,7 @@
        to identify it as an interface for retrieving HTTP parts through a 
bean-like interface.
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link org.apache.juneau.http.annotation.Request Request}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.Request}
        <ul>
                <li class='jf'>{@link 
org.apache.juneau.http.annotation.Request#partParser() partParser} - Override 
the part parser.
        </ul>
@@ -16574,7 +16574,7 @@
        The {@link org.apache.juneau.http.annotation.Response @Response} 
annotation is used to identify schema information about an HTTP response.
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link org.apache.juneau.http.annotation.Response 
Response}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.Response}
        <ul>
                <li class='jf'>{@link 
org.apache.juneau.http.annotation.Response#api() api} - Free-form Swagger JSON.
                <li class='jf'>{@link 
org.apache.juneau.http.annotation.Response#code() code} - HTTP status code.
@@ -16969,7 +16969,7 @@
        The {@link org.apache.juneau.http.annotation.ResponseHeader 
@ResponseHeader} annotation can be applied to <ja>@RestMethod</ja>-annotated 
parameters to denote them as an HTTP response headers.
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link org.apache.juneau.http.annotation.ResponseHeader 
ResponseHeader}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.ResponseHeader}
        <ul>
                <li class='jf'>{@link 
org.apache.juneau.http.annotation.ResponseHeader#_default() _default} - Default 
value if not present.
                <li class='jf'>{@link 
org.apache.juneau.http.annotation.ResponseHeader#_enum() _enum} - Output 
validation.  Must match one of the values.
@@ -17085,7 +17085,7 @@
        The {@link org.apache.juneau.http.annotation.ResponseStatus 
@ResponseStatus} annotation annotation can be applied to 
<ja>@RestMethod</ja>-annotated parameters to denote them as an HTTP response 
status codes.
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link org.apache.juneau.http.annotation.ResponseStatus 
ResponseStatus}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.ResponseStatus}
 </ul>
 <p>
        This can only be applied to parameters of the {@link 
org.apache.juneau.Value} class with an {@link java.lang.Integer} type.
@@ -17258,10 +17258,10 @@
 </p>
 <ul class='doctree'>
        <li class='ja'>
-               {@link 
org.apache.juneau.rest.annotation.RestResource#serializers()} 
+               {@link 
org.apache.juneau.rest.annotation.RestResource#serializers() 
RestResource(serializers)} 
                - Annotation on resource Java class.
        <li class='ja'>
-               {@link 
org.apache.juneau.rest.annotation.RestMethod#serializers()} 
+               {@link 
org.apache.juneau.rest.annotation.RestMethod#serializers() 
RestMethod(serializers)} 
                - Annotation on resource Java method.
        <li class='jf'>
                {@link org.apache.juneau.rest.RestContext#REST_serializers} 
@@ -17326,10 +17326,10 @@
 </p>
 <ul class='doctree'>
        <li class='ja'>
-               {@link 
org.apache.juneau.rest.annotation.RestResource#parsers()} 
+               {@link org.apache.juneau.rest.annotation.RestResource#parsers() 
RestResource(parsers)} 
                - Annotation on resource Java class.
        <li class='ja'>
-               {@link org.apache.juneau.rest.annotation.RestMethod#parsers()} 
+               {@link org.apache.juneau.rest.annotation.RestMethod#parsers() 
RestMethod(parsers)} 
                - Annotation on resource Java method.
        <li class='jm'>
                {@link 
org.apache.juneau.rest.RestContextBuilder#parsers(Class[])} 
@@ -17387,7 +17387,7 @@
        These properties can be defined for serializers and parsers registered 
on a REST resource via the following:
 </p>
 <ul>
-       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestResource#properties()} 
+       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestResource#properties() 
RestResource(properties)} 
        <li class='jc'>{@link org.apache.juneau.rest.RestContextBuilder} - 
Various methods on the context builder.
 </ul>
 <h5 class='figure'>Example:</h5>
@@ -17432,7 +17432,7 @@
        Properties can also be overridden at the Java method level:
 </p>
 <ul>
-       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestMethod#properties()} 
+       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestMethod#properties() 
RestMethod(properties)} 
        <li class='jc'>{@link org.apache.juneau.rest.RequestProperties} 
 </ul>
 <p class='bpcode w800'>
@@ -17484,8 +17484,8 @@
 </ul>
 <h5 class='section'>See Also:</h5>
 <ul>
-       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestResource#flags()} - Shorthand for boolean 
properties.
-       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestMethod#flags()} - Shorthand for boolean 
properties.
+       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestResource#flags() RestResource(flags)} - 
Shorthand for boolean properties.
+       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestMethod#flags() RestMethod(flags)} - 
Shorthand for boolean properties.
        <li class='jc'>{@link org.apache.juneau.rest.RestContextProperties} 
        <li class='jc'>{@link org.apache.juneau.rest.RestMethodProperties} 
        <li class='jc'>{@link org.apache.juneau.rest.RequestProperties} 
@@ -17504,10 +17504,10 @@
        Transforms are associated serializers and parsers registered on a REST 
resource via the following:
 </p>
 <ul>
-       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestResource#beanFilters()} 
-       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestResource#pojoSwaps()} 
-       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestMethod#beanFilters()} 
-       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestMethod#pojoSwaps()}
+       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestResource#beanFilters() 
RestResource(beanFilters)} 
+       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestResource#pojoSwaps() 
RestResource(pojoSwaps)} 
+       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestMethod#beanFilters() 
RestMethod(beanFilters)} 
+       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestMethod#pojoSwaps() RestMethod(pojoSwaps)}
        <li class='jm'>{@link 
org.apache.juneau.rest.RestContextBuilder#beanFilters(Object...)} 
        <li class='jm'>{@link 
org.apache.juneau.rest.RestContextBuilder#pojoSwaps(Object...)} 
 </ul>
@@ -17632,7 +17632,6 @@
 <p>
        URIs are resolved by both regular and part serializers.
 </p>
-</p>
 </div><!-- END: 7.17 - juneau-rest-server.URIs -->
 
 <!-- 
====================================================================================================
 -->
@@ -17646,8 +17645,8 @@
        Guards are associated with resource classes and methods via the 
following:
 </p>
 <ul>
-       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestResource#guards()} 
-       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestMethod#guards()} 
+       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestResource#guards() RestResource(guards)} 
+       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestMethod#guards() RestMethod(guards)} 
        <li class='jm'>{@link 
org.apache.juneau.rest.RestContextBuilder#guards(Class...)} 
 </ul>
 <p class='bpcode w800'>
@@ -17725,8 +17724,8 @@
        Converters are associated with resource classes and methods via the 
following:
 </p>
 <ul>
-       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestResource#converters()} 
-       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestMethod#converters()} 
+       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestResource#converters() 
RestResource(converters)} 
+       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestMethod#converters() 
RestMethod(converters)} 
        <li class='jm'>{@link 
org.apache.juneau.rest.RestContextBuilder#converters(Class...)} 
 </ul>
 <h5 class='figure'>Example:</h5>
@@ -18216,7 +18215,7 @@
        Configuration files are associated with REST resources through the 
following:
 </p>
 <ul>
-       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestResource#config()}
+       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestResource#config() RestResource(config)}
 </ul>
 
 <h5 class='figure'>Example:</h5>
@@ -18347,7 +18346,7 @@
 </p>
 <h5 class='section'>See Also:</h5>
 <ul class='doctree'>
-       {@doc juneau-config}
+       <li>{@doc juneau-config}
 </ul>
 </div><!-- END: 7.23 - juneau-rest-server.ConfigurationFiles -->
 
@@ -18415,9 +18414,9 @@
        The APIs involved with defining client version headers are:
 </p>
 <ul>
-       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestResource#clientVersionHeader()}
+       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestResource#clientVersionHeader() 
RestResource(clientVersionHeader)}
        <li class='jm'>{@link 
org.apache.juneau.rest.RestContextBuilder#clientVersionHeader(String)}
-       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestMethod#clientVersion()}
+       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestMethod#clientVersion() 
RestMethod(clientVersion)}
 </ul>
 <h5 class='figure'>Example:</h5>
 <p class='bpcode w800'>
@@ -18581,7 +18580,7 @@
                                <jc>// Override the nav links for the swagger 
page.</jc>
                                navlinks={
                                        <js>"back: servlet:/"</js>,
-                                       <js>"json: 
servlet:/?method=OPTIONS&Accept=text/json&plainText=true"</js>
+                                       <js>"json: 
servlet:/?method=OPTIONS&amp;Accept=text/json&amp;plainText=true"</js>
                                },
                                <jc>// Never show aside contents of page 
inherited from class.</jc>
                                aside=<js>"NONE"</js>
@@ -18959,7 +18958,7 @@
                                        <js>"Search."</js>,
                                        <js>"Key/value pairs representing 
column names and search tokens."</js>,
                                        <js>"'*' and '?' can be used as 
meta-characters in string fields."</js>,
-                                       <js>"'>', '>=', '<', and '<=' can be 
used as limits on numeric and date fields."</js>,
+                                       <js>"'&gt;', '&gt;=', '&lt;', and 
'&lt;=' can be used as limits on numeric and date fields."</js>,
                                        <js>"Date fields can be matched with 
partial dates (e.g. '2018' to match any date in the year 2018)."</js>
                                },
                                type=<js>"array"</js>,
@@ -19024,7 +19023,7 @@
                                        + <js>"Search.\n"</js>
                                        + <js>"Key/value pairs representing 
column names and search tokens.\n"</js>
                                        + <js>"\\'*\\' and \\'?\\' can be used 
as meta-characters in string fields.\n"</js>
-                                       + <js>"\\'>\\', \\'>=\\', \\'<\\', and 
\\'<=\\' can be used as limits on numeric and date fields.\n"</js>
+                                       + <js>"\\'&gt;\\', \\'&gt;=\\', 
\\'&lt;\\', and \\'&lt;=\\' can be used as limits on numeric and date 
fields.\n"</js>
                                        + <js>"Date fields can be matched with 
partial dates (e.g. \\'2018\\' to match any date in the year 2018)."</js>
                                + <js>"',"</js>
                                + <js>"type:'array',"</js>
@@ -19098,7 +19097,7 @@
                                        <js>"Search."</js>,
                                        <js>"Key/value pairs representing 
column names and search tokens."</js>,
                                        <js>"'*' and '?' can be used as 
meta-characters in string fields."</js>,
-                                       <js>"'>', '>=', '<', and '<=' can be 
used as limits on numeric and date fields."</js>,
+                                       <js>"'&gt;', '&gt;=', '&lt;', and 
'&lt;=' can be used as limits on numeric and date fields."</js>,
                                        <js>"Date fields can be matched with 
partial dates (e.g. '2018' to match any date in the year 2018)."</js>
                                },
                                type=<js>"array"</js>,
@@ -19206,10 +19205,10 @@
                                        <jok>"x-examples"</jok>: {
                                                <jok>"application/json"</jok>: 
<jov>"{\n\t\"name\": \"Doggie\",\n\t\"species\": \"Dog\",\n\t\"price\": 
9.99,\n\t\"tags\": [\n..."</jov>,
                                                
<jok>"application/json+simple"</jok>: <jov>"{\n\tname: 'Doggie',\n\tspecies: 
'Dog',\n\tprice: 9.99,\n\ttags: [\n\t\t'friendly..."</jov>,
-                                               <jok>"text/xml"</jok>: 
<jov>"&lt;?xml version=\"1.0\" 
encoding=\"UTF-8\"?&gt;\n&lt;object&gt;\n\t&lt;name&gt;Doggie&lt;/name&..."</jov>,
+                                               <jok>"text/xml"</jok>: 
<jov>"&lt;?xml version=\"1.0\" 
encoding=\"UTF-8\"?&gt;\n&lt;object&gt;\n\t&lt;name&gt;Doggie&lt;/name&amp;..."</jov>,
                                                
<jok>"text/html+stripped"</jok>: 
<jov>"&lt;table&gt;\n\t&lt;tr&gt;\n\t\t&lt;td&gt;name&lt;/td&gt;\n\t\t&lt;td&gt;Doggie&lt;/t..."</jov>,
                                                <jok>"text/uon"</jok>: 
<jov>"(\n\tname=Doggie,\n\tspecies=Dog,\n\tprice=9.99,\n\ttags=@(\n\t\tfriendly,\n\t\tcute\n\t)\n)"</jov>,
-                                               
<jok>"application/x-www-form-urlencoded"</jok>: 
<jov>"name=Doggie\n&species=Dog\n&price=9.99\n&tags=@(\n\tfriendly,\n\tcute\n)"</jov>,
+                                               
<jok>"application/x-www-form-urlencoded"</jok>: 
<jov>"name=Doggie\n&amp;species=Dog\n&amp;price=9.99\n&amp;tags=@(\n\tfriendly,\n\tcute\n)"</jov>,
                                                <jok>"text/openapi"</jok>: 
<jov>"(\n\tname=Doggie,\n\tspecies=Dog,\n\tprice=9.99,\n\ttags=@(\n\t\tfriendly,\n\t\tcute\n\t)\n)"</jov>,
                                                <jok>"octal/msgpack"</jok>: 
<jov>"84 A4 6E 61 6D 65 A6 44 6F 67 67 69 65 A7 73 70 65 63 69 65 73 A3 44 6F 
67 A5 70 72 69 63 6..."</jov>,
                                                <jok>"text/plain"</jok>: 
<jov>"{name:'Doggie',species:'Dog',price:9.99,tags:['friendly','cute']}"</jov>,
@@ -19393,7 +19392,7 @@
                                                <jok>"text/xml"</jok>: 
<jov>"&lt;?xml version=\"1.0\" 
encoding=\"UTF-8\"?&gt;\n&lt;Pet&gt;\n\t&lt;id&gt;123&lt;/id&gt;\n\t&lt;spec..."</jov>,
                                                <jok>"text/xml+schema"</jok>: 
<jov>"&lt;schema xmlns=\"http://www.w3.org/2001/XMLSchema\"; 
targetNamespace=\"http://www.apache.org/...";</jov>,
                                                <jok>"text/uon"</jok>: 
<jov>"(\n\tid=123,\n\tspecies=(\n\t\tname=Dog,\n\t\tid=123\n\t),\n\tname=Doggie,\n\ttags=@(\n\t\t(\n\t\t\tn..."</jov>,
-                                               
<jok>"application/x-www-form-urlencoded"</jok>: 
<jov>"id=123\n&species=(\n\tname=Dog,\n\tid=123\n)\n&name=Doggie\n&tags=@(\n\t(\n\..."</jov>,
+                                               
<jok>"application/x-www-form-urlencoded"</jok>: 
<jov>"id=123\n&amp;species=(\n\tname=Dog,\n\tid=123\n)\n&amp;name=Doggie\n&amp;tags=@(\n\t(\n\..."</jov>,
                                                <jok>"text/openapi"</jok>: 
<jov>"(\n\tid=123,\n\tspecies=(\n\t\tname=Dog,\n\t\tid=123\n\t),\n\tname=Doggie,\n\ttags=@(\n\t\t(\n\t\..."</jov>,
                                                <jok>"octal/msgpack"</jok>: 
<jov>"86 A2 69 64 7B A7 73 70 65 63 69 65 73 82 A4 6E 61 6D 65 A3 44 6F 67 A2 
69 64 7B A4 6E 61 6D 65 ..."</jov>,
                                                <jok>"text/xml+soap"</jok>: 
<jov>"&lt;?xml version=\"1.0\" encoding=\"UTF-8\"?&gt;\n&lt;Envelope 
soap=\"http://www.w3.org/2003/05/...";</jov>,
@@ -19701,8 +19700,8 @@
        <br>It's used in the following locations:
 </p>
 <ul>
-       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestResource#htmldoc()}
-       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestMethod#htmldoc()}
+       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestResource#htmldoc() RestResource(htmldoc)}
+       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.RestMethod#htmldoc() RestMethod(htmldoc)}
 </ul>
 <p>
        The annotation itself is just a convenience for setting configuration 
properties set
@@ -19870,7 +19869,7 @@
 <br>They are registered in the following locations:
 </p>
 <ul>
-       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.HtmlDoc#widgets() @HtmlDoc.widgets}
+       <li class='ja'>{@link 
org.apache.juneau.rest.annotation.HtmlDoc#widgets() HtmlDoc(widgets)}
        <li class='jm'>{@link 
org.apache.juneau.rest.RestContextBuilder#widgets(Class...)}
        <li class='jm'>{@link 
org.apache.juneau.rest.RestContextBuilder#widgets(Widget...)}
        <li class='jf'>{@link org.apache.juneau.rest.RestContext#REST_widgets}
@@ -20498,10 +20497,10 @@
 </p>
 <ul class='doctree'>
        <li class='ja'>
-               {@link 
org.apache.juneau.rest.annotation.RestResource#defaultRequestHeaders() 
@RestResource(defaultRequestHeaders)} 
+               {@link 
org.apache.juneau.rest.annotation.RestResource#defaultRequestHeaders() 
RestResource(defaultRequestHeaders)} 
                <br>Defines default headers on request when the client doesn't 
specify them.
        <li class='ja'>
-               {@link 
org.apache.juneau.rest.annotation.RestResource#defaultResponseHeaders() 
@RestResource(defaultResponseHeaders)}
+               {@link 
org.apache.juneau.rest.annotation.RestResource#defaultResponseHeaders() 
RestResource(defaultResponseHeaders)}
                <br>Appends the specified headers if they weren't already set 
programmatically. 
 </ul>          
 
@@ -21691,13 +21690,13 @@
        </ul>
        <li class='jp'>{@link org.apache.juneau.http.annotation}
        <ul>
-               <li class='ja'>{@link org.apache.juneau.http.annotation.Body 
Body}
-               <li class='ja'>{@link org.apache.juneau.http.annotation.Header 
Header}
-               <li class='ja'>{@link 
org.apache.juneau.http.annotation.FormData FormData}
-               <li class='ja'>{@link org.apache.juneau.http.annotation.Query 
Query}
-               <li class='ja'>{@link org.apache.juneau.http.annotation.Path 
Path}
-               <li class='ja'>{@link org.apache.juneau.http.annotation.Request 
Request}
-               <li class='ja'>{@link 
org.apache.juneau.http.annotation.Response Response}
+               <li class='ja'>{@link org.apache.juneau.http.annotation.Body}
+               <li class='ja'>{@link org.apache.juneau.http.annotation.Header}
+               <li class='ja'>{@link 
org.apache.juneau.http.annotation.FormData}
+               <li class='ja'>{@link org.apache.juneau.http.annotation.Query}
+               <li class='ja'>{@link org.apache.juneau.http.annotation.Path}
+               <li class='ja'>{@link org.apache.juneau.http.annotation.Request}
+               <li class='ja'>{@link 
org.apache.juneau.http.annotation.Response}
        </ul>
 </ul>
 
@@ -21961,7 +21960,7 @@
        to denote that they are the HTTP body of the request.
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link org.apache.juneau.http.annotation.Body Body}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.Body}
        <ul>
                <li class='jf'>{@link 
org.apache.juneau.http.annotation.Body#required() required} - Input validation. 
 Body must be present.
                <li class='jf'>{@link 
org.apache.juneau.http.annotation.Body#schema() schema} - Swagger schema.
@@ -22056,7 +22055,7 @@
        to denote that they are form-data parameters on the request.
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link org.apache.juneau.http.annotation.FormData 
FormData}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.FormData}
        <ul>
                <li class='jf'>{@link 
org.apache.juneau.http.annotation.FormData#_default() _default} - Default value 
if not present.
                <li class='jf'>{@link 
org.apache.juneau.http.annotation.FormData#_enum() _enum} - Input validation.  
Must match one of the values.
@@ -22164,7 +22163,7 @@
        to denote that they are query parameters on the request.
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link org.apache.juneau.http.annotation.Query Query}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.Query}
        <ul>
                <li class='jf'>{@link 
org.apache.juneau.http.annotation.Query#_default() _default} - Default value if 
not present.
                <li class='jf'>{@link 
org.apache.juneau.http.annotation.Query#_enum() _enum} - Input validation.  
Must match one of the values.
@@ -22275,7 +22274,7 @@
        to denote that they are header parameters on the request.
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link org.apache.juneau.http.annotation.Header Header}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.Header}
        <ul>
                <li class='jf'>{@link 
org.apache.juneau.http.annotation.Header#_default() _default} - Default value 
if not present.
                <li class='jf'>{@link 
org.apache.juneau.http.annotation.Header#_enum() _enum} - Input validation.  
Must match one of the values.
@@ -22372,7 +22371,7 @@
        to denote that they are path parameters on the request.
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link org.apache.juneau.http.annotation.Path Path}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.Path}
        <ul>
                <li class='jf'>{@link 
org.apache.juneau.http.annotation.Path#_enum() _enum} - Input validation.  Must 
match one of the values.
                <li class='jf'>{@link 
org.apache.juneau.http.annotation.Path#allowEmptyValue() allowEmptyValue} - 
Input validation.  Allow empty value.
@@ -22463,7 +22462,7 @@
 </p>
 
 <ul class='doctree'>
-       <li class='ja'>{@link org.apache.juneau.http.annotation.Request Request}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.Request}
        <ul>
                <li class='jf'>{@link 
org.apache.juneau.http.annotation.Request#partSerializer() partSerializer} - 
Override the part serializer.
        </ul>
@@ -22521,11 +22520,11 @@
        Any of the following annotations can be used on the methods:
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link org.apache.juneau.http.annotation.Body Body}
-       <li class='ja'>{@link org.apache.juneau.http.annotation.Header Header}
-       <li class='ja'>{@link org.apache.juneau.http.annotation.FormData 
FormData}
-       <li class='ja'>{@link org.apache.juneau.http.annotation.Query Query}
-       <li class='ja'>{@link org.apache.juneau.http.annotation.Path Path}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.Body}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.Header}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.FormData}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.Query}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.Path}
 </ul>
 <p>
        The behavior and functionality of all of the annotations are the same 
as if they were used on method arguments directly.
@@ -22580,7 +22579,7 @@
        The {@link org.apache.juneau.http.annotation.Response @Response} 
annotation can be applied to types returned by <ja>@RemoteMethod</ja>-annotated 
methods.
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link org.apache.juneau.http.annotation.Response 
Response}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.Response}
        <ul>
                <li class='jf'>{@link 
org.apache.juneau.http.annotation.Response#partParser() partParser} - Override 
the part parser.
        </ul>
@@ -22626,9 +22625,9 @@
        Any of the following annotations can be used on the methods:
 </p>
 <ul class='doctree'>
-       <li class='ja'>{@link org.apache.juneau.http.annotation.ResponseBody 
ResponseBody}
-       <li class='ja'>{@link org.apache.juneau.http.annotation.ResponseHeader 
ResponseHeader}
-       <li class='ja'>{@link org.apache.juneau.http.annotation.ResponseStatus 
ResponseStatus}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.ResponseBody}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.ResponseHeader}
+       <li class='ja'>{@link org.apache.juneau.http.annotation.ResponseStatus}
 </ul>
 <p>
        The behavior and functionality of all of the annotations are the same 
as if they were used on method arguments directly. This means full support for 
OpenAPI serialization and validation.
@@ -23498,6 +23497,19 @@
        Juneau configurations and console commands.
 </p>
 
+<p>
+       Features include:
+</p>
+<ul class='spaced-list'>
+       <li>
+               A builder-based API for defining and starting microservices.
+       <li>
+               An extensible API that allows you to hook into various 
lifecycle events.
+       <li>
+               Simple-to-use APIs for accessing manifest file entries, 
command-line arguments, and external configuration 
+               file properties.
+</ul>
+
 <!-- 
====================================================================================================
 -->
 
 <h3 class='topic new' onclick='toggle(this)'><a 
href='#juneau-microservice-core.Overview' 
id='juneau-microservice-core.Overview'>11.1 - Microservice Overview</a></h3>
@@ -25754,6 +25766,10 @@
                <li class='jc'>{@link 
org.apache.juneau.examples.core.xml.XmlComplexExample} - XmlSerializer and 
XmlParser usage on serialize and deserialize complex Pojo bean.
                <li class='jc'>{@link 
org.apache.juneau.examples.core.xml.XmlConfigurationExample} - XmlSerializers 
configured using properties defined in XmlSerializer class.
        </ul>
+       <li class='jp'>{@link org.apache.juneau.examples.core.dto}
+               <ul>
+                       <li class='jc'>{@link 
org.apache.juneau.examples.core.dto.DtoExample} - Usage of core dto module.
+               </ul>
        <li class='jp'>{@link org.apache.juneau.examples.core.rdf}
        <ul>
                <li class='jc'>{@link 
org.apache.juneau.examples.core.rdf.RdfExample} - RdfXmlSerializer usage on 
serialize simple Pojo bean.
@@ -25761,8 +25777,17 @@
        </ul>
        <li class='jp'>{@link org.apache.juneau.examples.core.html}
                <ul>
-                       <li class='jc'>{@link 
org.apache.juneau.examples.core.html.HtmlSimpleExample} - HtmlSerializer usage 
on serialize simple Pojo bean.
-                       <li class='jc'>{@link 
org.apache.juneau.examples.core.html.HtmlComplexExample} - HtmlSerializer usage 
on serialize complex Pojo bean.
+                       <li class='jc'>{@link 
org.apache.juneau.examples.core.html.HtmlSimpleExample} - HtmlSerializer usage 
on serialize and deserialize simple Pojo bean.
+                       <li class='jc'>{@link 
org.apache.juneau.examples.core.html.HtmlComplexExample} - HtmlSerializer usage 
on serialize and deserialize complex Pojo bean.
+               </ul>
+       <li class='jp'>{@link org.apache.juneau.examples.core.uon}
+               <ul>
+                       <li class='jc'>{@link 
org.apache.juneau.examples.core.uon.UONExample} - UonSerializer usage on 
serialize and deserialize simple Pojo bean.
+                       <li class='jc'>{@link 
org.apache.juneau.examples.core.uon.UONComplexExample} - UonSerializer usage on 
serialize and deserialize complex Pojo bean.
+               </ul>
+       <li class='jp'>{@link org.apache.juneau.examples.core.svl}
+               <ul>
+                       <li class='jc'>{@link 
org.apache.juneau.examples.core.svl.SvlExample} - Usage of Svl module in juneau.
                </ul>
 </ul>
 </div><!-- END: 15.2 - juneau-examples-core.Examples -->
@@ -26663,7 +26688,7 @@
        For example, selecting <l>APPLICATION/JSON+SIMPLE</l> shows us 
simplified JSON:
 </p>
 <p class='bpcode w800'>
-       
http://localhost:10000/petstore/pet?plainText=true&Accept=application%2Fjson%2Bsimple
+       
http://localhost:10000/petstore/pet?plainText=true&amp;Accept=application%2Fjson%2Bsimple
 </p>                   
 <img class='bordered w800' 
src='doc-files/juneau-examples-rest.PetStoreResource.5b.png'>
 <p>
@@ -26722,7 +26747,7 @@
                <ja>@Override</ja> <jc>/* MenuItemWidget */</jc>
                <jk>public</jk> Div getContent(RestRequest req) {
                        Div div = <jsm>div</jsm>();
-                       Set&lt;MediaType&gt; l = <jk>new</jk> TreeSet<>();
+                       Set&lt;MediaType&gt; l = <jk>new</jk> TreeSet&lt;&gt;();
                        <jk>for</jk> (Serializer s : 
req.getSerializers().getSerializers())
                                l.add(s.getPrimaryMediaType());
                        <jk>for</jk> (MediaType mt : l) {
@@ -26768,7 +26793,7 @@
        The converter will take the POJOs to be serialized and filter them 
based on the provided query/view/sort/paging attributes:
 </p>
 <p class='bpcode w800'>
-       
http://localhost:10000/petstore/pet?s=name%3DHoppy*&v=species%2Cname&o=name&p=0&l=20
+       
http://localhost:10000/petstore/pet?s=name%3DHoppy*&amp;v=species%2Cname&amp;o=name&amp;p=0&amp;l=20
 </p>                   
 <img class='bordered w800' 
src='doc-files/juneau-examples-rest.PetStoreResource.7b.png'>
 <p>
@@ -26970,7 +26995,7 @@
        <jk>public class</jk> PhotosResource <jk>extends</jk> BasicRestServlet {
        
                <jd>/** Our cache of photos */</jd>
-               <jk>private</jk> Map&lt;String,Photo&gt; <jf>photos</jf> = 
<jk>new</jk> TreeMap<>();
+               <jk>private</jk> Map&lt;String,Photo&gt; <jf>photos</jf> = 
<jk>new</jk> TreeMap&lt;&gt;();
        
                <jd>/** Our bean class for storing photos */</jd>
                <jk>public static class</jk> Photo {
@@ -27326,15 +27351,15 @@
                        PostInput in
                ) <jk>throws</jk> BadRequest {
 
-               List&lt;Object&gt; results = <jk>new</jk> LinkedList<>();
+               List&lt;Object&gt; results = <jk>new</jk> LinkedList&lt;&gt;();
 
                <jc>// Don't try to submit empty input.</jc>
                <jk>if</jk> (isEmpty(in.<jf>sql</jf>))
                        <jk>return</jk> results;
 
-               <jk>if</jk> (in.<jf>pos</jf> < 1 || in.<jf>pos</jf> > 10000)
+               <jk>if</jk> (in.<jf>pos</jf> &lt; 1 || in.<jf>pos</jf> > 10000)
                        <jk>throw new</jk> BadRequest(<js>"Invalid value for 
position.  Must be between 1-10000"</js>);
-               <jk>if</jk> (in.<jf>limit</jf> < 1 || in.<jf>limit</jf> > 10000)
+               <jk>if</jk> (in.<jf>limit</jf> &lt; 1 || in.<jf>limit</jf> > 
10000)
                        <jk>throw new</jk> BadRequest(<js>"Invalid value for 
limit.  Must be between 1-10000"</js>);
 
                String sql = <jk>null</jk>;
@@ -27348,7 +27373,7 @@
                                        sql = s.trim();
                                        <jk>if</jk> (! sql.isEmpty()) {
                                                Object o = <jk>null</jk>;
-                                               <jk>if</jk> 
(<jf>allowUpdates</jf> || (<jf>allowTempUpdates</jf> && ! 
sql.matches(<js>"(?:i)commit.*"</js>))) {
+                                               <jk>if</jk> 
(<jf>allowUpdates</jf> || (<jf>allowTempUpdates</jf> &amp;&amp; ! 
sql.matches(<js>"(?:i)commit.*"</js>))) {
                                                        <jk>if</jk> 
(st.execute(sql)) {
                                                                <jk>try</jk> 
(ResultSet rs = st.getResultSet()) {
                                                                        o = 
<jk>new</jk> ResultSetList(rs, in.<jf>pos</jf>, in.<jf>limit</jf>, 
<jf>includeRowNums</jf>);
@@ -28170,7 +28195,7 @@
 </p>   
 
 <p>
-       The <code>juneau-examples-rest-springboot</code> class contains the 
same examples as <code>juneau-examples-rest</code>
+       The <code>juneau-examples-rest-springboot</code> library contains the 
same examples as <code>juneau-examples-rest</code>
        but also includes the following:
 </p>
 <ul class='spaced-list'>
@@ -34861,7 +34886,7 @@
                </ul>
 </ul>
 
-<h5 class='topic w800'>juneau-server</h5>
+<h5 class='topic w800'>juneau-rest-server</h5>
 <ul class='spaced-list'>
        <li>
                New methods on {@link org.apache.juneau.rest.RestServlet}:
@@ -34874,6 +34899,12 @@
                <br>This allows for any of those instance to be injectable 
beans.
 </ul>
 
+<h5 class='topic w800'>juneau-rest-server-springboot</h5>
+<ul class='spaced-list'>
+       <li>
+               New project containing classes for making it easy to use Juneau 
with Spring Boot.
+</ul>
+
 <h5 class='topic w800'>juneau-microservice-core</h5>
 <ul class='spaced-list'>
        <li>
@@ -34899,13 +34930,19 @@
                New {@link 
org.apache.juneau.microservice.jetty.JettyMicroservice} class replaces the 
previous <code>RestMicroservice</code>.
 </ul>
 
-<h5 class='topic w800'>juneau-examples-rest</h5>
+<h5 class='topic w800'>juneau-my-jetty-microservice</h5>
+<ul class='spaced-list'>
+       <li>
+               New template starter project for Jetty-based microservices.
+</ul>
+
+<h5 class='topic w800'>juneau-my-springboot-microservice</h5>
 <ul class='spaced-list'>
        <li>
-               New <code>org.apache.juneau.examples.rest.spring</code> package 
with code showing how to use Juneau REST
-               with Spring Boot. 
+               Template starter project for Spring-Boot-based microservices.
        <li>
-               New <code>app.json</code> and <code>Procfile</code> files for 
deploying examples into Heroku.
+               <code>app.json</code> and <code>Procfile</code> files for 
deploying examples into Heroku.
+               <br>Includes instructions.
 </ul>
 </div><!-- END: 8.0.0 -->
 
diff --git a/juneau-doc/src/main/javadoc/resources/fragments/about.html 
b/juneau-doc/src/main/javadoc/resources/fragments/about.html
index abed929..265c3d5 100644
--- a/juneau-doc/src/main/javadoc/resources/fragments/about.html
+++ b/juneau-doc/src/main/javadoc/resources/fragments/about.html
@@ -16,14 +16,34 @@
        Apache Juneau&trade; is a single cohesive Java ecosystem consisting of 
the following parts:
 </p>
 <ul class='spaced-list'>
-       <li><b>juneau-marshall</b><br>A universal toolkit for marshalling POJOs 
to a wide variety of content types using a common framework with no external 
library dependencies.
-       <li><b>juneau-dto</b><br>A variety of predefined DTOs for serializing 
and parsing languages such as HTML5, Swagger and ATOM.
-       <li><b>juneau-svl</b><br>A simple yet powerful variable replacement 
language API.
-       <li><b>juneau-config</b><br>A sophisticated configuration file API.
-       <li><b>juneau-rest-server</b><br>A universal REST server API for 
creating Swagger-based self-documenting REST interfaces using POJOs, simply 
deployed as 
-               one or more top-level servlets in any Servlet 3.1.0+ container 
or Spring Boot.
-       <li><b>juneau-rest-client</b><br>A universal REST client API for 
interacting with Juneau or 3rd-party REST interfaces using POJOs and proxy 
interfaces.
-       <li><b>juneau-microservice</b><br>A REST microservice API that combines 
all the features above as a simple configurable Jetty server for 
+       <li>
+               <b>juneau-marshall</b>
+               <br>A universal toolkit for marshalling POJOs to a wide variety 
of content types using a common framework with no external library dependencies.
+       <li>
+               <b>juneau-dto</b>
+               <br>A variety of predefined DTOs for serializing and parsing 
languages such as HTML5, Swagger and ATOM.
+       <li>
+               <b>juneau-svl</b>
+               <br>A simple yet powerful variable replacement language API.
+       <li>
+               <b>juneau-config</b>
+               <br>A sophisticated configuration API.
+       <li>
+               <b>juneau-rest-server</b>
+               <br>A universal REST server API for creating REST interfaces 
using POJOs simply deployed in any Servlet 3.1.0+ container.
+               <br>Includes auto-generation of Swagger and self-hosting of 
Swagger UI through OPTIONS page requests.
+       <li>
+               <b>juneau-rest-server-springboot</b>
+               <br>Integration support for deploying Juneau-based REST 
resources as Spring beans in a Spring Boot application.
+       <li>
+               <b>juneau-rest-client</b>
+               <br>A universal REST client API for interacting with Juneau or 
3rd-party REST interfaces using POJOs and proxy interfaces.
+       <li>
+               <b>juneau-microservice</b>
+               <br>A builder-based API for creating microservices.
+       <li>
+               <b>juneau-microservice-jetty</b>
+               <br>REST microservice API that combines all the features above 
as a simple configurable Jetty server for 
                creating lightweight standalone REST interfaces that start up 
in milliseconds.
 </ul>
 <p>
diff --git a/juneau-doc/src/main/javadoc/resources/juneau-doc.css 
b/juneau-doc/src/main/javadoc/resources/juneau-doc.css
index aa9848d..5afe1de 100755
--- a/juneau-doc/src/main/javadoc/resources/juneau-doc.css
+++ b/juneau-doc/src/main/javadoc/resources/juneau-doc.css
@@ -332,7 +332,10 @@ l {
 .footer .spaced-list ul { margin:0; max-width: 800px; }
 
 /* Documentation Tree */
-.doctree li { max-width: 800px; }
+.doctree li { 
+       max-width: 800px;
+       margin-top: 0px; 
+}
 li.normal {
     list-style-image:none; 
 }
@@ -377,12 +380,15 @@ li.jp {
 }
 
 .doctree ul { 
-       padding: 5px 0px 5px 20px; 
+       padding: 0px 0px 0px 15px; 
+       margin-top: -2px;
+       margin-bottom: -2px;
 }
 
 ul.doctree {
-       padding: 0px 0px 0px 20px; 
+       padding: 0px 0px 0px 15px; 
        margin-left: 5px;
+       margin-top: -2px;
 }
 
 .topic a {
diff --git 
a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestContext.java
 
b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestContext.java
index e1967df..32a3e60 100644
--- 
a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestContext.java
+++ 
b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestContext.java
@@ -2673,7 +2673,7 @@ public final class RestContext extends BeanContext {
         *      String scheme = request.getScheme();
         *      <jk>int</jk> port = request.getServerPort();
         *      StringBuilder sb = <jk>new</jk> 
StringBuilder(request.getScheme()).append(<js>"://"</js>).append(request.getServerName());
-        *      <jk>if</jk> (! (port == 80 && <js>"http"</js>.equals(scheme) || 
port == 443 && <js>"https"</js>.equals(scheme)))
+        *      <jk>if</jk> (! (port == 80 &amp;&amp; 
<js>"http"</js>.equals(scheme) || port == 443 &amp;&amp; 
<js>"https"</js>.equals(scheme)))
         *              sb.append(<js>':'</js>).append(port);
         *      authorityPath = sb.toString();
         * </p>

Reply via email to