Diffstat (limited to 'docs/usermanual/installation.sgm') (more/less context) (ignore 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,33 +1,50 @@ | |||
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> |
12 | <para> | 30 | <para> |
13 | If you had QPE/QTopia installed previously, <emphasis>completely</emphasis> remove | 31 | If you had QPE/QTopia installed previously, <emphasis>completely</emphasis> remove |
14 | it, and then remove the source line for that feed from your /etc/ipkg.conf file before | 32 | it, and then remove the source line for that feed from your /etc/ipkg.conf file before |
15 | attempting to install &opie;. | 33 | 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/" \ |
25 | >> /etc/ipkg.conf | 42 | >> /etc/ipkg.conf |
26 | </literallayout> | 43 | </literallayout> |
27 | </informalexample> | 44 | </informalexample> |
28 | then, run: | 45 | then, run: |
29 | <informalexample> | 46 | <informalexample> |
30 | <literallayout> | 47 | <literallayout> |
31 | ipkg update && ipkg install task-opie | 48 | ipkg update && ipkg install task-opie |
32 | </literallayout> | 49 | </literallayout> |
33 | </informalexample> | 50 | </informalexample> |
@@ -35,39 +52,29 @@ If you have a 3100 or 3800 series &ipaq;, run: | |||
35 | <informalexample> | 52 | <informalexample> |
36 | <literallayout> | 53 | <literallayout> |
37 | ipkg install libqt2-emb-fonts | 54 | ipkg install libqt2-emb-fonts |
38 | </literallayout> | 55 | </literallayout> |
39 | </informalexample> | 56 | </informalexample> |
40 | finally, start &opie; with: | 57 | finally, start &opie; with: |
41 | <informalexample> | 58 | <informalexample> |
42 | <literallayout> | 59 | <literallayout> |
43 | /etc/init.d/opie start | 60 | /etc/init.d/opie start |
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> |
60 | <para> | 67 | <para> |
61 | &opie; applications will install and run on the default &zaurus; ROM with no problems, | 68 | &opie; applications will install and run on the default &zaurus; ROM with no problems, |
62 | except for Launcher. It is not compatible with the default ROM, and should not be | 69 | except for Launcher. It is not compatible with the default ROM, and should not be |
63 | installed. | 70 | installed. |
64 | </para> | 71 | </para> |
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> |
72 | </section> | 79 | </section> |
73 | </chapter> | 80 | </chapter> |