juneau-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From jamesbog...@apache.org
Subject [1/2] juneau git commit: Javadoc updates.
Date Thu, 11 Jan 2018 16:53:40 GMT
Repository: juneau
Updated Branches:
  refs/heads/master c162400e6 -> 8c69d59d6


http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/xml/package.html
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/xml/package.html b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/xml/package.html
index 619e86a..422b16f 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/xml/package.html
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/xml/package.html
@@ -1476,7 +1476,7 @@
 				The {@link org.apache.juneau.xml.annotation.XmlFormat#COLLAPSED} format can be applied to bean properties
 				of type array/Collection.
 				<br>This causes the child objects to be serialized directly inside the bean element.
-				<br>This format must be used in conjunction with {@link org.apache.juneau.xml.annotation.Xml#childName()}
+				<br>This format must be used in conjunction with {@link org.apache.juneau.xml.annotation.Xml#childName() @Xml.childName()}
 				to differentiate which collection the values came from if you plan on parsing the output back into beans.
 				<br>Note that child names must not conflict with other property names.
 			</p>
@@ -2104,8 +2104,8 @@
 			href='annotation/package-summary.html#TOC'>org.apache.juneau.xml.annotation</a> package.
 			<br>Other XML annotations are also modeled after JAXB. 
 			However, since many of the features of JAXB are already implemented for all serializers and parsers
-			at a higher level through various general annotations such as {@link org.apache.juneau.annotation.Bean} 
-			and {@link org.apache.juneau.annotation.BeanProperty} it was decided to maintain separate Juneau XML 
+			at a higher level through various general annotations such as {@link org.apache.juneau.annotation.Bean @Bean} 
+			and {@link org.apache.juneau.annotation.BeanProperty @BeanProperty} it was decided to maintain separate Juneau XML 
 			annotations instead of reusing JAXB annotations.
 			<br>This may change in some future implementation, but for now it was decided that having separate Juneau XML 
 			annotations was less confusing.
@@ -2256,7 +2256,7 @@
 	<xt>&lt;/per:person&gt;</xt>
 		</p>
 		<p>
-			Another useful feature is the {@link org.apache.juneau.annotation.Bean#propertyNamer()} annotation that 
+			Another useful feature is the {@link org.apache.juneau.annotation.Bean#propertyNamer() @Bean.propertyNamer()} annotation that 
 			allows you to plug in your own logic for determining bean property names.
 			<br>The {@link org.apache.juneau.PropertyNamerDLC} is an example of an alternate property namer.
 			It converts bean property names to lowercase-dashed format.

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/yaml/proto/YamlClassMeta.java
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/yaml/proto/YamlClassMeta.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/yaml/proto/YamlClassMeta.java
index b1b22bb..6398cfb 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/yaml/proto/YamlClassMeta.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/yaml/proto/YamlClassMeta.java
@@ -35,9 +35,9 @@ public class YamlClassMeta extends ClassMetaExtended {
 	}
 
 	/**
-	 * Returns the {@link Json} annotation defined on the class.
+	 * Returns the {@link Json @Json} annotation defined on the class.
 	 *
-	 * @return The value of the {@link Json} annotation, or <jk>null</jk> if not specified.
+	 * @return The value of the annotation, or <jk>null</jk> if not specified.
 	 */
 	protected Json getAnnotation() {
 		return json;

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/yaml/proto/package.html
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/yaml/proto/package.html b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/yaml/proto/package.html
index 31dfd1b..0049b28 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/yaml/proto/package.html
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/yaml/proto/package.html
@@ -384,7 +384,7 @@
 	}
 		</p>
 		<p>
-			Another useful feature is the {@link org.apache.juneau.annotation.Bean#propertyNamer()} annotation that 
+			Another useful feature is the {@link org.apache.juneau.annotation.Bean#propertyNamer() @Bean.propertyNamer()} annotation that 
 			allows you to plug in your own logic for determining bean property names.
 			<br>The {@link org.apache.juneau.PropertyNamerDLC} is an example of an alternate property namer.
 			It converts bean property names to lowercase-dashed format.

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-doc/src/main/javadoc/overview.html
----------------------------------------------------------------------
diff --git a/juneau-doc/src/main/javadoc/overview.html b/juneau-doc/src/main/javadoc/overview.html
index 0c9d628..e2c8d9a 100644
--- a/juneau-doc/src/main/javadoc/overview.html
+++ b/juneau-doc/src/main/javadoc/overview.html
@@ -2602,15 +2602,6 @@
  	<ja>@Bean</ja>(typeName=<js>"baz"</js>)
  	<jk>public class</jk> Baz {}
 	 		</p>
-	 		
-	 		<p class='bcode'>
-	 WriterSerializer s = JsonSerializer
-	 	.create()
-	 	.addBeanTypeProperties()
-	 			
-	 		
-	 		
-	 		</p>
 	 		<p>
 	 			When serialized as JSON, <js>"_type"</js> attributes would be added when needed to infer the type during 
 	 			parsing:
@@ -5574,7 +5565,7 @@
 			</p>
 			<p>
 				Child resources must also be subclasses of {@link org.apache.juneau.rest.RestServlet}, and
-				must specify a {@link org.apache.juneau.rest.annotation.RestResource#path()} annotation to 
+				must specify a {@link org.apache.juneau.rest.annotation.RestResource#path() @RestResource.path()} annotation to 
 				identify the subpath of the child.
 				For example, the <l>HelloWorldResource</l> class is annotated as follows:
 			</p>
@@ -9098,7 +9089,7 @@
 			<li>
 				Support for static files has been simplified and improved.
 				<ul>
-					<li>Syntax on {@link org.apache.juneau.rest.annotation.RestResource#staticFiles()} has been simplified, and
+					<li>Syntax on {@link org.apache.juneau.rest.annotation.RestResource#staticFiles() @RestResource.staticFiles()} has been simplified, and
 						now allows you to specify response headers in the strings.
 					<li>Response headers for static files can also be configured through 
 						{@link org.apache.juneau.rest.RestContext#REST_staticFileResponseHeaders REST_staticFileResponseHeaders}.
@@ -9115,7 +9106,7 @@
 				<code>@RestResource.allowMethodParam</code> renamed to {@link org.apache.juneau.rest.annotation.RestResource#allowedMethodParams}.
 			<li>
 				<code>@RestMethod.serializersInherit</code> and <code>@RestMethod.parsersInherit</code> replaced with
-				simplified {@link org.apache.juneau.rest.annotation.RestMethod#inherit()}. 
+				simplified {@link org.apache.juneau.rest.annotation.RestMethod#inherit() @RestMethod.inherit()}. 
 			<li>
 				Changes to {@link org.apache.juneau.rest.RequestFormData}:
 				<ul>
@@ -9162,12 +9153,12 @@
 						{@link org.apache.juneau.rest.RestRequest#getClasspathReaderResource(String) getClasspathReaderResource(String)}
 				</ul>
 			<li>
-				Changes to {@link org.apache.juneau.rest.annotation.RestResource}:
+				Changes to {@link org.apache.juneau.rest.annotation.RestResource @RestResource}:
 				<ul>
 					<li>New {@link org.apache.juneau.rest.annotation.RestResource#mimeTypes() mimeTypes()} annotation.
 				</ul>
 			<li>
-				Changes to {@link org.apache.juneau.rest.annotation.RestMethod}:
+				Changes to {@link org.apache.juneau.rest.annotation.RestMethod @RestMethod}:
 				<ul>
 					<li>New {@link org.apache.juneau.rest.annotation.RestMethod#supportedAcceptTypes() supportedAcceptTypes()} and
 						{@link org.apache.juneau.rest.annotation.RestMethod#supportedContentTypes() supportedContentTypes()}
@@ -9388,7 +9379,7 @@
 			<li>
 				Annotation <code><ja>@HtmlDoc</ja>(links)</code> renamed to {@link org.apache.juneau.rest.annotation.HtmlDoc#navlinks() navlinks}.
 			<li>
-				New annotation {@link org.apache.juneau.rest.annotation.HtmlDoc#head()}.
+				New annotation {@link org.apache.juneau.rest.annotation.HtmlDoc#head() @HtmlDoc.head()}.
 				<br>Allows you to specify arbitrary HTML content in the <xt>&lt;head&gt;</xt> section of the page.
 			<li>
 				Removed annotation <code><ja>@HtmlDoc</ja>(favIcon)</code>.
@@ -10040,7 +10031,7 @@
 				</ul>
 		
 			<li>
-				Bug fix with {@link org.apache.juneau.rest.annotation.HtmlDoc#nowrap()} so that the setting only applies
+				Bug fix with {@link org.apache.juneau.rest.annotation.HtmlDoc#nowrap() @HtmlDoc.nowrap()} so that the setting only applies
 				to the data contents, not the whole page.
 			<li>
 				Two convenience methods added to {@link org.apache.juneau.rest.RestRequest}:
@@ -10052,16 +10043,16 @@
 			<li>
 				Annotations added:
 				<ul>
-					<li>{@link org.apache.juneau.rest.annotation.RestResource#siteName()}
-					<li>{@link org.apache.juneau.rest.annotation.RestResource#flags()}
-					<li>{@link org.apache.juneau.rest.annotation.RestMethod#flags()}
+					<li>{@link org.apache.juneau.rest.annotation.RestResource#siteName() @RestResource.siteName()}
+					<li>{@link org.apache.juneau.rest.annotation.RestResource#flags() @RestResource.flags()}
+					<li>{@link org.apache.juneau.rest.annotation.RestMethod#flags() @RestMethod.flags()}
 				</ul>
 			</li>
 			<li>
 				Eliminated the <code>@RestResource.stylesheet()</code> annotation.  
 				It's no longer needed now that you can easily specify styles via <ja>@Htmldoc</ja>.
 			<li>
-				Eliminated the following annotations since they are now redundant with {@link org.apache.juneau.rest.annotation.HtmlDoc#header()}:
+				Eliminated the following annotations since they are now redundant with {@link org.apache.juneau.rest.annotation.HtmlDoc#header() @HtmlDoc.header()}:
 				<ul>
 					<li><code>title()</code>
 					<li><code>description()</code>
@@ -10214,7 +10205,7 @@
 						<li><code><del>SerializerContext.SERIALIZER_uriResolution</del></code>
 						<li><code><del>SerializerContext.SERIALIZER_maxIndent</del></code>
 				</ul>
-			<li>New annotation property: {@link org.apache.juneau.annotation.BeanProperty#value()}.
+			<li>New annotation property: {@link org.apache.juneau.annotation.BeanProperty#value() @BeanProperty.value()}.
 				<br>The following two annotations are considered equivalent:
 				<p class='bcode'>
 	<ja>@BeanProperty</ja>(name=<js>"foo"</js>)
@@ -10229,11 +10220,11 @@
 				<ul>
 					<li>{@link org.apache.juneau.serializer.SerializerListener}
 					<li>{@link org.apache.juneau.serializer.SerializerBuilder#listener(Class)}
-					<li>{@link org.apache.juneau.rest.annotation.RestResource#serializerListener()}
+					<li>{@link org.apache.juneau.rest.annotation.RestResource#serializerListener() @RestResource.serializerListener()}
 					<li><code><del>RestConfig.serializerListener(Class)</del></code>
 					<li>{@link org.apache.juneau.parser.ParserListener}
 					<li>{@link org.apache.juneau.parser.ParserBuilder#listener(Class)}
-					<li>{@link org.apache.juneau.rest.annotation.RestResource#parserListener()}
+					<li>{@link org.apache.juneau.rest.annotation.RestResource#parserListener() @RestResource.parserListener()}
 					<li><code><del>RestConfig.parserListener(Class)</del></code>
 					<li><code><del>RestClientBuilder.listeners(Class,Class)</del></code>
 				</ul>
@@ -10272,7 +10263,7 @@
 					<li>{@link org.apache.juneau.BeanContext#BEAN_includeProperties BEAN_includeProperties}
 					<li>{@link org.apache.juneau.BeanContext#BEAN_excludeProperties BEAN_excludeProperties}
 				</ul>
-			<li>New annotation property: {@link org.apache.juneau.annotation.BeanProperty#format()}.
+			<li>New annotation property: {@link org.apache.juneau.annotation.BeanProperty#format() @BeanProperty.format()}.
 		</ul>
 
 		<h6 class='topic'>org.apache.juneau.rest</h6>
@@ -10720,7 +10711,7 @@
 	RestClient client = RestClient.<jsm>create</jsm>().rootUrl(<jf>samplesUrl</jf>).build();			
 	IAddressBook ab = client.getRemoteableProxy(IAddressBook.<jk>class</jk>, <js>"/addressBook/myproxy"</js>);
 			</p>
-				See {@link org.apache.juneau.rest.annotation.RestMethod#name()} for more information.
+				See {@link org.apache.juneau.rest.annotation.RestMethod#name() @RestMethod.name()} for more information.
 			<li>{@link org.apache.juneau.rest.RestRequest#toString()} can be called at any time to view the headers and content of the request
 				without affecting functionality.  Very useful for debugging.
 			<li>You can now use numeric values in path annotations.  
@@ -10982,12 +10973,12 @@
 			<li>General improvements to Bean Dictionary support.
 				<ul>
 					<li>New {@link org.apache.juneau.BeanDictionaryList} class can be used for defining reusable sets of bean dictionaries consisting
-						of classes annotated with {@link org.apache.juneau.annotation.Bean#typeName()}.
+						of classes annotated with {@link org.apache.juneau.annotation.Bean#typeName() @Bean.typeName()}.
 					<li>New {@link org.apache.juneau.BeanDictionaryMap} class can be used for defining reusable sets of bean dictionaries consisting
-						of classes not annotated with {@link org.apache.juneau.annotation.Bean#typeName()}.
-					<li>New {@link org.apache.juneau.annotation.Bean#beanDictionary()} annotation.
+						of classes not annotated with {@link org.apache.juneau.annotation.Bean#typeName() @Bean.typeName()}.
+					<li>New {@link org.apache.juneau.annotation.Bean#beanDictionary() @Bean.beanDictionary()} annotation.
 				</ul>
-			<li>Removed restriction on getters and setters to be prefixed with "getX/setX/isX" if a {@link org.apache.juneau.annotation.BeanProperty#name()} annotation is used.
+			<li>Removed restriction on getters and setters to be prefixed with "getX/setX/isX" if a {@link org.apache.juneau.annotation.BeanProperty#name() @BeanProperty.name()} annotation is used.
 			<li>Improvements to ATOM DTO:
 				<ul>
 					<li>New {@link org.apache.juneau.dto.atom.AtomBuilder} class.
@@ -11636,7 +11627,7 @@
 				</ul>
 			<li>New methods in {@link org.apache.juneau.rest.RestServlet}:
 				<ul>
-					<li><code><del>RestServlet.getChildClasses()</del></code>  - Programmatic equivalent to {@link org.apache.juneau.rest.annotation.RestResource#children()} annotation.
+					<li><code><del>RestServlet.getChildClasses()</del></code>  - Programmatic equivalent to {@link org.apache.juneau.rest.annotation.RestResource#children() @RestResource.children()} annotation.
 					<li><code><del>RestServlet.shouldLog(HttpServletRequest,HttpServletResponse,RestException)</del></code> 
 					<li><code><del>RestServlet.shouldLogStackTrace(HttpServletRequest,HttpServletResponse,RestException)</del></code> 
 					<li><code><del>RestServlet.logObjects(Level,String,Object[])</del></code> 
@@ -11650,12 +11641,12 @@
 				from {@link org.apache.juneau.rest.RestServletDefault} and <code><del>RestServletJenaDefault</del></code>.  
 				These may represent a security risk if not handled correctly, so removed
 				them as a precaution.
-			<li>Removed <code>RestServletProperties.REST_htDocsFolder</code>.  Replaced with {@link org.apache.juneau.rest.annotation.RestResource#staticFiles()}.
-			<li>New annotations on {@link org.apache.juneau.rest.annotation.RestResource}.
+			<li>Removed <code>RestServletProperties.REST_htDocsFolder</code>.  Replaced with {@link org.apache.juneau.rest.annotation.RestResource#staticFiles() @RestResource.staticFiles()}.
+			<li>New annotations on {@link org.apache.juneau.rest.annotation.RestResource @RestResource}.
 				<ul>
 					<li><code><del>RestResource.stylesheet()</del></code>
 					<li><code><del>RestResource.favicon()</del></code>
-					<li>{@link org.apache.juneau.rest.annotation.RestResource#staticFiles()}
+					<li>{@link org.apache.juneau.rest.annotation.RestResource#staticFiles() @RestResource.staticFiles()}
 				</ul>
 			<li>Eliminated <code>org.apache.juneau.rest.jaxrs.JsonProvider</code> class.  
 				Some JAX-RS implementations use code scanning to find providers, so if you were using <code>DefaultJenaProvider</code>, it would
@@ -11990,8 +11981,8 @@
 				want to provide labels in resource bundles.
 				<ul>
 					<li><del><code>RestResource.label()</code></del>
-					<li>{@link org.apache.juneau.rest.annotation.RestResource#description()}
-					<li>{@link org.apache.juneau.rest.annotation.RestMethod#description()}
+					<li>{@link org.apache.juneau.rest.annotation.RestResource#description() @RestResource.description()}
+					<li>{@link org.apache.juneau.rest.annotation.RestMethod#description() @RestMethod.description()}
 					<li><del><code>RestMethod#responses()</code></del>
 					<li><del><code>Attr.description()</code></del>
 					<li><del><code>Content.description()</code></del>
@@ -12181,7 +12172,7 @@
 		<ul class='spaced-list'>
 			<li>{@link org.apache.juneau.rest.RestConverter} API fixed to handle the existence of POJO filters.
 				{@link org.apache.juneau.rest.converters.Introspectable}/{@link org.apache.juneau.rest.converters.Queryable}/{@link org.apache.juneau.rest.converters.Traversable} classes can now work with filtered POJOs.  
-			<li>{@link org.apache.juneau.rest.annotation.RestResource#messages()} annotation can now be defined on super and subclasses so that NLS messages can be defined in multiple resource bundles.
+			<li>{@link org.apache.juneau.rest.annotation.RestResource#messages() @RestResource.messages()} annotation can now be defined on super and subclasses so that NLS messages can be defined in multiple resource bundles.
 			<li>Performance improvements in <code>RestServletNls</code> class. 
 			<li>Fixed bug where two REST java methods mapped to the same path pattern wasn't triggering an exception when it was supposed to.
 		</ul>
@@ -12497,7 +12488,7 @@
 		</p>
 		<ul class='spaced-list'>
 			<li>New {@link org.apache.juneau.rest.Redirect} class that simplifies performing redirections in REST methods.
-			<li>New pluggable {@link org.apache.juneau.rest.ResponseHandler} class and {@link org.apache.juneau.rest.annotation.RestResource#responseHandlers()} annotation
+			<li>New pluggable {@link org.apache.juneau.rest.ResponseHandler} class and {@link org.apache.juneau.rest.annotation.RestResource#responseHandlers() @RestResource.responseHandlers()} annotation
 				for defining customer response handlers for special kinds of POJOs.
 			<li>New method <del><code>UrlEncodingSerializer.serializeUrlPart(Object)</code></del> method.
 			<li>New method <code><del>RestRequest.getServletURIBuilder()</del></code> for construcing servlet-based URLs more efficiently.
@@ -13659,10 +13650,10 @@
 		<ul class='spaced-list'>
 			<li>Build-in default <code>OPTIONS</code> pages.</li>
 			<li>New {@link org.apache.juneau.rest.annotation.RestResource#defaultRequestHeaders() @RestResource.defaultRequestHeaders} and {@link org.apache.juneau.rest.annotation.RestResource#defaultResponseHeaders() @RestResource.defaultResponseHeaders} annotations.</li>
-			<li>New {@link org.apache.juneau.rest.annotation.RestMethod#serializers() @RestMethod.serializers} and {@link org.apache.juneau.rest.annotation.RestMethod#parsers() @RestMethod.parsers} annotations.</li>
-			<li>New {@link org.apache.juneau.rest.annotation.RestMethod#properties() @RestMethod.properties} annotation.</li>
-			<li>New {@link org.apache.juneau.rest.annotation.RestMethod#defaultRequestHeaders() @RestMethod.defaultRequestHeaders} annotation.</li>
-			<li>New {@link org.apache.juneau.rest.annotation.RestMethod#matchers() @RestMethod.matchers} annotation and {@link org.apache.juneau.rest.RestMatcher} class.</li>
+			<li>New {@link org.apache.juneau.rest.annotation.RestMethod#serializers() @RestMethod.serializers()} and {@link org.apache.juneau.rest.annotation.RestMethod#parsers() @RestMethod.parsers()} annotations.</li>
+			<li>New {@link org.apache.juneau.rest.annotation.RestMethod#properties() @RestMethod.properties()} annotation.</li>
+			<li>New {@link org.apache.juneau.rest.annotation.RestMethod#defaultRequestHeaders() @RestMethod.defaultRequestHeaders()} annotation.</li>
+			<li>New {@link org.apache.juneau.rest.annotation.RestMethod#matchers() @RestMethod.matchers()} annotation and {@link org.apache.juneau.rest.RestMatcher} class.</li>
 			<li><code>Readers</code> and <code>InputStreams</code> can be specified on <del><code>@Content</code></del> annotated parameters.</li>
 			<li>New <del><code>@HasParam</code></del> annotation.</li>
 			<li>Full RFC2616 support for matching <code>Accept</code> headers to serializers.</li>		
@@ -13775,7 +13766,7 @@
 						Used by RDF/XML serializer to construct <code>rdf:resource</code> attributes.
 					</li>
 					<li>
-						New {@link org.apache.juneau.annotation.BeanProperty#properties() @BeanProperty.properties} annotation.
+						New {@link org.apache.juneau.annotation.BeanProperty#properties() @BeanProperty.properties()} annotation.
 						Used for limiting properties on child elements.
 					</li>	
 				</ul>
@@ -13819,7 +13810,7 @@
 				Several new annotations on REST methods:
 				<ul>
 					<li><code>@RestMethod.filters()</code> - Associate post-formatting filters on a method level.</li>
-					<li>{@link org.apache.juneau.rest.annotation.RestMethod#guards() @RestMethod.guards} - Associate method-level guards.</li>
+					<li>{@link org.apache.juneau.rest.annotation.RestMethod#guards() @RestMethod.guards()} - Associate method-level guards.</li>
 				</ul>
 			</li>
 			<li>				

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-client/src/main/java/org/apache/juneau/rest/client/RestClientBuilder.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-client/src/main/java/org/apache/juneau/rest/client/RestClientBuilder.java b/juneau-rest/juneau-rest-client/src/main/java/org/apache/juneau/rest/client/RestClientBuilder.java
index 915b2a6..f0f5c77 100644
--- a/juneau-rest/juneau-rest-client/src/main/java/org/apache/juneau/rest/client/RestClientBuilder.java
+++ b/juneau-rest/juneau-rest-client/src/main/java/org/apache/juneau/rest/client/RestClientBuilder.java
@@ -1675,7 +1675,7 @@ public class RestClientBuilder extends BeanContextBuilder {
 	}
 
 	/**
-	 * XXX
+	 * TODO
 	 *
 	 * <h5 class='section'>See Also:</h5>
 	 * <ul>
@@ -1690,7 +1690,7 @@ public class RestClientBuilder extends BeanContextBuilder {
 	}
 
 	/**
-	 * XXX
+	 * TODO
 	 *
 	 * <h5 class='section'>See Also:</h5>
 	 * <ul>

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-server-jaxrs/src/main/java/org/apache/juneau/rest/jaxrs/BaseProvider.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server-jaxrs/src/main/java/org/apache/juneau/rest/jaxrs/BaseProvider.java b/juneau-rest/juneau-rest-server-jaxrs/src/main/java/org/apache/juneau/rest/jaxrs/BaseProvider.java
index 8dec722..c7cd4e8 100644
--- a/juneau-rest/juneau-rest-server-jaxrs/src/main/java/org/apache/juneau/rest/jaxrs/BaseProvider.java
+++ b/juneau-rest/juneau-rest-server-jaxrs/src/main/java/org/apache/juneau/rest/jaxrs/BaseProvider.java
@@ -73,7 +73,7 @@ public class BaseProvider implements MessageBodyReader<Object>, MessageBodyWrite
 	}
 
 	/**
-	 * Returns properties defined on the specified method through the {@link RestMethod#properties()}
+	 * Returns properties defined on the specified method through the {@link RestMethod#properties() @RestMethod.properties()}
 	 * annotation specified on the method and the {@link JuneauProvider#properties()} annotation specified on the 
 	 * provider class.
 	 *

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-server-jaxrs/src/main/java/org/apache/juneau/rest/jaxrs/JuneauProvider.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server-jaxrs/src/main/java/org/apache/juneau/rest/jaxrs/JuneauProvider.java b/juneau-rest/juneau-rest-server-jaxrs/src/main/java/org/apache/juneau/rest/jaxrs/JuneauProvider.java
index b972eeb..d84ecd1 100644
--- a/juneau-rest/juneau-rest-server-jaxrs/src/main/java/org/apache/juneau/rest/jaxrs/JuneauProvider.java
+++ b/juneau-rest/juneau-rest-server-jaxrs/src/main/java/org/apache/juneau/rest/jaxrs/JuneauProvider.java
@@ -83,7 +83,7 @@ public @interface JuneauProvider {
 	 * Property values will be converted to the appropriate type.
 	 * 
 	 * <p>
-	 * These properties can be augmented/overridden through the {@link RestMethod#properties()} annotation on the REST method.
+	 * These properties can be augmented/overridden through the {@link RestMethod#properties() @RestMethod.properties()} annotation on the REST method.
 	 */
 	Property[] properties() default {};
 

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-server-jaxrs/src/main/java/org/apache/juneau/rest/jaxrs/package.html
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server-jaxrs/src/main/java/org/apache/juneau/rest/jaxrs/package.html b/juneau-rest/juneau-rest-server-jaxrs/src/main/java/org/apache/juneau/rest/jaxrs/package.html
index c699667..13a3494 100644
--- a/juneau-rest/juneau-rest-server-jaxrs/src/main/java/org/apache/juneau/rest/jaxrs/package.html
+++ b/juneau-rest/juneau-rest-server-jaxrs/src/main/java/org/apache/juneau/rest/jaxrs/package.html
@@ -84,7 +84,7 @@
 		<li>
 			Use existing Juneau serializers and parsers for converting streams to POJOs and vis-versa.
 		<li>
-			Use annotations to specify filters and properties using the {@link org.apache.juneau.rest.annotation.RestMethod}
+			Use annotations to specify filters and properties using the {@link org.apache.juneau.rest.annotation.RestMethod @RestMethod}
 			and {@link org.apache.juneau.rest.jaxrs.JuneauProvider} annotations.
 	</ul>
 	<p>

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/HtmlDocBuilder.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/HtmlDocBuilder.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/HtmlDocBuilder.java
index 648022e..54ebb1b 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/HtmlDocBuilder.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/HtmlDocBuilder.java
@@ -33,8 +33,8 @@ import org.apache.juneau.utils.*;
  * <p>
  * This class is instantiated through the following methods.
  * <ul>
- * 	<li>{@link RestContextBuilder#getHtmlDocBuilder()} - Set values programmatically during servlet initialization.
- * 	<li>{@link RestResponse#getHtmlDocBuilder()} - Set values programmatically during a REST request.
+ * 	<li class='jm'>{@link RestContextBuilder#getHtmlDocBuilder()} - Set values programmatically during servlet initialization.
+ * 	<li class='jm'>{@link RestResponse#getHtmlDocBuilder()} - Set values programmatically during a REST request.
  * </ul>
  */
 public class HtmlDocBuilder {

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/ReaderResource.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/ReaderResource.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/ReaderResource.java
index 3e0ed20..a085127 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/ReaderResource.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/ReaderResource.java
@@ -25,7 +25,7 @@ import org.apache.juneau.rest.response.*;
 import org.apache.juneau.svl.*;
 
 /**
- * Represents the contents of a text file with convenience methods for resolving {@link Parameter} variables and adding
+ * Represents the contents of a text file with convenience methods for resolving {@link Parameter @Parameter} variables and adding
  * HTTP response headers.
  *
  * <p>

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestCallHandler.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestCallHandler.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestCallHandler.java
index adcebbb..b8ac10d 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestCallHandler.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestCallHandler.java
@@ -278,7 +278,7 @@ public class RestCallHandler {
 	 *
 	 * <p>
 	 * The default implementation renders a plain text English message, optionally with a stack trace if
-	 * {@link RestResource#renderResponseStackTraces()} is enabled.
+	 * {@link RestResource#renderResponseStackTraces() @RestResource.renderResponseStackTraces()} is enabled.
 	 *
 	 * <p>
 	 * Subclasses can override this method to provide their own custom error response handling.

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestContext.java
----------------------------------------------------------------------
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 301f751..121b7e1 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
@@ -231,7 +231,7 @@ public final class RestContext extends BeanContext {
 	 * large numbers of servlets.
 	 *
 	 * <p>
-	 * Child resources must specify a value for {@link RestResource#path()} that identifies the subpath of the child resource
+	 * Child resources must specify a value for {@link RestResource#path() @RestResource.path()} that identifies the subpath of the child resource
 	 * relative to the parent path.
 	 *
 	 * <p>
@@ -340,7 +340,7 @@ public final class RestContext extends BeanContext {
 	 *
 	 * <p>
 	 * The client version is used to support backwards compatibility for breaking REST interface changes.
-	 * <br>Used in conjunction with {@link RestMethod#clientVersion()} annotation.
+	 * <br>Used in conjunction with {@link RestMethod#clientVersion() @RestMethod.clientVersion()} annotation.
 	 */
 	public static final String REST_clientVersionHeader = PREFIX + "clientVersionHeader.s";
 
@@ -956,7 +956,7 @@ public final class RestContext extends BeanContext {
 	 * 	<li>This annotation is ignored on top-level servlets (i.e. servlets defined in <code>web.xml</code> files).
 	 * 		<br>Therefore, implementers can optionally specify a path value for documentation purposes.
 	 * 	<li>Typically, this setting is only applicable to resources defined as children through the 
-	 * 		{@link RestResource#children()} annotation.
+	 * 		{@link RestResource#children() @RestResource.children()} annotation.
 	 * 		<br>However, it may be used in other ways (e.g. defining paths for top-level resources in microservices).
 	 *	</ul>
 	 */
@@ -1839,7 +1839,7 @@ public final class RestContext extends BeanContext {
 	 * The resource resolver is used for instantiating child resource classes.
 	 *
 	 * <p>
-	 * Unless overridden via the {@link RestResource#resourceResolver()} annotation or the {@link RestContextBuilder#resourceResolver(Class)}
+	 * Unless overridden via the {@link RestResource#resourceResolver() @RestResource.resourceResolver()} annotation or the {@link RestContextBuilder#resourceResolver(Class)}
 	 * method, this value is always inherited from parent to child.
 	 * This allows a single resource resolver to be passed in to the top-level servlet to handle instantiation of all
 	 * child resources.
@@ -1875,7 +1875,7 @@ public final class RestContext extends BeanContext {
 	 * </p>
 	 *
 	 * <p>
-	 * A typical usage pattern involves using variables inside the {@link HtmlDoc} annotation:
+	 * A typical usage pattern involves using variables inside the {@link HtmlDoc @HtmlDoc} annotation:
 	 * <p class='bcode'>
 	 * 	<ja>@RestMethod</ja>(
 	 * 		name=<jsf>GET</jsf>, path=<js>"/{name}/*"</js>,
@@ -2116,7 +2116,7 @@ public final class RestContext extends BeanContext {
 	}
 
 	/**
-	 * Returns the path for this resource as defined by the {@link RestResource#path()} annotation or
+	 * Returns the path for this resource as defined by the {@link RestResource#path() @RestResource.path()} annotation or
 	 * {@link RestContextBuilder#path(String)} method concatenated with those on all parent classes.
 	 *
 	 * <p>
@@ -2135,7 +2135,7 @@ public final class RestContext extends BeanContext {
 	 * The widgets used for resolving <js>"$W{...}"<js> variables.
 	 *
 	 * <p>
-	 * Defined by the {@link HtmlDoc#widgets()} annotation or {@link RestContextBuilder#widgets(Class...)} method.
+	 * Defined by the {@link HtmlDoc#widgets() @HtmlDoc.widgets()} annotation or {@link RestContextBuilder#widgets(Class...)} method.
 	 *
 	 * @return The var resolver widgets as a map with keys being the name returned by {@link Widget#getName()}.
 	 */
@@ -2363,45 +2363,45 @@ public final class RestContext extends BeanContext {
 	}
 
 	/**
-	 * Returns the value of the {@link RestResource#renderResponseStackTraces()} setting.
+	 * TODO
 	 *
-	 * @return The value of the {@link RestResource#renderResponseStackTraces()} setting.
+	 * @return TODO
 	 */
 	protected boolean isRenderResponseStackTraces() {
 		return renderResponseStackTraces;
 	}
 
 	/**
-	 * Returns the value of the {@link RestResource#allowHeaderParams()} setting.
+	 * TODO
 	 *
-	 * @return The value of the {@link RestResource#allowHeaderParams()} setting.
+	 * @return TODO
 	 */
 	protected boolean isAllowHeaderParams() {
 		return allowHeaderParams;
 	}
 
 	/**
-	 * Returns the value of the {@link RestResource#allowBodyParam()} setting.
+	 * TODO
 	 *
-	 * @return The value of the {@link RestResource#allowBodyParam()} setting.
+	 * @return TODO
 	 */
 	protected boolean isAllowBodyParam() {
 		return allowBodyParam;
 	}
 
 	/**
-	 * Returns the value of the {@link RestResource#defaultCharset()} setting.
+	 * TODO
 	 *
-	 * @return The value of the {@link RestResource#defaultCharset()} setting.
+	 * @return TODO
 	 */
 	protected String getDefaultCharset() {
 		return defaultCharset;
 	}
 
 	/**
-	 * Returns the value of the {@link RestResource#maxInput()} setting.
+	 * TODO
 	 *
-	 * @return The value of the {@link RestResource#maxInput()} setting.
+	 * @return TODO
 	 */
 	protected long getMaxInput() {
 		return maxInput;
@@ -2888,10 +2888,9 @@ public final class RestContext extends BeanContext {
 	}
 
 	/**
-	 * Returns the context path of the resource if it's specified via the {@link RestResource#contextPath()} setting
-	 * on this or a parent resource.
+	 * TODO
 	 *
-	 * @return The {@link RestResource#contextPath()} setting value, or <jk>null</jk> if it's not specified.
+	 * @return TODO
 	 */
 	protected String getContextPath() {
 		if (contextPath != null)

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestContextBuilder.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestContextBuilder.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestContextBuilder.java
index 2e7f9e7..87105a5 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestContextBuilder.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestContextBuilder.java
@@ -381,7 +381,7 @@ public class RestContextBuilder extends BeanContextBuilder implements ServletCon
 	 * Sets a property on this resource.
 	 *
 	 * <p>
-	 * This is the programmatic equivalent to the {@link RestResource#properties()} annotation.
+	 * This is the programmatic equivalent to the {@link RestResource#properties() @RestResource.properties()} annotation.
 	 *
 	 * @param key The property name.
 	 * @param value The property value.
@@ -458,7 +458,7 @@ public class RestContextBuilder extends BeanContextBuilder implements ServletCon
 	 * Returns the configuration properties for this resource.
 	 *
 	 * <p>
-	 * The configuration properties are determined via the {@link RestResource#properties()} annotation on the resource.
+	 * The configuration properties are determined via the {@link RestResource#properties() @RestResource.properties()} annotation on the resource.
 	 *
 	 * <p>
 	 * The configuration properties can be augmented programmatically by adding the following method to your resource:
@@ -660,7 +660,7 @@ public class RestContextBuilder extends BeanContextBuilder implements ServletCon
 	 * Shortcut for adding a single child to this resource.
 	 * 
 	 * <p>
-	 * This can be used for resources that don't have a {@link RestResource#path()} annotation.
+	 * This can be used for resources that don't have a {@link RestResource#path() @RestResource.path()} annotation.
 	 * 
 	 * <h5 class='section'>See Also:</h5>
 	 * <ul>
@@ -723,7 +723,7 @@ public class RestContextBuilder extends BeanContextBuilder implements ServletCon
 	 *
 	 * <p>
 	 * The client version is used to support backwards compatibility for breaking REST interface changes.
-	 * <br>Used in conjunction with {@link RestMethod#clientVersion()} annotation.
+	 * <br>Used in conjunction with {@link RestMethod#clientVersion() @RestMethod.clientVersion()} annotation.
 	 * 
 	 * <h5 class='section'>See Also:</h5>
 	 * <ul>

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestConverter.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestConverter.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestConverter.java
index 6dfa6ee..3803b2e 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestConverter.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestConverter.java
@@ -25,7 +25,7 @@ import org.apache.juneau.serializer.*;
  * after invocation of the REST method.
  *
  * <p>
- * Converters are associated with REST methods through the {@link RestMethod#converters()} annotation.
+ * Converters are associated with REST methods through the {@link RestMethod#converters() @RestMethod.converters()} annotation.
  *
  * <h5 class='section'>Example:</h5>
  * <p class='bcode'>
@@ -41,7 +41,7 @@ import org.apache.juneau.serializer.*;
  * </p>
  *
  * <p>
- * Converters can also be associated at the servlet level using the {@link RestResource#converters()} annotation.
+ * Converters can also be associated at the servlet level using the {@link RestResource#converters() @RestResource.converters()} annotation.
  * Applying converters at the resource level is equivalent to applying converters to each resource method individually.
  *
  * <h6 class='topic'>How to implement</h6>

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestException.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestException.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestException.java
index 072ceb2..ad942f7 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestException.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestException.java
@@ -145,11 +145,8 @@ public class RestException extends FormattedRuntimeException {
 	/**
 	 * Returns the number of times this exception occurred on this servlet.
 	 *
-	 * <p>
-	 * This only gets set if {@link RestResource#useStackTraceHashes()} is enabled on the servlet.
-	 *
 	 * @return
-	 * 	The occurrence number if {@link RestResource#useStackTraceHashes()} is enabled, or <code>0</code> otherwise.
+	 * 	The occurrence number if {@link RestResource#useStackTraceHashes() @RestResource.useStackTraceHashes()} is enabled, or <code>0</code> otherwise.
 	 */
 	public int getOccurrence() {
 		return occurrence;

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestGuard.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestGuard.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestGuard.java
index c828cc6..c68b563 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestGuard.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestGuard.java
@@ -26,8 +26,8 @@ import org.apache.juneau.rest.annotation.*;
  * For example, guards can be used to ensure that only administrators can call certain methods.
  *
  * <p>
- * Guards are applied to REST methods declaratively through the {@link RestResource#guards()} or
- * {@link RestMethod#guards()} annotations.
+ * Guards are applied to REST methods declaratively through the {@link RestResource#guards() @RestResource.guards()} or
+ * {@link RestMethod#guards() @RestMethod.guards()} annotations.
  *
  * <p>
  * If multiple guards are specified, ALL guards must pass in order for the request to proceed.

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestMatcher.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestMatcher.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestMatcher.java
index 13948d3..3e1daf0 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestMatcher.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestMatcher.java
@@ -15,7 +15,7 @@ package org.apache.juneau.rest;
 import org.apache.juneau.rest.annotation.*;
 
 /**
- * Class used for defining method-level matchers using the {@link RestMethod#matchers()} annotation.
+ * Class used for defining method-level matchers using the {@link RestMethod#matchers() @RestMethod.matchers()} annotation.
  *
  * <p>
  * Matchers are used to allow multiple Java methods to handle requests assigned to the same URL path pattern, but
@@ -29,7 +29,7 @@ import org.apache.juneau.rest.annotation.*;
  *
  * <p>
  * When multiple matchers are specified on a method, only one matcher is required to match.
- * This is opposite from the {@link RestMethod#guards()} annotation, where all guards are required to match in order to
+ * This is opposite from the {@link RestMethod#guards() @RestMethod.guards()} annotation, where all guards are required to match in order to
  * execute the method.
  *
  * <h5 class='section'>Example:</h5>

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestParam.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestParam.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestParam.java
index 5c4a1e5..95b6c27 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestParam.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestParam.java
@@ -23,7 +23,7 @@ import org.apache.juneau.rest.annotation.*;
  * Used to resolve instances of classes being passed to Java REST methods.
  *
  * <p>
- * This class is associated with REST classes via the {@link RestResource#paramResolvers()} annotation and
+ * This class is associated with REST classes via the {@link RestResource#paramResolvers() @RestResource.paramResolvers()} annotation and
  * {@link RestContextBuilder#paramResolvers(Class...)} method.
  */
 public abstract class RestParam {

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestRequest.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestRequest.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestRequest.java
index 6b105a8..2723e3d 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestRequest.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestRequest.java
@@ -855,7 +855,7 @@ public final class RestRequest extends HttpServletRequestWrapper {
 	 *
 	 * @param name The name of the resource (i.e. the value normally passed to {@link Class#getResourceAsStream(String)}.
 	 * @param resolveVars
-	 * 	If <jk>true</jk>, any {@link org.apache.juneau.rest.annotation.Parameter} variables will be
+	 * 	If <jk>true</jk>, any {@link org.apache.juneau.rest.annotation.Parameter @Parameter} variables will be
 	 * 	resolved by the variable resolver returned by {@link #getVarResolverSession()}.
 	 * 	<br>See {@link RestContext#getVarResolver()} for the list of supported variables.
 	 * @param mediaType The value to set as the <js>"Content-Type"</js> header for this object.
@@ -878,7 +878,7 @@ public final class RestRequest extends HttpServletRequestWrapper {
 	 *
 	 * @param name The name of the resource (i.e. the value normally passed to {@link Class#getResourceAsStream(String)}.
 	 * @param resolveVars
-	 * 	If <jk>true</jk>, any {@link org.apache.juneau.rest.annotation.Parameter} variables will be
+	 * 	If <jk>true</jk>, any {@link org.apache.juneau.rest.annotation.Parameter @Parameter} variables will be
 	 * 	resolved by the variable resolver returned by {@link #getVarResolverSession()}.
 	 * 	<br>See {@link RestContext#getVarResolver()} for the list of supported variables.
 	 * @return A new reader resource, or <jk>null</jk> if resource could not be found.

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestResourceResolver.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestResourceResolver.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestResourceResolver.java
index 8489a29..ce256c6 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestResourceResolver.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestResourceResolver.java
@@ -47,7 +47,7 @@ public interface RestResourceResolver {
 	 * The default implementation simply creates a new class instance using {@link Class#newInstance()}.
 	 * 
 	 * @param parent 
-	 * 	The parent resource (i.e. the instance whose class has the {@link RestResource#children()} annotation.
+	 * 	The parent resource (i.e. the instance whose class has the {@link RestResource#children() @RestResource.children()} annotation.
 	 * @param c The class to resolve.
 	 * @param builder The initialization configuration for the resource.
 	 * @return The instance of that class.

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestServletGroupDefault.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestServletGroupDefault.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestServletGroupDefault.java
index 5be7201..86efd72 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestServletGroupDefault.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestServletGroupDefault.java
@@ -25,7 +25,7 @@ import org.apache.juneau.rest.labels.*;
  * They're meant to be used as jumping-off points for child resources.
  *
  * <p>
- * Child resources are specified using the {@link RestResource#children()} annotation.
+ * Child resources are specified using the {@link RestResource#children() @RestResource.children()} annotation.
  */
 @RestResource()
 public abstract class RestServletGroupDefault extends RestServletDefault {

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/UrlPathPattern.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/UrlPathPattern.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/UrlPathPattern.java
index 469655d..a362f67 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/UrlPathPattern.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/UrlPathPattern.java
@@ -20,7 +20,7 @@ import java.util.regex.*;
 import org.apache.juneau.rest.annotation.*;
 
 /**
- * A parsed path pattern constructed from a {@link RestMethod#path()} value.
+ * A parsed path pattern constructed from a {@link RestMethod#path() @RestMethod.path()} value.
  *
  * <p>
  * Handles aspects of matching and precedence ordering.
@@ -35,7 +35,7 @@ public final class UrlPathPattern implements Comparable<UrlPathPattern> {
 	/**
 	 * Constructor.
 	 *
-	 * @param patternString The raw pattern string from the {@link RestMethod#path()} annotation.
+	 * @param patternString The raw pattern string from the {@link RestMethod#path() @RestMethod.path()} annotation.
 	 */
 	public UrlPathPattern(String patternString) {
 		this.patternString = patternString;

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Body.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Body.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Body.java
index bee7c8b..3276c8c 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Body.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Body.java
@@ -19,7 +19,7 @@ import java.io.*;
 import java.lang.annotation.*;
 
 /**
- * Annotation that can be applied to a parameter of a {@link RestMethod} annotated method to identify it as the HTTP
+ * Annotation that can be applied to a parameter of a {@link RestMethod @RestMethod} annotated method to identify it as the HTTP
  * request body converted to a POJO.
  *
  * <h5 class='section'>Example:</h5>

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/FormData.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/FormData.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/FormData.java
index d8f177f..7b38884 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/FormData.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/FormData.java
@@ -21,7 +21,7 @@ import org.apache.juneau.httppart.*;
 import org.apache.juneau.rest.*;
 
 /**
- * Annotation that can be applied to a parameter of a {@link RestMethod} annotated method to identify it as a form post
+ * Annotation that can be applied to a parameter of a {@link RestMethod @RestMethod} annotated method to identify it as a form post
  * entry converted to a POJO.
  *
  * <h5 class='section'>Example:</h5>

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/HasFormData.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/HasFormData.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/HasFormData.java
index 28ec934..6e2846a 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/HasFormData.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/HasFormData.java
@@ -20,7 +20,7 @@ import java.lang.annotation.*;
 import org.apache.juneau.rest.*;
 
 /**
- * Annotation that can be applied to a parameter of a {@link RestMethod} annotated method to identify whether or not
+ * Annotation that can be applied to a parameter of a {@link RestMethod @RestMethod} annotated method to identify whether or not
  * the request has the specified multipart form POST parameter.
  *
  * <p>

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Header.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Header.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Header.java
index b23c4ae..3e038f2 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Header.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Header.java
@@ -20,7 +20,7 @@ import java.lang.annotation.*;
 import org.apache.juneau.httppart.*;
 
 /**
- * Annotation that can be applied to a parameter of a {@link RestMethod} annotated method to identify it as a HTTP
+ * Annotation that can be applied to a parameter of a {@link RestMethod @RestMethod} annotated method to identify it as a HTTP
  * request header converted to a POJO.
  *
  * <h5 class='section'>Example:</h5>

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/HtmlDoc.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/HtmlDoc.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/HtmlDoc.java
index 5235cbb..3f4c39d 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/HtmlDoc.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/HtmlDoc.java
@@ -21,8 +21,8 @@ import org.apache.juneau.rest.widget.*;
  * Contains all the configurable annotations for the {@link HtmlDocSerializer}.
  *
  * <p>
- * Used with {@link RestResource#htmldoc()} and {@link RestMethod#htmldoc()} to customize the HTML view of serialized
- * POJOs.
+ * Used with {@link RestResource#htmldoc() @RestResource.htmldoc()} and {@link RestMethod#htmldoc() @RestMethod.htmldoc()} 
+ * to customize the HTML view of serialized POJOs.
  *
  * <p>
  * All annotations specified here have no effect on any serializers other than {@link HtmlDocSerializer} and is
@@ -534,13 +534,13 @@ public @interface HtmlDoc {
 	 * 	<li>Property:  {@link RestContext#REST_widgets}
 	 * 	<li>Annotations: 
 	 * 		<ul>
-	 * 			<li>{@link HtmlDoc#widgets()} 
+	 * 			<li class='ja'>{@link HtmlDoc#widgets()} 
 	 * 		</ul>
 	 * 	<li>Methods: 
 	 * 		<ul>
-	 * 			<li>{@link RestContextBuilder#widgets(Class...)}
-	 * 			<li>{@link RestContextBuilder#widgets(Widget...)}
-	 * 			<li>{@link RestContextBuilder#widgets(boolean,Widget...)}
+	 * 			<li class='jm'>{@link RestContextBuilder#widgets(Class...)}
+	 * 			<li class='jm'>{@link RestContextBuilder#widgets(Widget...)}
+	 * 			<li class='jm'>{@link RestContextBuilder#widgets(boolean,Widget...)}
 	 * 		</ul>
 	 * 	<li>Widgets are inherited from parent to child, but can be overridden by reusing the widget name.
 	 * 	<li>Values are appended to the existing list.

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Messages.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Messages.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Messages.java
index 630aa77..413ccdf 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Messages.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Messages.java
@@ -21,7 +21,7 @@ import java.util.*;
 import org.apache.juneau.utils.*;
 
 /**
- * Annotation that can be applied to a parameter of a {@link RestMethod} annotated method to identify it as the
+ * Annotation that can be applied to a parameter of a {@link RestMethod @RestMethod} annotated method to identify it as the
  * resource bundle for the request locale.
  *
  * <p>

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Method.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Method.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Method.java
index 3af46e2..06effcd 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Method.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Method.java
@@ -18,7 +18,7 @@ import static java.lang.annotation.RetentionPolicy.*;
 import java.lang.annotation.*;
 
 /**
- * Annotation that can be applied to a parameter of a {@link RestMethod} annotated method to identify it as the HTTP
+ * Annotation that can be applied to a parameter of a {@link RestMethod @RestMethod} annotated method to identify it as the HTTP
  * method.
  *
  * <p>

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Parameter.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Parameter.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Parameter.java
index 834bf74..0df125f 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Parameter.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Parameter.java
@@ -18,8 +18,8 @@ import static java.lang.annotation.RetentionPolicy.*;
 import java.lang.annotation.*;
 
 /**
- * Annotation used in conjunction with {@link MethodSwagger#parameters()} to identify content and header descriptions
- * on specific method requests.
+ * Annotation used in conjunction with {@link MethodSwagger#parameters() @MethodSwagger.parameters()} to identify 
+ * content and header descriptions on specific method requests.
  *
  * <h5 class='section'>Example:</h5>
  * <p class='bcode'>

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Path.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Path.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Path.java
index 7bbb662..cd08438 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Path.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Path.java
@@ -20,7 +20,7 @@ import java.lang.annotation.*;
 import org.apache.juneau.httppart.*;
 
 /**
- * Annotation that can be applied to a parameter of a {@link RestMethod} annotated method to identify it as a variable
+ * Annotation that can be applied to a parameter of a {@link RestMethod @RestMethod} annotated method to identify it as a variable
  * in a URL path pattern converted to a POJO.
  *
  * <h5 class='section'>Example:</h5>

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/PathRemainder.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/PathRemainder.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/PathRemainder.java
index 36fcd25..377c166 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/PathRemainder.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/PathRemainder.java
@@ -18,7 +18,7 @@ import static java.lang.annotation.RetentionPolicy.*;
 import java.lang.annotation.*;
 
 /**
- * Annotation that can be applied to a parameter of a {@link RestMethod} annotated method to identify it as the URL
+ * Annotation that can be applied to a parameter of a {@link RestMethod @RestMethod} annotated method to identify it as the URL
  * parameter remainder after a path pattern match.
  *
  * <h5 class='section'>Example:</h5>

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Properties.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Properties.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Properties.java
index ee2fdf2..018d5fe 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Properties.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Properties.java
@@ -20,7 +20,7 @@ import java.lang.annotation.*;
 import org.apache.juneau.*;
 
 /**
- * Annotation that can be applied to a parameter of a {@link RestMethod} annotated method to identify the
+ * Annotation that can be applied to a parameter of a {@link RestMethod @RestMethod} annotated method to identify the
  * request-duration properties object for the current request.
  *
  * <h5 class='section'>Example:</h5>

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Property.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Property.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Property.java
index bbb82c5..8c4e150 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Property.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Property.java
@@ -18,7 +18,7 @@ import static java.lang.annotation.RetentionPolicy.*;
 import java.lang.annotation.*;
 
 /**
- * Property name/value pair used in the {@link RestResource#properties()} annotation.
+ * Property name/value pair used in the {@link RestResource#properties() @RestResource.properties()} annotation.
  *
  * <p>
  * Any of the properties defined on any of the serializers or parsers can be defined.

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Response.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Response.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Response.java
index e124651..5d7f964 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Response.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/Response.java
@@ -20,7 +20,7 @@ import java.lang.annotation.*;
 import org.apache.juneau.rest.*;
 
 /**
- * Annotation used in conjunction with {@link MethodSwagger#responses()} to identify possible responses by the method.
+ * Annotation used in conjunction with {@link MethodSwagger#responses() @MethodSwagger.responses()} to identify possible responses by the method.
  *
  * <h5 class='section'>Example:</h5>
  * <p class='bcode'>

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/RestMethod.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/RestMethod.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/RestMethod.java
index 9e6c602..a52be4c 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/RestMethod.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/annotation/RestMethod.java
@@ -156,7 +156,7 @@ public @interface RestMethod {
 	 *
 	 * <p>
 	 * The client version is identified via the HTTP request header identified by
-	 * {@link RestResource#clientVersionHeader()} which by default is <js>"X-Client-Version"</js>.
+	 * {@link RestResource#clientVersionHeader() @RestResource.clientVersionHeader()} which by default is <js>"X-Client-Version"</js>.
 	 *
 	 * <p>
 	 * This is a specialized kind of {@link RestMatcher} that allows you to invoke different Java methods for the same
@@ -648,7 +648,7 @@ public @interface RestMethod {
 	int priority() default 0;
 
 	/**
-	 * Same as {@link RestResource#properties()}, except defines property values by default when this method is called.
+	 * Same as {@link RestResource#properties() @RestResource.properties()}, except defines property values by default when this method is called.
 	 *
 	 * <p>
 	 * This is equivalent to simply calling <code>res.addProperties()</code> in the Java method, but is provided for

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/package.html
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/package.html b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/package.html
index c279e99..2aa96d8 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/package.html
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/package.html
@@ -1259,8 +1259,8 @@
 	 		The title and description can be defined in the following ways.
 	 	</p>
 	 	<ul>
-	 		<li>Annotations:  {@link org.apache.juneau.rest.annotation.RestResource#title()}, 
-	 			{@link org.apache.juneau.rest.annotation.RestResource#description()}
+	 		<li>Annotations:  {@link org.apache.juneau.rest.annotation.RestResource#title() @RestResource.title()}, 
+	 			{@link org.apache.juneau.rest.annotation.RestResource#description() @RestResource.description()}
 	 		<li>By overriding methods on the servlet class:  
 	 			{@link org.apache.juneau.rest.RestInfoProvider#getTitle(RestRequest)}, 
 	 			{@link org.apache.juneau.rest.RestInfoProvider#getDescription(RestRequest)} 
@@ -3130,7 +3130,7 @@
 	}
 		</p>
 		<p>
-			To support overloaded methods, the {@link org.apache.juneau.rest.annotation.RestResource#allowedMethodParams()} 
+			To support overloaded methods, the {@link org.apache.juneau.rest.annotation.RestResource#allowedMethodParams() @RestResource.allowedMethodParams()} 
 			setting must be enabled on your servlet.
 		</p>
 		<p class='bcode'>
@@ -3179,21 +3179,21 @@
 				<td class='code'>&amp;method=X</td>
 				<td>
 					Overload the HTTP method as a GET parameter (e.g <l>"POST"</l>).
-					<br>Must be enabled via {@link org.apache.juneau.rest.annotation.RestResource#allowedMethodParams()} setting.
+					<br>Must be enabled via {@link org.apache.juneau.rest.annotation.RestResource#allowedMethodParams() @RestResource.allowedMethodParams()} setting.
 				</td>
 			</tr>
 			<tr>
 				<td class='code'>&amp;X=headerValue</td>
 				<td>
 					Specify a header value as a GET parameter.
-					<br>Must be enabled via {@link org.apache.juneau.rest.annotation.RestResource#allowHeaderParams()} setting.
+					<br>Must be enabled via {@link org.apache.juneau.rest.annotation.RestResource#allowHeaderParams() @RestResource.allowHeaderParams()} setting.
 				</td>
 			</tr>
 			<tr>
 				<td class='code'>&amp;content=X</td>
 				<td>
 					Pass in the HTTP body content on PUT and POST methods as a UON-encoded GET parameter.
-					<br>Must be enabled via {@link org.apache.juneau.rest.annotation.RestResource#allowBodyParam()} setting.
+					<br>Must be enabled via {@link org.apache.juneau.rest.annotation.RestResource#allowBodyParam() @RestResource.allowBodyParam()} setting.
 				</td>
 			</tr>
 		</table>

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/remoteable/RemoteableServiceProperties.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/remoteable/RemoteableServiceProperties.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/remoteable/RemoteableServiceProperties.java
index c82fed2..1683122 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/remoteable/RemoteableServiceProperties.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/remoteable/RemoteableServiceProperties.java
@@ -28,7 +28,7 @@ import org.apache.juneau.rest.annotation.*;
  *
  * <p>
  * These properties are only valid at the class level, not the method level.
- * Setting them on {@link RestMethod#properties()} has no effect.
+ * <br>Setting them on {@link RestMethod#properties() @RestMethod.properties()} has no effect.
  */
 public final class RemoteableServiceProperties {
 

http://git-wip-us.apache.org/repos/asf/juneau/blob/8c69d59d/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/widget/Widget.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/widget/Widget.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/widget/Widget.java
index 16bb005..354574d 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/widget/Widget.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/widget/Widget.java
@@ -61,7 +61,7 @@ import org.apache.juneau.utils.*;
  *
  * <p>
  * The following shows an example of a widget that renders an image located in the <code>htdocs</code> static files
- * directory in your classpath (see {@link RestResource#staticFiles()}):
+ * directory in your classpath (see {@link RestResource#staticFiles() @RestResource.staticFiles()}):
  * <p class='bcode'>
  * 	<jk>public class</jk> MyWidget <jk>extends</jk> Widget {
  *


Mime
View raw message