- Minor doc updates

git-svn-id: svn://192.168.0.80/JavaXT/javaxt-core@1624 2c7b0aa6-e0b2-3c4e-bb4a-8b65b6c465ff

Author: pborissow

src/javaxt/http/Response.java

@@ -127,16 +127,18 @@ public String getCharacterEncoding(){
   //**************************************************************************
   /** Returns the body of the http response as an input stream. No distinction
    *  is made between "normal" responses (e.g. status code 200) and error
-   *  responses (e.g. 404). <p/>
+   *  responses (e.g. 404).
+   *  <p>
    *  Sample Usage:
+   *  </p>
    <pre>
-        java.io.InputStream inputStream = response.getInputStream();
+    try(java.io.InputStream inputStream = response.getInputStream()){
         byte[] b = new byte[1024];
-        int x=0;
+        int x;
         while ( (x = inputStream.read(b)) != -1) {
             //Do something! Example: outputStream.write(b,0,x);
         }
-        inputStream.close();
+    }
    </pre>
    */
     public InputStream getInputStream(){

src/javaxt/io/Directory.java

@@ -3248,12 +3248,13 @@ protected void finalize() throws Throwable {
  *   Java wrapper of Windows native APIs for file system monitoring. The name of
  *   the methods in this class corresponds to the name of Windows native APIs.
  *   You might want to check Windows Platform SDK for detailed technical
- *   information. <p/>
- *
+ *   information.
+ *   <p>
  *   Also note that if you change the package or method name of this class, you
  *   need to use javah to regenerate a C header file and recompile the dll file.
  *   As far as I know, there is no way around it because of the way JVM binds to
  *   native dll.
+ *   </p>
  *
  ******************************************************************************/
 

src/javaxt/utils/Date.java

@@ -719,11 +719,11 @@ private long diff(java.util.Date date1, java.util.Date date2, String interval){
    *  decimal value (numbers after the decimal point) represent fractions of a
    *  month. Roughly speaking, a day is 0.03 of a month.
    *
-   *  <p/>
-   *
+   *  <p>
    *  There are some interesting results when comparing dates around the end
    *  of two different months. Specifically when comparing a longer month to
    *  shorter month. For example:
+   *  </p>
    *  <ul>
    *  <li>"2024-01-31" v "2024-02-29" = 1 month</li>
    *  <li>"2023-01-31" v "2023-02-28" = 1 month</li>
@@ -741,11 +741,11 @@ private long diff(java.util.Date date1, java.util.Date date2, String interval){
    *  In these examples you can see that we are following semantic rules
    *  rather than straight math.
    *
-   *  <p/>
-   *
+   *  <p>
    *  Note that you can use the compareTo() method to compare months using the
    *  Java standard which rounds down the difference between two months and
    *  does not return fractions.
+   *  </p>
    */
     public static double getMonthsBetween(javaxt.utils.Date start, javaxt.utils.Date end) {
         return getMonthsBetween(start.getLocalDate(), end.getLocalDate());
@@ -1443,9 +1443,10 @@ public static HashMap<String, String> getTimeZones(){
    *  running an updated version of Windows 7 or Windows Server 2008 R2, use
    *  the tzutil /l command. Source:
    *  http://technet.microsoft.com/en-us/library/ff715394%28v=ws.10%29.aspx
-   *  <p/>
+   *  <p>
    *  Time zone mappings were taken from this source:
    *  http://code.google.com/p/java-time-zone-list/source/browse/TimeZones/src/TimeZoneList.java
+   *  </p>
    */
     static {
         String[][] kvp = {

src/javaxt/utils/URL.java

@@ -604,7 +604,7 @@ public String getPath(){
   /** Used to update the path portion of the URL. If the supplied path starts
    *  with "./" or "../", only part of the path will be replaced. Otherwise,
    *  the entire path will be replaced.
-   *  <p/>
+   *  <p>
    *  When supplying a relative path (path starting with "./" or "../"), the
    *  url parser assumes that directories in the original path are terminated
    *  with a "/". For example:
@@ -616,7 +616,7 @@ public String getPath(){
    *  <pre>http://www.example.com/path/</pre>
    *  If you provide a relative path like "../index.html", will yield this:
    *  <pre>http://www.example.com/index.html</pre>
-   *  <p/>
+   *  </p>
    *  Note that if the supplied path contains a query string,
    *  the original query string will be replaced with the new one.
    */

src/javaxt/webservices/Parameter.java

@@ -20,7 +20,7 @@ public class Parameter {
     private int maxOccurs = 1;
     protected boolean IsNillable;
     protected boolean IsAttribute;
-    
+
     private Parameter[] children = null;
     private Option[] options = null;
     private Node parentNode;
@@ -149,12 +149,14 @@ public Object getValue(){
    *  between the value and the parameter data type, this method will attempt
    *  to convert the value to the correct datatype. For example, if a byte[]
    *  array is given for a base64Binary parameter, the array is converted to a
-   *  base64 encoded string. <p/>
+   *  base64 encoded string.
+   *  <p>
    *  This method is intended for parameters with simple types. For complex
    *  types, use the getChildren() method and set values for the composite
    *  parameters individually. Alternatively, you can pass a properly formed
    *  xml fragment (string) which will be used, without modification, in the
    *  SOAP/XML request.
+   *  </p>
    *  @param val Accepts either an array or a single instance of byte, string,
    *  boolean, double, float, int, short, long, decimal, java.util.Date,
    *  javaxt.utils.Date, java.io.File, and javaxt.io.File.
@@ -165,7 +167,7 @@ public void setValue(Object val){
             value = null;
             return;
         }
-        
+
         if (isComplex()){
             if (val instanceof String){
                 String str = (String) val;
@@ -271,7 +273,7 @@ else if (type.equalsIgnoreCase("string")){
    *  SOAP request.
    */
     protected String toXML(String attributes, String ns){
-        
+
         if (ns!=null) ns = ns.trim();
         else ns = "";
 
@@ -285,7 +287,7 @@ protected String toXML(String attributes, String ns){
 
             if (value instanceof byte[]){
                 xml.append("<" + name + attributes + ">");
-                xml.append(javaxt.utils.Base64.encode((byte[]) value)); 
+                xml.append(javaxt.utils.Base64.encode((byte[]) value));
                 xml.append("</" + name + ">");
             }
             else if (value instanceof Object[]){