postgresql-jdbc.git / summary / log / commit / refs

commit    bc63b4316e47a08b23e4fd973b488cb0c5ffec60
Author:   Stephen Nelson <stephen@eccostudio.com>
Date:     Mon Jul 14 10:15:23 2014 +0000

    Fixing javadoc comments to allow Ant publicapi task to succeed


 org/postgresql/copy/PGCopyInputStream.java         |  1 -
 org/postgresql/ds/common/BaseDataSource.java       |  2 +-
 org/postgresql/geometric/PGpoint.java              |  3 +-
 .../ssl/SingleCertValidatingFactory.java           | 33 +++++++++++-----------
 4 files changed, 19 insertions(+), 20 deletions(-)

diff --git a/org/postgresql/copy/PGCopyInputStream.java b/org/postgresql/copy/PGCopyInputStream.java
index 6abb04f7..dd66beab 100644
--- a/org/postgresql/copy/PGCopyInputStream.java
+++ b/org/postgresql/copy/PGCopyInputStream.java
@@ -37,7 +37,6 @@ public class PGCopyInputStream extends InputStream implements CopyOut {
     /**
      * Use given CopyOut operation for reading
      * @param op COPY TO STDOUT operation
-     * @throws SQLException if initializing the operation fails
      */
     public PGCopyInputStream(CopyOut op) {
         this.op = op;
diff --git a/org/postgresql/ds/common/BaseDataSource.java b/org/postgresql/ds/common/BaseDataSource.java
index b86ee2be..ca8be242 100644
--- a/org/postgresql/ds/common/BaseDataSource.java
+++ b/org/postgresql/ds/common/BaseDataSource.java
@@ -512,7 +512,7 @@ public abstract class BaseDataSource implements Referenceable
 
     /**
      * Set the state of column sanitiser optimisation.
-     * @param boolean new optimisation state
+     * @param disableColumnSanitiser new optimisation state
      */
 	public void setDisableColumnSanitiser(boolean disableColumnSanitiser) {
 		this.disableColumnSanitiser = disableColumnSanitiser;
diff --git a/org/postgresql/geometric/PGpoint.java b/org/postgresql/geometric/PGpoint.java
index f1055239..31f106eb 100644
--- a/org/postgresql/geometric/PGpoint.java
+++ b/org/postgresql/geometric/PGpoint.java
@@ -128,7 +128,8 @@ public class PGpoint extends PGobject implements PGBinaryObject, Serializable, C
     }
 
     /**
-     * @return the PGpoint in the binary syntax expected by org.postgresql
+     * Populate the byte array with PGpoint in the binary syntax expected
+     * by org.postgresql
      */
     public void toBytes(byte[] b, int offset) {
         ByteConverter.float8(b, offset, x);
diff --git a/org/postgresql/ssl/SingleCertValidatingFactory.java b/org/postgresql/ssl/SingleCertValidatingFactory.java
index e1ffba48..eda65cb1 100644
--- a/org/postgresql/ssl/SingleCertValidatingFactory.java
+++ b/org/postgresql/ssl/SingleCertValidatingFactory.java
@@ -35,46 +35,45 @@ import org.postgresql.ssl.WrappedFactory;
  * more secure than relying on a central CA signing your server's certificate
  * as it pins the server's certificate.
  * 
- * <p />
- *
+ * <p>
  * This class requires a single String parameter specified by setting
  * the connection property <code>sslfactoryarg</code>. The value of this property
  * is the PEM-encoded remote server's SSL certificate.
- *
- * <p />
+ * </p>
+ * <p>
  * Where the certificate is loaded from is based upon the prefix of the 
- * <code>sslfactoryarg</code> property. The following table lists the valid
+ * <pre><code>sslfactoryarg</code></pre> property. The following table lists the valid
  * set of prefixes.
- * <table border="1">
+ * <table border="1" summary="Valid prefixes for sslfactoryarg">
  *   <tr>
  *     <th>Prefix</th>
  *     <th>Example</th>
  *     <th>Explanation</th>
  *   </tr>
  *   <tr>
- *     <td><code>classpath:</code></td>
- *     <td><code>classpath:ssl/server.crt</code></td>
+ *     <td><pre><code>classpath:</code></pre></td>
+ *     <td><pre><code>classpath:ssl/server.crt</code></pre></td>
  *     <td>Loaded from the classpath.</td>
  *   </tr>
  *   <tr>
- *     <td><code>file:</code></td>
- *     <td><code>file:/foo/bar/server.crt</code></td>
+ *     <td><pre><code>file:</code></pre></td>
+ *     <td><pre><code>file:/foo/bar/server.crt</code></pre></td>
  *     <td>Loaded from the filesystem.</td>
  *   </tr>
  *   <tr>
- *     <td><code>env:</code></td>
- *     <td><code>env:mydb_cert<pre>
- *     <td>Loaded from string value of the <code>mydb_cert</code>
+ *     <td><pre><code>env:</code></pre></td>
+ *     <td><pre><code>env:mydb_cert</code></pre></td>
+ *     <td>Loaded from string value of the <pre><code>mydb_cert</code></pre>
  *     environment variable.</td>
  *   </tr>
  *   <tr>
- *     <td><code>sys:</code></td>
- *     <td><code>sys:mydb_cert<pre>
- *     <td>Loaded from string value of the <code>mydb_cert</code>
+ *     <td><pre><code>sys:</code></pre></td>
+ *     <td><pre><code>sys:mydb_cert</code></pre></td>
+ *     <td>Loaded from string value of the <pre><code>mydb_cert</code></pre>
  *     system property.</td>
  *   </tr>
  *   <tr>
- *     <td><code>-----BEGIN CERTIFICATE------</code></td>
+ *     <td><pre>-----BEGIN CERTIFICATE------</pre></td>
  *     <td><pre>
 -----BEGIN CERTIFICATE-----
 MIIDQzCCAqygAwIBAgIJAOd1tlfiGoEoMA0GCSqGSIb3DQEBBQUAMHUxCzAJBgNV


[parent: 841e7c306a3c]