cordova-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From jsoref <...@git.apache.org>
Subject [GitHub] cordova-docs pull request: CB-6680 Clarify instructions for instal...
Date Wed, 21 May 2014 16:41:06 GMT
Github user jsoref commented on a diff in the pull request:

    https://github.com/apache/cordova-docs/pull/205#discussion_r12906738
  
    --- Diff: docs/en/edge/guide/cli/index.md ---
    @@ -73,22 +74,41 @@ To install the `cordova` command-line tool, follow these steps:
        the CLI does use it behind-the-scenes to download some assets when
        creating a new project.
     
    -1. Install the `cordova` utility. In Unix, prefixing the additional
    -   `sudo` command may be necessary to install development utilities in
    -   otherwise restricted directories:
    +1. Install the `cordova` module using Node.js' `npm` utility. The cordova
    +   module will automatically be downloaded by the `npm` utility.
     
    -        $ sudo npm install -g cordova
    +   * on OS X and Linux:
     
    -   The installation log may produce errors for any uninstalled
    -   platform SDKs.  Following installation, you should be able to run
    -   `cordova` on the command line.
    +            $ sudo npm install -g cordova
    +
    +       On OS X and Linux, prefixing the `npm` command with
    +       `sudo` may be necessary to install this development utility in
    +       otherwise restricted directories such as 
    +       `/usr/local/share`. If you are using the optional
    +       nvm/nave tool or have write access to the install directory,
    +       you may be able to omit the `sudo` prefix. There are
    +       [more tips](http://justjs.com/posts/npm-link-developing-your-own-npm-modules-without-tears)
    +       available on using `npm` without `sudo`, if you desire to do that.
    +
    +   * on Windows:
    +
    +            C:\>npm install -g cordova
    +
    +   The `-g` flag above tells `npm` to install cordova globally. Otherwise
    +   it will be installed in a subdirectory of the current working directory.
    --- End diff --
    
    Add (`c:\` in this example).
    
    I'd suggest `pushd %USERPROFILE%` before the npm install example to suggest a reasonable
directory.
    
    Also clarify that *subdirectory* means `node_modules\cordova`


---
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