-rw-r--r-- | docs/usermanual/software.sgm | 8 |
1 files changed, 4 insertions, 4 deletions
diff --git a/docs/usermanual/software.sgm b/docs/usermanual/software.sgm index 8b82118..a0a8264 100644 --- a/docs/usermanual/software.sgm +++ b/docs/usermanual/software.sgm | |||
@@ -1,65 +1,65 @@ | |||
1 | <chapter><title>Software</title> | 1 | <chapter><title>Software</title> |
2 | 2 | ||
3 | <para> | 3 | <para> |
4 | The "Software" application, also called oipkg, is what is used to install and | 4 | The "Software" application, also called oipkg, is what is used to install and |
5 | remove software. It is actually a frontend to the command line program "ipkg" | 5 | remove software. It is actually a frontend to the command line program "ipkg" |
6 | so most things you can do with oipkg you can also do with ipkg. Oipkg can | 6 | so most things you can do with oipkg you can also do with ipkg. Oipkg can |
7 | install things either remotely from a web server (called a "feed") or it can | 7 | install things either remotely from a web server (called a "feed") or it can |
8 | install an ipkg package file that resides on the local filesystem. | 8 | install an ipkg package file that resides on the local filesystem. |
9 | </para> | 9 | </para> |
10 | <important> | 10 | <important> |
11 | <para> | 11 | <para> |
12 | If you are using a version of ipkg lower than 0.99.20 there is a bug that prevents | 12 | If you are using a version of ipkg lower than 0.99.20 there is a bug that prevents |
13 | oipkg from working properly. If you see errors in the installation log about not being | 13 | oipkg from working properly. If you see errors in the installation log about not being |
14 | able to kill the old gunzip process, you can get around this by starting oipkg from | 14 | able to kill the old gunzip process, you can get around this by starting oipkg from |
15 | Embedded Konsole. | 15 | Embedded Konsole. |
16 | </para> | 16 | </para> |
17 | </important> | 17 | </important> |
18 | 18 | ||
19 | <section><title>Installing Software</title> | 19 | <section><title>Installing Software</title> |
20 | <para> | 20 | <para> |
21 | There are several way to install a software package, depending on how you are | 21 | There are several way to install a software package, depending on how you are |
22 | accessing the package. | 22 | accessing the package. |
23 | </para> | 23 | </para> |
24 | <para> | 24 | <para> |
25 | To install software from a feed (see <xref linkend=feed>), first select "Opie" from the | 25 | To install software from a feed (see <xref linkend=feed>), first select "&opie;" from the |
26 | "Section" pulldown menu, the press the "+" icon next to "Feeds" in the main view. | 26 | "Section" pulldown menu, the press the "+" icon next to "Feeds" in the main view. |
27 | This will show all the available Opie packages (you can change which packages | 27 | This will show all the available &opie; packages (you can change which packages |
28 | to view by selecting something else from the "Section" pulldown). Installed | 28 | to view by selecting something else from the "Section" pulldown). Installed |
29 | packages are marked with a blue circle, while packages that are not installed are marked with a red | 29 | packages are marked with a blue circle, while packages that are not installed are marked with a red |
30 | box. If you click on the icon for an uninstalled package, it will turn into an | 30 | box. If you click on the icon for an uninstalled package, it will turn into an |
31 | open box, with a blue circle coming out of it, indicating that you have marked | 31 | open box, with a blue circle coming out of it, indicating that you have marked |
32 | this package to be installed. Mark as many packages as you wish this way, and | 32 | this package to be installed. Mark as many packages as you wish this way, and |
33 | then press the "Apply" icon (same red box and blue dot icon) to install all | 33 | then press the "Apply" icon (same red box and blue dot icon) to install all |
34 | the marked packages. It will also remove any packages marked for removal (see | 34 | the marked packages. It will also remove any packages marked for removal (see |
35 | below). Clicking this will open a window showing all the packages marked to be | 35 | below). Clicking this will open a window showing all the packages marked to be |
36 | removed and installed, with some check boxes on the bottom, which represent | 36 | removed and installed, with some check boxes on the bottom, which represent |
37 | arguments to be sent to ipkg, which you can usually ignore. After verifying | 37 | arguments to be sent to ipkg, which you can usually ignore. After verifying |
38 | that all the packages to be installed are correct, press "Ok" in the upper | 38 | that all the packages to be installed are correct, press "Ok" in the upper |
39 | right corner (or press "x" to cancel and go back to the package selection | 39 | right corner (or press "x" to cancel and go back to the package selection |
40 | window). The packages should then install, and you should see their icons | 40 | window). The packages should then install, and you should see their icons |
41 | appear in the Launcher, if they are Opie applications. | 41 | appear in the Launcher, if they are &opie; applications. |
42 | </para> | 42 | </para> |
43 | <para> | 43 | <para> |
44 | If you would like to install software that is not avaialable in a feed, you can | 44 | If you would like to install software that is not avaialable in a feed, you can |
45 | download it to your device, and open Filemanger to the directory that it is in. You | 45 | download it to your device, and open Filemanger to the directory that it is in. You |
46 | can then press and hold on the file name, and select "Open in Software", and oipkg | 46 | can then press and hold on the file name, and select "Open in Software", and oipkg |
47 | will be started, with the package already marked to install. Confirm that it is the | 47 | will be started, with the package already marked to install. Confirm that it is the |
48 | correct package, and check any options that you may need and press "Ok" to install | 48 | correct package, and check any options that you may need and press "Ok" to install |
49 | the package. | 49 | the package. |
50 | </para> | 50 | </para> |
51 | <para> | 51 | <para> |
52 | If you would like to install a package but are not sure where to find it, and it is not in | 52 | If you would like to install a package but are not sure where to find it, and it is not in |
53 | any of the feeds that you are using, you can try to have oipkg search for it. You can | 53 | any of the feeds that you are using, you can try to have oipkg search for it. You can |
54 | enter a query in the "Search" field in the toolbars, and then press the magnifying | 54 | enter a query in the "Search" field in the toolbars, and then press the magnifying |
55 | glass icon. Oipkg will then search a list of feeds as well as some software websites, | 55 | glass icon. Oipkg will then search a list of feeds as well as some software websites, |
56 | and show you all the packages that it thinks might be what you are looking for, and | 56 | and show you all the packages that it thinks might be what you are looking for, and |
57 | displays them under the "ipkgfind&killefiz" section in the Package view. You can | 57 | displays them under the "ipkgfind&killefiz" section in the Package view. You can |
58 | then select the packages that you would like to install from that list and install them | 58 | then select the packages that you would like to install from that list and install them |
59 | as you normally would install packages from a feed. | 59 | as you normally would install packages from a feed. |
60 | </para> | 60 | </para> |
61 | </section> | 61 | </section> |
62 | 62 | ||
63 | <section><title>Removing Software</title> | 63 | <section><title>Removing Software</title> |
64 | <para> | 64 | <para> |
65 | Removing software is the same as installing software, except you will press the | 65 | Removing software is the same as installing software, except you will press the |
@@ -111,49 +111,49 @@ done, click "Ok" to save, or "x" to cancel. | |||
111 | </section> | 111 | </section> |
112 | <section><title>Deleting Servers</title> | 112 | <section><title>Deleting Servers</title> |
113 | <para> | 113 | <para> |
114 | If you no longer need to use a server, this can be done by going to | 114 | If you no longer need to use a server, this can be done by going to |
115 | Settings&arrow;Servers. You can then select the server you wish to delete and | 115 | Settings&arrow;Servers. You can then select the server you wish to delete and |
116 | press the "Remove" button. "Ok" will save the deletion, and "x" will cancel it. | 116 | press the "Remove" button. "Ok" will save the deletion, and "x" will cancel it. |
117 | </para> | 117 | </para> |
118 | </section> | 118 | </section> |
119 | </section> | 119 | </section> |
120 | 120 | ||
121 | <section><title>Destinations</title> | 121 | <section><title>Destinations</title> |
122 | <para> | 122 | <para> |
123 | Software is distributed in a format called "ipkg" which contains all the | 123 | Software is distributed in a format called "ipkg" which contains all the |
124 | necessary files for the program, as well as information on where to put them. | 124 | necessary files for the program, as well as information on where to put them. |
125 | However, this information is only half complete, as it tells the package manager | 125 | However, this information is only half complete, as it tells the package manager |
126 | where in the "destination" to put the files, but the package manager must know | 126 | where in the "destination" to put the files, but the package manager must know |
127 | where this "destination" is. The default destination is "/" (called "root") so | 127 | where this "destination" is. The default destination is "/" (called "root") so |
128 | if the package says to install a file in opt/QtPalmtop/ then the file will be | 128 | if the package says to install a file in opt/QtPalmtop/ then the file will be |
129 | installed in /opt/QtPalmtop/. However, if ask the package manger to use a | 129 | installed in /opt/QtPalmtop/. However, if ask the package manger to use a |
130 | destination at /mnt/hda/ (this is typically where a compact flash card would be) | 130 | destination at /mnt/hda/ (this is typically where a compact flash card would be) |
131 | then the files will be installed in /mnt/hda/opt/QtPalmtop/. | 131 | then the files will be installed in /mnt/hda/opt/QtPalmtop/. |
132 | </para> | 132 | </para> |
133 | <para> | 133 | <para> |
134 | The problem with installing file in a destination other than root is that the | 134 | The problem with installing file in a destination other than root is that the |
135 | software usually does not know where to fine the installed files, and Opie does | 135 | software usually does not know where to fine the installed files, and &opie; does |
136 | not know where to find the information that tells it how to display the program | 136 | not know where to find the information that tells it how to display the program |
137 | in the Launcher. To get around this, the package manager creates links | 137 | in the Launcher. To get around this, the package manager creates links |
138 | <footnote><para>See <xref linkend=symlink> for more information on symbolic | 138 | <footnote><para>See <xref linkend=symlink> for more information on symbolic |
139 | links in Linux</para></footnote> from where the files would be if they were | 139 | links in Linux</para></footnote> from where the files would be if they were |
140 | installed in root to where they are actually installed. This means that no more | 140 | installed in root to where they are actually installed. This means that no more |
141 | space is taken up where the files would normally be installed, but any programs | 141 | space is taken up where the files would normally be installed, but any programs |
142 | can still find the files where they think they should be. | 142 | can still find the files where they think they should be. |
143 | </para> | 143 | </para> |
144 | 144 | ||
145 | <section><title>Using Destinations</title> | 145 | <section><title>Using Destinations</title> |
146 | <para> | 146 | <para> |
147 | To mark a single package to be installed to a destination other than the default, you | 147 | To mark a single package to be installed to a destination other than the default, you |
148 | can press and hold on it, and select the destination you would like to use from the | 148 | can press and hold on it, and select the destination you would like to use from the |
149 | "Install to" menu. That package will then be installed in that destination. | 149 | "Install to" menu. That package will then be installed in that destination. |
150 | </para> | 150 | </para> |
151 | <para> | 151 | <para> |
152 | To install a group of packages in a destination other than root, go to | 152 | To install a group of packages in a destination other than root, go to |
153 | Settings&arrow;Setups to open the settings dialog to the Setups tab. From here | 153 | Settings&arrow;Setups to open the settings dialog to the Setups tab. From here |
154 | you can select the destination you would like to install the package to from the | 154 | you can select the destination you would like to install the package to from the |
155 | pulldown menu at the bottom. You will also want to check "Link to root | 155 | pulldown menu at the bottom. You will also want to check "Link to root |
156 | destination" so that links are properly made. Once you have selected the | 156 | destination" so that links are properly made. Once you have selected the |
157 | destination you want to install the package to, click the dialog's "Ok" button, | 157 | destination you want to install the package to, click the dialog's "Ok" button, |
158 | and all packages that you mark for install will be installed in the selected feed | 158 | and all packages that you mark for install will be installed in the selected feed |
159 | (The destination will not be changed for the packages already marked for | 159 | (The destination will not be changed for the packages already marked for |