cordova-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject [02/12] docs commit: [CB-3820] add CLI to config.xml discussion
Date Wed, 24 Jul 2013 22:12:57 GMT
[CB-3820] add CLI to config.xml discussion


Branch: refs/heads/master
Commit: 8a37ba325be2f61b7ed9961ba9e26ef30362474c
Parents: e73f0d5
Author: Mike Sierra <>
Authored: Fri Jul 19 13:41:49 2013 -0400
Committer: Michael Brooks <>
Committed: Wed Jul 24 15:10:08 2013 -0700

 docs/en/edge/config_ref/ | 26 ++++++++++++++++----------
 1 file changed, 16 insertions(+), 10 deletions(-)
diff --git a/docs/en/edge/config_ref/ b/docs/en/edge/config_ref/
index 807f13f..e060740 100644
--- a/docs/en/edge/config_ref/
+++ b/docs/en/edge/config_ref/
@@ -19,16 +19,22 @@ license: Licensed to the Apache Software Foundation (ASF) under one
 # Configuration Reference
-You can set various application configuration parameters using a platform-agnostic configuration
file, `config.xml`.
-This file is based on the W3C [Packaged Web Apps (Widgets)](
-The location of the `config.xml` file is different depending on the platform. The contents,
in general, are not.
-## Platform-Specific Properties
-As with any abstraction layer, Apache Cordova cannot be a perfect silver bullet. As such,
some native and platform-specific
-properties, characteristics and behaviours are encapsulated as much as possible as `<preference>`
elements inside the
-`config.xml` file. The following sub-sections linked to are guides which go into more details
about these preferences.
+Many aspects of an application's behavior can be controlled with a
+platform-agnostic configuration file, `config.xml`, which is formatted
+based on the W3C's
+[Packaged Web Apps (Widgets)](
+For projects created with the Cordova CLI (described in The
+Command-line Interface), this file can be found in the top-level `www`
+directory.  Using the CLI to build projects regenerates versions of
+this file in various subdirectories within `platforms`. For non-CLI
+projects, each platform-specific file serves as a source.
+While the location of the `config.xml` file may change depending on
+the platform, its contents generally do not. Some platform-specific
+features are also specified in the same configuration file. Details
+are listed below:
 - iOS Configuration
 - Android Configuration

View raw message