[SQLLINE-186] Added setting TerminalBuilder.PROP_DUMB before and afte…

HISTORY.md

@@ -2,6 +2,142 @@
 
 For a full list of releases, see <a href="https://github.com/julianhyde/sqlline/releases">github</a>.
 
+## <a href="https://github.com/julianhyde/sqlline/releases/tag/sqlline-1.6.0">1.6.0</a> (2018-11-26)
+
+This is the most colorful and interactive SQLLine ever! Upgrading to
+<a href="https://github.com/julianhyde/sqlline/issues/105">`jline3`</a>
+and improved
+<a href="https://github.com/julianhyde/sqlline/issues/190">dialect support</a>
+allowed us to add
+<a href="https://github.com/julianhyde/sqlline/issues/164">syntax highlighting</a>,
+<a href="https://github.com/julianhyde/sqlline/issues/190">line continuation</a>
+and
+<a href="https://github.com/julianhyde/sqlline/issues/184">multi-line editing</a>.
+There are new commands
+<a href="https://github.com/julianhyde/sqlline/issues/105">`!rerun`</a>,
+<a href="https://github.com/julianhyde/sqlline/issues/105">`!/`</a> and
+<a href="https://github.com/julianhyde/sqlline/issues/143">`!reset`</a>,
+new properties
+<a href="https://github.com/julianhyde/sqlline/issues/164">`colorScheme`</a>,
+<a href="https://github.com/julianhyde/sqlline/issues/151">`escapeOutput`</a>,
+<a href="https://github.com/julianhyde/sqlline/issues/177">`maxHistoryRows`</a>,
+<a href="https://github.com/julianhyde/sqlline/issues/177">`maxHistoryFileRows`</a>,
+<a href="https://github.com/julianhyde/sqlline/issues/60">`mode`</a>,
+<a href="https://github.com/julianhyde/sqlline/issues/199">`prompt`</a>,
+<a href="https://github.com/julianhyde/sqlline/issues/199">`rightPrompt`</a>,
+<a href="https://github.com/julianhyde/sqlline/issues/183">`strictJdbc`</a>,
+<a href="https://github.com/julianhyde/sqlline/issues/190">`useLineContinuation`</a>,
+<a href="https://github.com/julianhyde/sqlline/issues/146">`version`</a>,
+and improvements to existing commands.
+
+This release requires Java version 8 or higher. (Since the previous
+release, we have dropped support for JDK 1.6 and 1.7.)
+
+WARNING: Between version 2 and 3, jline changed the format of its
+history file. After this change, you may need to remove your history
+file (~/.sqlline/history) or provide a `--historyfile` argument before
+SQLLine will start successfully.
+
+Bugs and functional changes:
+
+* [<a href="https://github.com/julianhyde/sqlline/issues/218">SQLLINE-218</a>]
+  Update default of `maxColumnWidth` property to -1,
+  and add getter to `SqlLineOpts` for `maxWidth` property
+* [<a href="https://github.com/julianhyde/sqlline/issues/213">SQLLINE-213</a>]
+  Syntax highlighting does not work for `!sql`, `!all` commands
+* [<a href="https://github.com/julianhyde/sqlline/issues/215">SQLLINE-215</a>]
+  `!metadata 1` command should not show private methods, or methods inherited
+  from `java.lang.Object`
+* [<a href="https://github.com/julianhyde/sqlline/issues/183">SQLLINE-183</a>]
+  Add wrapper around `DatabaseMetaData`, to make SQLLine less susceptible to
+  errors in underlying JDBC driver
+* [<a href="https://github.com/julianhyde/sqlline/issues/60">SQLLINE-60</a>]
+  Add 'vi' editing mode, and add `mode` property to switch between emacs and
+  vi
+* [<a href="https://github.com/julianhyde/sqlline/issues/199">SQLLINE-199</a>]
+  Make use of jline3's powerful `StyleResolver` functionality to parse styles
+* [<a href="https://github.com/julianhyde/sqlline/issues/199">SQLLINE-199</a>]
+  Add `prompt` and `rightPrompt` properties to allow customization of prompt
+  and right prompt
+* [<a href="https://github.com/julianhyde/sqlline/issues/201">SQLLINE-201</a>]
+  Line continuation and highlight for sqlline comments
+* [<a href="https://github.com/julianhyde/sqlline/issues/203">SQLLINE-203</a>]
+  Carry on even if JDBC driver's `ResultSetMetaData.getColumnDisplaySize()`
+  throws
+* [<a href="https://github.com/julianhyde/sqlline/issues/205">SQLLINE-205</a>]
+  Show human-readable message if `!go` command fails
+* [<a href="https://github.com/julianhyde/sqlline/issues/190">SQLLINE-190</a>]
+  Make sure that exceptions during highlighting/line continuation do not cause
+  infinite loops
+* [<a href="https://github.com/julianhyde/sqlline/issues/190">SQLLINE-190</a>]
+  Add `Dialect` API, and various database-specific behaviors
+* [<a href="https://github.com/julianhyde/sqlline/issues/164">SQLLINE-164</a>]
+  Syntax highlighting
+* [<a href="https://github.com/julianhyde/sqlline/issues/184">SQLLINE-184</a>]
+  Multi-line parsing is fooled by a line that ends in a semi-colon followed by
+  a comment
+* [<a href="https://github.com/julianhyde/sqlline/issues/168">SQLLINE-168</a>]
+  In multiline parsing, detect mismatched brackets and parentheses
+* [<a href="https://github.com/julianhyde/sqlline/issues/129">SQLLINE-129</a>]
+  Allow multiline query parsing in shell mode and files
+* [<a href="https://github.com/julianhyde/sqlline/issues/151">SQLLINE-151</a>]
+  Add property `escapeOutput` to escape control symbols
+* [<a href="https://github.com/julianhyde/sqlline/issues/177">SQLLINE-177</a>]
+  Add `maxHistoryRows` and `maxHistoryFileRows` properties
+* [<a href="https://github.com/julianhyde/sqlline/issues/160">SQLLINE-160</a>]
+  Use `maxColumnWidth` in `TableOutputFormat` column width calculation
+* [<a href="https://github.com/julianhyde/sqlline/issues/158">SQLLINE-158</a>]
+  Add `xmlattrs` output format name as a synonym for `xmlattr`
+* [<a href="https://github.com/julianhyde/sqlline/issues/155">SQLLINE-155</a>]
+  Do not use default encoding
+* [<a href="https://github.com/julianhyde/sqlline/issues/155">SQLLINE-154</a>]
+  Do not use default locale
+* [<a href="https://github.com/julianhyde/sqlline/issues/105">SQLLINE-105</a>]
+  Upgrade to jline3,
+  drop support for Java versions lower than 8,
+  and add `!rerun` command (also known as `!/`)
+* [<a href="https://github.com/julianhyde/sqlline/issues/73">SQLLINE-73</a>]
+  Re-execute the previous query
+* [<a href="https://github.com/julianhyde/sqlline/issues/143">SQLLINE-143</a>]
+  Add `!reset` command, and add a mode to `!set` command to show current value
+* [<a href="https://github.com/julianhyde/sqlline/issues/146">SQLLINE-146</a>]
+  Add read-only `version` property
+
+Other:
+
+* [<a href="https://github.com/julianhyde/sqlline/issues/191">SQLLINE-191</a>]
+  Release 1.6
+* [<a href="https://github.com/julianhyde/sqlline/issues/193">SQLLINE-193</a>]
+  Add key strokes to help output
+* Upgrade JMockit to 1.41
+* [<a href="https://github.com/julianhyde/sqlline/issues/141">SQLLINE-141</a>]
+  Add test for `!save` command
+* [<a href="https://github.com/julianhyde/sqlline/issues/179">SQLLINE-179</a>]
+  Add `<useManifestOnlyJar>false</useManifestOnlyJar>` setting for
+  `maven-surefire-plugin`
+* [<a href="https://github.com/julianhyde/sqlline/issues/181">SQLLINE-181</a>]
+  Use `<code>` tag rather than `<tt>`, as `<tt>` is deprecated in HTML5
+* [<a href="https://github.com/julianhyde/sqlline/issues/166">SQLLINE-166</a>]
+  Refactor properties, adding `enum BuiltInProperty` and
+  `interface SqlLineProperty.Writer`
+* [<a href="https://github.com/julianhyde/sqlline/issues/172">SQLLINE-172</a>]
+  Travis CI fails for Oracle JDK 10
+* [<a href="https://github.com/julianhyde/sqlline/issues/98">SQLLINE-98</a>]
+  Add `appveyor.yml`, to allow CI on Windows
+* Generate javadoc in HTML 5
+* [<a href="https://github.com/julianhyde/sqlline/issues/162">SQLLINE-162</a>]
+  Various cleanup in `SqlLineArgsTest`
+* [<a href="https://github.com/julianhyde/sqlline/issues/163">SQLLINE-163</a>]
+  Upgrade `checkstyle` to 7.8.2, `maven-checkstyle-plugin` to 3.0.0 to support
+  Java 8 syntax
+* Site: Publish manual and API for release 1.5.0
+* [<a href="https://github.com/julianhyde/sqlline/issues/153">SQLLINE-153</a>]
+  Invalid link to API docs on `README.md` page
+* [<a href="https://github.com/julianhyde/sqlline/issues/149">SQLLINE-149</a>]
+  Correct typos
+* [<a href="https://github.com/julianhyde/sqlline/issues/142">SQLLINE-142</a>]
+  Add missed `-e` option in `--help` output
+
 ## <a href="https://github.com/julianhyde/sqlline/releases/tag/sqlline-1.5.0">1.5.0</a> (2018-09-09)
 
 Bugs and functional changes:

