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 6d5b67c  Update Javadocs.
6d5b67c is described below

commit 6d5b67ca9d63d9f9d3b7600a6935a276afaa898c
Author: JamesBognar <jamesbog...@apache.org>
AuthorDate: Mon Mar 5 13:48:48 2018 -0500

    Update Javadocs.
---
 .../main/java/org/apache/juneau/jena/package.html  |  59 -----
 .../main/java/org/apache/juneau/json/package.html  |  37 ---
 .../main/java/org/apache/juneau/uon/package.html   |  44 ---
 .../org/apache/juneau/urlencoding/package.html     |  43 ---
 .../main/java/org/apache/juneau/xml/package.html   |  47 ----
 juneau-doc/src/main/javadoc/doc-files/rfc_uon.txt  | 294 +++++++++++++++++++++
 juneau-doc/src/main/javadoc/overview.html          |  55 +++-
 7 files changed, 343 insertions(+), 236 deletions(-)

diff --git 
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/package.html
 
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/package.html
index 426d991..db4f100 100644
--- 
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/package.html
+++ 
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/package.html
@@ -75,65 +75,6 @@
 <a id="RdfOverview"></a>
 <h2 class='topic' onclick='toggle(this)'>1 - RDF support overview</h2>
 <div class='topic'>
-       <p>
-               Juneau supports serializing and parsing arbitrary POJOs to and 
from the following RDF formats:
-       </p>
-       <ul>
-               <li>RDF/XML
-               <li>Abbreviated RDF/XML
-               <li>N-Triple
-               <li>Turtle
-               <li>N3
-       </ul>
-       <p>
-               Juneau can serialize and parse instances of any of the 
following POJO types:
-       </p>
-       <ul class='spaced-list'>
-               <li>
-                       Java primitive objects (e.g. <code>String</code>, 
<code>Integer</code>, <code>Boolean</code>, 
-                       <code>Float</code>).
-               <li>
-                       Java collections framework objects (e.g. 
<code>HashSet</code>, <code>TreeMap</code>) containing anything on 
-                               this list.
-               <li>
-                       Multi-dimensional arrays of any type on this list.
-               <li>
-                       Java Beans with properties of any type on this list.
-               <li>
-                       Classes with standard transformations to and from 
<code>Strings</code> (e.g. classes containing 
-                       <code>toString()</code>, <code>fromString()</code>, 
<code>valueOf()</code>, <code>constructor(String)</code>).
-       </ul>
-       <p>
-               In addition to the types shown above, Juneau includes the 
ability to define 'swaps' to transform non-standard 
-               object and property types to serializable forms (e.g. to 
transform <code>Calendars</code> to and from 
-               <code>ISO8601</code> strings, or <code>byte[]</code> arrays to 
and from base-64 encoded strings).
-               <br>These  can be associated with serializers/parsers, or can 
be associated with classes or bean properties through 
-               type and method annotations.
-       </p>
-       <p>
-               Refer to <a 
href='../../../../overview-summary.html#juneau-marshall.PojoCategories' 
class='doclink'>POJO Categories</a> 
-               for a complete definition of supported POJOs.
-       </p>
-       
-       <h5 class='topic'>Prerequisites</h5>
-       <p>
-               Juneau uses the Jena library for these formats.  
-               <br>The predefined serializers and parsers convert POJOs to and 
from RDF models and then uses Jena to convert 
-               them to and from the various RDF languages.     
-       </p>
-       <p>
-               Jena libraries must be provided on the classpath separately if 
you plan on making use of the RDF support.
-       </p>
-       <p>
-               The minimum list of required jars are:
-       </p>
-       <ul>
-               <li><code>jena-core-2.7.1.jar</code>    
-               <li><code>jena-iri-0.9.2.jar</code>     
-               <li><code>log4j-1.2.16.jar</code>       
-               <li><code>slf4j-api-1.6.4.jar</code>    
-               <li><code>slf4j-log4j12-1.6.4.jar</code>        
-       </ul>
 
        <!-- 
========================================================================================================
 -->
        <a id="RdfOverviewExample"></a>
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/package.html 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/package.html
index 41c80b3..f4de010 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/package.html
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/package.html
@@ -73,43 +73,6 @@
 <a id="Overview"></a>
 <h2 class='topic' onclick='toggle(this)'>1 -JSON support overview</h2>
 <div class='topic'>
