Added rest of written manual. Still lots of minor things to fix, but its all in there at least. Also, removed the document declaration to work on all systems.

1 files changed, 216 insertions, 1 deletions

diff --git a/docs/usermanual/usermanual.sgm b/docs/usermanual/usermanual.sgm
index 1fe8c52..44cf7de 100644
--- a/docs/usermanual/usermanual.sgm
+++ b/docs/usermanual/usermanual.sgm
@@ -1,13 +1,13 @@
-<!DOCTYPE book SYSTEM "/usr/local/sgml/4.2sgml/docbook.dtd">
+<!DOCTYPE book PUBLIC "-OASIS//DTD DocBook V4.2//EN">
 <book><title>Opie User Manual</title>
 <part><title>Getting Started</title>
 <chapter><title>What is Opie?</title>
 <para>
 Opie is a GUI (Graphical User Interface) for the Linux operating system (and
 might work on other OSes as well).  It was originally designed for handheld 
 computers (such as the Compaq/HP iPAQ and the Sharp Zaurus), but which could 
 probably function well in other environments requiring a light GUI, such as an 
 old laptop, or an internet kiosk.  It is bassed upon QT/Embedded from Trolltech,
 which is in turn a graphical environment designed for embedded applications,
 based upon the QT toolkit.
 </para>
@@ -681,13 +681,228 @@ name of the column in the main view to sort by that field.
 </para>
 </section>
 
 <section><title>Viewing Options</title>
 <para>
 The ``View'' menu lets you choose which files to view. If ``Hidden'' is checked, 
 hidden files will be visible (in Linux, hidden files start with a ``.''). If
 ``Symlinks'' is checked, symbolic links (files or directories which are merely
 links to other files or directories) will be visible.
 </para>
 </section>
 </chapter>
