Unhide the --example flag for relevant commands (#4633)

Author: sigurdm

lib/src/command/add.dart

@@ -167,7 +167,6 @@ For example (follow the same format including spaces):
       defaultsTo: true,
       help:
           'Also update dependencies in `example/` after modifying pubspec.yaml in the root package (if it exists).',
-      hide: true,
     );
   }
 

lib/src/command/downgrade.dart

@@ -48,7 +48,6 @@ class DowngradeCommand extends PubCommand {
       'example',
       defaultsTo: true,
       help: 'Also run in `example/` (if it exists).',
-      hide: true,
     );
 
     argParser.addOption(

lib/src/command/get.dart

@@ -56,7 +56,6 @@ class GetCommand extends PubCommand {
       'example',
       defaultsTo: true,
       help: 'Also run in `example/` (if it exists).',
-      hide: true,
     );
 
     argParser.addOption(

lib/src/command/remove.dart

@@ -59,7 +59,6 @@ To remove a dependency override of a package prefix the package name with
       'example',
       defaultsTo: true,
       help: 'Also update dependencies in `example/` (if it exists).',
-      hide: true,
     );
 
     argParser.addOption(

lib/src/command/upgrade.dart

@@ -89,7 +89,6 @@ class UpgradeCommand extends PubCommand {
       'example',
       defaultsTo: true,
       help: 'Also run in `example/` (if it exists).',
-      hide: true,
     );
 
     argParser.addOption(

test/testdata/goldens/help_test/pub add --help.txt

@@ -43,6 +43,8 @@ Usage: pub add [options] [<section>:]<package>[:descriptor] [<section>:]<package
 -n, --dry-run            Report what dependencies would change but don't change any.
     --[no-]precompile    Build executables in immediate dependencies.
 -C, --directory=<dir>    Run this in the directory <dir>.
+    --[no-]example       Also update dependencies in `example/` after modifying pubspec.yaml in the root package (if it exists).
+                         (defaults to on)
 
 Run "pub help" to see global options.
 See https://dart.dev/tools/pub/cmd/pub-add for detailed documentation.

test/testdata/goldens/help_test/pub downgrade --help.txt

@@ -10,6 +10,8 @@ Usage: pub downgrade [dependencies...]
 -h, --help               Print this usage information.
     --[no-]offline       Use cached packages instead of accessing the network.
 -n, --dry-run            Report what dependencies would change but don't change any.
+    --[no-]example       Also run in `example/` (if it exists).
+                         (defaults to on)
 -C, --directory=<dir>    Run this in the directory <dir>.
     --tighten            Updates lower bounds in pubspec.yaml to match the resolved version.
 

test/testdata/goldens/help_test/pub get --help.txt

@@ -12,6 +12,8 @@ Usage: pub get
                           has changed.
                           Useful for CI or deploying to production.
     --[no-]precompile     Build executables in immediate dependencies.
+    --[no-]example        Also run in `example/` (if it exists).
+                          (defaults to on)
 -C, --directory=<dir>     Run this in the directory <dir>.
 
 Run "pub help" to see global options.

test/testdata/goldens/help_test/pub remove --help.txt

@@ -16,6 +16,8 @@ Usage: pub remove <package1> [<package2>...]
     --[no-]offline       Use cached packages instead of accessing the network.
 -n, --dry-run            Report what dependencies would change but don't change any.
     --[no-]precompile    Precompile executables in immediate dependencies.
+    --[no-]example       Also update dependencies in `example/` (if it exists).
+                         (defaults to on)
 -C, --directory=<dir>    Run this in the directory <dir>.
 
 Run "pub help" to see global options.

test/testdata/goldens/help_test/pub upgrade --help.txt

@@ -12,6 +12,8 @@ Usage: pub upgrade [dependencies...]
     --tighten              Updates lower bounds in pubspec.yaml to match the resolved version.
     --unlock-transitive    Also upgrades the transitive dependencies of the listed [dependencies]
     --major-versions       Upgrades packages to their latest resolvable versions, and updates pubspec.yaml.
+    --[no-]example         Also run in `example/` (if it exists).
+                           (defaults to on)
 -C, --directory=<dir>      Run this in the directory <dir>.
 
 Run "pub help" to see global options.