summaryrefslogtreecommitdiff
path: root/docs/usermanual
Unidiff
Diffstat (limited to 'docs/usermanual') (more/less context) (ignore whitespace changes)
-rw-r--r--docs/usermanual/software.sgm59
1 files changed, 47 insertions, 12 deletions
diff --git a/docs/usermanual/software.sgm b/docs/usermanual/software.sgm
index 7284682..8b82118 100644
--- a/docs/usermanual/software.sgm
+++ b/docs/usermanual/software.sgm
@@ -9,19 +9,24 @@ install an ipkg package file that resides on the local filesystem.
9</para> 9</para>
10<important> 10<important>
11<para> 11<para>
12There is a bug in oipkg that prevents it from installing packages 12If you are using a version of ipkg lower than 0.99.20 there is a bug that prevents
13properly. There is, however, a workaround for it. Simply run oipkg from 13oipkg from working properly. If you see errors in the installation log about not being
14Embedded Konsole to avoid the bug. 14able to kill the old gunzip process, you can get around this by starting oipkg from
15Embedded Konsole.
15</para> 16</para>
16</important> 17</important>
17 18
18<section><title>Installing Software</title> 19<section><title>Installing Software</title>
19<para> 20<para>
20To install software, first select "Opie" from the "Section" pulldown menu, 21There are several way to install a software package, depending on how you are
21the press the "+" icon next to "Feeds" in the main view. This will show all 22accessing the package.
22the available Opie packages (you can change which packages to view by selecting 23</para>
23something else from the "Section" pulldown). Installed packages are marked 24<para>
24with a blue circle, while packages that are not installed are marked with a red 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.
27This will show all the available Opie packages (you can change which packages
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
25box. 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
26open 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
27this 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
@@ -35,6 +40,24 @@ right corner (or press "x" to cancel and go back to the package selection
35window). The packages should then install, and you should see their icons 40window). The packages should then install, and you should see their icons
36appear in the Launcher, if they are Opie applications. 41appear in the Launcher, if they are Opie applications.
37</para> 42</para>
43<para>
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
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
48correct package, and check any options that you may need and press "Ok" to install
49the package.
50</para>
51<para>
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
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,
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
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.
60</para>
38</section> 61</section>
39 62
40<section><title>Removing Software</title> 63<section><title>Removing Software</title>
@@ -47,7 +70,7 @@ remove, and then pressing apply.
47</para> 70</para>
48</section> 71</section>
49 72
50<section><title>Servers</title> 73<section id=feed><title>Servers</title>
51<para> 74<para>
52When you install software normally, ipkg downloadins the packages automatically 75When you install software normally, ipkg downloadins the packages automatically
53from ipkg servers (also called "Feeds") and installing them. The list of 76from ipkg servers (also called "Feeds") and installing them. The list of
@@ -121,14 +144,26 @@ can still find the files where they think they should be.
121 144
122<section><title>Using Destinations</title> 145<section><title>Using Destinations</title>
123<para> 146<para>
124To install a package in a destination other than root, go to 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
149"Install to" menu. That package will then be installed in that destination.
150</para>
151<para>
152To install a group of packages in a destination other than root, go to
125Settings&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
126you 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
127pulldown 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
128destination" so that links are properly made. Once you have selected the 156destination" so that links are properly made. Once you have selected the
129destination 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,
130and all packages that you install will be installed to the destination you 158and all packages that you mark for install will be installed in the selected feed
131selected. 159(The destination will not be changed for the packages already marked for
160installation).
161</para>
162<para>
163You can also change the default destination by checking View&arrow;Destinations
164to add the Destination toolbar to your toolbars. You can then select the default
165destination from the pulldown menu, as well as use the checkbox to select whether
166the packages should be linked to the root destination or not.
132</para> 167</para>
133</section> 168</section>
134<section><title>Adding Destinations</title> 169<section><title>Adding Destinations</title>