-       <p>
-               Juneau supports converting arbitrary POJOs to and from JSON 
using ultra-efficient serializers and parsers.
-               <br>The JSON serializer converts POJOs directly to JSON without 
the need for intermediate DOM objects using a 
-               highly-efficient state machine.
-               <br>Likewise, the JSON parser creates POJOs directly from JSON 
without the need for intermediate DOM objects. 
-       </p>
-       <p>
-               Juneau can serialize and parse instances of any of the 
following POJO types:
-       </p>
-       <ul class='spaced-list'>
-               <li>
-                       Java primitives and primitive objects (e.g. 
<code>String</code>, <code>Integer</code>, <code>Boolean</code>, 
-                       <code>Float</code>).
-               <li>
-                       Java Collections Framework objects (e.g. 
<code>HashSet</code>, <code>TreeMap</code>) containing anything on 
-                       this list.
-               <li>
-                       Multi-dimensional arrays of any type on this list.
-               <li>
-                       Java Beans with properties of any type on this list.
-               <li>
-                       Classes with standard transformations to and from 
<code>Strings</code> (e.g. classes containing 
-                       <code>toString()</code>, <code>fromString()</code>, 
<code>valueOf()</code>, <code>constructor(String)</code>).
-               <li>
-                       Non-serializable classes and properties with associated 
<code>PojoSwaps</code> that convert them to 
-                       serializable forms.
-       </ul>
-       <p>
-               Refer to <a 
href='../../../../overview-summary.html#juneau-marshall.PojoCategories' 
class='doclink'>POJO Categories</a> 
-               for a complete definition of supported POJOs.
-       </p>
-       
-       <h5 class='topic'>Prerequisites</h5>
-       <p>
-               The Juneau JSON serialization and parsing support does not 
require any external prerequisites.  
-               It only requires Java 1.6 or above.
-       </p>
 
        <!-- 
========================================================================================================
 -->
        <a id="OverviewExample"></a>
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/uon/package.html 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/uon/package.html
index 152e263..48ce2b7 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/uon/package.html
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/uon/package.html
@@ -69,50 +69,6 @@
 <a id="Overview"></a>
 <h2 class='topic' onclick='toggle(this)'>1 - URL encoding support overview</h2>
 <div class='topic'>
-       <p>
-               Juneau supports converting arbitrary POJOs to and from 
URL-encoded strings using ultra-efficient serializers 
-               and parsers.
-               <br>The serializer converts POJOs directly to URL-encoded 
strings without the need for intermediate DOM objects 
-               using a highly-efficient state machine.
-               <br>Likewise, the parser creates POJOs directly from 
URL-encoded strings without the need for intermediate DOM 
-               objects. 
-       </p>
-       <p>
-               Juneau uses UON (URL-Encoded Object Notation) for representing 
POJOs.  
-               The UON specification can be found <a 
href='doc-files/rfc_uon.txt'>here</a>.
-       </p>
-       <p>
-               Juneau can serialize and parse instances of any of the 
following POJO types:
-       </p>
-       <ul class='spaced-list'>
-               <li>
-                       Java primitives and primitive objects (e.g. 
<code>String</code>, <code>Integer</code>, <code>Boolean</code>, 
-                       <code>Float</code>).
-               <li>
-                       Java Collections Framework objects (e.g. 
<code>HashSet</code>, <code>TreeMap</code>) containing anything 
-                       on this list.
-               <li>
-                       Multi-dimensional arrays of any type on this list.
-               <li>
-                       Java Beans with properties of any type on this list.
-               <li>
-                       Classes with standard transformations to and from 
<code>Strings</code> (e.g. classes containing 
-                       <code>toString()</code>, <code>fromString()</code>, 
<code>valueOf()</code>, 
-                       <code>constructor(String)</code>).
-               <li>
-                       Non-serializable classes and properties with associated 
<code>PojoSwaps</code> that convert them to 
-                       serializable forms.
-       </ul>
-       <p>
-               Refer to <a 
href='../../../../overview-summary.html#juneau-marshall.PojoCategories' 
class='doclink'>POJO Categories</a> 
-               for a complete definition of supported POJOs.
-       </p>
-       
-       <h5 class='topic'>Prerequisites</h5>
-       <p>
-               The Juneau URL-encoding serialization and parsing support does 
not require any external prerequisites.  
-               It only requires Java 1.6 or above.
-       </p>
 
        <!-- 
