From 271972b7a831319e14930f765400149fdd099cb6 Mon Sep 17 00:00:00 2001
From: brandonkelly <brandon@pixelandtonic.com>
Date: Mon, 29 Apr 2024 16:25:22 -0700
Subject: [PATCH] `@since` tags and release notes for #14897

[ci skip]
---
 CHANGELOG-WIP.md             | 2 ++
 src/config/GeneralConfig.php | 1 +
 src/db/pgsql/Schema.php      | 6 ++++++
 3 files changed, 9 insertions(+)

diff --git a/CHANGELOG-WIP.md b/CHANGELOG-WIP.md
index 0a0a87baf62..5b26d62a239 100644
--- a/CHANGELOG-WIP.md
+++ b/CHANGELOG-WIP.md
@@ -9,6 +9,8 @@
 ### Administration
 - Improved the behavior of the URI input within Edit Route modals. ([#14884](https://github.com/craftcms/cms/issues/14884))
 - Added the `asyncCsrfInputs` config setting. ([#14625](https://github.com/craftcms/cms/pull/14625))
+- Added the `backupCommandFormat` config setting. ([#14897](https://github.com/craftcms/cms/pull/14897))
+- The `backupCommand` config setting can now be set to a closure, which will be passed a `mikehaertl\shellcommand\Command` object. ([#14897](https://github.com/craftcms/cms/pull/14897))
 - `resave` commands now support an `--if-invalid` option. ([#14731](https://github.com/craftcms/cms/issues/14731))
 
 ### Development
diff --git a/src/config/GeneralConfig.php b/src/config/GeneralConfig.php
index 1a79820fb19..3052a985744 100644
--- a/src/config/GeneralConfig.php
+++ b/src/config/GeneralConfig.php
@@ -469,6 +469,7 @@ class GeneralConfig extends BaseConfig
      *  :::
      *
      * @group Environment
+     * @since 4.9.0
      */
     public ?string $backupCommandFormat = null;
 
diff --git a/src/db/pgsql/Schema.php b/src/db/pgsql/Schema.php
index 09b8346468a..25151e6e87f 100644
--- a/src/db/pgsql/Schema.php
+++ b/src/db/pgsql/Schema.php
@@ -233,6 +233,12 @@ public function loadTableSchema($name): ?TableSchema
         return null;
     }
 
+    /**
+     * Whether `pg_restore` should be used by default for the backup command.
+     *
+     * @return bool
+     * @since 4.9.0
+     */
     public function usePgRestore(): bool
     {
         return in_array(Craft::$app->getConfig()->getGeneral()->backupCommandFormat, [