+
+<chapter><title>Embedded Konsole</title>
+<para>
+EmbeddedKonsole is Opie's terminal emulator.  From here you can do pretty much
+anything (since Linux is actually a command line based OS by itself).  I will
+not go into much detail on using the linux command line, as that is covered in
+many other places (http://www.tldp.org is a good place to start, or read
+O'Reilly's \underline{Running Linux} for a comprehensive look at Linux for the
+beginner).  I will, however, give a quick overview of using a Linux shell.
+</para>
+
+<section><title>Using Embedded Konsole</title>
+<para>
+Along the top of the window is a row of menus and icons.  The ``Font'' menu lets
+you select the font size that you want the console to use, while the Options
+menu lets you select various options.  Below this row of menus and icons is a
+pulldown list with various common commands in it.
+</para>
+
+<section><title>Options Menu</title>
+<para>
+The first submenu in the options menu is the ``Command List'' menu, which lets 
+you edit or hide the command list pulldown.  The ``Tabs on top'' or ``Tabs on 
+bottom'' (depending on which is currently enabled) allows you to select where 
+the tabs representing multiple terminal sessions are drawn.  The ``Colors'' 
+submenu lets you select from a color scheme, or make your own, and the ``Scroll 
+Bar'' submenu lets you select where or if the scroll bar is drawn.
+</para>
+</section>
+<section><title>Icons</title>
+<para>
+The row of icons to the right of the menus allows you to type common keystrokes 
+without having an input method visible, as well as some other things.
+</para>
+<para>
+The icon all the way on the left will open a new terminal session in a new tab,
+while the icon all the way on the right will paste text from the clipboard into
+the terminal.
+</para>
+<para>
+The other icons are the same as typing (from left to right) enter, space, tab
+(for tab completion), up, and down (for the command history).
+</para>
+</section>
+<section><title>Command List</title>
+<para>
+The command list is a pulldown menu with a list of commonly used commands.  
+Selecting one will type the command into the terminal wherever the cursor is.  
+You can edit or hide this menu from <GUIMenu>Options</GUIMenu>
+<GUIMenuItem>Command List.</GUIMenuItem>
+</para>
+</section>
+</section>
+
+<section><title>What is a Shell</title>
+<para>
+A shell is a program that accepts input from a user, and runs commands.  Each 
+``command'' in the shell is actually a separate program (unless you are using a 
+shell like BusyBox, which makes some of the more common commands part of its own 
+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 
+sequence of commands, sometimes with some flow control statements, saved to a 
+file and run each time the script is run.  For the most part, the average user 
+does not need to know about any of this, though.  If you are running Opie on the 
+Familiar distribution, it is advisable to install the bash shell (ipkg install 
+bash) because it offers things like tab completion, use of the backspace key, 
+and a command history, as well as offering a more advanced scripting languauge 
+than most other shells.
+</para>
+</section>
+
+<section><title>Running Programs</title>
+<para>
+To run a program or a command (remember, a command is just another program), you 
+simply type the name of the program and hit ``Return'' (in Linux, program names 
+do not have a special suffix like they do in windows, in fact the ``.'' 
+character has no special meaning unless it is at the begining of a filename, in 
+which case it makes the file ``hidden'').  When you type a program name and hit 
+``Return'' the shell looks in a special list of directories called your 
+``path'', and if it cannot find it in any of those directories, it stops looking 
+and tells you it could not find them.  If you want to run a program that is not 
+in your path, you must specify an absolute or relative path to that program.  
+For instance, to run a program that is in the directory you are currently in, 
+you would type <literal>./program</literal> (``./'' is a special directory that
+is explained below), or to run a program in /home/username/ you would call
+<literal>/home/username/program</literal>.
+</para>
+<para>
+Most programs take ``arguments'' when run from the command line.  An argument is 
+a string that contains no spaces that changes how the program behaves (a text 
+editor, for instance, might take a single argument, which would be the name of 
+the file you wish to edit).  Usually, you can use the arguments ``-h'' or 
+``--help'' to get a list of the common arguments that that program takes, along 
+with a short usage description, and a short description of what each argument 
+does.
+</para>
+</section>
+
+<section><title>Basic Navigation</title>
+<para>
+The command that you will use most often in the shell is probably the ``cd'' 
+command, which stands for ``change directory.''  With this command, you can move 
+around in the file system, by issuing the command like this: <userinput>cd
+<replaceable>[new directory]</replaceable></userinput>, where <replaceable>[new
+directory]</replaceable> is the directory you want to move to.
+This directory name does not have to include the entire directory structure, but
+can be ``relative'' which means it assumes you are talking about directories
+relative to the directory you are in.  For example, if you are in a directory 
+called /home/username and you want to move to the directory 
+/home/username/other/dir you could simply type <userinput>cd 
+other/dir</userinput> and you would end up in /home/username/other/dir.  You can
+also specify a full, or "absolute" path, by specifying the entire path name
+starting with / ( / is a special directory called the "root" directory, and does
+not have a "parent" directory, which means that it is not in any other
+directory).  There are also two special directories called ``./'' and ``../''.
+The ``./'' directory is the current directory you are in, and you will probably
+never use this in conjunction with the cd command (why would you want to move to
+the directory you are already in?).  The ``../'' directory represents the parent
+directory of the directory you are currently in, so if you are in
+/home/username, ../ is the same as /home.  You can string several ../'s
+together, so if you are in /home/username/dir/ ../../ represents /home.  There
+is one other special directory, called "~/" that points to your home
+directory (usually /home/username or /root for the root user).
+</para>
+</section>
+
+<section><title>Moving Files</title>
+<para>
+To move files around, you need to use the ``cp'' (copy) and ``mv'' (move) 
+commands.  Both of these are run the same way: \verb+command originalfile 
+newfile+.  The only difference is that cp creates a new file without touching 
+the old one, while mv deletes the original file.  The two path names can be 
+either absolute or relative.  If you only specify a directory for the 
+destination, and no filename, it will use the filename for the original file.
+</para>
+</section>
+
+<section><title>Deleting Files</title>
+<para>
+To delete a file, run the ``rm'' command, and to delete a directory, run the 
+``rmdir'' command, each of them take the file to be removed as their only 
+argument.  The rmdir command requires the directory to be empty, so if you want 
+to delete a directory that is not empty, along with all its contents, run 
+<userinput>rm -r dir</userinput>.
+</para>
+</section>
+
+<section><title>Linking Files</title>
+<para>
+In Linux, you can have a special file called a ``symbolic link'' that acts just 
+like a copy of another file, except it takes up less space.  This is convinient 
+if two applications are looking for the same file in two separate places, 
+because the file can be in both places at once, without taking up any extra 
+space, and any change to one is automatically applied to the other (really, 
+there is only one file, the link is just a file pointing to the original file).  
+This is also useful for naming applications independant of their version number. 
+ For instance, you could have a link called ``application'' that points to 
+``application1.0''.  To create a link, use the following command: 
+<userinput>ln -s originalfile link</userinput>.
+</para>
+</section>
+</chapter>
+</part>
+
+<part><title>Settings</title>
+<chapter><title>Software</title>
+
+<para>
+The ``Software'' application, also called oipkg, is what is used to install and 
+remove software.  It is actually a frontend to the command line program ``ipkg'' 
+so most things you can do with oipkg you can also do with ipkg.  Oipkg can 
+install things either remotely from a web server (called a ``feed'') or it can 
+install an ipkg package file that resides on the local filesystem.
+</para>
+<important>
+<para>
+Note: 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.
+</para>
+</important>
+
+<section><title>Installing Software</title>
+<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 
+box.  If you click on the icon for an uninstalled package, it will turn into an 
+open box, with a blue circle coming out of it, indicating that you have marked 
+this package to be installed.  Mark as many packages as you wish this way, and 
+then press the ``Apply'' icon (same red box and blue dot icon) to install all 
+the marked packages.  It will also remove any packages marked for removal (see 
+below).  Clicking this will open a window showing all the packages marked to be 
+removed and installed, with some check boxes on the bottom, which represent 
+arguments to be sent to ipkg, which you can usually ignore.  After verifying 
+that all the packages to be installed are correct, press ``Ok'' in the upper 
+right corner (or press ``x'' to cancel and go back to the package selection 
+window).  The packages should then install, and you should see their icons
+appear in the Launcher, if they are Opie applications.
+</para>
+</section>
+
+<section><title>Removing Software</title>
+<para>
+Removing software is the same as installing software, except you will press the
+blue circle icon of an installed package, and it will have a red ``X'' over it.  
+Then press the apply icon, and ``Ok''.  You can install and remove packages at 
+the same time by marking the ones you want to install and the ones you want to 
+remove, and then pressing apply.
+</para>
+</section>
+</chapter>
+</part>
 </book>
\ No newline at end of file