========================================================================================================
 -->
        <a id="OverviewExample"></a>
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/urlencoding/package.html
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/urlencoding/package.html
index 6a23232..2860594 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/urlencoding/package.html
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/urlencoding/package.html
@@ -69,49 +69,6 @@
 <a id="Overview"></a>
 <h2 class='topic' onclick='toggle(this)'>1 - URL encoding support overview</h2>
 <div class='topic'>
-       <p>
-               Juneau supports converting arbitrary POJOs to and from 
URL-encoded strings using ultra-efficient serializers 
-               and parsers.
-               <br>The serializer converts POJOs directly to URL-encoded 
strings without the need for intermediate DOM objects 
-               using a highly-efficient state machine.
-               <br>Likewise, the parser creates POJOs directly from 
URL-encoded strings without the need for intermediate DOM 
-               objects. 
-       </p>
-       <p>
-               Juneau uses UON (URL-Encoded Object Notation) for representing 
POJOs.  
-               The UON specification can be found <a 
href='doc-files/rfc_uon.txt'>here</a>.
-       </p>
-       <p>
-               Juneau can serialize and parse instances of any of the 
following POJO types:
-       </p>
-       <ul class='spaced-list'>
-               <li>
-                       Java primitives and primitive objects (e.g. 
<code>String</code>, <code>Integer</code>, <code>Boolean</code>, 
-                       <code>Float</code>).
-               <li>
-                       Java Collections Framework objects (e.g. 
<code>HashSet</code>, <code>TreeMap</code>) containing anything 
-                       on this list.
-               <li>
-                       Multi-dimensional arrays of any type on this list.
-               <li>
-                       Java Beans with properties of any type on this list.
-               <li>
-                       Classes with standard transformations to and from 
<code>Strings</code> (e.g. classes containing 
-                       <code>toString()</code>, <code>fromString()</code>, 
<code>valueOf()</code>, <code>constructor(String)</code>).
-               <li>
-                       Non-serializable classes and properties with associated 
<code>PojoSwaps</code> that convert them to 
-                       serializable forms.
-       </ul>
-       <p>
-               Refer to <a 
href='../../../../overview-summary.html#juneau-marshall.PojoCategories' 
class='doclink'>POJO Categories</a> 
-               for a complete definition of supported POJOs.
-       </p>
-       
-       <h5 class='topic'>Prerequisites</h5>
-       <p>
-               The Juneau URL-encoding serialization and parsing support does 
not require any external prerequisites.  
-               It only requires Java 1.6 or above.
-       </p>
 
        <!-- 
========================================================================================================
 -->
        <a id="OverviewExample"></a>
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 499dbfe..7de0b06 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
@@ -84,53 +84,6 @@
 <a id="Overview"></a>
 <h2 class='topic' onclick='toggle(this)'>1 - XML support overview</h2>
 <div class='topic'>
