summaryrefslogtreecommitdiff
path: root/docs
Unidiff
Diffstat (limited to 'docs') (more/less context) (ignore whitespace changes)
-rw-r--r--docs/usermanual/installation.sgm46
1 files changed, 26 insertions, 20 deletions
diff --git a/docs/usermanual/installation.sgm b/docs/usermanual/installation.sgm
index 9849965..24d973f 100644
--- a/docs/usermanual/installation.sgm
+++ b/docs/usermanual/installation.sgm
@@ -1,67 +1,73 @@
1<chapter><title>Installation</title> 1<chapter><title>Installation</title>
2<section><title>&ipaq;</title> 2<section><title>&ipaq;</title>
3<para> 3<para>
4To install opie on an &ipaq;, you will need a fresh Familiar installation (ie, 4To install &opie; on an &ipaq;, you will need a recent Familiar installation (i.e.
5install Familiar, and stop before you do ipkg install task-complete or ipkg 5install the Familiar "bootstrap" image, and do not install task-complete or task-x),
6install task-x), go to http://familiar.handhelds.org to get the latest version, 6go to http://familiar.handhelds.org to get the latest version, and to get installation
7and to get installation instructions (again, stop after the initial boot and do 7instructions (again, stop after the initial boot and do not install X, as it is not
8not install X, as it is not necessary, and will only take up space). 8necessary, and will only take up space).
9</para> 9</para>
10 10
11<note> 11<note>
12<para> 12<para>
13If you had qpe/qtopia installed previously, 13If you had QPE/QTopia installed previously, <emphasis>completely</emphasis> remove
14<emphasis>completely</emphasis> remove it, and remove the src line for it from 14it, and then remove the source line for that feed from your /etc/ipkg.conf file before
15your /etc/ipkg.conf file before attempting to install opie. 15attempting to install &opie;.
16</para> 16</para>
17</note> 17</note>
18<para> 18<para>
19Once you have Familiar installed, set up a network connection between your $ipaq; 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), 20and the ouside world (again, see the Familiar site for instructions on this),
21and then run this command: 21and then run this command:
22<informalexample> 22<informalexample>
23<literallayout> 23<literallayout>
24 echo src opie "http://131.152.105.154/feeds/ipaq/unstable/" \ 24 echo src opie "http://opie.handhelds.org/feed/ipaq/unstable/" \
25 >> /etc/ipkg.conf 25 >> /etc/ipkg.conf
26</literallayout> 26</literallayout>
27</informalexample> 27</informalexample>
28then, run: 28then, run:
29<informalexample> 29<informalexample>
30<literallayout> 30<literallayout>
31 ipkg update && ipkg install task-opie 31 ipkg update && ipkg install task-opie
32</literallayout> 32</literallayout>
33</informalexample> 33</informalexample>
34If you have a 3100 or 3800 series &ipaq;, run: 34If you have a 3100 or 3800 series &ipaq;, run:
35<informalexample> 35<informalexample>
36<literallayout> 36<literallayout>
37 ipkg install qt-embedded-rotation 37 ipkg install libqt2-emb-fonts
38</literallayout> 38</literallayout>
39</informalexample> 39</informalexample>
40finally, start &opie; with: 40finally, start &opie; with:
41<informalexample> 41<informalexample>
42<literallayout> 42<literallayout>
43 /etc/init.d/opie start 43 /etc/init.d/opie start
44</literallayout> 44</literallayout>
45</informalexample> 45</informalexample>
46</para> 46</para>
47 47
48<para> 48<para>
49&opie; should now be running (if you should have to reboot, which is rare, &opie; 49&opie; 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" 50will start automatically). From here, you can use either the "Packages"
51application in the Settings tab, or run ipkg from the command line to install 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 52other &opie; applications. Check out the various task-opie-* packages to install
53of apps at once (you can always uninstall individual apps individually). You 53various sets of applications all at once (you can always uninstall individual
54will probably want to install opie-embeddedkonsole first, so you have access to 54applications individually). You will probably want to install opie-embeddedkonsole
55the command line in &opie;. 55or opie-console first, so you have access to the command line in &opie;.
56</para> 56</para>
57</section> 57</section>
58 58
59<section><title>&zaurus;</title> 59<section><title>&zaurus;</title>
60<para> 60<para>
61To completely install &opie; on the &zaurus;, you will have to install OpenZaurus, 61&opie; applications will install and run on the default &zaurus; ROM with no problems,
62which includes &opie;. However, individual &opie; applications will work fine on the 62except for Launcher. It is not compatible with the default ROM, and should not be
63default &zaurus; rom. Do not install &opie;'s launcher on a default &zaurus; ROM 63installed.
64though. 64</para>
65
66<para>
67Another option is to replace the default &zaurus; ROM with the OpenZaurus
68ROM. OpenZaurus is a openly developed Linux distribution designed to run on the
69&zaurus;, and uses &opie; as its default user interface. For more information and
70installation instructions, please visit their site, http://www.openzaurus.org/.
65</para> 71</para>
66</section> 72</section>
67</chapter> 73</chapter>