Uploaded image for project: 'MongoDB Database Tools'
  1. MongoDB Database Tools
  2. TOOLS-846

--help output is somewhat unclear about defaults and explicit settings

    XMLWordPrintableJSON

Details

    • Icon: Task Task
    • Resolution: Done
    • Icon: Major - P3 Major - P3
    • 3.1.8
    • None
    • None
    • None
    • Kernel Tools 8 08/28/15, Kernel Tools 9 09/18/15

    Description

      running --help on any of the tools shows which options can be set vs. which options are standalone by appending an = sign to them. This can be confusing when text in the description says things like "If no path is passed in, will default to std out"

      Which can make it somewhat unclear when people see something like out=

      and assume out= will write to stdout when in fact it will ignore the flag since it parses it as the null string.

      Instead of the = signs we probably want it to say something like "is settable" as opposed to a flag like --gzip which is not settable.

      It's a subtle documentation change that should make things more clear.

      Attachments

        Activity

          People

            gabriel.russell@mongodb.com Gabriel Russell (Inactive)
            osmar.olivo Osmar Olivo
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: