Merge pull request #15799 from MikeMcQuaid/deprecate_postgresql_upgra…

…de_database Deprecate `postgresql-upgrade-database`
Homebrew · Aug 1, 2023 · 8a74f83 · 8a74f83
2 parents e3c0faf + 04e07dc
commit 8a74f83
Show file tree

Hide file tree

Showing 3 changed files with 5 additions and 7 deletions.
diff --git a/Library/Homebrew/cmd/postgresql-upgrade-database.rb b/Library/Homebrew/cmd/postgresql-upgrade-database.rb
@@ -15,13 +15,18 @@ def postgresql_upgrade_database_args
       EOS
 
       named_args :none
+
+      hide_from_man_page!
     end
   end
 
   sig { void }
   def postgresql_upgrade_database
     postgresql_upgrade_database_args.parse
 
+    odeprecated "brew postgresql_upgrade_database",
+                "using new, versioned e.g. `var/postgres@14` datadir and `pg_upgrade`"
+
     name = "postgresql"
     pg = Formula[name]
     bin = pg.bin

diff --git a/docs/Manpage.md b/docs/Manpage.md
@@ -529,10 +529,6 @@ information is displayed in interactive shells, and suppressed otherwise.
 Pin the specified *`formula`*, preventing them from being upgraded when
 issuing the `brew upgrade` *`formula`* command. See also `unpin`.
 
-### `postgresql-upgrade-database`
-
-Upgrades the database for the `postgresql` formula.
-
 ### `postinstall`, `post_install` *`installed_formula`* [...]
 
 Rerun the post-install steps for *`formula`*.

diff --git a/manpages/brew.1 b/manpages/brew.1
@@ -743,9 +743,6 @@ Also include outdated casks including those with \fBauto_updates true\fR\.
 .SS "\fBpin\fR \fIinstalled_formula\fR [\.\.\.]"
 Pin the specified \fIformula\fR, preventing them from being upgraded when issuing the \fBbrew upgrade\fR \fIformula\fR command\. See also \fBunpin\fR\.
 .
-.SS "\fBpostgresql\-upgrade\-database\fR"
-Upgrades the database for the \fBpostgresql\fR formula\.
-.
 .SS "\fBpostinstall\fR, \fBpost_install\fR \fIinstalled_formula\fR [\.\.\.]"
 Rerun the post\-install steps for \fIformula\fR\.
 .