cvs: peardoc /en/package/html html-quickform-advmultiselect.xml /en/package/html/html-quickform-advmultiselect intro.xml

farell		Fri Jan 23 14:08:40 2009 UTC

  Modified files:              
    /peardoc/en/package/html	html-quickform-advmultiselect.xml 
    /peardoc/en/package/html/html-quickform-advmultiselect	intro.xml 
  Log:
  include the "getting started -> Overview" section (basic concepts)
  
http://cvs.php.net/viewvc.cgi/peardoc/en/package/html/html-quickform-advmultiselect.xml?r1=1.14&r2=1.15&diff_format=u
Index: peardoc/en/package/html/html-quickform-advmultiselect.xml
diff -u peardoc/en/package/html/html-quickform-advmultiselect.xml:1.14 peardoc/en/package/html/html-quickform-advmultiselect.xml:1.15
--- peardoc/en/package/html/html-quickform-advmultiselect.xml:1.14	Fri Jan 23 13:54:06 2009
+++ peardoc/en/package/html/html-quickform-advmultiselect.xml	Fri Jan 23 14:08:36 2009
@@ -127,6 +127,11 @@
   </section>
  </chapter>
 
+ <chapter xml:id="package.html.html-quickform-advmultiselect.tutorial">
+  <info><title>Getting started</title></info>
+  &package.html.html-quickform-advmultiselect.intro;
+ </chapter>
+
  <chapter xml:id="package.html.html-quickform-advmultiselect.ref">
   <info>
    <title>Reference guide</title>
http://cvs.php.net/viewvc.cgi/peardoc/en/package/html/html-quickform-advmultiselect/intro.xml?r1=1.4&r2=1.5&diff_format=u
Index: peardoc/en/package/html/html-quickform-advmultiselect/intro.xml
diff -u /dev/null peardoc/en/package/html/html-quickform-advmultiselect/intro.xml:1.5
--- /dev/null	Fri Jan 23 14:08:40 2009
+++ peardoc/en/package/html/html-quickform-advmultiselect/intro.xml	Fri Jan 23 14:08:40 2009
@@ -0,0 +1,54 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xmlns="http://docbook.org/ns/docbook" version="lillet" xml:id="package.html.html-quickform-advmultiselect.intro">
+ <refnamediv>
+  <refname>Overview</refname>
+  <refpurpose>features and usage patterns</refpurpose>
+ </refnamediv>
+
+ <refsection xml:id="package.html.html-quickform-advmultiselect.intro.purpose">
+  <info><title>In brief</title></info>
+  <simpara>
+   The purpose of this tutorial is to give the new users of HTML_QuickForm_advmultiselect
+   an overview of its features and usage patterns. It describes a small subset
+   of available functionality, but points to the parts of the documentation
+   that give a more in-depth overview.
+  </simpara>
+ </refsection>
+
+ <refsection xml:id="package.html.html-quickform-advmultiselect.intro.concepts">
+  <info><title>Basic concepts</title></info>
+  <para>
+   In a usability test with non-information workers in an intranet application,
+   we could be surprised that none (or few) of the users successfully selected
+   multiple responses when presented in a HTML select element with multiple
+   selection enabled.
+   <emphasis role="bold">They simply did not know that control click exist.</emphasis>
+  </para>
+  <para>
+   To solve this problem, the QuickForm advmultiselect element provides an interface that
+   allow user-end to do their selection very easily. In this interface, there are:
+   <itemizedlist>
+    <listitem>
+     <simpara>a list with all items still available for selection.</simpara>
+    </listitem>
+    <listitem>
+     <simpara>a list with all items already selected.</simpara>
+    </listitem>
+    <listitem>
+     <simpara>two buttons to swap items from one list to the other.</simpara>
+    </listitem>
+   </itemizedlist>
+  </para>
+  <para>
+   For each new item to add to your selection, select it from the unselected list (source),
+   then clic on the <emphasis>add</emphasis> button to move it to the selection list (destination).
+   It does not exists in the source list after transfer.
+  </para>
+  <para>
+   For each item to remove from your selection, select it in the selected list (source),
+   then clic on the <emphasis>remove</emphasis> button to move it to the unselected list (destination).
+   It does not exists in the source list after transfer.
+  </para>
+ </refsection>
+
+</refentry>
\ No newline at end of file