From bf83f72c0f1fbecd8007cad39df9b6cfdc3bd85e Mon Sep 17 00:00:00 2001
From: Leena Miettinen <riitta-leena.miettinen@digia.com>
Date: Thu, 10 Jul 2014 16:00:51 +0200
Subject: Doc: add docs for Change UI Example

Describe the example files.
Add example file extensions to the qdocconf file to
have all files listed on the doc page.
Fix capitalization in the configuration file.
Use more descriptive values for the component in the
package information file. Rearrange sections to be able
to use an include file for documenting all package
information files.
Add more detailed information about creating the installer.
Add image.

Change-Id: I64ffff29d08f1dff4cd92c3b796f1a0e6c2fb280
Reviewed-by: Kai Koehne <kai.koehne@digia.com>
---
 examples/changeuserinterface/config/config.xml     |   8 +++---
 .../meta/package.xml                               |   7 ++---
 examples/doc/changeuserinterface.qdoc              |  30 +++++++++++++++++----
 .../images/qtifw-examples-changeuserinterface.png  | Bin 0 -> 41473 bytes
 4 files changed, 33 insertions(+), 12 deletions(-)
 create mode 100644 examples/doc/images/qtifw-examples-changeuserinterface.png

(limited to 'examples')

diff --git a/examples/changeuserinterface/config/config.xml b/examples/changeuserinterface/config/config.xml
index c00f6c705..bdd7e9c2a 100644
--- a/examples/changeuserinterface/config/config.xml
+++ b/examples/changeuserinterface/config/config.xml
@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Installer>
-    <Name>Change installer UI Example</Name>
+    <Name>Change Installer UI Example</Name>
     <Version>1.0.0</Version>
-    <Title>Change installer UI Example</Title>
+    <Title>Change Installer UI Example</Title>
     <Publisher>Qt-Project</Publisher>
-    <StartMenuDir>Change installer UI Example</StartMenuDir>
-    <TargetDir>@HomeDir@/IFWChangeInstallerUIExample</TargetDir>
+    <StartMenuDir>Qt IFW Examples</StartMenuDir>
+    <TargetDir>@HomeDir@/IfwExample</TargetDir>
 </Installer>
diff --git a/examples/changeuserinterface/packages/org.qtproject.ifw.example.changeuserinterface/meta/package.xml b/examples/changeuserinterface/packages/org.qtproject.ifw.example.changeuserinterface/meta/package.xml
index 04f1986d8..ad6125dea 100644
--- a/examples/changeuserinterface/packages/org.qtproject.ifw.example.changeuserinterface/meta/package.xml
+++ b/examples/changeuserinterface/packages/org.qtproject.ifw.example.changeuserinterface/meta/package.xml
@@ -1,9 +1,10 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Package>
-    <DisplayName>Change UI example</DisplayName>
-    <Description>Change license accept/reject labels text</Description>
-    <ReleaseDate>2013-01-01</ReleaseDate>
+    <DisplayName>Dummy Component</DisplayName>
+    <Description>This example does not install any components. It demonstrates
+    modifying the text on the next page.</Description>
     <Version>1.0.0-1</Version>
+    <ReleaseDate>2013-01-01</ReleaseDate>
     <Script>installscript.qs</Script>
     <Licenses>
         <License name="Beer Public License Agreement" file="license.txt" />
diff --git a/examples/doc/changeuserinterface.qdoc b/examples/doc/changeuserinterface.qdoc
index 872177b18..bc4fb9075 100644
--- a/examples/doc/changeuserinterface.qdoc
+++ b/examples/doc/changeuserinterface.qdoc
@@ -32,10 +32,13 @@
 
     \brief Changing the installer UI by using a component script.
 
-    \e {Change Installer UI} demonstrates how to add a license page to the
-    installer by using a component script.
+    \image qtifw-examples-changeuserinterface.png
 
-    \note Do not use component scripts for translations.
+    \e {Change Installer UI} demonstrates how to use the \c Component() function
+    to modify the default text for the radio button labels on the
+    \l{License Check Page}{license check page}. This example does not install
+    any components, but we specify a dummy component in the package information
+    file, because installers without components are not allowed.
 
     \include installerfw-examples-configuring.qdocinc
 
@@ -44,8 +47,8 @@
     \include installerfw-examples-packaging.qdocinc
 
     \list
-        \li The \c <Version> section specifies the version number of the
-            component.
+        \li The \c <Script> section specifies the file name of the JavaScript
+            file that is loaded to perform operations.
         \li The \c <Licenses> section specifies the \c name of the license
             agreement to be accepted by the end user and the filename of the
             \c file that contains the license.
@@ -53,5 +56,22 @@
 
     \quotefile changeuserinterface/packages/org.qtproject.ifw.example.changeuserinterface/meta/package.xml
 
+    \section1 Modifying UI Text
+
+    In installscript.qs, we call the \c Component() function to add the license
+    check page and to connect to the \c changeLicenseLabels signal when end
+    users enter the page:
+
+    \quotefromfile changeuserinterface/packages/org.qtproject.ifw.example.changeuserinterface/meta/installscript.qs
+    \skipto Component()
+    \printuntil }
+
+    We use the \c changeLicenseLabels function to change the text labels for the
+    accept and reject license radio buttons on the page:
+
+    \printuntil }
+
+    \note Do not use the \c Component() function to add translations.
+
     \include installerfw-examples-generating.qdocinc
 */
diff --git a/examples/doc/images/qtifw-examples-changeuserinterface.png b/examples/doc/images/qtifw-examples-changeuserinterface.png
new file mode 100644
index 000000000..c9bfad983
Binary files /dev/null and b/examples/doc/images/qtifw-examples-changeuserinterface.png differ
-- 
cgit v1.2.3