-rw-r--r-- | docs/usermanual/installation.sgm | 46 |
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> |
4 | To install opie on an &ipaq;, you will need a fresh Familiar installation (ie, | 4 | To install &opie; on an &ipaq;, you will need a recent Familiar installation (i.e. |
5 | install Familiar, and stop before you do ipkg install task-complete or ipkg | 5 | install the Familiar "bootstrap" image, and do not install task-complete or task-x), |
6 | install task-x), go to http://familiar.handhelds.org to get the latest version, | 6 | go to http://familiar.handhelds.org to get the latest version, and to get installation |
7 | and to get installation instructions (again, stop after the initial boot and do | 7 | instructions (again, stop after the initial boot and do not install X, as it is not |
8 | not install X, as it is not necessary, and will only take up space). | 8 | necessary, and will only take up space). |
9 | </para> | 9 | </para> |
10 | 10 | ||
11 | <note> | 11 | <note> |
12 | <para> | 12 | <para> |
13 | If you had qpe/qtopia installed previously, | 13 | If you had QPE/QTopia installed previously, <emphasis>completely</emphasis> remove |
14 | <emphasis>completely</emphasis> remove it, and remove the src line for it from | 14 | it, and then remove the source line for that feed from your /etc/ipkg.conf file before |
15 | your /etc/ipkg.conf file before attempting to install opie. | 15 | attempting to install &opie;. |
16 | </para> | 16 | </para> |
17 | </note> | 17 | </note> |
18 | <para> | 18 | <para> |
19 | Once you have Familiar installed, set up a network connection between your $ipaq; | 19 | Once you have Familiar installed, set up a network connection between your &ipaq; |
20 | and the ouside world (again, see the Familiar site for instructions on this), | 20 | and the ouside world (again, see the Familiar site for instructions on this), |
21 | and then run this command: | 21 | and 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> |
28 | then, run: | 28 | then, 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> |
34 | If you have a 3100 or 3800 series &ipaq;, run: | 34 | If 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> |
40 | finally, start &opie; with: | 40 | finally, 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; |
50 | will start automatically). From here, you can use either the "Software" | 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 | 51 | application in the Settings tab, or run ipkg from the command line to install |
52 | other &opie; apps. Check out the various task-opie-* ipkgs to install various sets | 52 | other &opie; applications. Check out the various task-opie-* packages to install |
53 | of apps at once (you can always uninstall individual apps individually). You | 53 | various sets of applications all at once (you can always uninstall individual |
54 | will probably want to install opie-embeddedkonsole first, so you have access to | 54 | applications individually). You will probably want to install opie-embeddedkonsole |
55 | the command line in &opie;. | 55 | or 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> |
61 | To 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, |
62 | which includes &opie;. However, individual &opie; applications will work fine on the | 62 | except for Launcher. It is not compatible with the default ROM, and should not be |
63 | default &zaurus; rom. Do not install &opie;'s launcher on a default &zaurus; ROM | 63 | installed. |
64 | though. | 64 | </para> |
65 | |||
66 | <para> | ||
67 | 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 | ||
69 | &zaurus;, and uses &opie; as its default user interface. For more information and | ||
70 | installation instructions, please visit their site, http://www.openzaurus.org/. | ||
65 | </para> | 71 | </para> |
66 | </section> | 72 | </section> |
67 | </chapter> | 73 | </chapter> |