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,183 +1,183 @@
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
66blue 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.
67Then 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
68the 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
69remove, and then pressing apply. 69remove, 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>
75When you install software normally, ipkg downloadins the packages automatically 75When you install software normally, ipkg downloadins the packages automatically
76from ipkg servers (also called "Feeds") and installing them. The list of 76from ipkg servers (also called "Feeds") and installing them. The list of
77servers 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
78is 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
79it. 79it.
80</para> 80</para>
81<section><title>Selecting Servers</title> 81<section><title>Selecting Servers</title>
82<para> 82<para>
83To 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
84to 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
85called "Used Servers". Servers that are highlighted will be used to install 85called "Used Servers". Servers that are highlighted will be used to install
86software from, while servers that are not highlighted will be ignored. You can 86software from, while servers that are not highlighted will be ignored. You can
87click on a server to toggle its status. When a server is disabled, the 87click on a server to toggle its status. When a server is disabled, the
88information about that server such as its name and location is kept, so that 88information about that server such as its name and location is kept, so that
89you can resume using it without having to reenter this data. "Ok" will save the 89you can resume using it without having to reenter this data. "Ok" will save the
90changes, and "x" will cancel them. 90changes, 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>
95You can add a server to your list of available servers by going to 95You can add a server to your list of available servers by going to
96Settings&arrow;Servers. Click on the button labeled "New" and enter the name 96Settings&arrow;Servers. Click on the button labeled "New" and enter the name
97and URL into the appropriate fields at the bottom of the window. The name is 97and URL into the appropriate fields at the bottom of the window. The name is
98only for your convinience, so name it whatever makes sense to you. The URL is 98only for your convinience, so name it whatever makes sense to you. The URL is
99the URL of the feed, so the URL for the opie feed would be 99the 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
101save the new server, or "x" to cancel adding it. 101save 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>
106To change the URL or name of a server, go to Settings&arrow;Servers, and select 106To change the URL or name of a server, go to Settings&arrow;Servers, and select
107the server that you want to edit. The current Name and URL should appear in the 107the server that you want to edit. The current Name and URL should appear in the
108appropriate fields, and you can change them to the new values. Once you are 108appropriate fields, and you can change them to the new values. Once you are
109done, click "Ok" to save, or "x" to cancel. 109done, 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>
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
160installation). 160installation).
161</para> 161</para>
162<para> 162<para>
163You can also change the default destination by checking View&arrow;Destinations 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 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 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. 166the 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>
171To 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
172dialog 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
173Destination to the list. The new destination should be highlighted 173Destination to the list. The new destination should be highlighted
174automatically, 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
175entry 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
176name 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
177want 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
178under /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
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>