cordova-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From clelland <...@git.apache.org>
Subject [GitHub] cordova-cli pull request: CB-7345 improve cli documentation
Date Wed, 20 Aug 2014 18:30:24 GMT
Github user clelland commented on a diff in the pull request:

    https://github.com/apache/cordova-cli/pull/188#discussion_r16494980
  
    --- Diff: doc/build.txt ---
    @@ -1,8 +1,26 @@
     Synopsis
     
    -    cordova-cli build [PLATFORM..] [-- [platformopts]]
    +    cordova-cli build PROD TARGET EXP PLATS POPTS
    --- End diff --
    
    This is odd -- it moves the description of what is required / optional down to the lower
section, rather than showing it in the one-liner. I'd probably prefer something like
    
        cordova-cli build [PROD] [TARGET] [EXP] [PLATS] [-- [POPTS]]
    
        PROD:   --debug|--release
        ... etc
    
    but that's a matter of preference. the bare "--", for instance, is really part of the
overall command line, I think, not part of the platformopts, and it's almost hidden in the
lower section.


---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---

Mime
View raw message