Diffstat (limited to 'docs/usermanual/installation.sgm') (more/less context) (show whitespace changes)
-rw-r--r-- | docs/usermanual/installation.sgm | 45 |
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> |
4 | To install &opie; on an &ipaq;, you will need a recent Familiar installation (i.e. | 4 | To install &opie; on an &ipaq;, a recent Familiar installation will be needed. Go to |
5 | install the Familiar "bootstrap" image, and do not install task-complete or task-x), | 5 | the Familiar project homepage (http://familiar.handhelds.org) to download the latest |
6 | go to http://familiar.handhelds.org to get the latest version, and to get installation | 6 | version of the "bootstrap" image (do not install the bootstrap-opie or bootstrap-gpe |
7 | instructions (again, stop after the initial boot and do not install X, as it is not | 7 | images). Follow the instructions on the Familiar website to install the image. Do not |
8 | necessary, and will only take up space). | 8 | install the task-complete or task-x packages as they are not needed to run &opie; and |
9 | will unnecessarily occupy space on the &ipaq;. | ||
10 | </para> | ||
11 | |||
12 | <para> | ||
13 | A 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 | ||
15 | to 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 | ||
20 | that this package is installed. It is available in the Familiar feed and can be installed | ||
21 | by 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> |
19 | Once you have Familiar installed, set up a network connection between your &ipaq; | 37 | Once you have Familiar installed (including libpng3), and the network connection |
20 | and the ouside world (again, see the Familiar site for instructions on this), | 38 | between the &ipaq; and the outside world, run the following command: |
21 | and 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; | ||
50 | will start automatically). From here, you can use either the "Packages" | ||
51 | application in the Settings tab, or run ipkg from the command line to install | ||
52 | other &opie; applications. Check out the various task-opie-* packages to install | ||
53 | various sets of applications all at once (you can always uninstall individual | ||
54 | applications individually). You will probably want to install opie-embeddedkonsole | ||
55 | or 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> |
67 | Another option is to replace the default &zaurus; ROM with the OpenZaurus | 74 | Another option is to replace the default &zaurus; ROM with the OpenZaurus |
68 | ROM. OpenZaurus is a openly developed Linux distribution designed to run on the | 75 | ROM 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 |
70 | installation instructions, please visit their site, http://www.openzaurus.org/. | 77 | installation instructions, please visit their site, http://www.openzaurus.org/. |
71 | </para> | 78 | </para> |