cordova-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From mwbro...@apache.org
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


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

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

----------------------------------------------------------------------
 docs/en/edge/config_ref/index.md | 26 ++++++++++++++++----------
 1 file changed, 16 insertions(+), 10 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/8a37ba32/docs/en/edge/config_ref/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/config_ref/index.md b/docs/en/edge/config_ref/index.md
index 807f13f..e060740 100644
--- a/docs/en/edge/config_ref/index.md
+++ b/docs/en/edge/config_ref/index.md
@@ -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)](http://www.w3.org/TR/widgets/)
specification.
-
-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)](http://www.w3.org/TR/widgets/)
+specification.
+
+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


Mime
View raw message