cordova-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From purplecabb...@apache.org
Subject [10/50] [abbrv] docs commit: [CB-5739] rework intro text; VM config; 2GB VM memory floor; PC-style command prompts
Date Thu, 20 Feb 2014 21:08:49 GMT
[CB-5739] rework intro text; VM config; 2GB VM memory floor; PC-style command prompts


Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/10107a57
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/10107a57
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/10107a57

Branch: refs/heads/master
Commit: 10107a5727c2cd0eedc9fbc73f59777fed550603
Parents: 13e924c
Author: Mike Sierra <msierra@adobe.com>
Authored: Thu Feb 6 14:54:10 2014 -0500
Committer: Mike Sierra <msierra@adobe.com>
Committed: Thu Feb 6 14:54:10 2014 -0500

----------------------------------------------------------------------
 docs/en/edge/guide/platforms/wp8/index.md       |  68 +++++++++----------
 docs/en/edge/guide/platforms/wp8/parallels.md   |  20 +++---
 docs/en/edge/guide/platforms/wp8/vmware.md      |  16 +++--
 .../guide/platforms/wp8/parallel_cpu_opts.png   | Bin 99195 -> 98229 bytes
 4 files changed, 53 insertions(+), 51 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/10107a57/docs/en/edge/guide/platforms/wp8/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/wp8/index.md b/docs/en/edge/guide/platforms/wp8/index.md
index b900101..73ff0df 100644
--- a/docs/en/edge/guide/platforms/wp8/index.md
+++ b/docs/en/edge/guide/platforms/wp8/index.md
@@ -20,11 +20,24 @@ license: Licensed to the Apache Software Foundation (ASF) under one
 # Windows Phone Platform Guide
 
 This guide shows how to set up your SDK development environment to
-deploy Cordova apps for Windows Phone devices. It focuses on Windows
+deploy Cordova apps for Windows Phone devices.  It focuses on Windows
 Phone 8, but provides additional details on how to support Windows
 Phone 7.
+
 <!-- 2DO: can we easily discuss wp7 within wp8 topic? -->
 
+It shows how to develop apps using Windows Phone-specific command-line
+tools, or the cross-platform Cordova CLI discussed in The Command-Line
+Interface.  For a comparison of the two development paths, see the
+Overview.  You need to install the Windows Phone SDK, regardless of
+which you choose.
+
+See the following for more information specific to the Windows Phone
+platform:
+
+- Windows Phone Plugins
+- Upgrading Windows Phone
+
 ## Requirements and Support
 
 You will need the following:
