Merge pull request #994 from IntersectMBO/cl/queryproposalshelp

Improve query proposals help text.

cardano-cli/src/Cardano/CLI/EraBased/Options/Query.hs

@@ -531,7 +531,11 @@ pQueryProposalsCmd era envCli = do
   pure $
     subParser "proposals" $
       Opt.info (QueryProposalsCmd <$> pQueryProposalsCmdArgs w) $
-        Opt.progDesc "Get the governance proposals."
+        Opt.progDesc $
+          mconcat
+            [ "Get the governance proposals that are eligible for ratification. "
+            , "Proposals submitted during the current epoch are excluded, as they cannot be ratified until the next epoch. "
+            ]
  where
   pQueryProposalsCmdArgs :: ConwayEraOnwards era -> Parser (QueryProposalsCmdArgs era)
   pQueryProposalsCmdArgs w =

cardano-cli/test/cardano-cli-golden/files/golden/help.cli

@@ -7622,7 +7622,9 @@ Usage: cardano-cli conway query proposals --socket-path SOCKET_PATH
                                             )
                                             [--out-file FILEPATH]
 
-  Get the governance proposals.
+  Get the governance proposals that are eligible for ratification. Proposals
+  submitted during the current epoch are excluded, as they cannot be ratified
+  until the next epoch.
 
 Usage: cardano-cli conway stake-address 
                                           ( key-gen
@@ -9638,7 +9640,9 @@ Usage: cardano-cli latest query proposals --socket-path SOCKET_PATH
                                             )
                                             [--out-file FILEPATH]
 
-  Get the governance proposals.
+  Get the governance proposals that are eligible for ratification. Proposals
+  submitted during the current epoch are excluded, as they cannot be ratified
+  until the next epoch.
 
 Usage: cardano-cli latest stake-address 
                                           ( key-gen

cardano-cli/test/cardano-cli-golden/files/golden/help/conway_query.cli

@@ -65,4 +65,7 @@ Available commands:
   spo-stake-distribution   Get the SPO stake distribution.
   committee-state          Get the committee state
   treasury                 Get the treasury value
-  proposals                Get the governance proposals.
+  proposals                Get the governance proposals that are eligible for
+                           ratification. Proposals submitted during the current
+                           epoch are excluded, as they cannot be ratified until
+                           the next epoch.

cardano-cli/test/cardano-cli-golden/files/golden/help/conway_query_proposals.cli

@@ -11,7 +11,9 @@ Usage: cardano-cli conway query proposals --socket-path SOCKET_PATH
                                             )
                                             [--out-file FILEPATH]
 
-  Get the governance proposals.
+  Get the governance proposals that are eligible for ratification. Proposals
+  submitted during the current epoch are excluded, as they cannot be ratified
+  until the next epoch.
 
 Available options:
   --socket-path SOCKET_PATH

cardano-cli/test/cardano-cli-golden/files/golden/help/latest_query.cli

@@ -65,4 +65,7 @@ Available commands:
   spo-stake-distribution   Get the SPO stake distribution.
   committee-state          Get the committee state
   treasury                 Get the treasury value
-  proposals                Get the governance proposals.
+  proposals                Get the governance proposals that are eligible for
+                           ratification. Proposals submitted during the current
+                           epoch are excluded, as they cannot be ratified until
+                           the next epoch.

cardano-cli/test/cardano-cli-golden/files/golden/help/latest_query_proposals.cli

@@ -11,7 +11,9 @@ Usage: cardano-cli latest query proposals --socket-path SOCKET_PATH
                                             )
                                             [--out-file FILEPATH]
 
-  Get the governance proposals.
+  Get the governance proposals that are eligible for ratification. Proposals
+  submitted during the current epoch are excluded, as they cannot be ratified
+  until the next epoch.
 
 Available options:
   --socket-path SOCKET_PATH