Uploaded image for project: 'Subversion'
  1. Subversion
  2. SVN-4279

svnmucc options and help don't follow Subversion core tool conventions

    XMLWordPrintableJSON

Details

    • Bug
    • Status: Closed
    • Major
    • Resolution: Fixed
    • trunk
    • 1.8.0
    • svnmucc
    • None

    Description

      The output of 'svnmucc --help' does not follow conventions of other Subversion
      command line tools. svnmucc is being promoted to a core tool in 1.8, and thus
      its help text should match these conventions.
      
      Some points of concern:
      
        $ svnmucc --help                                      
        Multiple URL Command Client (for Subversion)
      
        Usage: svnmucc [OPTION]... [ACTION]...
      
      Saying "(for Subversion)" is redundant for a core tool.
      
        Actions:
          cp REV URL1 URL2      copy URL1@REV to URL2
          mkdir URL             create new directory URL
      
      Other tools say "subcommands" instead of "Actions".
      
      Furthermore, svnmucc has short option aliases which don't exist in standard
      tools (-?, -u, -p, -U, -n, -X):
      
        -h, --help, -?        display this text
        -m, --message ARG     use ARG as a log message
        -F, --file ARG        read log message from file ARG
        -u, --username ARG    commit the changes as username ARG
        -p, --password ARG    use ARG as the password
        -U, --root-url ARG    interpret all action URLs are relative to ARG
        -r, --revision ARG    use revision ARG as baseline for changes
        --with-revprop A[=B]  set revision property A in new revision to B
                              if specified, else to the empty string
        -n, --non-interactive don't prompt the user about anything
        -X, --extra-args ARG  append arguments from file ARG (one per line;
                              use "-" to read from standard input)
      
      I would suggest to remove -?, but to keep -u, -p, -U, and -n for backwards
      compatibility with existing scripts but list them in a special "backwards
      compat" section of the help text and mark them deprecated.
      

      Attachments

        Issue Links

          Activity

            People

              Unassigned Unassigned
              stsp Stefan Sperling
              Votes:
              0 Vote for this issue
              Watchers:
              0 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: