Minor Improvements to Release Script Output

Fixes OpenDDS#4759

tools/scripts/gitrelease.pl

@@ -96,9 +96,12 @@ sub get_rtd_link {
 sub usage {
   return
     "gitrelease.pl WORKSPACE VERSION [options]\n" .
+    "gitrelease.pl WORKSPACE VERSION --upload-artifacts\n" .
     "gitrelease.pl --help | -h\n" .
     "gitrelease.pl --list-all\n" .
-    "gitrelease.pl --update-authors\n";
+    "gitrelease.pl --update-authors\n" .
+    "gitrelease.pl --update-ace-tao\n" .
+    "gitrelease.pl --cherry-pick-prs PR...\n";
 }
 
 sub arg_error {
@@ -113,10 +116,10 @@ sub help {
   return usage() .
     "\n" .
     "Positional Arguments:\n" .
-    "    WORKSPACE:           Path of intermediate files directory. If it doesn't\n" .
+    "  WORKSPACE:             Path of intermediate files directory. If it doesn't\n" .
     "                         exist, it will be created. This should a new one for\n" .
     "                         each release.\n" .
-    "    VERSION:             Release version in a.b or a.b.c notation\n" .
+    "  VERSION:               Release version in a.b or a.b.c notation\n" .
     "\n" .
     "Options:\n" .
     "  --help | -h            Print this message\n" .
@@ -173,9 +176,10 @@ sub help {
     "                         the WORKSPACE or VERSION arguments.\n" .
     "  --update-ace-tao       Update acetao.ini to the latest ACE/TAO releases.\n" .
     "                         This doesn't run any release steps or require the\n" .
-    "                         WORKSPACE or VERSION arguments, but does require the\n" .
-    "                         GITHUB_TOKEN environment variable\n" .
-    "  --cherry-pick-prs PR.. Use git cherry-pick from the given GitHub PRs.\n" .
+    "                         WORKSPACE or VERSION arguments.\n" .
+    "  --cherry-pick-prs PR.. git cherry-pick from the given GitHub PRs.\n" .
+    "                         This doesn't run any release steps or require the\n" .
+    "                         WORKSPACE or VERSION arguments.\n" .
     "\n" .
     "Environment Variables:\n" .
     "  GITHUB_TOKEN           GitHub token with repo access to publish release on\n" .
@@ -1297,7 +1301,7 @@ sub update_ace_tao {
       if (version_lesser($r->{version}, $ace_tao_version->{next_minor})) {
         my $version = $r->{version}->{string};
         if ($ace_tao_version->{version} ne $version) {
-          print("Will update to $ace_tao_version->{version}\n");
+          print("Will update to $version\n");
           push(@updated, $ace_tao_version);
         }
         else {
@@ -1387,7 +1391,7 @@ sub update_ace_tao {
     # Prepare Commit and PR Messages
     my $short_desc = 'Update ACE/TAO to ' . join(", ", @versions);
     my $full_desc = "$short_desc\n\n$long_desc";
-    print($full_desc);
+    print("Markdown Summary for commit and PR:\n$full_desc");
     if ($ENV{GITHUB_WORKSPACE}) {
       # Write the commit/PR message only if the update branch doesn't already
       # exist or the acetao.ini on the update branch is different. We're