-       <p>
-               Juneau supports converting arbitrary POJOs to and from XML 
using ultra-efficient serializers and parsers.
-               <br>The XML serializer converts POJOs directly to XML without 
the need for intermediate DOM objects.
-               <br>Likewise, the XML parser uses a STaX parser and creates 
POJOs directly without intermediate DOM objects. 
-       </p>
-       <p>
-               Unlike frameworks such as JAXB, Juneau does not require POJO 
classes to be annotated to produce and consume 
-               XML.
-               <br>For example, it can serialize and parse instances of any of 
the following POJO types:
-       </p>
-       <ul class='spaced-list'>
-               <li>
-                       Java primitive objects (e.g. <code>String</code>, 
<code>Integer</code>, <code>Boolean</code>, 
-                       <code>Float</code>).
-               <li>
-                       Java collections framework objects (e.g. 
<code>HashSet</code>, <code>TreeMap</code>) containing anything 
-                       on this list.
-               <li>
-                       Multi-dimensional arrays of any type on this list.
-               <li>
-                       Java Beans with properties of any type on this list.
-               <li>
-                       Classes with standard transformations to and from 
<code>Strings</code> (e.g. classes containing 
-                       <code>toString()</code>, <code>fromString()</code>, 
<code>valueOf()</code>, 
-                       <code>constructor(String)</code>).
-       </ul>
-       <p>
-               In addition to the types shown above, Juneau includes the 
ability to define transforms to transform 
-               non-standard object and property types to serializable forms 
(e.g. to transform <code>Calendars</code> to and 
-               from <code>ISO8601</code> strings, or <code>byte[]</code> 
arrays to and from base-64 encoded strings).
-               <br>These transforms can be associated with 
serializers/parsers, or can be associated with classes or bean 
-               properties through type and method annotations.
-       </p>
-       <p>
-               Refer to <a 
href='../../../../overview-summary.html#juneau-marshall.PojoCategories' 
class='doclink'>POJO Categories</a> 
-               for a complete definition of supported POJOs.
-       </p>
-       <p>
-               While annotations are not required to produce or consume XML, 
several XML annotations are provided for handling 
-               namespaces and fine-tuning the format of the XML produced.
-       </p>
-       
-       <h5 class='topic'>Prerequisites</h5>
-       <p>
-               The Juneau XML serialization and parsing support does not 
require any external prerequisites.  
-               It only requires Java 1.6 or above.
-       </p>
 
        <!-- 
========================================================================================================
 -->
        <a id="OverviewExample"></a>
