diff --git a/README.md b/README.md
index 7e4621e..13712e7 100644
--- a/README.md
+++ b/README.md
@@ -45,7 +45,7 @@ Add a dependency to your `build.gradle`:
 
 ```
 dependencies {
-  compile 'org.hjson:hjson:3.0.1'
+  compile 'org.hjson:hjson:3.1.0'
 }
 ```
 
@@ -57,7 +57,7 @@ Add a dependency to your `pom.xml`:
 <dependency>
   <groupId>org.hjson</groupId>
   <artifactId>hjson</artifactId>
-  <version>3.0.1</version>
+  <version>3.1.0</version>
 </dependency>
 ```
 
@@ -67,7 +67,7 @@ Add a dependency to your `ivy.xml`:
 
 ```xml
 <dependencies>
-  <dependency org="org.hjson" name="hjson" rev="3.0.1"/>
+  <dependency org="org.hjson" name="hjson" rev="3.1.0"/>
 </dependencies>
 ```
 
diff --git a/docs/allclasses-frame.html b/docs/allclasses-frame.html
index 70a7f4d..b78d2d4 100644
--- a/docs/allclasses-frame.html
+++ b/docs/allclasses-frame.html
@@ -3,7 +3,7 @@
 <html lang="en">
 <head>
 <!-- Generated by javadoc -->
-<title>All Classes (hjson 3.0.1 API)</title>
+<title>All Classes (hjson 3.1.0 API)</title>
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>
diff --git a/docs/allclasses-noframe.html b/docs/allclasses-noframe.html
index 6a34fcf..ebe7b9b 100644
--- a/docs/allclasses-noframe.html
+++ b/docs/allclasses-noframe.html
@@ -3,7 +3,7 @@
 <html lang="en">
 <head>
 <!-- Generated by javadoc -->
-<title>All Classes (hjson 3.0.1 API)</title>
+<title>All Classes (hjson 3.1.0 API)</title>
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>
diff --git a/docs/constant-values.html b/docs/constant-values.html
index cd87fbb..fce4220 100644
--- a/docs/constant-values.html
+++ b/docs/constant-values.html
@@ -3,7 +3,7 @@
 <html lang="en">
 <head>
 <!-- Generated by javadoc -->
-<title>Constant Field Values (hjson 3.0.1 API)</title>
+<title>Constant Field Values (hjson 3.1.0 API)</title>
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>
@@ -11,7 +11,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="Constant Field Values (hjson 3.0.1 API)";
+            parent.document.title="Constant Field Values (hjson 3.1.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/deprecated-list.html b/docs/deprecated-list.html
index c839f2f..d8259b5 100644
--- a/docs/deprecated-list.html
+++ b/docs/deprecated-list.html
@@ -3,7 +3,7 @@
 <html lang="en">
 <head>
 <!-- Generated by javadoc -->
-<title>Deprecated List (hjson 3.0.1 API)</title>
+<title>Deprecated List (hjson 3.1.0 API)</title>
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>
@@ -11,7 +11,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="Deprecated List (hjson 3.0.1 API)";
+            parent.document.title="Deprecated List (hjson 3.1.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/help-doc.html b/docs/help-doc.html
index 644e4ee..6be979c 100644
--- a/docs/help-doc.html
+++ b/docs/help-doc.html
@@ -3,7 +3,7 @@
 <html lang="en">
 <head>
 <!-- Generated by javadoc -->
-<title>API Help (hjson 3.0.1 API)</title>
+<title>API Help (hjson 3.1.0 API)</title>
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>
@@ -11,7 +11,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="API Help (hjson 3.0.1 API)";
+            parent.document.title="API Help (hjson 3.1.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/index-all.html b/docs/index-all.html
index 963a1e9..35be689 100644
--- a/docs/index-all.html
+++ b/docs/index-all.html
@@ -3,7 +3,7 @@
 <html lang="en">
 <head>
 <!-- Generated by javadoc -->
-<title>Index (hjson 3.0.1 API)</title>
+<title>Index (hjson 3.1.0 API)</title>
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>
@@ -11,7 +11,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="Index (hjson 3.0.1 API)";
+            parent.document.title="Index (hjson 3.1.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/index.html b/docs/index.html
index 23c182e..24b2f86 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -3,7 +3,7 @@
 <html lang="en">
 <head>
 <!-- Generated by javadoc -->
-<title>hjson 3.0.1 API</title>
+<title>hjson 3.1.0 API</title>
 <script type="text/javascript">
     tmpTargetPage = "" + window.location.search;
     if (tmpTargetPage != "" && tmpTargetPage != "undefined")
diff --git a/docs/org/hjson/HjsonDsf.html b/docs/org/hjson/HjsonDsf.html
index e449b80..d9f85ec 100644
--- a/docs/org/hjson/HjsonDsf.html
+++ b/docs/org/hjson/HjsonDsf.html
@@ -3,7 +3,7 @@
 <html lang="en">
 <head>
 <!-- Generated by javadoc -->
-<title>HjsonDsf (hjson 3.0.1 API)</title>
+<title>HjsonDsf (hjson 3.1.0 API)</title>
 <link rel="stylesheet" type="text/css" href="../../stylesheet.css" title="Style">
 <script type="text/javascript" src="../../script.js"></script>
 </head>
@@ -11,7 +11,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="HjsonDsf (hjson 3.0.1 API)";
+            parent.document.title="HjsonDsf (hjson 3.1.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/org/hjson/HjsonOptions.html b/docs/org/hjson/HjsonOptions.html
index ca86f7b..f28d1c4 100644
--- a/docs/org/hjson/HjsonOptions.html
+++ b/docs/org/hjson/HjsonOptions.html
@@ -3,7 +3,7 @@
 <html lang="en">
 <head>
 <!-- Generated by javadoc -->
-<title>HjsonOptions (hjson 3.0.1 API)</title>
+<title>HjsonOptions (hjson 3.1.0 API)</title>
 <link rel="stylesheet" type="text/css" href="../../stylesheet.css" title="Style">
 <script type="text/javascript" src="../../script.js"></script>
 </head>
@@ -11,7 +11,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="HjsonOptions (hjson 3.0.1 API)";
+            parent.document.title="HjsonOptions (hjson 3.1.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/org/hjson/IHjsonDsfProvider.html b/docs/org/hjson/IHjsonDsfProvider.html
index eb4f6c1..1034540 100644
--- a/docs/org/hjson/IHjsonDsfProvider.html
+++ b/docs/org/hjson/IHjsonDsfProvider.html
@@ -3,7 +3,7 @@
 <html lang="en">
 <head>
 <!-- Generated by javadoc -->
-<title>IHjsonDsfProvider (hjson 3.0.1 API)</title>
+<title>IHjsonDsfProvider (hjson 3.1.0 API)</title>
 <link rel="stylesheet" type="text/css" href="../../stylesheet.css" title="Style">
 <script type="text/javascript" src="../../script.js"></script>
 </head>
@@ -11,7 +11,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="IHjsonDsfProvider (hjson 3.0.1 API)";
+            parent.document.title="IHjsonDsfProvider (hjson 3.1.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/org/hjson/JsonArray.html b/docs/org/hjson/JsonArray.html
index b277ef4..e858b75 100644
--- a/docs/org/hjson/JsonArray.html
+++ b/docs/org/hjson/JsonArray.html
@@ -3,7 +3,7 @@
 <html lang="en">
 <head>
 <!-- Generated by javadoc -->
-<title>JsonArray (hjson 3.0.1 API)</title>
+<title>JsonArray (hjson 3.1.0 API)</title>
 <link rel="stylesheet" type="text/css" href="../../stylesheet.css" title="Style">
 <script type="text/javascript" src="../../script.js"></script>
 </head>
@@ -11,7 +11,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="JsonArray (hjson 3.0.1 API)";
+            parent.document.title="JsonArray (hjson 3.1.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/org/hjson/JsonObject.Member.html b/docs/org/hjson/JsonObject.Member.html
index 339f2c9..f6ecbc5 100644
--- a/docs/org/hjson/JsonObject.Member.html
+++ b/docs/org/hjson/JsonObject.Member.html
@@ -3,7 +3,7 @@
 <html lang="en">
 <head>
 <!-- Generated by javadoc -->
-<title>JsonObject.Member (hjson 3.0.1 API)</title>
+<title>JsonObject.Member (hjson 3.1.0 API)</title>
 <link rel="stylesheet" type="text/css" href="../../stylesheet.css" title="Style">
 <script type="text/javascript" src="../../script.js"></script>
 </head>
@@ -11,7 +11,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="JsonObject.Member (hjson 3.0.1 API)";
+            parent.document.title="JsonObject.Member (hjson 3.1.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/org/hjson/JsonObject.html b/docs/org/hjson/JsonObject.html
index af04452..3c6f408 100644
--- a/docs/org/hjson/JsonObject.html
+++ b/docs/org/hjson/JsonObject.html
@@ -3,7 +3,7 @@
 <html lang="en">
 <head>
 <!-- Generated by javadoc -->
-<title>JsonObject (hjson 3.0.1 API)</title>
+<title>JsonObject (hjson 3.1.0 API)</title>
 <link rel="stylesheet" type="text/css" href="../../stylesheet.css" title="Style">
 <script type="text/javascript" src="../../script.js"></script>
 </head>
@@ -11,7 +11,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="JsonObject (hjson 3.0.1 API)";
+            parent.document.title="JsonObject (hjson 3.1.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/org/hjson/JsonType.html b/docs/org/hjson/JsonType.html
index fbeafce..003a470 100644
--- a/docs/org/hjson/JsonType.html
+++ b/docs/org/hjson/JsonType.html
@@ -3,7 +3,7 @@
 <html lang="en">
 <head>
 <!-- Generated by javadoc -->
-<title>JsonType (hjson 3.0.1 API)</title>
+<title>JsonType (hjson 3.1.0 API)</title>
 <link rel="stylesheet" type="text/css" href="../../stylesheet.css" title="Style">
 <script type="text/javascript" src="../../script.js"></script>
 </head>
@@ -11,7 +11,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="JsonType (hjson 3.0.1 API)";
+            parent.document.title="JsonType (hjson 3.1.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/org/hjson/JsonValue.html b/docs/org/hjson/JsonValue.html
index 0ce216f..5cdcaf4 100644
--- a/docs/org/hjson/JsonValue.html
+++ b/docs/org/hjson/JsonValue.html
@@ -3,7 +3,7 @@
 <html lang="en">
 <head>
 <!-- Generated by javadoc -->
-<title>JsonValue (hjson 3.0.1 API)</title>
+<title>JsonValue (hjson 3.1.0 API)</title>
 <link rel="stylesheet" type="text/css" href="../../stylesheet.css" title="Style">
 <script type="text/javascript" src="../../script.js"></script>
 </head>
@@ -11,7 +11,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="JsonValue (hjson 3.0.1 API)";
+            parent.document.title="JsonValue (hjson 3.1.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/org/hjson/ParseException.html b/docs/org/hjson/ParseException.html
index cca1d66..4930f66 100644
--- a/docs/org/hjson/ParseException.html
+++ b/docs/org/hjson/ParseException.html
@@ -3,7 +3,7 @@
 <html lang="en">
 <head>
 <!-- Generated by javadoc -->
-<title>ParseException (hjson 3.0.1 API)</title>
+<title>ParseException (hjson 3.1.0 API)</title>
 <link rel="stylesheet" type="text/css" href="../../stylesheet.css" title="Style">
 <script type="text/javascript" src="../../script.js"></script>
 </head>
@@ -11,7 +11,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="ParseException (hjson 3.0.1 API)";
+            parent.document.title="ParseException (hjson 3.1.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/org/hjson/Stringify.html b/docs/org/hjson/Stringify.html
index 2fff940..3bac099 100644
--- a/docs/org/hjson/Stringify.html
+++ b/docs/org/hjson/Stringify.html
@@ -3,7 +3,7 @@
 <html lang="en">
 <head>
 <!-- Generated by javadoc -->
-<title>Stringify (hjson 3.0.1 API)</title>
+<title>Stringify (hjson 3.1.0 API)</title>
 <link rel="stylesheet" type="text/css" href="../../stylesheet.css" title="Style">
 <script type="text/javascript" src="../../script.js"></script>
 </head>
@@ -11,7 +11,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="Stringify (hjson 3.0.1 API)";
+            parent.document.title="Stringify (hjson 3.1.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/org/hjson/package-frame.html b/docs/org/hjson/package-frame.html
index e95da2f..99bd222 100644
--- a/docs/org/hjson/package-frame.html
+++ b/docs/org/hjson/package-frame.html
@@ -3,7 +3,7 @@
 <html lang="en">
 <head>
 <!-- Generated by javadoc -->
-<title>org.hjson (hjson 3.0.1 API)</title>
+<title>org.hjson (hjson 3.1.0 API)</title>
 <link rel="stylesheet" type="text/css" href="../../stylesheet.css" title="Style">
 <script type="text/javascript" src="../../script.js"></script>
 </head>
diff --git a/docs/org/hjson/package-summary.html b/docs/org/hjson/package-summary.html
index fc4b8e8..43f29a5 100644
--- a/docs/org/hjson/package-summary.html
+++ b/docs/org/hjson/package-summary.html
@@ -3,7 +3,7 @@
 <html lang="en">
 <head>
 <!-- Generated by javadoc -->
-<title>org.hjson (hjson 3.0.1 API)</title>
+<title>org.hjson (hjson 3.1.0 API)</title>
 <link rel="stylesheet" type="text/css" href="../../stylesheet.css" title="Style">
 <script type="text/javascript" src="../../script.js"></script>
 </head>
@@ -11,7 +11,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="org.hjson (hjson 3.0.1 API)";
+            parent.document.title="org.hjson (hjson 3.1.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/org/hjson/package-tree.html b/docs/org/hjson/package-tree.html
index c704299..cdd3154 100644
--- a/docs/org/hjson/package-tree.html
+++ b/docs/org/hjson/package-tree.html
@@ -3,7 +3,7 @@
 <html lang="en">
 <head>
 <!-- Generated by javadoc -->
-<title>org.hjson Class Hierarchy (hjson 3.0.1 API)</title>
+<title>org.hjson Class Hierarchy (hjson 3.1.0 API)</title>
 <link rel="stylesheet" type="text/css" href="../../stylesheet.css" title="Style">
 <script type="text/javascript" src="../../script.js"></script>
 </head>
@@ -11,7 +11,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="org.hjson Class Hierarchy (hjson 3.0.1 API)";
+            parent.document.title="org.hjson Class Hierarchy (hjson 3.1.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/overview-tree.html b/docs/overview-tree.html
index 8c2cdaf..3aa4149 100644
--- a/docs/overview-tree.html
+++ b/docs/overview-tree.html
@@ -3,7 +3,7 @@
 <html lang="en">
 <head>
 <!-- Generated by javadoc -->
-<title>Class Hierarchy (hjson 3.0.1 API)</title>
+<title>Class Hierarchy (hjson 3.1.0 API)</title>
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>
@@ -11,7 +11,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="Class Hierarchy (hjson 3.0.1 API)";
+            parent.document.title="Class Hierarchy (hjson 3.1.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/serialized-form.html b/docs/serialized-form.html
index fc2b110..fbfa8eb 100644
--- a/docs/serialized-form.html
+++ b/docs/serialized-form.html
@@ -3,7 +3,7 @@
 <html lang="en">
 <head>
 <!-- Generated by javadoc -->
-<title>Serialized Form (hjson 3.0.1 API)</title>
+<title>Serialized Form (hjson 3.1.0 API)</title>
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>
@@ -11,7 +11,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="Serialized Form (hjson 3.0.1 API)";
+            parent.document.title="Serialized Form (hjson 3.1.0 API)";
         }
     }
     catch(err) {
diff --git a/gradle.properties b/gradle.properties
index 431ff45..e6b9e0d 100644
--- a/gradle.properties
+++ b/gradle.properties
@@ -1,4 +1,4 @@
 group=org.hjson
 name=hjson
-version=3.0.1
+version=3.1.0
 description=Hjson, the Human JSON
diff --git a/history.md b/history.md
index 615f708..d1a8a3f 100644
--- a/history.md
+++ b/history.md
@@ -1,5 +1,11 @@
 # hjson-java History
 
+- v3.1.0
+  - escapes all control chars
+  - changes in formatted JSON output:
+    - opening braces now appear on the same line as the key when an array or an object are values in an object
+    - the root object or array are no longer preceded by a blank newline
+    - empty arrays or objects now appear on a line of their own when they are elements in an array
 - v3.0.1
   - fix for CVE-2023-34620 by not trying to parse more than 1000 levels into arrays and/or objects
   - fix for empty multiline string inside array or object
