Created.

git-svn-id: svn://svn.rockbox.org/rockbox/trunk@3442 a1c6a512-1295-4272-9138-f99709370657

www/manual/play-keyboard.t

@@ -0,0 +1,94 @@
+#define _PAGE_ Manual - Player keyboard
+#include "head.t"
+#include "manual.t"
+
+    <p>
+      The keyboard allows you to edit text. The first line holds the
+      text being edited and the second line is a combined menu line
+      where you both can select characters for insertion and the
+      operations; backspace, delete, accept and abort.
+    </p>
+
+    <p>
+      You move between the lines using the normal LEFT and RIGHT
+      buttons. An arrow to the left indicate what line is selected. The
+      second line will scroll. This is like like in most menus except
+      that the first line will always show the text being edited.
+    </p>
+
+    <h2>Button bindings and functionality</h2>
+
+    <table class=buttontable>
+      <tr><th>Line</th><th>Function and key bindings</th>
+	<tr><td>First</td><td>Text - Use UP and DOWN to move the cursor</td></tr>
+	<tr><td>Second</td>
+	  <td>
+	    <table>
+	      <tr>
+		<td>Characters</td><td>Chars selectable for
+		input. With ON insert the char between the
+		arrows. Select another character by using UP and
+		DOWN. Finally change the character subset with
+		MENU. There are three subsets to choose from:
+		capital letters, small letters and others.</td>
+	      </tr>
+	      <tr>
+		<td>Backspace</td><td>Use UP to delete the char to the
+		left the cursor.</td>
+	      </tr>
+	      <tr><td>Delete</td><td>Use UP to delete char under the
+		  cursor</td>
+	      </tr>
+	      <tr><td>Accept</td><td>UP accepts the text and returns
+		  to the application</td>
+	      </tr>
+	      <tr><td>Abort</td><td>UP returns to the application
+		  without any change</td>
+	      </tr>
+	    </table>
+	  </td>
+	</tr>
+    </table>
+
+    <h2>Example</h2>
+
+    <p>Supposed we want edit the text "file.mp3" and change it to
+    "fileName.mp3". Maybe as a part of doing a rename operation. This
+    is how the screen will look:</p>
+
+    <img src="play-keyboard-initial.png">
+
+    <p>Note how the arrow points to the first line. This means that UP
+    and DOWN will move the cursor on the first line so that you can
+    select where to insert a char or where to delete chars.</p>
+
+    <p>Now we press DOWN three times to move the cursor so it will be
+    above the dot. The we move down to the second line by pressing
+    RIGHT. Finally we select the character N by pressing UP a few
+    times. You will se that the second line will scroll to the left
+    placing a new character between the arrows each time you press
+    UP. We continue doing this until we have N between the arrows. The
+    screen will look something like this then.</p>
+
+    <img src="play-keyboard-Nselected.png">
+
+    <p>We are now ready to insert out first character. Press ON and N
+    will be inserted at the place of the cursor.</p>
+    
+    <p>To get to the small letters we press MENU, move to 'a' by using
+    UP and DOWN, insert it by pressing ON.</p>
+
+    <img src="play-keyboard-Naentered.png">
+
+    <p>Finally to feed our new text back to the application requesting
+    this we move further down by pressing RIGHT. This will scroll the
+    second line vertically, move away the character insertion line and
+    another menu line will be visible. We continue pressing RIGHT until
+    the menu choice Accept is visible.</p>
+
+    <img src="play-keyboard-accept.png">
+
+    <p>We acknowledge this by pressing UP. We are done. We will now be
+    taken back to where we were before entering the keyboard.</p>
+
+#include "foot.t"