HOWTO.md

@@ -10,8 +10,9 @@ Capitalization is tricky:
 
 ## How to make a release (for committers)
 
-Make sure `mvn clean install` and `mvn site` pass under JDK 8, 9,
-10 and 11.
+Make sure `mvn clean install`, `mvn site`, and
+`mvn javadoc:javadoc javadoc:test-javadoc` pass under JDK 8, 9, 10 and
+11.
 
 Write release notes. Run the
 [relNotes](https://github.com/julianhyde/share/blob/master/tools/relNotes)
@@ -20,7 +21,7 @@ script and append the output to [HISTORY.md](HISTORY.md).
 Update version numbers in README, README.md, src/docbkx/manual.xml,
 and the copyright date in NOTICE.
 
-Switch to JDK 10.
+Switch to JDK 11.
 
 Check that the sandbox is clean:
 
@@ -32,22 +33,35 @@ mvn clean
 Prepare:
 
 ```bash
-read -s GPG_PASSPHRASE
-mvn -Prelease -DreleaseVersion=x.y.0 -DdevelopmentVersion=x.(y+1).0-SNAPSHOT -Darguments="-Dgpg.passphrase=${GPG_PASSPHRASE}" release:prepare
+export GPG_TTY=$(tty)
+mvn -Prelease -DreleaseVersion=x.y.0 -DdevelopmentVersion=x.(y+1).0-SNAPSHOT release:prepare
 ```
 
 Perform:
 
 ```bash
-mvn -Prelease -DskipTests -Darguments="-Dgpg.passphrase=${GPG_PASSPHRASE}" release:perform
+mvn -Prelease -DskipTests release:perform
 ```
 
-Publish the release:
+Stage the release:
 * Go to http://oss.sonatype.org and log in.
 * Under "Build Promotion", click on "Staging Repositories".
 * Select the line "sqlline-nnnn", and click "Close". You might need to
   click "Refresh" a couple of times before it closes.
-* If it closes without errors, click "Release".
+
+Start a vote by sending an email with subject
+"[VOTE] Release sqlline-X.Y.0 (release candidate N)" to
+[sqlline-dev](https://groups.google.com/forum/#!forum/sqlline-dev).
+Borrow the text from
+[a previous vote](https://groups.google.com/forum/#!topic/sqlline-dev/SWHPzpyBwv0)
+
+If the vote is successful, send an email with subject
+"[RESULT] [VOTE] Release sqlline-X.Y.0 (release candidate N)".
+
+Publish the release:
+* Go to http://oss.sonatype.org and log in.
+* Under "Build Promotion", click on "Staging Repositories".
+* Select the line "sqlline-nnnn", and click "Release".
 
 Wait a couple of hours for the artifacts to appear on Maven central,
 and announce the release.

README

@@ -1,4 +1,4 @@
-SQLLine release 1.5.0
+SQLLine release 1.6.0
 
 This is a source or binary distribution of SQLLine.
 

README.md

@@ -27,7 +27,7 @@ If you have [Coursier](https://github.com/coursier/coursier) installed, you
 can quickly connect to a [demo Hypersonic database](https://github.com/julianhyde/foodmart-data-hsqldb) with:
 
 ```
-$ coursier launch sqlline:sqlline:1.5.0 org.hsqldb:hsqldb:2.4.1 net.hydromatic:foodmart-data-hsqldb:0.4 -M sqlline.SqlLine -- -u jdbc:hsqldb:res:foodmart -n FOODMART -p FOODMART -d org.hsqldb.jdbcDriver
+$ coursier launch sqlline:sqlline:1.6.0 org.hsqldb:hsqldb:2.4.1 net.hydromatic:foodmart-data-hsqldb:0.4 -M sqlline.SqlLine -- -u jdbc:hsqldb:res:foodmart -n FOODMART -p FOODMART -d org.hsqldb.jdbcDriver
 0: jdbc:hsqldb:res:foodmart> select avg("shelf_height" * "shelf_width" * "shelf_depth") as "avg_volume" from "product";
 +-------------------------+
 |       avg_volume        |
@@ -90,7 +90,7 @@ Use the following definition to use `sqlline` in your maven project:
 <dependency>
   <groupId>sqlline</groupId>
   <artifactId>sqlline</artifactId>
-  <version>1.5.0</version>
+  <version>1.6.0</version>
 </dependency>
 ```
 
@@ -99,7 +99,7 @@ Use the following definition to use `sqlline` in your maven project:
 Prerequisites:
 
 * Maven 3.2.5 or higher
-* Java 1.6 or higher (10 preferred)
+* Java 8 or higher (10 preferred)
 
 Check out and build:
 
@@ -133,6 +133,7 @@ mvn package
   <a href="mailto:sqlline-dev@googlegroups.com">sqlline-dev at googlegroups.com</a>
   (<a href="https://groups.google.com/group/sqlline-dev/topics">archive</a>,
   <a href="https://groups.google.com/group/sqlline-dev/subscribe">subscribe</a>)
+* Twitter: [@SQLLineShell](https://twitter.com/SQLLineShell)
 * [Issues](https://github.com/julianhyde/sqlline/issues)
 * [Release notes and history](HISTORY.md)
 * [HOWTO](HOWTO.md)