summaryrefslogtreecommitdiff
Unidiff
Diffstat (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
@@ -56,12 +56,14 @@ You can edit or hide this menu from <GUIMenu>Options</GUIMenu>&arrow;
56<para> 56<para>
57A shell is a program that accepts input from a user, and runs commands. Each 57A shell is a program that accepts input from a user, and runs commands. Each
58"command" in the shell is actually a separate program (unless you are using a 58"command" in the shell is actually a separate program (unless you are using a
59shell like BusyBox, which makes some of the more common commands part of its own 59shell like BusyBox, which makes some of the more common commands part of its own
60program in order to save space). Shells can actually be very powerful, and many 60program in order to save space). Shells can actually be very powerful, and many
61 61
62
63
62of them allow you to write something called "shell scripts" which are just a 64of them allow you to write something called "shell scripts" which are just a
63sequence of commands, sometimes with some flow control statements, saved to a 65sequence of commands, sometimes with some flow control statements, saved to a
64file and run each time the script is run. For the most part, the average user 66file and run each time the script is run. For the most part, the average user
65does not need to know about any of this, though. If you are running Opie on the 67does not need to know about any of this, though. If you are running Opie on the
66Familiar distribution, it is advisable to install the bash shell (ipkg install 68Familiar distribution, it is advisable to install the bash shell (ipkg install
67bash) because it offers things like tab completion, use of the backspace key, 69bash) because it offers things like tab completion, use of the backspace key,
@@ -143,13 +145,13 @@ To delete a file, run the "rm" command, and to delete a directory, run the
143argument. The rmdir command requires the directory to be empty, so if you want 145argument. The rmdir command requires the directory to be empty, so if you want
144to delete a directory that is not empty, along with all its contents, run 146to delete a directory that is not empty, along with all its contents, run
145<userinput>rm -r dir</userinput>. 147<userinput>rm -r dir</userinput>.
146</para> 148</para>
147</section> 149</section>
148 150
149<section><title>Linking Files</title> 151<section id=symlink><title>Linking Files</title>
150<para> 152<para>
151In Linux, you can have a special file called a "symbolic link" that acts just 153In Linux, you can have a special file called a "symbolic link" that acts just
152like a copy of another file, except it takes up less space. This is convinient 154like a copy of another file, except it takes up less space. This is convinient
153if two applications are looking for the same file in two separate places, 155if two applications are looking for the same file in two separate places,
154because the file can be in both places at once, without taking up any extra 156because the file can be in both places at once, without taking up any extra
155space, and any change to one is automatically applied to the other (really, 157space, and any change to one is automatically applied to the other (really,
@@ -157,7 +159,7 @@ there is only one file, the link is just a file pointing to the original file).
157This is also useful for naming applications independant of their version number. 159This is also useful for naming applications independant of their version number.
158 For instance, you could have a link called "application" that points to 160 For instance, you could have a link called "application" that points to
159"application1.0". To create a link, use the following command: 161"application1.0". To create a link, use the following command:
160<userinput>ln -s originalfile link</userinput>. 162<userinput>ln -s originalfile link</userinput>.
161</para> 163</para>
162</section> 164</section>
163</chapter> \ No newline at end of file 165</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
@@ -43,7 +43,74 @@ Removing 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. 43blue 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 44Then 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 45the same time by marking the ones you want to install and the ones you want to
46remove, and then pressing apply. 46remove, and then pressing apply.
47</para> 47</para>
48</section> 48</section>
49</chapter> \ No newline at end of file 49
50<section><title>Destinations</title>
51<para>
52Software is distributed in a format called "ipkg" which contains all the
53necessary files for the program, as well as information on where to put them.
54However, this information is only half complete, as it tells the package manager
55where in the "destination" to put the files, but the package manager must know
56where this "destination" is. The default destination is "/" (called "root") so
57if the package says to install a file in opt/QtPalmtop/ then the file will be
58installed in /opt/QtPalmtop/. However, if ask the package manger to use a
59destination at /mnt/hda/ (this is typically where a compact flash card would be)
60then the files will be installed in /mnt/hda/opt/QtPalmtop/.
61</para>
62<para>
63The problem with installing file in a destination other than root is that the
64software usually does not know where to fine the installed files, and Opie does
65not know where to find the information that tells it how to display the program
66in the Launcher. To get around this, the package manager creates links
67<footnote><para>See <xref linkend=symlink> for more information on symbolic
68links in Linux</para></footnote> from where the files would be if they were
69installed in root to where they are actually installed. This means that no more
70space is taken up where the files would normally be installed, but any programs
71can still find the files where they think they should be.
72</para>
73
74<section><title>Using Destinations</title>
75<para>
76To install a package in a destination other than root, go to
77Settings&arrow;Setups to open the settings dialog to the Setups tab. From here
78you can select the destination you would like to install the package to from the
79pulldown menu at the bottom. You will also want to check "Link to root
80destination" so that links are properly made. Once you have selected the
81destination you want to install the package to, click the dialog's "Ok" button,
82and all packages that you install will be installed to the destination you
83selected.
84</para>
85</section>
86<section><title>Adding Destinations</title>
87<para>
88To add a destination, go to Settings&arrow;Destinations to bring up the settings
89dialog at the Destinations tab, and press the "New" button to add a new
90Destination to the list. The new destination should be highlighted
91automatically, and you can then change the name and the URL with the two text
92entry fields below it. The name is only for easy display of the destination, so
93name it whatever makes the most sense to you. The URL is the location that you
94want the destination to have. So, if you want all your software to be installed
95under /usr/directory then you would set the URL to that. You can then click
96"Ok" to save, or "x" to cancel the changes.
97</para>
98</section>
99<section><title>Editing Destinations</title>
100<para>
101You can edit a destination by going to Settings&arrow;Destinations and selecting
102the destination that you would like to edit. Then you can edit the Name and URL
103fields in the same manner as when you added a destination. To save, click "Ok"
104or cancel by clicking "x".
105</para>
106</section>
107<section><title>Deleting Destinations</title>
108<para>
109Deleting a destination is very easy. Go to Settings&arrow;Destinations and
110select the Destination that you would like to delete in the dialog that appears.
111 Press the "Remove" button to delete the destination, and press "Ok" to save the
112changes, or "x" to cancel them.
113</para>
114</section>
115</section>
116</chapter>