Switch master to the stable pseudo-version and restore the shipped 0.2.0 script

HISTORY.asc

@@ -1,3 +1,14 @@
-0.2.1
------
+STABLE
+------
 === Fix bug where extension could not be dropped
+The extension now requires extension_drop and trunklet 0.3.3 or later, neither of which 0.2.0 required. Updating from trunklet-format 0.2.0 (PostgreSQL 12 or later) requires trunklet >= 0.3.3:
+
+* If you are on trunklet 0.2.1 or later, run `ALTER EXTENSION trunklet UPDATE;` first, then `CREATE EXTENSION extension_drop CASCADE;` and `ALTER EXTENSION "trunklet-format" UPDATE;`.
+* trunklet 0.2.0 has no update path to later versions: drop and recreate it (this also drops trunklet-format and any trunklet data), then install trunklet-format at the stable version.
+
+=== Add optional parameters
+A parameter written as `%name%Os` or `%name%OL` may be absent from the parameters, in which case it is treated as NULL. Identifiers (`I`) cannot be optional.
+
+=== Other changes
+* `extract_parameters()` returns NULL instead of an error when none of the requested parameters are present.
+* Template parse errors report the position in the template.

META.in.json

@@ -16,7 +16,7 @@
     "name": "trunklet-format",
 
     "X_comment": "REQUIRED. Version of the distribution. http://pgxn.org/spec/#version",
-    "version": "0.2.0",
+    "version": "stable",
 
     "X_comment": "REQUIRED. Short description of distribution.",
     "abstract": "A format()-based template language for trunklet",
@@ -41,7 +41,7 @@
             "file": "sql/trunklet-format.sql",
 
             "X_comment": "REQUIRED. Version the extension is at.",
-            "version": "0.2.0",
+            "version": "stable",
 
             "X_comment": "Optional: \"abstract\": Description of the extension.",
             "abstract": "A format()-based template language for trunklet",
@@ -75,20 +75,20 @@
     "X_comment": "Requires JSONB, which was released in 9.4",
     "X_comment": "trunklet currently requires 9.5",
     "X_comment": "extension_drop: 0.1.1 fixes bug with dependencies",
-    "X_comment": "Requires support for droping a language in trunklet; released in 0.3.0",
+    "X_comment": "trunklet 0.3.3: the drop command uses template_language__remove(ignore_missing_functions), added in 0.3.3",
     "prereqs": {
 
         "build": {
             "requires": {
                 "PostgreSQL": "9.5.0",
                 "extension_drop": ">= 0.1.1",
-                "trunklet": ">= 0.3.0"
+                "trunklet": ">= 0.3.3"
             }
         },
         "runtime": {
             "requires": {
                 "plpgsql": 0,
-                "trunklet": ">= 0.2.0"
+                "trunklet": ">= 0.3.3"
             }
         },
         "test": {

META.json

@@ -16,7 +16,7 @@
     "name": "trunklet-format",
 
     "X_comment": "REQUIRED. Version of the distribution. http://pgxn.org/spec/#version",
-    "version": "0.2.0",
+    "version": "stable",
 
     "X_comment": "REQUIRED. Short description of distribution.",
     "abstract": "A format()-based template language for trunklet",
@@ -41,7 +41,7 @@
             "file": "sql/trunklet-format.sql",
 
             "X_comment": "REQUIRED. Version the extension is at.",
-            "version": "0.2.0",
+            "version": "stable",
 
             "X_comment": "Optional: \"abstract\": Description of the extension.",
             "abstract": "A format()-based template language for trunklet",
@@ -75,20 +75,20 @@
     "X_comment": "Requires JSONB, which was released in 9.4",
     "X_comment": "trunklet currently requires 9.5",
     "X_comment": "extension_drop: 0.1.1 fixes bug with dependencies",
-    "X_comment": "Requires support for droping a language in trunklet; released in 0.3.0",
+    "X_comment": "trunklet 0.3.3: the drop command uses template_language__remove(ignore_missing_functions), added in 0.3.3",
     "prereqs": {
 
         "build": {
             "requires": {
                 "PostgreSQL": "9.5.0",
                 "extension_drop": ">= 0.1.1",
-                "trunklet": ">= 0.3.0"
+                "trunklet": ">= 0.3.3"
             }
         },
         "runtime": {
             "requires": {
                 "plpgsql": 0,
-                "trunklet": ">= 0.2.0"
+                "trunklet": ">= 0.3.3"
             }
         },
         "test": {

README.md

@@ -53,6 +53,18 @@ super user and running:
 
     CREATE EXTENSION "trunklet-format";
 
+Updating an existing trunklet-format 0.2.0 install (PostgreSQL 12 or later)
+requires trunklet >= 0.3.3 and extension_drop, neither of which 0.2.0 required.
+If you are on trunklet 0.2.1 or later, run:
+
+    ALTER EXTENSION trunklet UPDATE;
+    CREATE EXTENSION extension_drop CASCADE;
+    ALTER EXTENSION "trunklet-format" UPDATE;
+
+trunklet 0.2.0 has no update path to later versions: drop and recreate it (this
+also drops trunklet-format and any trunklet data), then install trunklet-format
+at the stable version.
+
 If you want to install trunklet-format and all of its supporting objects into a specific
 schema, use the `PGOPTIONS` environment variable to specify the schema, like
 so: