summaryrefslogtreecommitdiff
path: root/docs/usermanual
Side-by-side diff
Diffstat (limited to 'docs/usermanual') (more/less context) (ignore whitespace changes)
-rw-r--r--docs/usermanual/usermanual.sgm5
1 files changed, 4 insertions, 1 deletions
diff --git a/docs/usermanual/usermanual.sgm b/docs/usermanual/usermanual.sgm
index 0232cd3..f691889 100644
--- a/docs/usermanual/usermanual.sgm
+++ b/docs/usermanual/usermanual.sgm
@@ -1,114 +1,117 @@
<!DOCTYPE book PUBLIC "-OASIS//DTD DocBook V4.2//EN" [
<!ENTITY arrow "-->">
]>
<book><title>Opie User Manual</title>
+<bookinfo><authorgroup><collab>
+<collabname>The Opie Team</collabname>
+</collab></authorgroup></bookinfo>
<part><title>Getting Started</title>
<chapter><title>What is Opie?</title>
<para>
Opie is a GUI (Graphical User Interface) for the Linux operating system (and
might work on other OSes as well). It was originally designed for handheld
computers (such as the Compaq/HP iPAQ and the Sharp Zaurus), but could
probably function well in other environments requiring a light GUI, such as an
old laptop, or an internet kiosk. It is based upon QT/Embedded from Trolltech,
which is in turn a graphical environment designed for embedded applications,
based upon the QT toolkit.
</para>
<para>
Opie has been designed for devices with small screens, and a touchscreen input
-device (ie, only one mouse click, and no constant mouse position), as well as
+device (ie, only one mouse click, and no constant mouse position), as well as
designed to fit in a relatively small amount of storage space (about 5 megabytes
for the base libraries and the launcher).
</para>
</chapter>
<chapter><title>Installation</title>
<section><title>iPAQ</title>
<para>
To install opie on an iPAQ, you will need a fresh Familiar installation (ie,
install Familiar, and stop before you do ipkg install task-complete or ipkg
install 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).
</para>
<note>
<para>
If you had qpe/qtopia installed previously,
<emphasis>completely</emphasis> remove it, and remove the src line for it 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:
<informalexample>
<literallayout>
echo src opie "http://131.152.105.154/feeds/ipaq/unstable/" \
>> /etc/ipkg.conf
</literallayout>
</informalexample>
then, run:
<informalexample>
<literallayout>
ipkg update && ipkg install task-opie
</literallayout>
</informalexample>
If you have a 3100 or 3800 series iPAQ, run:
<informalexample>
<literallayout>
ipkg install qt-embedded-rotation
</literallayout>
</informalexample>
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 "Software"
application in the Settings tab, or run ipkg from the command line to install
other Opie apps. Check out the various task-opie-* ipkgs to install various sets
of apps at once (you can always uninstall individual apps individually). You
will probably want to install opie-embeddedkonsole first, so you have access to
the command line in Opie.
</para>
</section>
<section><title>Zaurus</title>
<para>
To completely install Opie on the Zaurus, you will have to install OpenZaurus,
which includes Opie. However, individual Opie applications will work fine on the
default Zaurus rom. Do not install Opie's launcher on a default Zaurus ROM
though.
</para>
</section>
</chapter>
<chapter><title>Using Opie</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".
</para>
<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.
</para>
</section>
<section><title>Launcher</title>