summaryrefslogtreecommitdiff
Unidiff
Diffstat (more/less context) (ignore whitespace changes)
-rw-r--r--docs/usermanual/usermanual.tex47
1 files changed, 46 insertions, 1 deletions
diff --git a/docs/usermanual/usermanual.tex b/docs/usermanual/usermanual.tex
index 5ef81f6..4364e3f 100644
--- a/docs/usermanual/usermanual.tex
+++ b/docs/usermanual/usermanual.tex
@@ -1,16 +1,17 @@
1\documentclass[12pt,letterpaper,oneside, openany]{book} \usepackage[latin1] {inputenc} 1\documentclass[12pt,letterpaper,oneside, openany]{book} \usepackage[latin1] {inputenc}
2\usepackage{amsmath} \usepackage{amsfonts} \usepackage{amssymb} 2\usepackage{amsmath} \usepackage{amsfonts} \usepackage{amssymb} \usepackage[pdftex]{hyperref}
3\title{Opie User Manual} 3\title{Opie User Manual}
4\author{The Opie Team} 4\author{The Opie Team}
5\hypersetup{bookmarks=true, bookmarksopen=false,pdftitle={Opie User Manual},pdfauthor={The Opie Team}}
5\begin{document} 6\begin{document}
6\maketitle 7\maketitle
7\tableofcontents 8\tableofcontents
8\part{Getting Started} 9\part{Getting Started}
9\chapter{What is Opie?} 10\chapter{What is Opie?}
10Opie 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. 11Opie 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.
11 12
12Opie has been designed for devices with small screens, and a touchscreen input device (ie, only one mouse click, and no constant mouse position), as well as designed to fit in a relatively small amount of storage space (about 5 megabytes for the base libraries and the launcher). 13Opie has been designed for devices with small screens, and a touchscreen input device (ie, only one mouse click, and no constant mouse position), as well as designed to fit in a relatively small amount of storage space (about 5 megabytes for the base libraries and the launcher).
13\chapter{Installation} 14\chapter{Installation}
14\section{iPaq} 15\section{iPaq}
15To install opie on an ipaq, you will need a fresh familiar installation (ie, install familiar, and stop before you do ipkg install task-complete or ipkg install task-x), go to http://familiar.handhelds.org to get the latest version, and to get installation instructions. 16To install opie on an ipaq, you will need a fresh familiar installation (ie, install familiar, and stop before you do ipkg install task-complete or ipkg install task-x), go to http://familiar.handhelds.org to get the latest version, and to get installation instructions.
16 17
@@ -199,13 +200,57 @@ The command that you will use most often in the shell is probably the ``cd'' com
199 200
200\section{Moving Files} 201\section{Moving Files}
201 202
202To 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. 203To 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.
203 204
204\section{Deleting Files} 205\section{Deleting Files}
205 206
206To 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. 207To 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.
207 208
208\section{Linking Files} 209\section{Linking Files}
209 210
210In 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 no other, one of them is just a file pointing to the other one). This is also usefull 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: \verb+ln -s originalfile link+. 211In 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 no other, one of them is just a file pointing to the other one). This is also usefull 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: \verb+ln -s originalfile link+.
212
213\chapter{File Manager}
214The file manager allows easy access to your file system, letting you browse, copy, move, delete and link files. You can also use it to open the file in an application based upon the file type, or add the file to your ``Documents'' tab, as well as several other filesystem related things.
215
216\section{Navigating }
217
218To enter a directory, simply press its icon or name in the main view. There are also two buttons in the toolbar which help with navigation. The back arrow will take you back to the directory you were previously looking at, while the up arrow will take you up one level in the directory structure (so, if you are in /usr/bin, it will take you to /usr, regardless of where you were before). The ``Dir'' menu shows the current path, with each directory as a menu item. So, if you are in /opt/QtPalmtop/bin there will be four entries: /, opt, QtPalmtop, and bin. Selecting one of these will take you immediately to that directory.
219
220\section{Selecting Files}
221
222When you click on a file, its selection status is toggled. So the first time you click on it, it will be selected, and the second time it will be deselected. To select multiple files, simply click on each one you want to select.
223
224\section{Moving Files}
225
226To copy a file from one directory to another, press and hold on the filenam, and select ``Copy'' from the menu that pops up. Then, change into the directory thatyou want to copy it into, and press the "paste" icon (an image of a clipboard and a piece of paper). To move a file, do the same thing, except select ``Cut'' from the first menu, instead of ``Copy''. You can also move or copy multiple file by selecting all of them and using the cut or copy buttons in the toolbar.
227
228\section{Deleting Files}
229
230To delete a file, press and hold it to bring up its menu, then select ``Delete'', and click ``Yes'' (or ``No'' to cancel). Delete will delete all the currently selected files, which may be more than the one that you pressed and held on.
231
232\section{Renaming Files}
233
234To change a file's name, first bring up the input method you want to use (unless you are going to use the hardware keyboard), then press and hold on the filename, and select ``rename''. A new file will appear with a ``Name'' field that is editable, enter the new name in, and click another file to keep the new name.
235
236\section{Creating Directories}
237
238To create a directory, first bring up the input method you want to use (if you are using one), and then click the new directory button (an image of a file folder with a ``+'' sign). A new folder will be created with the name ``New Folder'', and the folder name will be editable. Enter the name you want and then click another file to create the folder.
239
240\section{Viewing Files}
241
242To view a file, press and hold on a file, and the menu that comes up will contain two entries for vieing the file, the first depends on the filetype, but usually lets you open the file in a specific program. The second is ``view as text'' which will open the file up in TextEdit (regardless of whether or not it is actually a text file).
243
244\section{Adding to ``Documents''}
245
246To add a file to your ``Documents'', press and hold the file, and select ``Add to documents'' from the menu. This will add the file to the documents tab, which you can use to quickly open the file (simply click on the icon for the file in the Documents tab). Some programs also use the Documents list to aid in quickly opening files.
247
248
249\section{Sorting Files}
250
251To sort the files, use the ``Sort'' menu to select wich field you want to sort the files by (``by Name'', for instance, will sort the file alphabetically by name). If ``Ascending'' is checked, the files will be sorted in ascending order, if it is not, they will be sorted in descending order.
252
253\section{Viewing Options}
254
255The ``View'' menu lets you choose which files you 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.
211\end{document} \ No newline at end of file 256\end{document} \ No newline at end of file