-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,183 +1,183 @@ | |||
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 |
66 | blue circle icon of an installed package, and it will have a red "X" over it. | 66 | blue circle icon of an installed package, and it will have a red "X" over it. |
67 | Then press the apply icon, and "Ok". You can install and remove packages at | 67 | Then press the apply icon, and "Ok". You can install and remove packages at |
68 | the same time by marking the ones you want to install and the ones you want to | 68 | the same time by marking the ones you want to install and the ones you want to |
69 | remove, and then pressing apply. | 69 | remove, and then pressing apply. |
70 | </para> | 70 | </para> |
71 | </section> | 71 | </section> |
72 | 72 | ||
73 | <section id=feed><title>Servers</title> | 73 | <section id=feed><title>Servers</title> |
74 | <para> | 74 | <para> |
75 | When you install software normally, ipkg downloadins the packages automatically | 75 | When you install software normally, ipkg downloadins the packages automatically |
76 | from ipkg servers (also called "Feeds") and installing them. The list of | 76 | from ipkg servers (also called "Feeds") and installing them. The list of |
77 | servers and where they are is stored in a file called ipkg.conf in /etc/. Oipkg | 77 | servers and where they are is stored in a file called ipkg.conf in /etc/. Oipkg |
78 | is capable of maintaining this list, as well as adding or deleting feeds from | 78 | is capable of maintaining this list, as well as adding or deleting feeds from |
79 | it. | 79 | it. |
80 | </para> | 80 | </para> |
81 | <section><title>Selecting Servers</title> | 81 | <section><title>Selecting Servers</title> |
82 | <para> | 82 | <para> |
83 | To select which feeds you want to be able to see and install packages from, go | 83 | To select which feeds you want to be able to see and install packages from, go |
84 | to Settings&arrow;Setups. There will be a box with a list of servers in it | 84 | to Settings&arrow;Setups. There will be a box with a list of servers in it |
85 | called "Used Servers". Servers that are highlighted will be used to install | 85 | called "Used Servers". Servers that are highlighted will be used to install |
86 | software from, while servers that are not highlighted will be ignored. You can | 86 | software from, while servers that are not highlighted will be ignored. You can |
87 | click on a server to toggle its status. When a server is disabled, the | 87 | click on a server to toggle its status. When a server is disabled, the |
88 | information about that server such as its name and location is kept, so that | 88 | information about that server such as its name and location is kept, so that |
89 | you can resume using it without having to reenter this data. "Ok" will save the | 89 | you can resume using it without having to reenter this data. "Ok" will save the |
90 | changes, and "x" will cancel them. | 90 | changes, and "x" will cancel them. |
91 | </para> | 91 | </para> |
92 | </section> | 92 | </section> |
93 | <section><title>Adding Servers</title> | 93 | <section><title>Adding Servers</title> |
94 | <para> | 94 | <para> |
95 | You can add a server to your list of available servers by going to | 95 | You can add a server to your list of available servers by going to |
96 | Settings&arrow;Servers. Click on the button labeled "New" and enter the name | 96 | Settings&arrow;Servers. Click on the button labeled "New" and enter the name |
97 | and URL into the appropriate fields at the bottom of the window. The name is | 97 | and URL into the appropriate fields at the bottom of the window. The name is |
98 | only for your convinience, so name it whatever makes sense to you. The URL is | 98 | only for your convinience, so name it whatever makes sense to you. The URL is |
99 | the URL of the feed, so the URL for the opie feed would be | 99 | the URL of the feed, so the URL for the opie feed would be |
100 | "http://131.152.105.154/feeds/ipaq/unstable". When you are done, click "Ok" to | 100 | "http://131.152.105.154/feeds/ipaq/unstable". When you are done, click "Ok" to |
101 | save the new server, or "x" to cancel adding it. | 101 | save the new server, or "x" to cancel adding it. |
102 | </para> | 102 | </para> |
103 | </section> | 103 | </section> |
104 | <section><title>Editing Servers</title> | 104 | <section><title>Editing Servers</title> |
105 | <para> | 105 | <para> |
106 | To change the URL or name of a server, go to Settings&arrow;Servers, and select | 106 | To change the URL or name of a server, go to Settings&arrow;Servers, and select |
107 | the server that you want to edit. The current Name and URL should appear in the | 107 | the server that you want to edit. The current Name and URL should appear in the |
108 | appropriate fields, and you can change them to the new values. Once you are | 108 | appropriate fields, and you can change them to the new values. Once you are |
109 | done, click "Ok" to save, or "x" to cancel. | 109 | done, click "Ok" to save, or "x" to cancel. |
110 | </para> | 110 | </para> |
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 |
160 | installation). | 160 | installation). |
161 | </para> | 161 | </para> |
162 | <para> | 162 | <para> |
163 | You can also change the default destination by checking View&arrow;Destinations | 163 | You can also change the default destination by checking View&arrow;Destinations |
164 | to add the Destination toolbar to your toolbars. You can then select the default | 164 | to add the Destination toolbar to your toolbars. You can then select the default |
165 | destination from the pulldown menu, as well as use the checkbox to select whether | 165 | destination from the pulldown menu, as well as use the checkbox to select whether |
166 | the packages should be linked to the root destination or not. | 166 | the packages should be linked to the root destination or not. |
167 | </para> | 167 | </para> |
168 | </section> | 168 | </section> |
169 | <section><title>Adding Destinations</title> | 169 | <section><title>Adding Destinations</title> |
170 | <para> | 170 | <para> |
171 | To add a destination, go to Settings&arrow;Destinations to bring up the settings | 171 | To add a destination, go to Settings&arrow;Destinations to bring up the settings |
172 | dialog at the Destinations tab, and press the "New" button to add a new | 172 | dialog at the Destinations tab, and press the "New" button to add a new |
173 | Destination to the list. The new destination should be highlighted | 173 | Destination to the list. The new destination should be highlighted |
174 | automatically, and you can then change the name and the URL with the two text | 174 | automatically, and you can then change the name and the URL with the two text |
175 | entry fields below it. The name is only for easy display of the destination, so | 175 | entry fields below it. The name is only for easy display of the destination, so |
176 | name it whatever makes the most sense to you. The URL is the location that you | 176 | name it whatever makes the most sense to you. The URL is the location that you |
177 | want the destination to have. So, if you want all your software to be installed | 177 | want the destination to have. So, if you want all your software to be installed |
178 | under /usr/directory then you would set the URL to that. You can then click | 178 | under /usr/directory then you would set the URL to that. You can then click |
179 | "Ok" to save, or "x" to cancel the changes. | 179 | "Ok" to save, or "x" to cancel the changes. |
180 | </para> | 180 | </para> |
181 | </section> | 181 | </section> |
182 | <section><title>Editing Destinations</title> | 182 | <section><title>Editing Destinations</title> |
183 | <para> | 183 | <para> |