https://pantsbuild.org/ logo
Powered by
#general
  • h

    happy-kitchen-89482

    08/11/2015, 3:13 PM
    well
  • h

    happy-kitchen-89482

    08/11/2015, 3:13 PM
    no one reads --help-all
  • h

    happy-kitchen-89482

    08/11/2015, 3:14 PM
    certainly not the top of it
  • h

    happy-kitchen-89482

    08/11/2015, 3:14 PM
    but sure
  • h

    happy-kitchen-89482

    08/11/2015, 3:14 PM
    "all means all"
  • a

    ancient-stone-50795

    08/11/2015, 3:14 PM
    ./pants —help-all | less
  • a

    ancient-stone-50795

    08/11/2015, 3:14 PM
    In fact, git help automatically turns on a paginator
  • a

    ancient-stone-50795

    08/11/2015, 3:15 PM
    I would love that as a feature
  • h

    happy-kitchen-89482

    08/11/2015, 3:15 PM
    I'll look into it
  • a

    ancient-stone-50795

    08/11/2015, 3:16 PM
    I don’t want to make more work for you, but I do use —help-all all the time and recommend it to others. It is a lot easier than explaining all the nuisances of pants option usage to casual users, which we have a good number of.
  • h

    happy-kitchen-89482

    08/11/2015, 3:16 PM
    fair
  • h

    happy-kitchen-89482

    08/11/2015, 3:16 PM
    I'm not sure what "showing subsystem help" means
  • h

    happy-kitchen-89482

    08/11/2015, 3:17 PM
    do we want to expose the concept of subsystems to end users?
  • h

    happy-kitchen-89482

    08/11/2015, 3:17 PM
    As far as they are concerned these are flags that happen to be prefixed with a subsystem name (--jvm-debug or whatever)
  • h

    happy-kitchen-89482

    08/11/2015, 3:17 PM
    ?
  • a

    ancient-stone-50795

    08/11/2015, 3:17 PM
    We just might want to list the subsystem names and descriptions, maybe only along with —help-advanced?
  • h

    happy-kitchen-89482

    08/11/2015, 3:17 PM
    But then the global help becomes quite cluttered
  • h

    happy-kitchen-89482

    08/11/2015, 3:17 PM
    with things that many users may not care about
  • a

    ancient-stone-50795

    08/11/2015, 3:17 PM
    Anyone who wants to specify options in pants.ini needs to know what a subsystem is
  • h

    happy-kitchen-89482

    08/11/2015, 3:18 PM
    yeah, true
  • a

    ancient-stone-50795

    08/11/2015, 3:18 PM
    I don’t think its terribly important, but something to think about
  • e

    enough-analyst-54434

    08/11/2015, 3:24 PM
    Isn't it true that if a subsystem tweak is needed by a user it should be hard/rare?
  • e

    enough-analyst-54434

    08/11/2015, 3:25 PM
    IE: how much is the need to tweak this stuff a transient artifact of where we are?
  • e

    enough-analyst-54434

    08/11/2015, 3:25 PM
    I think we all have the goal of no flags for ~any 99% pants op and only pants install maintainers need to care about the 1%
  • e

    enough-analyst-54434

    08/11/2015, 3:26 PM
    granted - we are those maintainers and so may have a skewed usage perspective of 1% knob tweak both due to our roles and our involvement in the high-churn timeline
  • a

    ancient-stone-50795

    08/11/2015, 3:27 PM
    I thought that one of the main features of a subsystem was to be able to set an option at the subsystem level and have it propagate down to taksks like
    Copy code
    [jvm]
options: [ … ]
  • e

    enough-analyst-54434

    08/11/2015, 3:28 PM
    Yes - but also in a repo 100 people use every day - ~1 person will tweak this ~once a year
  • e

    enough-analyst-54434

    08/11/2015, 3:29 PM
    So it should be doable - certainly - but its not clear to me it need to be super easy
  • h

    happy-kitchen-89482

    08/11/2015, 3:29 PM
    well, one counter-example is --jvm-debug
  • e

    enough-analyst-54434

    08/11/2015, 3:29 PM
    if the only doc is in the html site - that should be fine
1...159160161...2420Latest