[ 
https://issues.apache.org/jira/browse/CB-5068?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13797349#comment-13797349
 ] 

Tom Himanen commented on CB-5068:
---------------------------------

The documentation mentioned is here: 
http://cordova.apache.org/docs/en/3.1.0/cordova_device_device.md.html#Device

In fact, after reading this documentation once again I understood that app must 
mean ${app_path}/platforms/android/. Unfortunately I have missed the 
potentially existing definition of "app" somewhere in the documentation, and it 
wasn't intuitive enough for me to understand it right away. One reason to this 
misunderstanding is ${app_path}/www/config.xml. Btw, could 
${app_path}/www/config.xml be moved somewhere under 
${app_path}/platforms/blackberry since the file is platform-specific? This is 
maybe a stupid question, but I don't know yet what this file is. It also 
confused me in the beginning.

So, if (app === ${app_path}/platforms/android/) the documentation is coherent 
and there is nothing to correct in 3.1.0 documentation. However, it would be 
more intuitive to start all the paths from the project directory, because in 
BlackBerry's instructions the path for file to be edited is www/plugins.xml. In 
my opinion, in the documentation all the paths should be relative to 
${app_path} and if there are "variables" or "shortcuts" as "app", for example, 
the "variable" should be in italic font or something.

I really don't want to complain. I just want to help improving Cordova. You 
have done great job with this project, and I really love things I can do using 
Cordova.

> File "app/www/cordova.js" is referenced in "app/www/index.html" but doesn't 
> exist.
> ----------------------------------------------------------------------------------
>
>                 Key: CB-5068
>                 URL: https://issues.apache.org/jira/browse/CB-5068
>             Project: Apache Cordova
>          Issue Type: Bug
>          Components: CordovaJS
>    Affects Versions: 3.1.0
>         Environment: Ubuntu 12.04.3 +
> npm 1.3.11 +
> nodejs 0.10.20 +
>            Reporter: Tom Himanen
>            Assignee: Andrew Grieve
>            Priority: Critical
>              Labels: cordova-cli, cordovajs, script, ubuntu, www
>
> Is far as I know, "cordova create hello com.example.hello HelloWorld" should 
> create cordova.js in hello/www. This doesn't happen though. 
> hello/www/index.html references to cordova.js relatively 
> (hello/www/cordova.js) but no cordova.js can be found. A screenshot of the 
> issue described above can be seen here: 
> https://twitter.com/TomHimanen/status/388032198760083456
> This issue can be reproduced by running my Cordova CLI installation script 
> version 1.6 (and any later) on clean install of Ubuntu 12.04.3. The script 
> can be downloaded here: 
> http://static.himanen.info/scripts/install_cordova_cli/install_cordova_cli-1.6.sh
> One weird thing connected with this issue is that a few weeks ago I installed 
> Cordova CLI with the script version 1.0 
> (http://static.himanen.info/scripts/install_cordova_cli/install_cordova_cli-1.0.sh)
>  on one of my virtual machines running Ubuntu 12.04.3, and after running the 
> script I had a project with cordova.js in project's www folder. This doesn't 
> happen anymore. Because having cordova.js in www was rare, I took a snapshot 
> of the virtual machine state to be able to develop mobile applications. I 
> took a screenshot of that machine to prove that there really is cordova.js in 
> www folder: https://twitter.com/TomHimanen/status/389493699454849024/photo/1



--
This message was sent by Atlassian JIRA
(v6.1#6144)

Reply via email to