@@ -36,8 +49,6 @@ You will need the following:
 
 - The [Windows Phone SDK](https://dev.windowsphone.com/en-us/downloadsdk).
 
-  <!-- 2DO: install which SDK for WP? Both __Windows Phone__ and __Ultimate 2013__ versions,
failed at `cordova platform add wp8` stage: complains latest version is not installed. Requires
clean install? -->
-  
 To develop Cordova apps for Windows Phone devices, you may use a PC
 running Windows, but you may also develop on a Mac, either by running
 a virtual machine environment or by using Boot Camp to dual-boot a
@@ -63,7 +74,7 @@ development environment on a Mac:
   installation instructions provided by the [Microsoft Developer
   Network](http://msdn.microsoft.com/en-US/library/windows/apps/jj945425).
 
-  <!-- 2DO: virtualBox doesn't work yet; any config info? -->
+  <!-- 2DO: virtualBox doesn't work yet; any extra config info? -->
   
 - __Boot Camp__: To set up the Windows 8 partition, follow the
   installation instructions provided by the [Microsoft Developer
@@ -87,17 +98,17 @@ section if you plan to use the cross-platform CLI utility, but see The
 Command-Line Interface for instructions how to install it on Windows 8.
 
 The Cordova download contains separate archives for each platform. Be
-sure to expand the appropriate archive, `wp8` in this case,
-<!-- 2DO: check location of cordova wp8 dir -->
-within an empty directory.  The relevant executible utilities are
-available in the top-level `bin` directory. (Consult the __README__
-file if necessary for more detailed directions.)
+sure to expand the appropriate archive, `wp8` in this case, within an
+empty directory.  The relevant executible utilities are available in
+the top-level `bin` directory. (Consult the __README__ file if
+necessary for more detailed directions.)
 
 These shell tools allow you to create, build, and run Windows Phone
 apps.  For information on the additional command-line interface that
 enables plugin features across all platforms, see Using Plugman to
-Manage Plugins. See Application Plugins for details on how to develop
-plugins.
+Manage Plugins. See Application Plugins for guidance on how to develop
+plugins, and Windows Phone Plugins for details specific to the Windows
+Phone platform.
 
 ## Install the SDK
 
@@ -159,10 +170,10 @@ cross-platform CLI tool described in The Command-Line Interface, or
 the set of Windows Phone-specific shell tools. From within a
 source-code directory, here's the CLI approach:
 
-        $ cordova create hello com.example.hello HelloWorld
-        $ cd hello
-        $ cordova platform add wp8
-        $ cordova build
+        > cordova create hello com.example.hello HelloWorld
+        > cd hello
+        > cordova platform add wp8
+        > cordova build
 
 Here's the corresponding lower-level shell-tool approach:
 
@@ -176,8 +187,8 @@ If you are using the CLI in development, the project directory's
 top-level `www` directory contains the source files. Run either of
 these within the project directory to rebuild the app:
 
-        $ cordova build
-        $ cordova build wp8   # do not rebuild other platforms
+        > cordova build
+        > cordova build wp8   # do not rebuild other platforms
 
 If you are using the Windows Phone-specific shell tools in
 development, there is a different approach.  Once you generate the
@@ -194,20 +205,16 @@ for release:
         C:\path\to\project\cordova\build.bat --debug        
         C:\path\to\project\cordova\build.bat --release
 
-## Configure an Emulator
-
-<!-- 2DO: can you configure WP emulator to choose different devices? -->
-
 ## Deploy to Emulator
 
 At this point you can use the `cordova` CLI utility to deploy the
 application to the emulator from the command line:
 
-        $ cordova emulate wp8
+        > cordova emulate wp8
 
 Otherwise use the alternate shell interface:
 
-        $ /path/to/project/cordova/run --emulator
+        > /path/to/project/cordova/run --emulator
 
 The emulator launches a device image with the app installed. From the
 home screen, navigate to the apps panel to launch the __HelloWorld__
@@ -227,6 +234,10 @@ location or simulate sequences of movements:
 
 ![](img/guide/platforms/wp8/wp8_emulator_loc.png)
 
+## Configure an Emulator
+
+<!-- 2DO: can you configure WP emulator to choose different devices? -->
+
 ## Deploy to Device
 
 <!-- 2DO: any app signing procedure other than registration??  -->
@@ -247,17 +258,6 @@ have all the advanced features included in Internet Explorer 10, but
 implements the same set of APIs. Windows Phone 8 apps do _not_ run on
 Windows Phone 7 devices.
 
-See the following for more detailed platform-specific information that
-applies to both versions:
-
-- Upgrading Windows Phone
-- Windows Phone Plugins
-- Windows Phone Command-line Tools
-
-The command-line tools above refer to versions prior to Cordova 3.0.
-See The Command-Line Interface for information about the
-current interface.
-
 ## System Requirements
 
 - SDK and IDE (Visual Studio)

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/10107a57/docs/en/edge/guide/platforms/wp8/parallels.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/wp8/parallels.md b/docs/en/edge/guide/platforms/wp8/parallels.md
index cb8833c..70df54a 100644
--- a/docs/en/edge/guide/platforms/wp8/parallels.md
+++ b/docs/en/edge/guide/platforms/wp8/parallels.md
@@ -21,18 +21,18 @@ license: Licensed to the Apache Software Foundation (ASF) under one
 
 This section shows how to configure Parallels Desktop on a Mac so that
 you can use Cordova to generate Windows Phone applications.
-<!-- 2DO: assume no xtra parallels requirements for win8? -->
 
-Before following these instructions, you should have already installed
-Windows under Parallels Desktop, as detailed at the
-[Microsoft Developer Network](http://msdn.microsoft.com/en-US/library/windows/apps/jj945424).
-Then follow these steps:
+The
+[Microsoft Developer Network](http://msdn.microsoft.com/en-US/library/windows/apps/jj945424)
+provides general instructions for how to run Windows under Parallels
+Desktop. After installing Windows, follow these steps:
 
 1. Within Parallels Desktop, select the Windows 8 disk image you have
-   prepared and choose __Settings__.
+   prepared, and choose __Settings__.
 
-1. Choose the __General &rarr; CPUs__ options. Specify _two_ CPUs and
-   a generous amount of memory:
+1. Choose the __General &rarr; CPUs__ options. Specify _two_ CPUs.
+   Specify at least 2GB of memory, even if it falls outside the
+   recommended range:
 
    ![](img/guide/platforms/wp8/parallel_cpu_opts.png)
 
@@ -42,5 +42,5 @@ Then follow these steps:
 
    ![](img/guide/platforms/wp8/parallel_optimize_opts.png)
 
-Once you complete these steps, you are then ready to install the
-Windows Phone SDK.  See the Windows Phone Platform Guide for details.
+Once you complete these steps, you are ready to install the Windows
+Phone SDK.  See the Windows Phone Platform Guide for details.

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/10107a57/docs/en/edge/guide/platforms/wp8/vmware.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/wp8/vmware.md b/docs/en/edge/guide/platforms/wp8/vmware.md
index e27cd2d..7d41200 100644
--- a/docs/en/edge/guide/platforms/wp8/vmware.md
+++ b/docs/en/edge/guide/platforms/wp8/vmware.md
@@ -19,13 +19,13 @@ license: Licensed to the Apache Software Foundation (ASF) under one
 
 # Configuring VMWare Fusion
 
-This section shows how to configure VMWare Fusion on a Mac so that you
-can use Cordova to generate Windows Phone applications.
-<!-- 2DO: assume no extra win8 VMware req's for win8? --> 
-Before following these instructions, you should have already installed
-Windows under VMWare Fusion, as detailed at the [Microsoft Developer
-Network](http://msdn.microsoft.com/en-US/library/windows/apps/jj945426).
-Then follow these steps:
+This section shows how to configure VMWare Fusion on a Mac so that
+you can use Cordova to generate Windows Phone applications.
+
+The [Microsoft Developer
+Network](http://msdn.microsoft.com/en-US/library/windows/apps/jj945426)
+provides general instructions for how to run Windows under VMWare
+Fusion.  After installing Windows, follow these steps:
 
 1. Within VMWare Fusion, select the Windows 8 disk image you have
    prepared and choose __Settings__.
@@ -50,5 +50,7 @@ Then follow these steps:
         mce.enable = "TRUE"
         vhv.enable = "TRUE"
 
+<!-- 2DO: check how this option appears in UI -->
+
 Once you complete these steps, you are then ready to install the
 Windows Phone SDK.  See the Windows Phone Platform Guide for details.

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/10107a57/template/docs/default/img/guide/platforms/wp8/parallel_cpu_opts.png
----------------------------------------------------------------------
diff --git a/template/docs/default/img/guide/platforms/wp8/parallel_cpu_opts.png b/template/docs/default/img/guide/platforms/wp8/parallel_cpu_opts.png
index 53a9433..48c98ba 100644
Binary files a/template/docs/default/img/guide/platforms/wp8/parallel_cpu_opts.png and b/template/docs/default/img/guide/platforms/wp8/parallel_cpu_opts.png
differ


Mime
View raw message