Bug:19117 committing Danny's edit with a few light revisions

git-svn-id: svn+ssh://svn.marklogic.com/project/engsvn/client-api/java/trunk@113063 62cac252-8da6-4816-9e9d-6dc37b19578c

Author: ehennum

src/main/resources/example/README.txt

@@ -1,35 +1,35 @@
 MarkLogic Java API Examples
-2012-4-2
+August 2012
 
 == Cookbook =============
 
 The com/marklogic/client/example/cookbook directory provides recipes
 for common tasks using the MarkLogic Java API.
 
-Before using the examples, please perform the following actions:
+Before using the examples, perform the following actions:
 
-1.  Install 5.1 MarkLogic Server for your chosen platform.
+1.  Install MarkLogic 6 for your chosen platform.
 
-    We recommend that you uninstall any pevious MarkLogic version before installing
-    MarkLogic 5.1 and use a fresh data directory for your forests.
-
-2.  Set up a new REST API instance for your database.  You can use the AppServices web UI at
+2.  Set up a new REST API instance for your database.  You can use Information
+Studio at:
 
         http://YOUR_HOST:8000/appservices/
 
-    to create a new RESTful Server for a database.  Alternatively, you can use the bash shell
-    script provided with the REST API examples.
+    to create a new RESTful Server for a database.
 
-3.  Edit Example.properties to specify the connection parameters for the REST API instance.
+3.  Edit Example.properties to specify the connection parameters for the
+REST API instance.
 
-    You must identify users for the rest-writer and rest-admin roles.  To add a user for
-    each of those roles, you can use the Admin UI at
+    You must identify users for the rest-writer and rest-admin roles.  To
+    add a user for each of those roles, you can use the Admin Interface at:
 
         http://YOUR_HOST:8001/user-summary.xqy?section=security
 
-    If you make the user name the same as the role name and set the password to "x" you won't
-    have to modify those values in the properties file.  Change the example.port property to
-    the port number of the REST Server you created in step 2 of these instructions.
+    If you make the user name the same as the role name and set the
+    password to "x" you will not need to modify those values in the
+    properties file.  Change the example.port property to
+    the port number of the REST Server you created in step 2 of these
+    instructions.
 
 The examples illustrate the following common tasks:
 
@@ -41,15 +41,17 @@ The examples illustrate the following common tasks:
 *  DocumentDelete             delete a document from the database
 *  DocumentFormats            work with binary, JSON, text, and XML documents
 *  DocumentOutputStream       supply content while writing to the database
-*  JAXBDocument               write and read a POJO using JAXB 
+*  JAXBDocument               write and read a POJO using JAXB
 *  KeyValueSearch             search for documents based on values
 *  QueryOptions               configure search with saved options
 *  StringSearch               search with string criteria and saved options
-*  StructuredSearch           search with a criteria structure and saved options
-*  MultiStatementTransaction  complete a transaction with several requests 
+*  StructuredSearch           search with a criteria structure and saved
+                              options
+*  MultiStatementTransaction  complete a transaction with several requests
 *  DocumentReadTransform      transform content on the server while reading
 *  DocumentWriteTransform     transform content on the server while writing
-*  OptimisticLocking          write or delete a document only if it hasn't changed
+*  OptimisticLocking          write or delete a document only if it has not
+                              changed
 *  SSLClientCreator           create a database client using SSL
 
 Each example is a Java application that you can compile and run using the jar
@@ -63,26 +65,26 @@ an SSL certificate template.  The other examples do not use SSL.
 
 You can extend the Java API to support new kinds of content representations.
 
-The examples add support for the JDOM, XOM, Jackson, and Apache HTTPClient
-libraries.  
+The examples add support for the JDOM, XOM, Jackson, and other libraries. 
 
-To compile the JDOM example, first download the library at version 1.1.3 or
-higher from
+To compile the JDOM example, first download the library at version 2.0.2 or
+higher from:
 
     http://www.jdom.org/
 
 To compile the XOM example, first download the library at version 1.2.5 or
-higher from
+higher from:
 
     http://www.xom.nu/
 
 To compile the Jackson example (which uses the tree model), first download
-the core and databinding libraries at 2.0.1 or higher as linked from:
+the core and databinding libraries at 2.0.4 or higher as linked from:
 
     http://wiki.fasterxml.com/JacksonHome
 
 To compile the Apache HTTPClient example, you use the Apache HTTPClient
 bundled with the MarkLogic Java API in the lib subdirectory.
 
 The Java classes named *Example are applications that you can compile and run
-using the jar files for the library as well as the Java API and its dependencies.
+using the jar files for the library as well as the Java API and its
+dependencies.