Polish the options documentation for buidl_version.py

build_version.py

@@ -418,7 +418,9 @@ if __name__ == '__main__':
 
     APS.add_argument("-C", "--commit-changelog",
                      action="store_true",
-                     help="commit CHANGELOG.")
+                     help="commit CHANGELOG. "
+                          "To be used with --write-release. "
+                          "Recommend to use --start-release.")
 
     APS.add_argument("-j", "--jsduck",
                      action="store_true",
@@ -434,7 +436,11 @@ if __name__ == '__main__':
 
     APS.add_argument("-s", "--start-release",
                      action="store_true",
-                     help="start the new release.")
+                     help="start the new release cycle. "
+                          "Set the release number in the changelog and "
+                           "commit changes in the master branch. "
+                           "Equivalent to --write-release followed by "
+                           "--commit-changelog.")
 
     APS.add_argument("-u", "--user-doc",
                      action="store_true",
@@ -450,7 +456,9 @@ if __name__ == '__main__':
 
     APS.add_argument("-w", "--write-release",
                      action="store_true",
-                     help="write the release number in CHANGELOG.")
+                     help="write the release number in CHANGELOG. "
+                          "To be used with --commit-changelog. "
+                          "Recommend to use --start-release.")
 
     ARGS = APS.parse_args()