More user manual updates...

2 files changed, 136 insertions, 75 deletions

diff --git a/docs/usermanual/gettingaround.sgm b/docs/usermanual/gettingaround.sgm
index 90aa3cf..34ef403 100644
--- a/docs/usermanual/gettingaround.sgm
+++ b/docs/usermanual/gettingaround.sgm
@@ -1,82 +1,136 @@
 <chapter><title>Using &opie;</title>
+
+<section><title>Running &opie; for the first time</title>
 <para>
-Now that &opie; is installed and running, it's time to start using it.  When you
-first start &opie;, you will see the "Launcher" from which you can start all of
-your Applications, and the "Taskbar" along the bottom, where you can see all
-the running applications, select an input method, and interact with the
-installed "applets".
+If everything was installed as described in the previous section, &opie; should
+now start up and present a screen to calibrate the touchscreen. Using the stylus,
+press firmly in the middle of the cross-hairs as they appear on the screen. This
+usually needs to be done only once, however the screen can be re-calibrated at any
+time, if needed, by choosing the Calibrate application on the Settings tab.
 </para>
 
+<para>
+Once the screen has been calibrated, &opie; will now start up.  If the opie-login
+package is installed (which is installed with the default installation), a screen
+will appear requiring a person to log in before any applications can be accessed.
+The standard &opie; installation currently requires the user to log in as the
+'root' user in order for all functions to work correctly. Refer to the Familiar
+website (http://familiar.handhelds.org) for the default password for the version
+installed.
+</para>
+
+<para>
+Once the correct password has been entered, &opie; should now be running. When
+rebooted however, &opie; will start automatically. To install and remove
+applications, the "Packages" application (located on the Settings tab) or the
+command line ipkg application can be used. There are several task-opie packages
+which allow the installation of whole categories (e.g. games, PIM, settings, etc.)
+of software at once. It also might be helpful to install either opie-embeddedkonsole
+or opie-console first to allow access a command line from within &opie;.
+</para>
+</section>
+
 <section><title>Getting Around</title>
 <para>
-Getting around in &opie; is very easy, you simply click your stylus on whatever
-icon or button you want to click on.  The main difference between using the
-stylus and using a mouse is that you cannot right click with a stylus, so things
-that require a right click are kept to a minimum.  However, it is sometimes
-necessary to right click, and this is implemented with a "press and hold".
-Any time you want to do something that you think would require a right click on
-a normal pc, try pressing the stylus down and holding it still for a few
-seconds.  This usually opens up a context sensative menu, much like a right
-click usually does on a desktop interface.
+Now that &opie; is installed and running, it is time to start using it. When &opie;
+is started (after logging in), the following will be visible: the "Launcher" from
+which all of the applications can be started, and the "Taskbar" along the bottom, where
+all running applications can be accessed, select an input method, and interact with the
+installed applets.
+</para>
+
+<para>
+Getting around in &opie; is very easy. Using the stylus, simply click on whatever
+icon, button or control desired. The main difference between using the stylus and using
+a mouse is that there is not an intuitive way to "right click" with the stylus. However in
+&opie;, by pressing and holding the stylus down on the screen for approximately one second
+(i.e. commonly referred to as "click and hold") a right mouse button click is generated.
+This allows the user to perform common actions such as display context sensitive menus.
+</para>
+
+<para>
+Also included in several &opie; applications is context sensitive help. If there is a icon
+with a question mark on the left side of the application's title bar, then this option
+is available. Clicking on this icon will display instructions on using this feature.
+Click and hold the icon, until the window title changes to "What's this..." and then
+click on a part of the application window to display the context sensitive help.
 </para>
 </section>
 
 <section><title>Launcher</title>
 <para>
-The Launcher behaves like the "desktop" on most PC GUIs.  When no applications
-are running or visible, you will have access to the Launcher.  You can also map
-a hardware key to bring the Launcher to the top without closing any of the
-running applications (this is similar to "minimising" all the applications
-that are running).
+The Launcher is where applications can be started, and is similar in concept to the desktop
+found in most computer graphical user interfaces. When no other applications are running,
+it is visible, occupying most of the screen. 
 </para>
+
 <para>
-Along the top of the Launcher you will see a list of tabs which function as
-categories for your applications.  You can click on the tab for the category you
-want to view, and then click on the icon for the application that you wish to
-launch.  By default, there will be an Applications tab and a Settings tab (if
-you install any games, they will appear in the Games tab).  When new 
-applications are installed, they will usually appear in one of these three tabs,
-or in a tab of their own.  To add or delete tabs or to move applications between
-the tabs, you can use the Tab Manager application, or you can edit them by hand,
-by changing the directories in /opt/QtPalmtop/apps.
+Along the top of the Launcher is a series of tabs which function as categories for all
+installed applications. By default, there are the following tabs: PIM, Applications and
+Settings. If any games are installed, there will also appear a Games tab. To launch an
+application, click once on the application icon or name. The icon will darken and an
+hour glass will appear on the taskbar at the bottom of the screen to indicate that the
+application is launching.  Most applications take 1 or 2 seconds to start.
 </para>
+
 <para>
-There is also a tab to the far right called the "Documents" tab, which allows 
-you to quickly open your most often used documents.  You can click on a document
-to open it up in the proper application.  For help on adding files to the
-Documents tab see the <xref linkend="adddoc">.
+There is also a tab to the far right named Documents. It contains a listing of the
+documents found on the handheld device, allowing easy access. Documents are organized
+by document type and category.  At the bottom of the Document tab are 2 selection boxes
+which allow the list of docuemnts to be filtered by these criteria. For instructions on
+adding and removing documents from this tab, see the <xref linkend="adddoc">.
 </para>
+
+<para>
+The Launcher Settings application on the Settings tab allows each tab's appearance to
+be customized. Items that can be configured include background color/image, font, icon
+size and more. See the Launcher Settings section for more information.
+</para>
+
 </section>
 
 <section><title>Taskbar</title>
 <para>
-&opie; has a "Taskbar" that always runs along the bottom of the screen in &opie;,
-except for a few "fullscreen" applications that cover it up.  The Taskbar is
-what lets you select which input method you would like to use, shows what
-applications are running, and is also where the "applets" draw their icons.
-On the left of the Taskbar is an "O" button that opens a menu which has an
-entry for every tab in the Launcher, allowing you to star an applications
-without going back to the Launcher, or quiting the application that you are
-running.  On the right hand side of the Taskbar, you will probably see a clock 
-(unless you installed task-opie-minimal), which is actually just another applet
-that draws the time instead of an icon.
-</para>
-<para>
-When an application is run, it adds its icon to the Taskbar, starting from the
-right side of the input method icon, with new application's icons appearing to
-the right.  If you click on the icon for an application, it will be brought to 
-the screen, allowing you to interact with it.
-</para>
-<para>
-To the right of the "O" menu you will see an icon for the currently selected 
-input method.  Clicking this will bring up the input method, allowing you to
-type into the currently running application.  To the right of the input method
-icon is a small arrow pointing up, which will open a menu of all the currently
-installed input methods when clicked.  When you select one of these, it will
-become the current input method, with its icon replacing the previous one.
+The Taskbar is the small, horizontal section which appears at the bottom of the
+screen, below the Launcher. It is almost always visible while applications are
+running.  The Taskbar provides the following functions (from left to right):
+</para>
+
+<para>
+1. "O" menu - provides a listing of all installed applications, allowing them to be
+started if Launcher is not visible. It also provides an options to display Launcher
+if there are applications running, power off the handheld device and log out of &opie;.
+</para>
+
+<para>
+2. Input methods - allows the selection of an input method. Each input method has its
+own, unique icon, and the current one selected is shown on the Taskbar. Click on the icon
+to display or hide the input method. If more than one method is installed, a small upward
+pointing arrow is shown to the right of the icon. Click on this arrow to select a
+different input method.
+</para>
+
+<para>
+3. Running applications - if any applications are running, their icon will appear immediately
+to the right of the input method icon. Clicking on an icon will bring that application to
+the front so it can be viewed. When the application is exited, the icon will disappear from
+this area.
+</para>
+
+<para>
+4. Applets - applets are "mini" applications which appear on the right side of the Taskbar.
+Some applets provide quick access to information (e.g. PC cards installed, wireless nework,
+etc.), while others provide frequently used functions (e.g. notepad, voice memo recorder).
+Clicking on an applet's icon usually provides a menu or window to access its features.
+</para>
+
+<para>
+5. Clock - in reality just another applet, displays the current time. Clicking on the clock
+displays a dialog box which allows the time to be manually updated or syncronized over the
+Internet using the NTP protocol.
 </para>
 </section>
 
 <section><title>Dialogs</title>
 <para>
 In &opie;, dialogs, as well as some applications, have a button labeled "Ok" on
diff --git a/docs/usermanual/installation.sgm b/docs/usermanual/installation.sgm
index 24d973f..ce1d07b 100644
--- a/docs/usermanual/installation.sgm
+++ b/docs/usermanual/installation.sgm
@@ -1,27 +1,44 @@
 <chapter><title>Installation</title>
 <section><title>&ipaq;</title>
 <para>
-To install &opie; on an &ipaq;, you will need a recent Familiar installation (i.e.
-install the Familiar "bootstrap" image, and do not install task-complete or task-x),
-go to http://familiar.handhelds.org to get the latest version, and to get installation
-instructions (again, stop after the initial boot and do not install X, as it is not
-necessary, and will only take up space).
+To install &opie; on an &ipaq;, a recent Familiar installation will be needed. Go to
+the Familiar project homepage (http://familiar.handhelds.org) to download the latest
+version of the "bootstrap" image (do not install the bootstrap-opie or bootstrap-gpe
+images). Follow the instructions on the Familiar website to install the image. Do not
+install the task-complete or task-x packages as they are not needed to run &opie; and
+will unnecessarily occupy space on the &ipaq;.
+</para>
+
+<para>
+A network connection needs to be configured on the &ipaq; in order to download the
+&opie; packages from the feed. The Familiar site provides instructions for connecting
+to the Internet in a variety of ways. 
+</para>
+
+<para>
+&opie; requires the libpng3 package to be installed. Prior to installing &opie;, ensure
+that this package is installed. It is available in the Familiar feed and can be installed
+by running this command:
+<informalexample>
+<literallayout>
+     ipkg install libpng3
+</literallayout>
+</informalexample>
 </para>
 
 <note>
 <para>
 If you had QPE/QTopia installed previously, <emphasis>completely</emphasis> remove
 it, and then remove the source line for that feed from your /etc/ipkg.conf file before
 attempting to install &opie;.
 </para>
 </note>
 <para>
-Once you have Familiar installed, set up a network connection between your &ipaq;
-and the ouside world (again, see the Familiar site for instructions on this),
-and then run this command:
+Once you have Familiar installed (including libpng3), and the network connection
+between the &ipaq; and the outside world, run the following command:
 <informalexample>
 <literallayout>
      echo src opie "http://opie.handhelds.org/feed/ipaq/unstable/" \
           >> /etc/ipkg.conf
 </literallayout>
 </informalexample>
@@ -41,33 +58,23 @@ finally, start &opie; with:
 <informalexample>
 <literallayout>
      /etc/init.d/opie start
 </literallayout>
 </informalexample>
 </para>
-
-<para>
-&opie; should now be running (if you should have to reboot, which is rare, &opie;
-will start automatically). From here, you can use either the "Packages"
-application in the Settings tab, or run ipkg from the command line to install
-other &opie; applications. Check out the various task-opie-* packages to install
-various sets of applications all at once (you can always uninstall individual
-applications individually). You will probably want to install opie-embeddedkonsole
-or opie-console first, so you have access to the command line in &opie;.
-</para>
 </section>
 
 <section><title>&zaurus;</title>
 <para>
 &opie; applications will install and run on the default &zaurus; ROM with no problems,
 except for Launcher. It is not compatible with the default ROM, and should not be
 installed.
 </para>
 
 <para>
 Another option is to replace the default &zaurus; ROM with the OpenZaurus
-ROM. OpenZaurus is a openly developed Linux distribution designed to run on the
+ROM image. OpenZaurus is a openly developed Linux distribution designed to run on the
 &zaurus;, and uses &opie; as its default user interface. For more information and
 installation instructions, please visit their site, http://www.openzaurus.org/.
 </para>
 </section>
 </chapter>