diff --git a/juneau-doc/src/main/javadoc/doc-files/rfc_uon.txt 
b/juneau-doc/src/main/javadoc/doc-files/rfc_uon.txt
new file mode 100644
index 0000000..7880064
--- /dev/null
+++ b/juneau-doc/src/main/javadoc/doc-files/rfc_uon.txt
@@ -0,0 +1,294 @@
+Network Working Group                                          J. Bognar
+Request for Comments: 9999                                                
+Category: Informational                                       Salesforce
+                                                                Feb 2017
+
+                            ***DRAFT***
+               URI Object Notation (UON): Generic Syntax
+
+
+About this document
+
+   This memo provides information for the Internet community.  It does
+   not specify an Internet standard of any kind.  Distribution of this
+   memo is unlimited.
+
+Copyright Notice
+
+  Licensed to the Apache Software Foundation (ASF) under one
+  or more contributor license agreements.  See the NOTICE file
+  distributed with this work for additional information
+  regarding copyright ownership.  The ASF licenses this file
+  to you under the Apache License, Version 2.0 (the
+  "License"); you may not use this file except in compliance
+  with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing,
+  software distributed under the License is distributed on an
+  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+  KIND, either express or implied.  See the License for the
+  specific language governing permissions and limitations
+  under the License.
+
+Abstract
+
+   This document describes a grammar that builds upon RFC2396
+   (Uniform Resource Identifiers).  Its purpose is to define a 
+   generalized object notation for URI query parameter values similar in 
+   concept to Javascript Object Notation (RFC4627).  The goal is a 
+   syntax that allows for array and map structures to be
+   such that any data structure defined in JSON can be losslessly 
+   defined in an equivalent URI-based grammar, yet be fully compliant 
+   with the RFC2396 specification. 
+
+   This grammar provides the ability to construct the following data 
+   structures in URL parameter values: 
+       
+      OBJECT
+      ARRAY
+      NUMBER
+      BOOLEAN
+      STRING
+      NULL
+
+   Example:
+
+      The following shows a sample object defined in Javascript:
+
+         var x = { 
+            id: 1, 
+            name: 'John Smith', 
+            uri: 'http://sample/addressBook/person/1', 
+            addressBookUri: 'http://sample/addressBook', 
+            birthDate: '1946-08-12T00:00:00Z', 
+            otherIds: null,
+            addresses: [ 
+               { 
+                  uri: 'http://sample/addressBook/address/1', 
+                  personUri: 'http://sample/addressBook/person/1', 
+                  id: 1, 
+                  street: '100 Main Street', 
+                  city: 'Anywhereville', 
+                  state: 'NY', 
+                  zip: 12345, 
+                  isCurrent: true,
+               } 
+            ] 
+         } 
+
+      Using the syntax defined in this document, the equivalent 
+      UON notation would be as follows:
+
+         x=(id=1,name='John+Smith',uri=http://sample/
+         addressBook/person/1,addressBookUri=http://sample/
+         addressBook,birthDate=1946-08-12T00:00:00Z,otherIds=null,
+         addresses=@((uri=http://sample/addressBook/
+         address/1,personUri=http://sample/addressBook/
+         person/1,id=1,street='100+Main+Street',city=
+         Anywhereville,state=NY,zip=12345,isCurrent=true))) 
+
+1. Language constraints
+
+   The grammar syntax is constrained to usage of characters allowed by 
+      URI notation:
+
+      uric       = reserved | unreserved | escaped
+      reserved   = ";" | "/" | "?" | ":" | "@" | "&" | "=" | "+" |
+                   "$" | ","
+      unreserved = alphanum | mark
+      mark       = "-" | "_" | "." | "!" | "~" | "*" | "'" | "(" | ")"
+
+   In particular, the URI specification disallows the following 
+   characters in unencoded form:
+
+      unwise     = "{" | "}" | "|" | "\" | "^" | "[" | "]" | "`"
+      delims     = "<" | ">" | "#" | "%" | <">
+
+   The exclusion of {} and [] characters eliminates the possibility of 
+   using JSON as parameter values.
+
+
+2. Grammar constructs
+
+   The grammar consists of the following language constructs:
+   
+      Objects - Values consisting of one or more child name/value pairs.
+      Arrays - Values consisting of zero or more child values.
+      Booleans - Values consisting of true/false values.
+      Numbers - Decimal and floating point values.
+      Strings - Everything else.
+
+2.1. Objects 
+
+   Objects are values consisting of one or more child name/value pairs.
+   The (...) construct is used to define an object.
+
+   Example:  A simple map with two key/value pairs:
+
+      a1=(b1=x1,b2=x2)
+
+   Example:  A nested map:
+   
+      a1=(b1=(c1=x1,c2=x2))
+
+2.2. Arrays
+
+   Arrays are values consisting of zero or more child values.
+   The @(...) construct is used to define an array.
+
+   Example:  An array of two string values:
+
+      a1=@(x1,x2)
+
+   Example:  A 2-dimensional array:
+
+      a1=@(@(x1,x2),@(x3,x4))
+
+   Example:  An array of objects:
+
+      a1=@((b1=x1,b2=x2),(c1=x1,c2=x2))
+
+2.3. Booleans
+
+   Booleans are values that can only take on values "true" or "false".  
+   
+   Example:  Two boolean values:
+
+      a1=true&a2=false
+   
+2.4. Numbers
+
+   Numbers are represented without constructs.
+   Both decimal and float numbers are supported.
+   
+   Example:  Two numerical values, one decimal and one float:
+
+      a1=123&a2=1.23e1
+
+2.5. Null values
+
+   Nulls are represented by the keyword 'null':
+
+      a1=null
+
+2.6. Strings
+
+   Strings are encapsulated in single quote (') characters.
+   
+   Example:  Simple string values:
+
+      a1='foobar'&a2='123'&a3='true'
+         
+   The quotes are optional when the string cannot be confused
+   with one of the constructs listed above (i.e. objects/arrays/
+   booleans/numbers/null). 
+   
+   Example:  A simple string value, unquoted:
+
+      a1=foobar
+    
+   Strings must be quoted for the following cases:
+      
+      - The string can be confused with a boolean or number.
+      - The string is empty.
+      - The string contains one or more whitespace characters.
+      - The string starts with one of the following characters:
+        @ (
+      - The string contains any of the following characters:
+        ) , =
+   
+   For example, the string literal "(b1=x)" should be 
+   represented as follows:
+
+      a1='(b1=x)'
+   
+   The tilde character (~) is used for escaping characters to prevent 
+   them from being confused with syntax characters.  
+
+   The following characters must be escaped in string literals:  
+
+      ' ~
+   
+   Example:  The string "foo'bar~baz"
+
+      a1='foo~'bar~~baz'
+   
+2.7. Top-level attribute names
+
+   Top-level attribute names (e.g. "a1" in "&a1=foobar") are treated
+   as strings but for one exception.  The '=' character must be
+   encoded so as not to be confused as a key/value separator.
+   Note that the '=' character must also be escaped per the UON
+   notation.
+   
+   For example, the UON equivalent of {"a=b":"a=b"} constructed as
+   a top-level query parameter string would be as follows:
+   
+      a~%3Db=a~=b
+      
+   Note that the '=' character is encoded in the attribute name,
+   but it is not necessary to have it encoded in the attribute value.
+
+2.8. URL-encoded characters
+
+   UON notation allows for any character, even UON grammar
+   characters, to be URL-encoded.
+   
+   The following query strings are fully equivalent in structure:
+   
+     a1=(b1='x1',b2='x2')
+     %61%31=%79%6f%75%20%61%72%65%20%61%20%6e%65%72%64%21
+
+
+3. BNF
+
+   The following BNF describes the syntax for top-level URI query 
+   parameter values (e.g. ?<attrname>=<value>).
+
+   attrname    = (string | null)
+   value       = (var | string | null)
+
+   string      = ("'" litchar* "'") | litchar*
+   null        = "null"
+   
+   var         = ovar | avar | nvar | boolean | number
+   ovar        = "(" [pairs] ")"
+   avar        = "@(" [values] ")"
+
+   pairs       = pair ["," pairs]
+   pair        = key "=" value 
+   values      = value ["," values]
+   key         = (string | null)
+   boolean     = "true" | "false"
+
+   escape_seq  = "~" escaped
+   encode_seq  = "%" digithex digithex
+
+   number      = [-] (decimal | float) [exp]
+   decimal     = "0" | (digit19 digit*)
+   float       = decimal "." digit+
+   exp         = "e" [("+" | "-")] digit+
+
+   litchar     = unencoded | encode_seq | escape_seq
+   escaped     = "@" | "," | "(" | ")" | "~" | "=" 
+   unencoded   = alpha | digit | 
+                 ";" | "/" | "?" | ":" | "@" |
+                 "-" | "_" | "." | "!" | "*" | "'" 
+   alpha       = "a" | "b" | "c" | "d" | "e" | "f" | "g" | "h" | "i" |
+                 "j" | "k" | "l" | "m" | "n" | "o" | "p" | "q" | "r" |
+                 "s" | "t" | "u" | "v" | "w" | "x" | "y" | "z" |
+                 "A" | "B" | "C" | "D" | "E" | "F" | "G" | "H" | "I" |         
    
+                 "J" | "K" | "L" | "M" | "N" | "O" | "P" | "Q" | "R" |
+                 "S" | "T" | "U" | "V" | "W" | "X" | "Y" | "Z"
+   digit       = "0" | digit19
+   digit19     = "1" | "2" | "3" | "4" | "5" | "6" | "7" |
+                 "8" | "9"
+   digithex    = digit | 
+                 "A" | "B" | "C" | "D" | "E" | "F" |
+                 "a" | "b" | "c" | "d" | "e" | "f"
+
+
+
+
diff --git a/juneau-doc/src/main/javadoc/overview.html 
b/juneau-doc/src/main/javadoc/overview.html
index a0e3483..d447f21 100644
--- a/juneau-doc/src/main/javadoc/overview.html
+++ b/juneau-doc/src/main/javadoc/overview.html
@@ -3901,12 +3901,6 @@
                        <br>Likewise, the JSON parser creates POJOs directly 
from JSON without the need for intermediate DOM objects. 
                </p>
                
-               <h5 class='topic'>Prerequisites</h5>
-               <p>
-                       The Juneau JSON serialization and parsing support does 
not require any external prerequisites.  
-                       <br>It only requires Java 1.6 or above.
-               </p>
-               
                <h5 class='toc'>Additional Information - 
org.apache.juneau.json</h5>
                <ol class='toc'>
                        <li><p><a class='doclink' 
href='org/apache/juneau/json/package-summary.html#Overview'>JSON support 
overview</a></p> 
@@ -4023,6 +4017,17 @@
        <a id="juneau-marshall.XmlDetails"></a>
        <h3 class='topic' onclick='toggle(this)'>2.17 - XML Details</h3>
        <div class='topic'>
+               <p>
+                       Juneau supports converting arbitrary POJOs to and from 
XML using ultra-efficient serializers and parsers.
+                       <br>The XML serializer converts POJOs directly to XML 
without the need for intermediate DOM objects.
+                       <br>Likewise, the XML parser uses a STaX parser and 
creates POJOs directly without intermediate DOM objects. 
+               </p>
+               <p>
+                       Unlike frameworks such as JAXB, Juneau does not require 
POJO classes to be annotated to produce and consume 
+                       XML.
+                       <br>However, several XML annotations are provided for 
handling namespaces and fine-tuning the format of the XML produced.
+               </p>
+
                <h5 class='toc'>Additional Information - 
org.apache.juneau.xml</h5>
                <ol class='toc'>
                        <li><p><a class='doclink' 
href='org/apache/juneau/xml/package-summary.html#Overview'>XML support 
overview</a></p> 
@@ -4141,6 +4146,20 @@
        <a id="juneau-marshall.UonDetails"></a>
        <h3 class='topic' onclick='toggle(this)'>2.19 - UON Details</h3>
        <div class='topic'>
+
+               <p>
+                       Juneau supports converting arbitrary POJOs to and from 
UON strings using ultra-efficient serializers 
+                       and parsers.
+                       <br>The serializer converts POJOs directly to UON 
strings without the need for intermediate DOM objects 
+                       using a highly-efficient state machine.
+                       <br>Likewise, the parser creates POJOs directly from 
UON strings without the need for intermediate DOM 
+                       objects. 
+               </p>
+               <p>
+                       Juneau uses UON (URL-Encoded Object Notation) for 
representing POJOs.  
+                       The UON specification can be found <a 
href='doc-files/rfc_uon.txt'>here</a>.
+               </p>
+
                <h5 class='toc'>Additional Information - 
org.apache.juneau.uon</h5>
                <ol class='toc'>
                        <li><p><a class='doclink' 
href='org/apache/juneau/uon/package-summary.html#Overview'>UON support 
overview</a></p> 
@@ -4180,6 +4199,19 @@
        <a id="juneau-marshall.UrlEncodingDetails"></a>
        <h3 class='topic' onclick='toggle(this)'>2.20 - URL-Encoding 
Details</h3>
        <div class='topic'>
+               <p>
+                       Juneau supports converting arbitrary POJOs to and from 
URL-encoded strings using ultra-efficient serializers 
+                       and parsers.
+                       <br>The serializer converts POJOs directly to 
URL-encoded strings without the need for intermediate DOM objects 
+                       using a highly-efficient state machine.
+                       <br>Likewise, the parser creates POJOs directly from 
URL-encoded strings without the need for intermediate DOM 
+                       objects. 
+               </p>
+               <p>
+                       Juneau uses UON (URL-Encoded Object Notation) for 
representing POJOs.  
+                       The UON specification can be found <a 
href='doc-files/rfc_uon.txt'>here</a>.
+               </p>
+
                <h5 class='toc'>Additional Information - 
org.apache.juneau.urlencoding</h5>
                <ol class='toc'>
                        <li><p><a class='doclink' 
href='org/apache/juneau/urlencoding/package-summary.html#Overview'>URL encoding 
support overview</a></p> 
@@ -4295,6 +4327,17 @@
        <a id="juneau-marshall-rdf.RdfDetails"></a>
        <h3 class='topic' onclick='toggle(this)'>3.1 - RDF Details</h3>
        <div class='topic'>
+               <p>
+                       Juneau supports serializing and parsing arbitrary POJOs 
to and from the following RDF formats:
+               </p>
+               <ul>
+                       <li>RDF/XML
+                       <li>Abbreviated RDF/XML
+                       <li>N-Triple
+                       <li>Turtle
+                       <li>N3
+               </ul>
+
                <h5 class='toc'>Additional Information - 
org.apache.juneau.jena</h5>
                <ol class='toc'>
                        <li><p><a class='doclink' 
href='org/apache/juneau/jena/package-summary.html#RdfOverview'>RDF support 
overview</a></p> 

-- 
To stop receiving notification emails like this one, please contact
jamesbog...@apache.org.

Reply via email to