changed the oipkg docs at tille's suggestion.

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
@@ -11,5 +11,6 @@ install an ipkg package file that resides on the local filesystem.
 <para>
-There is a bug in oipkg that prevents it from installing packages
-properly.  There is, however, a workaround for it.  Simply run oipkg from
-Embedded Konsole to avoid the bug.
+If you are using a version of ipkg lower than 0.99.20 there is a bug that prevents 
+oipkg from working properly.  If you see errors in the installation log about not being 
+able to kill the old gunzip process, you can get around this by starting oipkg from 
+Embedded Konsole.
 </para>
@@ -19,7 +20,11 @@ Embedded Konsole to avoid the bug.
 <para>
-To install software, first select "Opie" from the "Section" pulldown menu,
-the press the "+" icon next to "Feeds" in the main view.  This will show all
-the available Opie packages (you can change which packages to view by selecting
-something else from the "Section" pulldown).  Installed packages are marked
-with a blue circle, while packages that are not installed are marked with a red
+There are several way to install a software package, depending on how you are 
+accessing the package.
+</para>
+<para>
+To install software from a feed (see <xref linkend=feed>), first select "Opie" from the
+"Section" pulldown menu, the press the "+" icon next to "Feeds" in the main view.  
+This will show all the available Opie packages (you can change which packages 
+to view by selecting something else from the "Section" pulldown).  Installed 
+packages are marked with a blue circle, while packages that are not installed are marked with a red
 box.  If you click on the icon for an uninstalled package, it will turn into an
@@ -37,2 +42,20 @@ appear in the Launcher, if they are Opie applications.
 </para>
+<para>
+If you would like to install software that is not avaialable in a feed, you can 
+download it to your device, and open Filemanger to the directory that it is in.  You
+can then press and hold on the file name, and select "Open in Software", and oipkg 
+will be started, with the package already marked to install.  Confirm that it is the 
+correct package, and check any options that you may need and press "Ok" to install 
+the package.
+</para>
+<para>
+If you would like to install a package but are not sure where to find it, and it is not in 
+any of the feeds that you are using, you can try to have oipkg search for it.  You can 
+enter a query in the "Search" field in the toolbars, and then press the magnifying
+glass icon.  Oipkg will then search a list of feeds as well as some software websites, 
+and show you all the packages that it thinks might be what you are looking for, and
+displays them under the "ipkgfind&amp;killefiz" section in the Package view.  You can
+then select the packages that you would like to install from that list and install them 
+as you normally would install packages from a feed.
+</para>
 </section>
@@ -49,3 +72,3 @@ remove, and then pressing apply.
 
-<section><title>Servers</title>
+<section id=feed><title>Servers</title>
 <para>
@@ -123,3 +146,8 @@ can still find the files where they think they should be.
 <para>
-To install a package in a destination other than root, go to 
+To mark a single package to be installed to a destination other than the default, you 
+can press and hold on it, and select the destination you would like to use from the 
+"Install to" menu.  That package will then be installed in that destination.
+</para>
+<para>
+To install a group of packages in a destination other than root, go to
 Settings&arrow;Setups to open the settings dialog to the Setups tab.  From here
@@ -129,4 +157,11 @@ destination" so that links are properly made.  Once you have selected the
 destination you want to install the package to, click the dialog's "Ok" button, 
-and all packages that you install will be installed to the destination you 
-selected.
+and all packages that you mark for install will be installed in the selected feed 
+(The destination will not be changed for the packages already marked for 
+installation).
+</para>
+<para>
+You can also change the default destination by checking View&arrow;Destinations 
+to add the Destination toolbar to your toolbars.  You can then select the default
+destination from the pulldown menu, as well as use the checkbox to select whether
+the packages should be linked to the root destination or not.
 </para>