WIP: release notes for 42.1.2

docs/_config.yml

@@ -1,3 +1,8 @@
 name: PostgreSQL JDBC Driver website
 markdown: redcarpet
 highlighter: pygments
+excerpt_separator: <!--more-->
+exclude:
+  - Gemfile
+  - Gemfile.lock
+  - README.md

docs/_includes/changelog/42.0.0-release.md → docs/_posts/2017-02-20-42.0.0-release.md

@@ -1,9 +1,24 @@
-<a name="version_42.0.0"></a>
-## Version 42.0.0 (2017-02-20)
-
-Notable changes:
-
-{% include changelog/42.0.0-notes.md %}
+---
+title:  "PostgreSQL JDBC Driver 42.0.0 Released"
+date:   2017-02-20 00:00:00 +0300
+categories:
+  - new_release
+version: 42.0.0
+---
+**Notable changes**
+
+* BUG: setCharacterStream truncates data. The bug is fixed in 42.1.0
+* BUG: no suitable driver found for jdbc:postgresql when using a DataSource implementation. The bug is fixed in 42.1.0
+* Support for PostgreSQL versions below 8.2 was dropped
+* java.util.logging is now used for logging: [logging documentation](https://jdbc.postgresql.org/documentation/head/logging.html)
+* Ensure executeBatch() can be used with pgbouncer. Previously pgjdbc could use server-prepared statements for batch execution even with prepareThreshold=0 (see [issue 742](https://github.com/pgjdbc/pgjdbc/issues/742))
+* Replication protocol API was added: [replication API documentation](https://jdbc.postgresql.org/documentation/head/replication.html), [GitHub PR 550](https://github.com/pgjdbc/pgjdbc/pull/550)
+* Version bumped to 42.0.0 to avoid version clash with PostgreSQL version
+* Error position is displayed when SQL has unterminated literals, comments, etc (see [issue 688](https://github.com/pgjdbc/pgjdbc/issues/688))
+
+<br>
+You may have noticed the change in the versioning of the driver, you can [read the FAQ](documentation/faq.html#versioning) for more information.
+<!--more-->
 
 AlexElin (6):
 
@@ -98,7 +113,7 @@ bd-infor (1):
 
 * docs: clarify handling of loglevel [PR#711](https://github.com/pgjdbc/pgjdbc/pull/711) [6334bac0](https://github.com/pgjdbc/pgjdbc/commit/6334bac036efaa4a9f2a445f1cbdcc310f4c6263)
 
-<a name="contributors_42.0.0"></a>
+<a name="contributors_{{ version }}"></a>
 ### Contributors to this release
 
 We thank the following people for their contributions to this release.

docs/_includes/changelog/42.1.0-release.md → docs/_posts/2017-05-04-42.1.0-release.md

@@ -1,9 +1,18 @@
-<a name="version_42.1.0"></a>
-## Version 42.1.0 (2017-05-04)
-
-Notable changes:
-
-{% include changelog/42.1.0-notes.md %}
+---
+title:  "PostgreSQL JDBC Driver 42.1.0 Released"
+date:   2017-05-04 00:00:00 +0300
+categories:
+  - new_release
+version: 42.1.0
+---
+**Notable changes**
+
+* fix: data being truncated in setCharacterStream (the bug introduced in 42.0.0) [PR#802](https://github.com/pgjdbc/pgjdbc/pull/802)
+* fix: calculation of lastReceiveLSN for logical replication [PR#801](https://github.com/pgjdbc/pgjdbc/pull/801)
+* fix: make sure org.postgresql.Driver is loaded when accessing though DataSource interface [#768](https://github.com/pgjdbc/pgjdbc/issues/768)
+* feat: support fetching a REF_CURSOR using getObject [PR#809](https://github.com/pgjdbc/pgjdbc/pull/809)
+* note: there's no 42.1.0.jre6 due to infinity handling bug. Fixed in 42.1.1.jre6
+<!--more-->
 
 Alexander Kjäll (1):
 
@@ -61,20 +70,20 @@ slmsbrhgn (1):
 
 * bug: fix data being trucated in setCharacterStream (the bug introduced in 42.0.0) [PR#802](https://github.com/pgjdbc/pgjdbc/pull/802) [28c98418](https://github.com/pgjdbc/pgjdbc/commit/28c98418b576394b7a0a4a6415ae86ba47be40ae)
 
-<a name="contributors_42.1.0"></a>
+<a name="contributors_{{ version }}"></a>
 ### Contributors to this release
 
 We thank the following people for their contributions to this release.
 
-[Alexander Kjäll](https://github.com/alexanderkjall)
-[Daniel Migowski](https://github.com/dmigowski)
-[Dave Cramer](davec@postgresintl.com)
-[Jacques Fuentes](https://github.com/jpfuentes2)
-[James](https://github.com/jamesthomp)
-[Joe Kutner](https://github.com/jkutner)
-[Jorge Solorzano](https://github.com/jorsol)
-[Philippe Marschall](https://github.com/marschall)
-[Robert Zenz](https://github.com/RobertZenz)
-[Vladimir Gordiychuk](https://github.com/Gordiychuk)
-[Vladimir Sitnikov](https://github.com/vlsi)
-[slmsbrhgn](https://github.com/slmsbrhgn)
+[Alexander Kjäll](https://github.com/alexanderkjall)  
+[Daniel Migowski](https://github.com/dmigowski)  
+[Dave Cramer](davec@postgresintl.com)  
+[Jacques Fuentes](https://github.com/jpfuentes2)  
+[James](https://github.com/jamesthomp)  
+[Joe Kutner](https://github.com/jkutner)  
+[Jorge Solorzano](https://github.com/jorsol)  
+[Philippe Marschall](https://github.com/marschall)  
+[Robert Zenz](https://github.com/RobertZenz)  
+[Vladimir Gordiychuk](https://github.com/Gordiychuk)  
+[Vladimir Sitnikov](https://github.com/vlsi)  
+[slmsbrhgn](https://github.com/slmsbrhgn)  

docs/_includes/changelog/42.1.1-release.md → docs/_posts/2017-05-05-42.1.1-release.md

@@ -1,16 +1,21 @@
-<a name="version_42.1.1"></a>
-## Version 42.1.1 (2017-05-05)
+---
+title:  "PostgreSQL JDBC Driver 42.1.1 Released"
+date:   2017-05-05 00:00:00 +0300
+categories:
+  - new_release
+version: 42.1.1
+---
+**Notable changes**
 
-Notable changes:
-
-{% include changelog/42.1.1-notes.md %}
+* fix: infinite dates might be corrupted when transferred in binary for certain JREs. For instance, 5881610-07-11 instead of infinity.
+<!--more-->
 
 Vladimir Sitnikov (2):
 
 * fix: infinite dates might be corrupted when transferred in binary for certain JREs [1e5bf563](https://github.com/pgjdbc/pgjdbc/commit/1e5bf563f41203417281117ed20b183cd295b4e0)
 * chore: print "include notable changes" to the generated changelog [6bc4fe07](https://github.com/pgjdbc/pgjdbc/commit/6bc4fe0758510243d1f3cb56b0b1ae374117f7e4)
 
-<a name="contributors_42.1.1"></a>
+<a name="contributors_{{ version }}"></a>
 ### Contributors to this release
 
 We thank the following people for their contributions to this release.

docs/_posts/2017-07-12-42.1.2-release.md

@@ -0,0 +1,64 @@
+---
+title: PostgreSQL JDBC Driver 42.1.2 Released
+date: 2017-07-12 18:11:06 +0300
+categories:
+  - new_release
+version: 42.1.2
+---
+**Notable changes**
+
+* Better logic for *returning* keyword detection. Previously, pgjdbc could be defeated by column names that contain *returning*, so pgjdbc failed to "return generated keys" as it considered statement as already having *returning* keyword [PR#824](https://github.com/pgjdbc/pgjdbc/pull/824) [201daf1d](https://github.com/pgjdbc/pgjdbc/commit/201daf1dc916bbc35e2bbec961aebfd1b1e30bfc) 
+* Replication API: fix issue #834 setting statusIntervalUpdate causes high CPU load [PR#835](https://github.com/pgjdbc/pgjdbc/pull/835) [59236b74](https://github.com/pgjdbc/pgjdbc/commit/59236b74acdd400d9d91d3eb2bb07d70b15392e5)
+* perf: use server-prepared statements for batch inserts when prepareThreshold>0. Note: this enables batch to use server-prepared from the first *executeBatch()* execution (previously it waited for *prepareThreshold* *executeBatch()* calls)  [abc3d9d7](https://github.com/pgjdbc/pgjdbc/commit/abc3d9d7f34a001322fbbe53f25d5e77a33a667f)
+<!--more-->
+
+AlexElin (1):
+
+* refactor: make PSQLState as enum [PR#837](https://github.com/pgjdbc/pgjdbc/pull/837) [fb5df7fe](https://github.com/pgjdbc/pgjdbc/commit/fb5df7fee1d3568356e680c6ac5a62336ec7bf6e)
+
+Dave Cramer (8):
+
+* Initial support of partitioned tables via JDBC metadata API [PR#823](https://github.com/pgjdbc/pgjdbc/pull/823) [9c3471f2](https://github.com/pgjdbc/pgjdbc/commit/9c3471f21f6ac9cf1a5e5700115ac7d0d55e0ad9)
+* fix javadoc complaints and some small edits to replication comments [PR#832](https://github.com/pgjdbc/pgjdbc/pull/832) [2d0bfceb](https://github.com/pgjdbc/pgjdbc/commit/2d0bfcebb0641ddb73d9297e6211f75537238b15)
+* fix issue #834 setting statusIntervalUpdate causes high CPU load \ [PR#835](https://github.com/pgjdbc/pgjdbc/pull/835) [59236b74](https://github.com/pgjdbc/pgjdbc/commit/59236b74acdd400d9d91d3eb2bb07d70b15392e5)
+* fix issue #838 make sure we don't get columns that are dropped [PR#840](https://github.com/pgjdbc/pgjdbc/pull/840) [464a2d43](https://github.com/pgjdbc/pgjdbc/commit/464a2d43519004174f1b530a595ee0ad9ffda870)
+* add missing connection documentation, fix spelling [PR#846](https://github.com/pgjdbc/pgjdbc/pull/846) [cd400f6f](https://github.com/pgjdbc/pgjdbc/commit/cd400f6f39d3c062fc94fa97b33b4d272a829a24)
+* more spelling mistakes for preferQueryMode [PR#850](https://github.com/pgjdbc/pgjdbc/pull/850) [73bc3c1b](https://github.com/pgjdbc/pgjdbc/commit/73bc3c1b7acda676f366631ff7e28f09a3399f37)
+* fix formatting of section on failover, still not perfect but better [PR#852](https://github.com/pgjdbc/pgjdbc/pull/852) [9f722014](https://github.com/pgjdbc/pgjdbc/commit/9f72201458d1ce0837e9525d947dcea2828b9475)
+* small reformat to clarify read and write connections [PR#854](https://github.com/pgjdbc/pgjdbc/pull/854) [551d71b6](https://github.com/pgjdbc/pgjdbc/commit/551d71b6a513c223d8d8d8d75afbe8b5d42ce783)
+
+Jorge Solorzano (3):
+
+* test: yet another rename to use "lsn" not "location" in Pg10. [PR#822](https://github.com/pgjdbc/pgjdbc/pull/822) [90228621](https://github.com/pgjdbc/pgjdbc/commit/902286212df19b1eda9310c4174756786ad249c7)
+* use zulu-9 [PR#828](https://github.com/pgjdbc/pgjdbc/pull/828) [4ac74886](https://github.com/pgjdbc/pgjdbc/commit/4ac74886e54e7689035be00c417a536717a45318)
+* fix: remove type name from cast exception of getBoolean and setObject [PR#781](https://github.com/pgjdbc/pgjdbc/pull/781) [394b3a2f](https://github.com/pgjdbc/pgjdbc/commit/394b3a2f4d93e9ca701d8c31b4b66fa25fca8945)
+
+Robert 'Bobby' Zenz (1):
+
+* fix: Add fallback to setObject(int, Object) for Number [PR#812](https://github.com/pgjdbc/pgjdbc/pull/812) [5b9edb7d](https://github.com/pgjdbc/pgjdbc/commit/5b9edb7dfb1b281bffedf7c9f2583f2df354c0ea)
+
+Vladimir Gordiychuk (1):
+
+* bug: floating logical replcation test [PR#829](https://github.com/pgjdbc/pgjdbc/pull/829) [2d3e8972](https://github.com/pgjdbc/pgjdbc/commit/2d3e8972a0b34106a8b7426619cabf852c38ddaa)
+
+Vladimir Sitnikov (7):
+
+* chore: implement a script to stage pgjdbc, pgdjbc-jre7, pgjdbc-jre6 artifacts [15d78839](https://github.com/pgjdbc/pgjdbc/commit/15d7883987d2de4b662aa8cd81c6de5be0257153)
+* doc: fix 42.1.0.jre8->jre6 typo [PR#42](https://github.com/pgjdbc/pgjdbc/pull/42) [88942b58](https://github.com/pgjdbc/pgjdbc/commit/88942b58637afbea16102a6a77d922914fd27562)
+* fix: use server-prepared statements for batch inserts when prepareThreshold>0 [abc3d9d7](https://github.com/pgjdbc/pgjdbc/commit/abc3d9d7f34a001322fbbe53f25d5e77a33a667f)
+* fix: better parsing for returning keyword [PR#824](https://github.com/pgjdbc/pgjdbc/pull/824) [201daf1d](https://github.com/pgjdbc/pgjdbc/commit/201daf1dc916bbc35e2bbec961aebfd1b1e30bfc)
+* docs: build index, changelog pages from _posts/... to reduce release overhead [d6fe07d7](https://github.com/pgjdbc/pgjdbc/commit/d6fe07d7bb613d7b8fb06ace64b9b37d3f23bbfe)
+* chore: make ./release_notes.sh create docs/_posts/$DATE_YMD-$VERS-release.md file [e00d4571](https://github.com/pgjdbc/pgjdbc/commit/e00d4571bb6ca24c8f93956b59fd1c9a14131394)
+* docs: add 42.1.2 release notes [6f127a61](https://github.com/pgjdbc/pgjdbc/commit/6f127a61eed5317133ea80f0a06f9441b170a17a)
+
+<a name="contributors_42.1.2"></a>
+### Contributors to this release
+
+We thank the following people for their contributions to this release.
+
+[AlexElin](https://github.com/AlexElin)  
+[Dave Cramer](davec@postgresintl.com)  
+[Jorge Solorzano](https://github.com/jorsol)  
+[Robert 'Bobby' Zenz](https://github.com/RobertZenz)  
+[Vladimir Gordiychuk](https://github.com/Gordiychuk)  
+[Vladimir Sitnikov](https://github.com/vlsi)  

docs/documentation/changelog.md

@@ -6,14 +6,11 @@ nav: ../
 ---
 
 # History of Changes
+{% comment %}There are no new lines after "for" and after "endfor" below in order to keep formatting of the output list sane.{% endcomment %}
 * [Introduction and explanation of symbols](#introduction)
-* [Version 42.1.1 (2017-05-05)](#version_42.1.1)
-	* [Contributors to this release](#contributors_42.1.1)
-* [Version 42.1.0 (2017-05-04)](#version_42.1.0)
-	* [Contributors to this release](#contributors_42.1.0)
-* [Version 42.0.0 (2017-02-18)](#version_42.0.0)
-	* [Contributors to this release](#contributors_42.0.0)
-* [Version 9.4.1212 (2016-11-01)](#version_9.4.1212)
+{% for post in site.categories.new_release %}* [Version {{ post.version }} ({{ post.date | date: "%Y-%d-%m"}})](#version_{{ post.version }})
+	* [Contributors to this release](#contributors_{{ post.version }})
+{% endfor %}* [Version 9.4.1212 (2016-11-01)](#version_9.4.1212)
 	* [Contributors to this release](#contributors_9.4.1212)
 * [Version 9.4.1211 (2016-09-18)](#version_9.4.1211)
 	* [Contributors to this release](#contributors_9.4.1211)
@@ -78,11 +75,11 @@ denote the various action types:![add](../media/img/add.jpg)=add,
 <img alt="update" src="../media/img/update.jpg" />=update
 ***
 
-{% include changelog/42.1.1-release.md %}
-
-{% include changelog/42.1.0-release.md %}
-
-{% include changelog/42.0.0-release.md %}
+{% for post in site.categories.new_release %}
+<a name="version_{{ post.version }}"></a>
+## Version {{ post.version }} ({{ post.date | date: "%Y-%d-%m"}})
+{{ post.content }}
+{% endfor %}
 
 <a name="version_9.4.1212"></a>
 ## Version 9.4.1212 (2016-11-02)

docs/download.md

@@ -24,9 +24,13 @@ downloading the appropriate JAR file and dropping it into your
 classpath.  Source versions are also available here for recent
 driver versions.
 
+{% for post in site.categories.new_release limit:1 %}
+{% capture current_version %}{{ post.version }}{% endcapture %}
+{% endfor %}
+
 ***
 <a name="current"></a>
-## Current Version *42.1.1*
+## Current Version *{{ current_version }}*
 
 This is the current version of the driver.  Unless you have unusual
 requirements (running old applications or JVMs), this is the driver
@@ -41,12 +45,11 @@ javax.sql package.
 you will need to use a JDBC3 version of the driver, which will by
 necessity not be current, found in [Other Versions](#others).
 
+[PostgreSQL JDBC 4.2 Driver, {{ current_version }}](download/postgresql-{{ current_version }}.jar)
 
-[PostgreSQL JDBC 4.0 Driver, 42.1.1](download/postgresql-42.1.1.jre6.jar)
-
-[PostgreSQL JDBC 4.1 Driver, 42.1.1](download/postgresql-42.1.1.jre7.jar)
+[PostgreSQL JDBC 4.1 Driver, {{ current_version }}.jre7](download/postgresql-{{ current_version }}.jre7.jar)
 
-[PostgreSQL JDBC 4.2 Driver, 42.1.1](download/postgresql-42.1.1.jar)
+[PostgreSQL JDBC 4.0 Driver, {{ current_version }}.jre6](download/postgresql-{{ current_version }}.jre6.jar)
 
 
 ***
@@ -86,29 +89,17 @@ versions of the JVM with the JDBC specification implemented.
 	<th>JDBC 4.2</th>
 	<th>Source</th>
 </tr>
-<tr>
-	<td>42.1.1</td>
-	<td><a href="download/postgresql-42.1.1.jre6.jar">42.1.1 JDBC 4</a></td>
-	<td><a href="download/postgresql-42.1.1.jre7.jar">42.1.1 JDBC 41</a></td>
-	<td><a href="download/postgresql-42.1.1.jar">42.1.1 JDBC 42</a></td>
-	<td><a href="download/postgresql-jdbc-42.1.1.src.tar.gz">42.1.1 JDBC Source</a></td>
-</tr>
-
-<tr>
-	<td>42.1.0</td>
-	<td>n/a</td>
-	<td><a href="download/postgresql-42.1.0.jre7.jar">42.1.0 JDBC 41</a></td>
-	<td><a href="download/postgresql-42.1.0.jar">42.1.0 JDBC 42</a></td>
-	<td><a href="download/postgresql-jdbc-42.1.0.src.tar.gz">42.1.0 JDBC Source</a></td>
-</tr>
 
+{% for post in site.categories.new_release %}
+{% capture ver %}{{ post.version }}{% endcapture %}
 <tr>
-	<td>42.0.0</td>
-	<td><a href="download/postgresql-42.0.0.jre6.jar">42.0.0 JDBC 4</a></td>
-	<td><a href="download/postgresql-42.0.0.jre7.jar">42.0.0 JDBC 41</a></td>
-	<td><a href="download/postgresql-42.0.0.jar">42.0.0 JDBC 42</a></td>
-	<td><a href="download/postgresql-jdbc-42.0.0.src.tar.gz">42.0.0 JDBC Source</a></td>
+	<td>{{ ver }}</td>
+	<td><a href="download/postgresql-{{ ver }}.jre6.jar">{{ ver }} JDBC 4</a></td>
+	<td><a href="download/postgresql-{{ ver }}.jre7.jar">{{ ver }} JDBC 41</a></td>
+	<td><a href="download/postgresql-{{ ver }}.jar">{{ ver }} JDBC 42</a></td>
+	<td><a href="download/postgresql-jdbc-{{ ver }}.src.tar.gz">{{ ver }} JDBC Source</a></td>
 </tr>
+{% endfor %}
 
 <tr>
 	<td>9.4.1212</td>

docs/index.html

@@ -10,24 +10,14 @@
 					<!-- <div id="pgFrontMain"> -->
 						<div id="pgFrontFeature">
 							<div id="pgFrontFeatureContent">
-								<p class="txtDate"><strong>May 05 2017</strong></p>
-								<h1 id="txtFrontFeatureHeading">PostgreSQL JDBC Driver 42.1.1 Released!</h1>
-								<p>
-									<strong>Notable changes</strong><br/>
-									{% capture notes%}{% include changelog/42.1.1-notes.md %}{% endcapture %}
-									{{ notes | markdownify }}
-								</p>
-								<p class="txtDate"><strong>May 04 2017</strong></p>
-								<h1 id="txtFrontFeatureHeading">PostgreSQL JDBC Driver 42.1.0 Released!</h1>
-								<p>
-									<strong>Notable changes</strong><br/>
-									{% capture notes%}{% include changelog/42.1.0-notes.md %}{% endcapture %}
-									{{ notes | markdownify }}
-								</p>
-								<p>
-									You may have noticed the change in the versioning of the driver, you can
-									<a href="documentation/faq.html#versioning">read the FAQ</a> for more information.
-								</p>
+								{% for post in site.posts %}
+								<p class="txtDate"><strong>{{ post.date | date_to_long_string }}</strong></p>
+								<h1 id="txtFrontFeatureHeading">{{ post.title }}</h1>
+								<div>
+								{{ post.excerpt | prepend: "<!--start-->" | split: "<!--start-->" | last }}
+								</div>
+								<p>See full <a href="/documentation/changelog.html#version_{{ post.version}}">changelog for {{ post.version}}</a>
+								{% endfor %}
 								<div id="txtFrontFeatureLink">
 									<br/>
 									<img src="media/img/layout/blt_blu_arrow.png" width="6" height="6" alt="" />