summaryrefslogtreecommitdiff
path: root/docs/usermanual/installation.sgm
Unidiff
Diffstat (limited to 'docs/usermanual/installation.sgm') (more/less context) (ignore whitespace changes)
-rw-r--r--docs/usermanual/installation.sgm67
1 files changed, 67 insertions, 0 deletions
diff --git a/docs/usermanual/installation.sgm b/docs/usermanual/installation.sgm
new file mode 100644
index 0000000..82834a6
--- a/dev/null
+++ b/docs/usermanual/installation.sgm
@@ -0,0 +1,67 @@
1<chapter><title>Installation</title>
2<section><title>iPAQ</title>
3<para>
4To install opie on an iPAQ, you will need a fresh Familiar installation (ie,
5install Familiar, and stop before you do ipkg install task-complete or ipkg
6install task-x), go to http://familiar.handhelds.org to get the latest version,
7and to get installation instructions (again, stop after the initial boot and do
8not install X, as it is not necessary, and will only take up space).
9</para>
10
11<note>
12<para>
13If you had qpe/qtopia installed previously,
14<emphasis>completely</emphasis> remove it, and remove the src line for it from
15your /etc/ipkg.conf file before attempting to install opie.
16</para>
17</note>
18<para>
19Once you have Familiar installed, set up a network connection between your iPAQ
20and the ouside world (again, see the Familiar site for instructions on this),
21and then run this command:
22<informalexample>
23<literallayout>
24 echo src opie "http://131.152.105.154/feeds/ipaq/unstable/" \
25 >> /etc/ipkg.conf
26</literallayout>
27</informalexample>
28then, run:
29<informalexample>
30<literallayout>
31 ipkg update && ipkg install task-opie
32</literallayout>
33</informalexample>
34If you have a 3100 or 3800 series iPAQ, run:
35<informalexample>
36<literallayout>
37 ipkg install qt-embedded-rotation
38</literallayout>
39</informalexample>
40finally, start Opie with:
41<informalexample>
42<literallayout>
43 /etc/init.d/opie start
44</literallayout>
45</informalexample>
46</para>
47
48<para>
49Opie should now be running (if you should have to reboot, which is rare, Opie
50will start automatically). From here, you can use either the "Software"
51application in the Settings tab, or run ipkg from the command line to install
52other Opie apps. Check out the various task-opie-* ipkgs to install various sets
53of apps at once (you can always uninstall individual apps individually). You
54will probably want to install opie-embeddedkonsole first, so you have access to
55the command line in Opie.
56</para>
57</section>
58
59<section><title>Zaurus</title>
60<para>
61To completely install Opie on the Zaurus, you will have to install OpenZaurus,
62which includes Opie. However, individual Opie applications will work fine on the
63default Zaurus rom. Do not install Opie's launcher on a default Zaurus ROM
64though.
65</para>
66</section>
67</chapter> \ No newline at end of file