| -rw-r--r-- | docs/usermanual/usermanual.sgm | 217 |
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 |