summaryrefslogtreecommitdiff
path: root/docs
Side-by-side diff
Diffstat (limited to 'docs') (more/less context) (ignore whitespace changes)
-rw-r--r--docs/usermanual/embeddedkonsole.sgm6
-rw-r--r--docs/usermanual/software.sgm69
2 files changed, 72 insertions, 3 deletions
diff --git a/docs/usermanual/embeddedkonsole.sgm b/docs/usermanual/embeddedkonsole.sgm
index 4ba0287..838e705 100644
--- a/docs/usermanual/embeddedkonsole.sgm
+++ b/docs/usermanual/embeddedkonsole.sgm
@@ -61,2 +61,4 @@ program in order to save space). Shells can actually be very powerful, and many
+
+
of them allow you to write something called "shell scripts" which are just a
@@ -148,3 +150,3 @@ to delete a directory that is not empty, along with all its contents, run
-<section><title>Linking Files</title>
+<section id=symlink><title>Linking Files</title>
<para>
@@ -162,2 +164,2 @@ This is also useful for naming applications independant of their version number.
</section>
-</chapter> \ No newline at end of file
+</chapter>
diff --git a/docs/usermanual/software.sgm b/docs/usermanual/software.sgm
index 459498a..f95772c 100644
--- a/docs/usermanual/software.sgm
+++ b/docs/usermanual/software.sgm
@@ -48,2 +48,69 @@ remove, and then pressing apply.
</section>
-</chapter> \ No newline at end of file
+
+<section><title>Destinations</title>
+<para>
+Software is distributed in a format called "ipkg" which contains all the
+necessary files for the program, as well as information on where to put them.
+However, this information is only half complete, as it tells the package manager
+where in the "destination" to put the files, but the package manager must know
+where this "destination" is. The default destination is "/" (called "root") so
+if the package says to install a file in opt/QtPalmtop/ then the file will be
+installed in /opt/QtPalmtop/. However, if ask the package manger to use a
+destination at /mnt/hda/ (this is typically where a compact flash card would be)
+then the files will be installed in /mnt/hda/opt/QtPalmtop/.
+</para>
+<para>
+The problem with installing file in a destination other than root is that the
+software usually does not know where to fine the installed files, and Opie does
+not know where to find the information that tells it how to display the program
+in the Launcher. To get around this, the package manager creates links
+<footnote><para>See <xref linkend=symlink> for more information on symbolic
+links in Linux</para></footnote> from where the files would be if they were
+installed in root to where they are actually installed. This means that no more
+space is taken up where the files would normally be installed, but any programs
+can still find the files where they think they should be.
+</para>
+
+<section><title>Using Destinations</title>
+<para>
+To install a package in a destination other than root, go to
+Settings&arrow;Setups to open the settings dialog to the Setups tab. From here
+you can select the destination you would like to install the package to from the
+pulldown menu at the bottom. You will also want to check "Link to root
+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.
+</para>
+</section>
+<section><title>Adding Destinations</title>
+<para>
+To add a destination, go to Settings&arrow;Destinations to bring up the settings
+dialog at the Destinations tab, and press the "New" button to add a new
+Destination to the list. The new destination should be highlighted
+automatically, and you can then change the name and the URL with the two text
+entry fields below it. The name is only for easy display of the destination, so
+name it whatever makes the most sense to you. The URL is the location that you
+want the destination to have. So, if you want all your software to be installed
+under /usr/directory then you would set the URL to that. You can then click
+"Ok" to save, or "x" to cancel the changes.
+</para>
+</section>
+<section><title>Editing Destinations</title>
+<para>
+You can edit a destination by going to Settings&arrow;Destinations and selecting
+the destination that you would like to edit. Then you can edit the Name and URL
+fields in the same manner as when you added a destination. To save, click "Ok"
+or cancel by clicking "x".
+</para>
+</section>
+<section><title>Deleting Destinations</title>
+<para>
+Deleting a destination is very easy. Go to Settings&arrow;Destinations and
+select the Destination that you would like to delete in the dialog that appears.
+ Press the "Remove" button to delete the destination, and press "Ok" to save the
+changes, or "x" to cancel them.
+</para>
+</section>
+</section>
+</chapter>