summaryrefslogtreecommitdiff
authorspiralman <spiralman>2002-07-31 20:03:57 (UTC)
committer spiralman <spiralman>2002-07-31 20:03:57 (UTC)
commitd5508db9a1a2f4b2c5b68f77a88975a9c7743655 (patch) (unidiff)
treef71bf96741575f69bf9ffcf5e0082f915d6c0272
parent4e4dfc6d8cff94ba72c4e9b15937a2fa7a08eabd (diff)
downloadopie-d5508db9a1a2f4b2c5b68f77a88975a9c7743655.zip
opie-d5508db9a1a2f4b2c5b68f77a88975a9c7743655.tar.gz
opie-d5508db9a1a2f4b2c5b68f77a88975a9c7743655.tar.bz2
changed the oipkg docs at tille's suggestion.
Diffstat (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
@@ -1,62 +1,85 @@
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>
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
28then 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
29the 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
30below). 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
31removed and installed, with some check boxes on the bottom, which represent 36removed and installed, with some check boxes on the bottom, which represent
32arguments 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
33that 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
34right 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
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>
41<para> 64<para>
42Removing 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
43blue circle icon of an installed package, and it will have a red "X" over it. 66blue circle icon of an installed package, and it will have a red "X" over it.
44Then press the apply icon, and "Ok". You can install and remove packages at 67Then press the apply icon, and "Ok". You can install and remove packages at
45the same time by marking the ones you want to install and the ones you want to 68the same time by marking the ones you want to install and the ones you want to
46remove, and then pressing apply. 69remove, 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
54servers and where they are is stored in a file called ipkg.conf in /etc/. Oipkg 77servers and where they are is stored in a file called ipkg.conf in /etc/. Oipkg
55is capable of maintaining this list, as well as adding or deleting feeds from 78is capable of maintaining this list, as well as adding or deleting feeds from
56it. 79it.
57</para> 80</para>
58<section><title>Selecting Servers</title> 81<section><title>Selecting Servers</title>
59<para> 82<para>
60To select which feeds you want to be able to see and install packages from, go 83To select which feeds you want to be able to see and install packages from, go
61to Settings&arrow;Setups. There will be a box with a list of servers in it 84to Settings&arrow;Setups. There will be a box with a list of servers in it
62called "Used Servers". Servers that are highlighted will be used to install 85called "Used Servers". Servers that are highlighted will be used to install
@@ -112,32 +135,44 @@ The problem with installing file in a destination other than root is that the
112software 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
113not 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
114in the Launcher. To get around this, the package manager creates links 137in the Launcher. To get around this, the package manager creates links
115<footnote><para>See <xref linkend=symlink> for more information on symbolic 138<footnote><para>See <xref linkend=symlink> for more information on symbolic
116links 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
117installed 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
118space 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
119can still find the files where they think they should be. 142can still find the files where they think they should be.
120</para> 143</para>
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>
135<para> 170<para>
136To add a destination, go to Settings&arrow;Destinations to bring up the settings 171To add a destination, go to Settings&arrow;Destinations to bring up the settings
137dialog at the Destinations tab, and press the "New" button to add a new 172dialog at the Destinations tab, and press the "New" button to add a new
138Destination to the list. The new destination should be highlighted 173Destination to the list. The new destination should be highlighted
139automatically, and you can then change the name and the URL with the two text 174automatically, and you can then change the name and the URL with the two text
140entry fields below it. The name is only for easy display of the destination, so 175entry fields below it. The name is only for easy display of the destination, so
141name it whatever makes the most sense to you. The URL is the location that you 176name it whatever makes the most sense to you. The URL is the location that you
142want the destination to have. So, if you want all your software to be installed 177want the destination to have. So, if you want all your software to be installed
143under /usr/directory then you would set the URL to that. You can then click 178under /usr/directory then you would set the URL to that. You can then click