From c4deb66b8ef26d05f98f3a3dab6145d8cf038d5a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gr=C3=A9goire=20Paris?= <postmaster@greg0ire.fr>
Date: Sun, 16 Jul 2023 12:30:21 +0200
Subject: [PATCH] Add details to sync-metadata-storage's help

People might think this command synchronizes the database with migration
files, when it merely synchronizes it with the definition of the
metadata table.
---
 .../Migrations/Tools/Console/Command/SyncMetadataCommand.php | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/lib/Doctrine/Migrations/Tools/Console/Command/SyncMetadataCommand.php b/lib/Doctrine/Migrations/Tools/Console/Command/SyncMetadataCommand.php
index 9dc2fbbb3..9a0ee48a2 100644
--- a/lib/Doctrine/Migrations/Tools/Console/Command/SyncMetadataCommand.php
+++ b/lib/Doctrine/Migrations/Tools/Console/Command/SyncMetadataCommand.php
@@ -20,7 +20,10 @@ protected function configure(): void
             ->setAliases(['sync-metadata-storage'])
             ->setDescription('Ensures that the metadata storage is at the latest version.')
             ->setHelp(<<<'EOT'
-The <info>%command.name%</info> command updates metadata storage the latest version.
+The way metadata is stored in the database can change between releases.
+The <info>%command.name%</info> command updates metadata storage to the latest version,
+ensuring it is ready to receive migrations generated by the current version of Doctrine Migrations.
+
 
     <info>%command.full_name%</info>
 EOT);