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.sgm45
1 files changed, 26 insertions, 19 deletions
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,11 +1,29 @@
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 recent Familiar installation (i.e. 4To install &opie; on an &ipaq;, a recent Familiar installation will be needed. Go to
5install the Familiar "bootstrap" image, and do not install task-complete or task-x), 5the Familiar project homepage (http://familiar.handhelds.org) to download the latest
6go to http://familiar.handhelds.org to get the latest version, and to get installation 6version of the "bootstrap" image (do not install the bootstrap-opie or bootstrap-gpe
7instructions (again, stop after the initial boot and do not install X, as it is not 7images). Follow the instructions on the Familiar website to install the image. Do not
8necessary, and will only take up space). 8install the task-complete or task-x packages as they are not needed to run &opie; and
9will unnecessarily occupy space on the &ipaq;.
10</para>
11
12<para>
13A network connection needs to be configured on the &ipaq; in order to download the
14&opie; packages from the feed. The Familiar site provides instructions for connecting
15to the Internet in a variety of ways.
16</para>
17
18<para>
19&opie; requires the libpng3 package to be installed. Prior to installing &opie;, ensure
20that this package is installed. It is available in the Familiar feed and can be installed
21by running this command:
22<informalexample>
23<literallayout>
24 ipkg install libpng3
25</literallayout>
26</informalexample>
9</para> 27</para>
10 28
11<note> 29<note>
@@ -16,9 +34,8 @@ attempting to install &opie;.
16</para> 34</para>
17</note> 35</note>
18<para> 36<para>
19Once you have Familiar installed, set up a network connection between your &ipaq; 37Once you have Familiar installed (including libpng3), and the network connection
20and the ouside world (again, see the Familiar site for instructions on this), 38between the &ipaq; and the outside world, run the following command:
21and then run this command:
22<informalexample> 39<informalexample>
23<literallayout> 40<literallayout>
24 echo src opie "http://opie.handhelds.org/feed/ipaq/unstable/" \ 41 echo src opie "http://opie.handhelds.org/feed/ipaq/unstable/" \
@@ -44,16 +61,6 @@ finally, start &opie; with:
44</literallayout> 61</literallayout>
45</informalexample> 62</informalexample>
46</para> 63</para>
47
48<para>
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 "Packages"
51application in the Settings tab, or run ipkg from the command line to install
52other &opie; applications. Check out the various task-opie-* packages to install
53various sets of applications all at once (you can always uninstall individual
54applications individually). You will probably want to install opie-embeddedkonsole
55or opie-console first, so you have access to the command line in &opie;.
56</para>
57</section> 64</section>
58 65
59<section><title>&zaurus;</title> 66<section><title>&zaurus;</title>
@@ -65,7 +72,7 @@ installed.
65 72
66<para> 73<para>
67Another option is to replace the default &zaurus; ROM with the OpenZaurus 74Another option is to replace the default &zaurus; ROM with the OpenZaurus
68ROM. OpenZaurus is a openly developed Linux distribution designed to run on the 75ROM image. 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 76&zaurus;, and uses &opie; as its default user interface. For more information and
70installation instructions, please visit their site, http://www.openzaurus.org/. 77installation instructions, please visit their site, http://www.openzaurus.org/.
71</para> 78</para>