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