author | spiralman <spiralman> | 2002-07-28 04:53:53 (UTC) |
---|---|---|
committer | spiralman <spiralman> | 2002-07-28 04:53:53 (UTC) |
commit | f3411388a892ef8fa04e2981f8a8ea77350cfd85 (patch) (unidiff) | |
tree | bfb3b36bb1c4d6f9d03c0bbc6a54785afdbabdec | |
parent | 70d4145745facd09297681df171d9d7df9a78220 (diff) | |
download | opie-f3411388a892ef8fa04e2981f8a8ea77350cfd85.zip opie-f3411388a892ef8fa04e2981f8a8ea77350cfd85.tar.gz opie-f3411388a892ef8fa04e2981f8a8ea77350cfd85.tar.bz2 |
replaced latex quotes (``'') with normal quotes ("")
-rw-r--r-- | docs/usermanual/usermanual.sgm | 308 |
1 files changed, 181 insertions, 127 deletions
diff --git a/docs/usermanual/usermanual.sgm b/docs/usermanual/usermanual.sgm index 44cf7de..bfa09fb 100644 --- a/docs/usermanual/usermanual.sgm +++ b/docs/usermanual/usermanual.sgm | |||
@@ -1,908 +1,962 @@ | |||
1 | <!DOCTYPE book PUBLIC "-OASIS//DTD DocBook V4.2//EN"> | 1 | <!DOCTYPE book PUBLIC "-OASIS//DTD DocBook V4.2//EN"> |
2 | <book><title>Opie User Manual</title> | 2 | <book><title>Opie User Manual</title> |
3 | <part><title>Getting Started</title> | 3 | <part><title>Getting Started</title> |
4 | <chapter><title>What is Opie?</title> | 4 | <chapter><title>What is Opie?</title> |
5 | <para> | 5 | <para> |
6 | Opie is a GUI (Graphical User Interface) for the Linux operating system (and | 6 | Opie is a GUI (Graphical User Interface) for the Linux operating system (and |
7 | might work on other OSes as well). It was originally designed for handheld | 7 | might work on other OSes as well). It was originally designed for handheld |
8 | computers (such as the Compaq/HP iPAQ and the Sharp Zaurus), but which could | 8 | computers (such as the Compaq/HP iPAQ and the Sharp Zaurus), but which could |
9 | probably function well in other environments requiring a light GUI, such as an | 9 | probably function well in other environments requiring a light GUI, such as an |
10 | old laptop, or an internet kiosk. It is bassed upon QT/Embedded from Trolltech, | 10 | old laptop, or an internet kiosk. It is bassed upon QT/Embedded from Trolltech, |
11 | which is in turn a graphical environment designed for embedded applications, | 11 | which is in turn a graphical environment designed for embedded applications, |
12 | based upon the QT toolkit. | 12 | based upon the QT toolkit. |
13 | </para> | 13 | </para> |
14 | <para> | 14 | <para> |
15 | Opie has been designed for devices with small screens, and a touchscreen input | 15 | Opie has been designed for devices with small screens, and a touchscreen input |
16 | device (ie, only one mouse click, and no constant mouse position), as well as | 16 | device (ie, only one mouse click, and no constant mouse position), as well as |
17 | designed to fit in a relatively small amount of storage space (about 5 megabytes | 17 | designed to fit in a relatively small amount of storage space (about 5 megabytes |
18 | for the base libraries and the launcher). | 18 | for the base libraries and the launcher). |
19 | </para> | 19 | </para> |
20 | </chapter> | 20 | </chapter> |
21 | <chapter><title>Installation</title> | 21 | <chapter><title>Installation</title> |
22 | <section><title>iPAQ</title> | 22 | <section><title>iPAQ</title> |
23 | <para> | 23 | <para> |
24 | To install opie on an iPAQ, you will need a fresh Familiar installation (ie, | 24 | To install opie on an iPAQ, you will need a fresh Familiar installation (ie, |
25 | install Familiar, and stop before you do ipkg install task-complete or ipkg | 25 | install Familiar, and stop before you do ipkg install task-complete or ipkg |
26 | install task-x), go to http://familiar.handhelds.org to get the latest version, | 26 | install task-x), go to http://familiar.handhelds.org to get the latest version, |
27 | and to get installation instructions (again, stop after the initial boot and do | 27 | and to get installation instructions (again, stop after the initial boot and do |
28 | not install X, as it is not necessary, and will only take up space). | 28 | not install X, as it is not necessary, and will only take up space). |
29 | </para> | 29 | </para> |
30 | 30 | ||
31 | <note> | 31 | <note> |
32 | <para> | 32 | <para> |
33 | Note: If you had qpe/qtopia installed previously, \emph{completely} remove it, | 33 | Note: If you had qpe/qtopia installed previously, \emph{completely} remove it, |
34 | and remove the src line for it from your /etc/ipkg.conf file before attempting | 34 | and remove the src line for it from your /etc/ipkg.conf file before attempting |
35 | to install opie. | 35 | to install opie. |
36 | </para> | 36 | </para> |
37 | </note> | 37 | </note> |
38 | <para> | 38 | <para> |
39 | Once you have Familiar installed, set up a network connection between your iPAQ | 39 | Once you have Familiar installed, set up a network connection between your iPAQ |
40 | and the ouside world (again, see the Familiar site for instructions on this), | 40 | and the ouside world (again, see the Familiar site for instructions on this), |
41 | and then run this command: | 41 | and then run this command: |
42 | <informalexample> | 42 | <informalexample> |
43 | <literallayout> | 43 | <literallayout> |
44 | echo src opie "http://131.152.105.154/feeds/ipaq/unstable/" \ | 44 | echo src opie "http://131.152.105.154/feeds/ipaq/unstable/" \ |
45 | >> /etc/ipkg.conf | 45 | >> /etc/ipkg.conf |
46 | </literallayout> | 46 | </literallayout> |
47 | </informalexample> | 47 | </informalexample> |
48 | then, run: | 48 | then, run: |
49 | <informalexample> | 49 | <informalexample> |
50 | <literallayout> | 50 | <literallayout> |
51 | ipkg update && ipkg install task-opie | 51 | ipkg update && ipkg install task-opie |
52 | </literallayout> | 52 | </literallayout> |
53 | </informalexample> | 53 | </informalexample> |
54 | If you have a 3100 or 3800 series iPAQ, run: | 54 | If you have a 3100 or 3800 series iPAQ, run: |
55 | <informalexample> | 55 | <informalexample> |
56 | <literallayout> | 56 | <literallayout> |
57 | ipkg install qt-embedded-rotation | 57 | ipkg install qt-embedded-rotation |
58 | </literallayout> | 58 | </literallayout> |
59 | </informalexample> | 59 | </informalexample> |
60 | finally, start Opie with: | 60 | finally, start Opie with: |
61 | <informalexample> | 61 | <informalexample> |
62 | <literallayout> | 62 | <literallayout> |
63 | /etc/init.d/opie start | 63 | /etc/init.d/opie start |
64 | </literallayout> | 64 | </literallayout> |
65 | </informalexample> | 65 | </informalexample> |
66 | </para> | 66 | </para> |
67 | 67 | ||
68 | <para> | 68 | <para> |
69 | Opie should now be running (if you should have to reboot, which is rare, Opie | 69 | Opie should now be running (if you should have to reboot, which is rare, Opie |
70 | will start automatically). From here, you can use either the ``Software'' | 70 | will start automatically). From here, you can use either the "Software" |
71 | application in the Settings tab, or run ipkg from the command line to install | 71 | application in the Settings tab, or run ipkg from the command line to install |
72 | other Opie apps. Check out the various task-opie-* ipkgs to install various sets | 72 | other Opie apps. Check out the various task-opie-* ipkgs to install various sets |
73 | |||
74 | |||
73 | of apps at once (you can always uninstall individual apps individually). You | 75 | of apps at once (you can always uninstall individual apps individually). You |
74 | will probably want to install opie-embeddedkonsole first, so you have access to | 76 | will probably want to install opie-embeddedkonsole first, so you have access to |
75 | the command line in Opie. | 77 | the command line in Opie. |
76 | </para> | 78 | </para> |
77 | </section> | 79 | </section> |
78 | 80 | ||
79 | <section><title>Zaurus</title> | 81 | <section><title>Zaurus</title> |
80 | <para> | 82 | <para> |
81 | To completely install Opie on the Zaurus, you will have to install OpenZaurus, | 83 | To completely install Opie on the Zaurus, you will have to install OpenZaurus, |
82 | which includes Opie. However, individual Opie applications will work fine on the | 84 | which includes Opie. However, individual Opie applications will work fine on the |
85 | |||
86 | |||
83 | default Zaurus rom. Do not install Opie's launcher on a default Zaurus ROM | 87 | default Zaurus rom. Do not install Opie's launcher on a default Zaurus ROM |
84 | though. | 88 | though. |
85 | </para> | 89 | </para> |
86 | </section> | 90 | </section> |
87 | </chapter> | 91 | </chapter> |
88 | 92 | ||
89 | <chapter><title>Using Opie</title> | 93 | <chapter><title>Using Opie</title> |
90 | <para> | 94 | <para> |
91 | Now that Opie is installed and running, it's time to start using it. When you | 95 | Now that Opie is installed and running, it's time to start using it. When you |
92 | first start Opie, you will see the ``Launcher'' from which you can start all of | 96 | first start Opie, you will see the "Launcher" from which you can start all of |
93 | your Applications, and the ``Taskbar'' along the bottom, where you can see all | 97 | your Applications, and the "Taskbar" along the bottom, where you can see all |
94 | the running applications, select an input method, and interact with the | 98 | the running applications, select an input method, and interact with the |
95 | installed ``applets''. | 99 | installed "applets". |
96 | </para> | 100 | </para> |
97 | 101 | ||
98 | <section><title>Getting Around</title> | 102 | <section><title>Getting Around</title> |
99 | <para> | 103 | <para> |
100 | Getting around in Opie is very easy, you simply click your stylus on whatever | 104 | Getting around in Opie is very easy, you simply click your stylus on whatever |
101 | icon or button you want to click on. The main difference between using the | 105 | icon or button you want to click on. The main difference between using the |
102 | stylus and using a mouse is that you cannot right click with a stylus, so things | 106 | stylus and using a mouse is that you cannot right click with a stylus, so things |
107 | |||
108 | |||
103 | that require a right click are kept to a minimum. However, it is sometimes | 109 | that require a right click are kept to a minimum. However, it is sometimes |
104 | necessary to right click, and this is implemented with a ``press and hold''. | 110 | necessary to right click, and this is implemented with a "press and hold". |
105 | Any time you want to do something that you think would require a right click on | 111 | Any time you want to do something that you think would require a right click on |
106 | a normal pc, try pressing the stylus down and holding it still for a few | 112 | a normal pc, try pressing the stylus down and holding it still for a few |
107 | seconds. This usually opens up a context sensative menu, much like a right | 113 | seconds. This usually opens up a context sensative menu, much like a right |
108 | click usually does on a desktop interface. | 114 | click usually does on a desktop interface. |
109 | </para> | 115 | </para> |
110 | </section> | 116 | </section> |
111 | 117 | ||
112 | <section><title>Launcher</title> | 118 | <section><title>Launcher</title> |
113 | <para> | 119 | <para> |
114 | The Launcher behaves like the ``desktop'' on most PC GUIs. When no applications | 120 | The Launcher behaves like the "desktop" on most PC GUIs. When no applications |
121 | |||
122 | |||
115 | are running or visible, you will have access to the Launcher. You can also map | 123 | are running or visible, you will have access to the Launcher. You can also map |
116 | a hardware key to bring the Launcher to the top without closing any of the | 124 | a hardware key to bring the Launcher to the top without closing any of the |
117 | running applications (this is similar to ``minimising'' all the applications | 125 | running applications (this is similar to "minimising" all the applications |
118 | that are running). | 126 | that are running). |
119 | </para> | 127 | </para> |
120 | <para> | 128 | <para> |
121 | Along the top of the Launcher you will see a list of tabs which function as | 129 | Along the top of the Launcher you will see a list of tabs which function as |
122 | categories for your applications. You can click on the tab for the category you | 130 | categories for your applications. You can click on the tab for the category you |
131 | |||
132 | |||
123 | want to view, and then click on the icon for the application that you wish to | 133 | want to view, and then click on the icon for the application that you wish to |
124 | launch. By default, there will be an Applications tab and a Settings tab (if | 134 | launch. By default, there will be an Applications tab and a Settings tab (if |
125 | you install any games, they will appear in the Games tab). When new | 135 | you install any games, they will appear in the Games tab). When new |
126 | applications are installed, they will usually appear in one of these three tabs, | 136 | applications are installed, they will usually appear in one of these three tabs, |
137 | |||
138 | |||
127 | or in a tab of their own. To add or delete tabs or to move applications between | 139 | or in a tab of their own. To add or delete tabs or to move applications between |
128 | the tabs, you can use the Tab Manager application, or you can edit them by hand, | 140 | the tabs, you can use the Tab Manager application, or you can edit them by hand, |
129 | by changing the directories in /opt/QtPalmtop/apps. | 141 | by changing the directories in /opt/QtPalmtop/apps. |
130 | </para> | 142 | </para> |
131 | <para> | 143 | <para> |
132 | There is also a tab to the far right called the ``Documents'' tab, which allows | 144 | There is also a tab to the far right called the "Documents" tab, which allows |
133 | you to quickly open your most often used documents. You can click on a document | 145 | you to quickly open your most often used documents. You can click on a document |
146 | |||
147 | |||
134 | to open it up in the proper application. For help on adding files to the | 148 | to open it up in the proper application. For help on adding files to the |
135 | Documents tab see \ref{docadd} on page \pageref{docadd} | 149 | Documents tab see \ref{docadd} on page \pageref{docadd} |
136 | </para> | 150 | </para> |
137 | </section> | 151 | </section> |
138 | 152 | ||
139 | <section><title>Taskbar</title> | 153 | <section><title>Taskbar</title> |
140 | <para> | 154 | <para> |
141 | Opie has a ``Taskbar'' that always runs along the bottom of the screen in Opie, | 155 | Opie has a "Taskbar" that always runs along the bottom of the screen in Opie, |
142 | except for a few ``fullscreen'' applications that cover it up. The Taskbar is | 156 | except for a few "fullscreen" applications that cover it up. The Taskbar is |
143 | what lets you select which input method you would like to use, shows what | 157 | what lets you select which input method you would like to use, shows what |
144 | applications are running, and is also where the ``applets'' draw their icons. | 158 | applications are running, and is also where the "applets" draw their icons. |
145 | On the left of the Taskbar is an ``O'' button that opens a menu which has an | 159 | On the left of the Taskbar is an "O" button that opens a menu which has an |
146 | entry for every tab in the Launcher, allowing you to star an applications | 160 | entry for every tab in the Launcher, allowing you to star an applications |
147 | without going back to the Launcher, or quiting the application that you are | 161 | without going back to the Launcher, or quiting the application that you are |
148 | running. On the right hand side of the Taskbar, you will probably see a clock | 162 | running. On the right hand side of the Taskbar, you will probably see a clock |
149 | (unless you installed task-opie-minimal), which is actually just another applet | 163 | (unless you installed task-opie-minimal), which is actually just another applet |
150 | that draws the time instead of an icon. | 164 | that draws the time instead of an icon. |
151 | </para> | 165 | </para> |
152 | <para> | 166 | <para> |
153 | When an application is run, it adds its icon to the Taskbar, starting from the | 167 | When an application is run, it adds its icon to the Taskbar, starting from the |
154 | right side of the input method icon, with new application's icons appearing to | 168 | right side of the input method icon, with new application's icons appearing to |
155 | the right. If you click on the icon for an application, it will be brought to | 169 | the right. If you click on the icon for an application, it will be brought to |
156 | the screen, allowing you to interact with it. | 170 | the screen, allowing you to interact with it. |
157 | </para> | 171 | </para> |
158 | <para> | 172 | <para> |
159 | To the right of the ``O'' menu you will see an icon for the currently selected | 173 | To the right of the "O" menu you will see an icon for the currently selected |
160 | input method. Clicking this will bring up the input method, allowing you to | 174 | input method. Clicking this will bring up the input method, allowing you to |
161 | type into the currently running application. To the right of the input method | 175 | type into the currently running application. To the right of the input method |
162 | icon is a small arrow pointing up, which will open a menu of all the currently | 176 | icon is a small arrow pointing up, which will open a menu of all the currently |
163 | installed input methods when clicked. When you select one of these, it will | 177 | installed input methods when clicked. When you select one of these, it will |
164 | become the current input method, with its icon replacing the previous one. | 178 | become the current input method, with its icon replacing the previous one. |
165 | </para> | 179 | </para> |
166 | </section> | 180 | </section> |
167 | 181 | ||
168 | <section><title>Dialogs</title> | 182 | <section><title>Dialogs</title> |
169 | <para> | 183 | <para> |
170 | In Opie, dialogs, as well as some applications, have a button labeled ``Ok'' on | 184 | In Opie, dialogs, as well as some applications, have a button labeled "Ok" on |
171 | the right side of the window title bar, in addition to the normal ``x''. For | 185 | the right side of the window title bar, in addition to the normal "x". For |
172 | dialogs, the ``Ok'' button will apply your changes and close the window, while | 186 | dialogs, the "Ok" button will apply your changes and close the window, while |
173 | the ``x'' will cancel them before closing the window (for people used to most | 187 | the "x" will cancel them before closing the window (for people used to most |
174 | desktop GUI's the ``Ok'' and ``x'' behave like the ``Ok'' and ``Cancel'' buttons | 188 | desktop GUI's the "Ok" and "x" behave like the "Ok" and "Cancel" buttons |
189 | |||
190 | |||
175 | you would normally see in the bottom right of the dialog window). | 191 | you would normally see in the bottom right of the dialog window). |
176 | </para> | 192 | </para> |
177 | <para> | 193 | <para> |
178 | For applications that have an ``Ok'' button as well as the ``x'' button that all | 194 | For applications that have an "Ok" button as well as the "x" button that all |
179 | applications have, the ``Ok'' button will usually save the current file and then | 195 | applications have, the "Ok" button will usually save the current file and then |
180 | close the application, while the ``x'' button will close the application without | 196 | close the application, while the "x" button will close the application without |
181 | saving. | 197 | saving. |
182 | </para> | 198 | </para> |
183 | </section> | 199 | </section> |
184 | </chapter> | 200 | </chapter> |
185 | 201 | ||
186 | <chapter><title>Upgrading</title> | 202 | <chapter><title>Upgrading</title> |
187 | <para> | 203 | <para> |
188 | First, you should shutdown Opie from the ``Shutdown'' app in the Settings tab. | 204 | First, you should shutdown Opie from the "Shutdown" app in the Settings tab. |
189 | Normally, simply running | 205 | Normally, simply running |
190 | <informalexample> | 206 | <informalexample> |
191 | <literallayout> | 207 | <literallayout> |
192 | ipkg update && ipkg upgrade | 208 | ipkg update && ipkg upgrade |
193 | </literallayout> | 209 | </literallayout> |
194 | </informalexample> | 210 | </informalexample> |
195 | will upgrade Opie. However, if you currently have a version with the 1.5.0 | 211 | will upgrade Opie. However, if you currently have a version with the 1.5.0 |
196 | version number, you will have to upgrade it differently, because Opie now uses a | 212 | version number, you will have to upgrade it differently, because Opie now uses a |
213 | |||
214 | |||
197 | different version number (the 1.5.0 was Qtopia's version number, we now use our | 215 | different version number (the 1.5.0 was Qtopia's version number, we now use our |
198 | own). To upgrade from one of these older versions, run: | 216 | own). To upgrade from one of these older versions, run: |
199 | <informalexample> | 217 | <informalexample> |
200 | <literallayout> | 218 | <literallayout> |
201 | ipkg update | 219 | ipkg update |
202 | ipkg install opie-update | 220 | ipkg install opie-update |
203 | </literallayout> | 221 | </literallayout> |
204 | </informalexample> | 222 | </informalexample> |
205 | Opie should then be upgraded. | 223 | Opie should then be upgraded. |
206 | </para> | 224 | </para> |
207 | </chapter> | 225 | </chapter> |
208 | </part> | 226 | </part> |
209 | 227 | ||
210 | <part><title>Applications</title> | 228 | <part><title>Applications</title> |
211 | <chapter><title>Contacts</title> | 229 | <chapter><title>Contacts</title> |
212 | <para> | 230 | <para> |
213 | Contacts is a way to keep track of all the people you know, and how to contact | 231 | Contacts is a way to keep track of all the people you know, and how to contact |
214 | them. as well as other information, such as their birthday, the company they | 232 | them. as well as other information, such as their birthday, the company they |
215 | work for, etc. | 233 | work for, etc. |
216 | <para> | 234 | <para> |
217 | 235 | ||
218 | <section><title>Adding Contacts</title> | 236 | <section><title>Adding Contacts</title> |
219 | <para> | 237 | <para> |
220 | To Add a user, go to <GUImenu>Contact</GUImenu><GUIMenuItem>Add</GUIMenuItem>, | 238 | To Add a user, go to <GUImenu>Contact</GUImenu><GUIMenuItem>Add</GUIMenuItem>, |
221 | or click the add icon in the toolbar (looks like a blank piece of paper). | 239 | or click the add icon in the toolbar (looks like a blank piece of paper). |
222 | First, you need to give the person a name. You can do this by either entering | 240 | First, you need to give the person a name. You can do this by either entering |
223 | their name in the name field, or by pressing ``Full Name...'', which will open | 241 | their name in the name field, or by pressing "Full Name...", which will open |
224 | up a new dialog that lets you enter each part of their name individually. Three | 242 | up a new dialog that lets you enter each part of their name individually. Three |
225 | of the entry fields have pulldown menus instead of labels that let you set which | 243 | of the entry fields have pulldown menus instead of labels that let you set which |
226 | parameter these input fields control. The File As field lets you control how | 244 | parameter these input fields control. The File As field lets you control how |
227 | their name is displayed in the main view, use the pulldown arrow to select from | 245 | their name is displayed in the main view, use the pulldown arrow to select from |
228 | some common ways of ordering their first and last names, or type in a custom | 246 | some common ways of ordering their first and last names, or type in a custom |
229 | one. You can also select a category for the user to be filed under, and clicking | 247 | one. You can also select a category for the user to be filed under, and clicking |
230 | the button labeled ``...'' lets you edit the available catagories (these are | 248 | the button labeled "..." lets you edit the available catagories (these are |
231 | convinient for displaying just the contacts you want when you have a lot of | 249 | convinient for displaying just the contacts you want when you have a lot of |
232 | them). | 250 | them). |
233 | </para> | 251 | </para> |
234 | <para> | 252 | <para> |
235 | The address tab lets you edit the contact's buisness and home addresses (select | 253 | The address tab lets you edit the contact's buisness and home addresses (select |
236 | which one you want to change from the pulldown menu at the top). The bottom | 254 | which one you want to change from the pulldown menu at the top). The bottom |
237 | field behaves just like the three custom fields in the ``General'' tab (and if | 255 | field behaves just like the three custom fields in the "General" tab (and if |
238 | you select the same thing from the pulldown list, it will modify the same | 256 | you select the same thing from the pulldown list, it will modify the same |
239 | parameter). | 257 | parameter). |
240 | </para> | 258 | </para> |
241 | <para> | 259 | <para> |
242 | The Details tab is used for miscelaneous things like the person's position, the | 260 | The Details tab is used for miscelaneous things like the person's position, the |
243 | name of their spouse, etc. | 261 | name of their spouse, etc. |
244 | </para> | 262 | </para> |
245 | <para> | 263 | <para> |
246 | When you are done, click ``Ok'' in the top right of the screen (you can always | 264 | When you are done, click "Ok" in the top right of the screen (you can always |
247 | edit their profile later), click the ``x'' to cancel, and not add the contact. | 265 | edit their profile later), click the "x" to cancel, and not add the contact. |
248 | </para> | 266 | </para> |
249 | </section> | 267 | </section> |
250 | <section><title>Editing Contacts</title> | 268 | <section><title>Editing Contacts</title> |
251 | <para> | 269 | <para> |
252 | To edit the contacts, select the person you want to edit, anc click the pencil | 270 | To edit the contacts, select the person you want to edit, anc click the pencil |
253 | icon, or go to <GUIMenu>Contact</GUIMenu><GUIMenuItem>Edit</GUIMenuItem>, and it | 271 | icon, or go to <GUIMenu>Contact</GUIMenu><GUIMenuItem>Edit</GUIMenuItem>, and it |
254 | will open up the same dialog used to add a user, except their information that | 272 | will open up the same dialog used to add a user, except their information that |
255 | is already entered will already be filled in. To finalise the changes, click | 273 | is already entered will already be filled in. To finalise the changes, click |
256 | ``Ok'', or to cancel them, click ``x''. | 274 | "Ok", or to cancel them, click "x". |
257 | </para> | 275 | </para> |
258 | </section> | 276 | </section> |
259 | 277 | ||
260 | <section><title>Deleting Contacts</title> | 278 | <section><title>Deleting Contacts</title> |
261 | <para> | 279 | <para> |
262 | To delete a contact, select the person from the list of contacts, and click the | 280 | To delete a contact, select the person from the list of contacts, and click the |
263 | trash can icon, or go to Contact \begin{math}\rightarrow\end{math}Delete. A | 281 | trash can icon, or go to Contact \begin{math}\rightarrow\end{math}Delete. A |
264 | dialog will pop up asking if you want to actually delete that contact, click yes | 282 | dialog will pop up asking if you want to actually delete that contact, click yes |
283 | |||
284 | |||
265 | to delete it, no will cancel. | 285 | to delete it, no will cancel. |
266 | </para> | 286 | </para> |
267 | </section> | 287 | </section> |
268 | 288 | ||
269 | <section><title>Editing Contacts</title> | 289 | <section><title>Editing Contacts</title> |
270 | <para> | 290 | <para> |
271 | To find a specific person, click the find icon (green magnifying glass), or go | 291 | To find a specific person, click the find icon (green magnifying glass), or go |
272 | to <GUIMenu>Contact</GUIMenu><GUIMenuItem>Find</GUIMenuItem>. A dialog will pop | 292 | to <GUIMenu>Contact</GUIMenu><GUIMenuItem>Find</GUIMenuItem>. A dialog will pop |
273 | up, and in the ``Find what'' input, enter the string you want to search for. You | 293 | up, and in the "Find what" input, enter the string you want to search for. You |
274 | can also select if you want the search to be case sensative, and if you want it | 294 | can also select if you want the search to be case sensative, and if you want it |
275 | to search backwards from the currently selected user. The Category drop down | 295 | to search backwards from the currently selected user. The Category drop down |
276 | menu lets you search only a specific category (``All'' to search all of them). | 296 | menu lets you search only a specific category ("All" to search all of them). |
277 | When you click ``Find'', it will start search for the string in all the fields | 297 | When you click "Find", it will start search for the string in all the fields |
278 | in all the contacts. When it finds a match, it will highlight the user in the | 298 | in all the contacts. When it finds a match, it will highlight the user in the |
279 | main view. You can use this to search for (as an example) who a certain phone | 299 | main view. You can use this to search for (as an example) who a certain phone |
280 | number belongs to, by entering the phone number in the ``find what'' field, and | 300 | number belongs to, by entering the phone number in the "find what" field, and |
281 | clicking ``Find''. | 301 | clicking "Find". |
282 | </para> | 302 | </para> |
283 | </section> | 303 | </section> |
284 | 304 | ||
285 | <section><title>Viewing Contacts</title> | 305 | <section><title>Viewing Contacts</title> |
286 | <para> | 306 | <para> |
287 | To view only the contacts in a certain category, go to the View menu, and check | 307 | To view only the contacts in a certain category, go to the View menu, and check |
288 | the categories you want to view. | 308 | the categories you want to view. |
289 | </para> | 309 | </para> |
290 | <para> | 310 | <para> |
291 | The list of letters on the bottom of the window lets you look at only the | 311 | The list of letters on the bottom of the window lets you look at only the |
292 | contacts who's names begin with that letter. These work much like entering text | 312 | contacts who's names begin with that letter. These work much like entering text |
293 | on a mobile phone. For example, to view all the contacts whos name starts with | 313 | on a mobile phone. For example, to view all the contacts whos name starts with |
294 | ``B'', press the ``ABC'' group twice (since ``B'' is the second letter in that | 314 | "B", press the "ABC" group twice (since "B" is the second letter in that |
295 | group). To go back to displaying all of the letters, click it two more times | 315 | group). To go back to displaying all of the letters, click it two more times |
296 | (pressing it four times brings you back to all the letters, so you pressed it 2 | 316 | (pressing it four times brings you back to all the letters, so you pressed it 2 |
297 | times to get to ``B'' and 2 more times to get back to all letters. 2+2=4). | 317 | times to get to "B" and 2 more times to get back to all letters. 2+2=4). |
298 | </para> | 318 | </para> |
299 | </section> | 319 | </section> |
300 | 320 | ||
301 | <section><title>Personal Details</title> | 321 | <section><title>Personal Details</title> |
302 | <para> | 322 | <para> |
303 | Change your personal details by going to <GUIMenu>Contact </GUIMenu> | 323 | Change your personal details by going to <GUIMenu>Contact </GUIMenu> |
304 | <GUIMenuItem>My Personal Details</GUIMenuItem>. This is used in today to | 324 | <GUIMenuItem>My Personal Details</GUIMenuItem>. This is used in today to |
305 | display who the device belongs to, as well as other apps. | 325 | display who the device belongs to, as well as other apps. |
306 | </para> | 326 | </para> |
307 | </section> | 327 | </section> |
308 | </chapter> | 328 | </chapter> |
309 | 329 | ||
310 | <chapter><title>Calendar</title> | 330 | <chapter><title>Calendar</title> |
311 | <para> | 331 | <para> |
312 | The Calendar is a way to keep track of all your appointments, birthdays, | 332 | The Calendar is a way to keep track of all your appointments, birthdays, |
313 | meetings, or any other event that you would put in a calendar. | 333 | meetings, or any other event that you would put in a calendar. |
314 | </para> | 334 | </para> |
315 | 335 | ||
316 | <section><title>Navigation</title> | 336 | <section><title>Navigation</title> |
317 | <para> | 337 | <para> |
318 | Navigation in the Calendar is simple. Along the top are five different buttons | 338 | Navigation in the Calendar is simple. Along the top are five different buttons |
319 | that allow you to set the type of view, which correspond to the five items in | 339 | that allow you to set the type of view, which correspond to the five items in |
320 | the ``View'' menu. Each one (except for ``Today'') changes the amount of time | 340 | the "View" menu. Each one (except for "Today") changes the amount of time |
321 | shown on the screen. ``Day'' shows one day, ``Week'' one week, etc. Today is the | 341 | shown on the screen. "Day" shows one day, "Week" one week, etc. Today is the |
322 | same as Day, except that it automatically sets the view to the current day. | 342 | same as Day, except that it automatically sets the view to the current day. |
323 | </para> | 343 | </para> |
324 | <section><title>The Day view</title> | 344 | <section><title>The Day view</title> |
325 | <para> | 345 | <para> |
326 | The day view shows your day divided up into blocks representing each hour. At | 346 | The day view shows your day divided up into blocks representing each hour. At |
327 | the top is the navigation bar, wher you will see a row of buttons, which | 347 | the top is the navigation bar, wher you will see a row of buttons, which |
328 | represent the days of the current week, and on the left and right sides of the | 348 | represent the days of the current week, and on the left and right sides of the |
329 | navigation bar are arrows, which allow you to move one day in that direction. If | 349 | navigation bar are arrows, which allow you to move one day in that direction. If |
350 | |||
351 | |||
330 | you are on the last day of the week, pressing the arrow will bring you into the | 352 | you are on the last day of the week, pressing the arrow will bring you into the |
331 | first day of the next week (or vice-versa if you are going backwards). There is | 353 | first day of the next week (or vice-versa if you are going backwards). There is |
332 | also a button that lists the current day, which you can press to select a day to | 354 | also a button that lists the current day, which you can press to select a day to |
333 | view from a calendar dialog. | 355 | view from a calendar dialog. |
334 | </para> | 356 | </para> |
335 | <para> | 357 | <para> |
336 | In the main view, there is a collumn of buttons, each of which represents one | 358 | In the main view, there is a collumn of buttons, each of which represents one |
337 | hour. If you select one, any new appointments will automatically default to | 359 | hour. If you select one, any new appointments will automatically default to |
338 | begining at that time and ending an hour later (which you can, of course, change | 360 | begining at that time and ending an hour later (which you can, of course, change |
361 | |||
362 | |||
339 | when you create the appointment). | 363 | when you create the appointment). |
340 | </para> | 364 | </para> |
341 | <para> | 365 | <para> |
342 | Clicking on an appointment will open a menu that lets you edit, delete or beam | 366 | Clicking on an appointment will open a menu that lets you edit, delete or beam |
343 | the appointment. Beam will beam the appointment to any device supporting the | 367 | the appointment. Beam will beam the appointment to any device supporting the |
344 | Obex protocol (PalmOS based devices, cellphones, etc). libopieobex must be | 368 | Obex protocol (PalmOS based devices, cellphones, etc). libopieobex must be |
345 | installed to use this feature. | 369 | installed to use this feature. |
346 | </para> | 370 | </para> |
347 | </section> | 371 | </section> |
348 | 372 | ||
349 | <section><title>The Week View</title> | 373 | <section><title>The Week View</title> |
350 | <para> | 374 | <para> |
351 | The week view allows you to see your week divided up into columns, representing | 375 | The week view allows you to see your week divided up into columns, representing |
352 | each day of the week, and rows, representing each hour of the day. In the | 376 | each day of the week, and rows, representing each hour of the day. In the |
353 | navigation bar at the top, there are two scroll boxes, the one on the left shows | 377 | navigation bar at the top, there are two scroll boxes, the one on the left shows |
378 | |||
379 | |||
354 | the current year, and the one to the right shows which week it is of that year. | 380 | the current year, and the one to the right shows which week it is of that year. |
355 | To the right of both of those is a label which shows the date range for the | 381 | To the right of both of those is a label which shows the date range for the |
356 | currently selected week. | 382 | currently selected week. |
357 | </para> | 383 | </para> |
358 | <para> | 384 | <para> |
359 | In the main view, you see the week divided up into rows and collumns | 385 | In the main view, you see the week divided up into rows and collumns |
360 | representing the days of the week, and hours of the day. In each cell, you will | 386 | representing the days of the week, and hours of the day. In each cell, you will |
361 | see a blue square which represents an appointment, which you can press to see | 387 | see a blue square which represents an appointment, which you can press to see |
362 | details of the appointment. If you press anywhere in the free space, you will go | 388 | details of the appointment. If you press anywhere in the free space, you will go |
389 | |||
390 | |||
363 | to the day of the column that you clicked in. | 391 | to the day of the column that you clicked in. |
364 | </para> | 392 | </para> |
365 | </section> | 393 | </section> |
366 | 394 | ||
367 | <section><title>The Week List View</title> | 395 | <section><title>The Week List View</title> |
368 | <para> | 396 | <para> |
369 | The week list view shows you all the appointments that you have that week | 397 | The week list view shows you all the appointments that you have that week |
370 | without graphically representing how long they are or showing the free time | 398 | without graphically representing how long they are or showing the free time |
371 | between them. This is convinient if you need to see a list of all your | 399 | between them. This is convinient if you need to see a list of all your |
372 | appointments, but do not need to see how your time is mapped out. The navigation | 400 | appointments, but do not need to see how your time is mapped out. The navigation |
401 | |||
402 | |||
373 | bar has an arrow button on either side, allowing you to move to the next or | 403 | bar has an arrow button on either side, allowing you to move to the next or |
374 | previous week, as well as a button which gives the current week number for that | 404 | previous week, as well as a button which gives the current week number for that |
375 | year. Pressing the week number button will bring up a calendar dialog, which | 405 | year. Pressing the week number button will bring up a calendar dialog, which |
376 | allows you to select the week you are viewing. Selecting a day from the calendar | 406 | allows you to select the week you are viewing. Selecting a day from the calendar |
407 | |||
408 | |||
377 | will bring you to the week that day is in. To the right of that is a button with | 409 | will bring you to the week that day is in. To the right of that is a button with |
378 | a ``2'' in it. When this is depressed, the main view will show two weeks at a | 410 | a "2" in it. When this is depressed, the main view will show two weeks at a |
379 | time, instead of one. The last item is a label which shows the range of dates | 411 | time, instead of one. The last item is a label which shows the range of dates |
380 | for the currently selected week. | 412 | for the currently selected week. |
381 | </para> | 413 | </para> |
382 | <para> | 414 | <para> |
383 | The main view is comprised of several rows, each of which represents a day of | 415 | The main view is comprised of several rows, each of which represents a day of |
384 | the week. If you have an appointment on that day, the date will be red, | 416 | the week. If you have an appointment on that day, the date will be red, |
385 | otherwise it will be black (the current day is blue). Clicking on the date | 417 | otherwise it will be black (the current day is blue). Clicking on the date |
386 | itself will bring you to the day view for that day. Under each day is a list of | 418 | itself will bring you to the day view for that day. Under each day is a list of |
387 | all the appointments for that day, as well as their start times. If you click on | 419 | all the appointments for that day, as well as their start times. If you click on |
420 | |||
421 | |||
388 | an appointment, you will go to an edit dialog for that appointment, which lets | 422 | an appointment, you will go to an edit dialog for that appointment, which lets |
389 | you view its details. Next to each day heading is a ``+'' sign, clicking it will | 423 | you view its details. Next to each day heading is a "+" sign, clicking it will |
424 | |||
425 | |||
390 | create a new appointment for that day. | 426 | create a new appointment for that day. |
391 | </para> | 427 | </para> |
392 | </section> | 428 | </section> |
393 | 429 | ||
394 | <section><title>The Month View</title> | 430 | <section><title>The Month View</title> |
395 | <para> | 431 | <para> |
396 | The month view looks like a normal monthly calendar, allowing you to see on what | 432 | The month view looks like a normal monthly calendar, allowing you to see on what |
433 | |||
434 | |||
397 | days of the month you have appointments. In the navigation bar, there are two | 435 | days of the month you have appointments. In the navigation bar, there are two |
398 | pairs of arrows. The pair with an arrow and a vertical line will take you to the | 436 | pairs of arrows. The pair with an arrow and a vertical line will take you to the |
437 | |||
438 | |||
399 | first or last month of the currently selected year, while the normal arrow | 439 | first or last month of the currently selected year, while the normal arrow |
400 | buttons will take you to the next or previous month. There is a dropdown menu | 440 | buttons will take you to the next or previous month. There is a dropdown menu |
401 | which allows you to select the month, and a entry field which allows you to | 441 | which allows you to select the month, and a entry field which allows you to |
402 | select the year (press the up or down arrows, or enter in your own year). | 442 | select the year (press the up or down arrows, or enter in your own year). |
403 | </para> | 443 | </para> |
404 | <para> | 444 | <para> |
405 | The main view is divided up into a grid, where the columns are the days of the | 445 | The main view is divided up into a grid, where the columns are the days of the |
406 | week, and the rows are the weeks (just like an ordinary calendar). The currently | 446 | week, and the rows are the weeks (just like an ordinary calendar). The currently |
447 | |||
448 | |||
407 | selected day has a bold box drawn around it, and if the day has an appointment, | 449 | selected day has a bold box drawn around it, and if the day has an appointment, |
408 | there will be a small blue square in the bottom right corner of it (that square | 450 | there will be a small blue square in the bottom right corner of it (that square |
409 | will have a smaller white square if it is a recurring appointment). If the | 451 | will have a smaller white square if it is a recurring appointment). If the |
410 | appointment is an all day event, it will be drawn as a green dot instead. When | 452 | appointment is an all day event, it will be drawn as a green dot instead. When |
411 | you click on the sqaure of a day, you will be taken to the day view for that | 453 | you click on the sqaure of a day, you will be taken to the day view for that |
412 | day. | 454 | day. |
413 | </para> | 455 | </para> |
414 | </section> | 456 | </section> |
415 | </section> | 457 | </section> |
416 | 458 | ||
417 | <section><title>Adding Appointments</title> | 459 | <section><title>Adding Appointments</title> |
418 | <para> | 460 | <para> |
419 | To add an appointment, click on the add appointment button in the toolbar at the | 461 | To add an appointment, click on the add appointment button in the toolbar at the |
462 | |||
463 | |||
420 | top of the window (an image of a blank page), and a dialog will open up, | 464 | top of the window (an image of a blank page), and a dialog will open up, |
421 | allowing you to enter information about the appointment (depending on the | 465 | allowing you to enter information about the appointment (depending on the |
422 | current view, and what you may have selected, there may be certain default | 466 | current view, and what you may have selected, there may be certain default |
423 | settings). | 467 | settings). |
424 | </para> | 468 | </para> |
425 | <para> | 469 | <para> |
426 | At the top of the window is the description field, where you can enter in a | 470 | At the top of the window is the description field, where you can enter in a |
427 | short description of the appointment, or select a common one from the dropdown | 471 | short description of the appointment, or select a common one from the dropdown |
428 | list. The location field allows you to do the same. The category dropdown allows | 472 | list. The location field allows you to do the same. The category dropdown allows |
473 | |||
474 | |||
429 | you to assign the appointment to a category, which you can use later to view | 475 | you to assign the appointment to a category, which you can use later to view |
430 | only some of your appointments. The button labeled ``...'' to the right of that | 476 | only some of your appointments. The button labeled "..." to the right of that |
431 | will open up a dialog where you can add, delete, or edit certain categories. | 477 | will open up a dialog where you can add, delete, or edit certain categories. |
432 | </para> | 478 | </para> |
433 | <para> | 479 | <para> |
434 | To enter a start and end time, select the date for each from the dropdown menu, | 480 | To enter a start and end time, select the date for each from the dropdown menu, |
435 | and then you can either manually enter a time, or you can use the three rows of | 481 | and then you can either manually enter a time, or you can use the three rows of |
436 | numbers to more quickly enter it in. To use the fast input method, first click | 482 | numbers to more quickly enter it in. To use the fast input method, first click |
437 | in the text entry field of the time you want to edit, then you need to select | 483 | in the text entry field of the time you want to edit, then you need to select |
438 | the hour. The first two rows are the hours, click whichever one you want. The | 484 | the hour. The first two rows are the hours, click whichever one you want. The |
439 | third row of numbers are the minutes, in units of five. When you select the | 485 | third row of numbers are the minutes, in units of five. When you select the |
440 | minutes field for the start time, it will automatically set the minutes field | 486 | minutes field for the start time, it will automatically set the minutes field |
441 | for the end time to the same thing, but you can change this by selecting the end | 487 | for the end time to the same thing, but you can change this by selecting the end |
488 | |||
489 | |||
442 | field and giving it its own minutes field. Because of this, it is fastest to set | 490 | field and giving it its own minutes field. Because of this, it is fastest to set |
443 | the start time first and then the end time. There is also an ``all day'' | 491 | the start time first and then the end time. There is also an "all day" |
444 | checkbox, which will make the appointment take up the entire day. | 492 | checkbox, which will make the appointment take up the entire day. |
445 | </para> | 493 | </para> |
446 | <para> | 494 | <para> |
447 | Underneath this you can set the timezone of the appointment from the dropdown | 495 | Underneath this you can set the timezone of the appointment from the dropdown |
448 | list. To change the available timezones, click the world icon, and it will open | 496 | list. To change the available timezones, click the world icon, and it will open |
449 | the City Time application. Refer to its documentation for changing the | 497 | the City Time application. Refer to its documentation for changing the |
450 | timezones. If you want to have an alarm go off, check the ``alarm'' checkbox, | 498 | timezones. If you want to have an alarm go off, check the "alarm" checkbox, |
451 | and then set the number of minutes before the appointment that you want the | 499 | and then set the number of minutes before the appointment that you want the |
452 | alarm to sound. If you set the dropdown list next to that to ``silent'' you will | 500 | alarm to sound. If you set the dropdown list next to that to "silent" you will |
453 | only be given a visual alarm, wheras if you set the alarm to ``Loud'', there | 501 | |
502 | |||
503 | only be given a visual alarm, wheras if you set the alarm to "Loud", there | ||
454 | will be an alarm sound as well. Note: opie-alarm must be installed for alarms to | 504 | will be an alarm sound as well. Note: opie-alarm must be installed for alarms to |
505 | |||
506 | |||
455 | work. | 507 | work. |
456 | </para> | 508 | </para> |
457 | <para> | 509 | <para> |
458 | To set whether the appointment repeats, click the "Repeat" button and a new | 510 | To set whether the appointment repeats, click the "Repeat" button and a new |
459 | dialog will open up. At the top is a row of buttons, which lets you set how | 511 | dialog will open up. At the top is a row of buttons, which lets you set how |
460 | often the appointment repeats. Selecting one of these buttons will change the | 512 | often the appointment repeats. Selecting one of these buttons will change the |
461 | interface below, to represent the available options for that type of repetition | 513 | interface below, to represent the available options for that type of repetition |
462 | (selecting ``None'' will turn off repetition if you turned it on and no longer | 514 | (selecting "None" will turn off repetition if you turned it on and no longer |
463 | want it). When you are done, click ``ok'' in the upper right to select that type | 515 | want it). When you are done, click "ok" in the upper right to select that type |
464 | of repetition, or ``x'' to set it back to what it was (none if it is a new | 516 | |
517 | |||
518 | of repetition, or "x" to set it back to what it was (none if it is a new | ||
465 | appointment). | 519 | appointment). |
466 | </para> | 520 | </para> |
467 | <para> | 521 | <para> |
468 | Finally, you can add notes to the appointment by clicking the ``Notes...'' | 522 | Finally, you can add notes to the appointment by clicking the "Notes..." |
469 | button which will open a dialog with a text entry field for adding notes. Press | 523 | button which will open a dialog with a text entry field for adding notes. Press |
470 | ``ok'' to accept the changes to the notes, ``x'' to cancel. | 524 | "ok" to accept the changes to the notes, "x" to cancel. |
471 | </para> | 525 | </para> |
472 | <para> | 526 | <para> |
473 | When you are done setting up the appointment, click ``ok'' in the top right of | 527 | When you are done setting up the appointment, click "ok" in the top right of |
474 | the window, or ``x'' to cancel adding the appointment. | 528 | the window, or "x" to cancel adding the appointment. |
475 | </para> | 529 | </para> |
476 | </section> | 530 | </section> |
477 | <section><title>Editing Appointments</title> | 531 | <section><title>Editing Appointments</title> |
478 | <para> | 532 | <para> |
479 | How you start editing an appointment varies depending on what view you are in, | 533 | How you start editing an appointment varies depending on what view you are in, |
480 | but they will all open the same dialog. The dialog is the same as the Add | 534 | but they will all open the same dialog. The dialog is the same as the Add |
481 | Appointment dialog, except that the fields will already be filled in with the | 535 | Appointment dialog, except that the fields will already be filled in with the |
482 | information that the appointment contains. Clicking ``ok'' will keep your | 536 | information that the appointment contains. Clicking "ok" will keep your |
483 | changes, ``x'' will revert them to what they were before you edited them. | 537 | changes, "x" will revert them to what they were before you edited them. |
484 | </para> | 538 | </para> |
485 | </section> | 539 | </section> |
486 | 540 | ||
487 | <section><title>Finding Appointments</title> | 541 | <section><title>Finding Appointments</title> |
488 | <para> | 542 | <para> |
489 | To find a specific appointment, click the find button in the toolbar (small | 543 | To find a specific appointment, click the find button in the toolbar (small |
490 | green magnifying glass) and it will open a find dialog. Here you can enter the | 544 | green magnifying glass) and it will open a find dialog. Here you can enter the |
491 | text you want to search for, as well as the category you want to search for, as | 545 | text you want to search for, as well as the category you want to search for, as |
492 | well as the start date, and whether you want the search to be case sensitive. | 546 | well as the start date, and whether you want the search to be case sensitive. |
493 | Click ``Find'' to find the next appointment that matches your criteria. | 547 | Click "Find" to find the next appointment that matches your criteria. |
494 | </para> | 548 | </para> |
495 | </section> | 549 | </section> |
496 | </chapter> | 550 | </chapter> |
497 | 551 | ||
498 | <chapter><title>Todo</title> | 552 | <chapter><title>Todo</title> |
499 | <para> | 553 | <para> |
500 | Todo is designed for storing information about things you need to do, but which | 554 | Todo is designed for storing information about things you need to do, but which |
501 | arent going to happen at a specific time, like "change the oil" or "mow the | 555 | arent going to happen at a specific time, like "change the oil" or "mow the |
502 | lawn". You can also give todo items a deadline, if they have to be completed by | 556 | lawn". You can also give todo items a deadline, if they have to be completed by |
503 | a certain time. | 557 | a certain time. |
504 | </para> | 558 | </para> |
505 | 559 | ||
506 | <section><title>Adding Tasks</title> | 560 | <section><title>Adding Tasks</title> |
507 | <para> | 561 | <para> |
508 | Go to Data \begin{math}\rightarrow\end{math}New Task, or click on the new task | 562 | Go to Data \begin{math}\rightarrow\end{math}New Task, or click on the new task |
509 | icon (blank page). The priority drop down menu lets you select the priority of | 563 | icon (blank page). The priority drop down menu lets you select the priority of |
510 | the task. The lower the number, the more important it is. The categories behave | 564 | the task. The lower the number, the more important it is. The categories behave |
511 | in much the same way that they do in Calendar, you can select the category from | 565 | in much the same way that they do in Calendar, you can select the category from |
512 | the drop down menu, or you can click the ``...'' button to add, delete, or edit | 566 | the drop down menu, or you can click the "..." button to add, delete, or edit |
513 | categories. To give the task a due date, check the ``Due'' checkbox, and then | 567 | categories. To give the task a due date, check the "Due" checkbox, and then |
514 | click the button next to it (it should contain the current date). That will open | 568 | click the button next to it (it should contain the current date). That will open |
515 | a calendar from which you can select the due date. The ``Completed'' check box | 569 | a calendar from which you can select the due date. The "Completed" check box |
516 | is the same as the checkbox next to each item in the main view. The ``Summary'' | 570 | is the same as the checkbox next to each item in the main view. The "Summary" |
517 | field is for a short summary that will be visible in the main view, as well as | 571 | field is for a short summary that will be visible in the main view, as well as |
518 | in the Today application. The down arrow next to it will copy the text in the | 572 | in the Today application. The down arrow next to it will copy the text in the |
519 | ``Summary'' field into the large text field below it, which is used for a more | 573 | "Summary" field into the large text field below it, which is used for a more |
520 | detailed description of the task. Click ``ok'' in the upper right to add the | 574 | detailed description of the task. Click "ok" in the upper right to add the |
521 | new task, or ``x'' to close the window without adding the new task. | 575 | new task, or "x" to close the window without adding the new task. |
522 | </para> | 576 | </para> |
523 | </section> | 577 | </section> |
524 | <section><title>Editing Tasks</title> | 578 | <section><title>Editing Tasks</title> |
525 | <para> | 579 | <para> |
526 | To edit a task, you can select it, and then go to | 580 | To edit a task, you can select it, and then go to |
527 | <GUIMenu>Data</GUIMenu><GUIMenuItem>Edit | 581 | <GUIMenu>Data</GUIMenu><GUIMenuItem>Edit |
528 | Task</GUIMenuItem>, or click the edit task icon (an image of a pencil). The same | 582 | Task</GUIMenuItem>, or click the edit task icon (an image of a pencil). The same |
529 | dialog should apear as if you were adding a task, but the information for that | 583 | dialog should apear as if you were adding a task, but the information for that |
530 | task should already be filled in. You can change any of it you want to, and then | 584 | task should already be filled in. You can change any of it you want to, and then |
531 | click ``ok'' in the top right corner to save the changes, or ``x'' to go back to | 585 | click "ok" in the top right corner to save the changes, or "x" to go back to |
532 | the way it was. | 586 | the way it was. |
533 | </para> | 587 | </para> |
534 | </section> | 588 | </section> |
535 | 589 | ||
536 | <section><title>Deleting Tasks</title> | 590 | <section><title>Deleting Tasks</title> |
537 | <para> | 591 | <para> |
538 | To delete a task, first select it, and then either select | 592 | To delete a task, first select it, and then either select |
539 | <GUIMenu>Data</GUIMenu> | 593 | <GUIMenu>Data</GUIMenu> |
540 | <GUIMenuItem>Delete...</GUIMenuItem> or press the Delete icon (an image of | 594 | <GUIMenuItem>Delete...</GUIMenuItem> or press the Delete icon (an image of |
541 | a trash can). A dialog should pop up, asking if you want to delete the task, | 595 | a trash can). A dialog should pop up, asking if you want to delete the task, |
542 | click yes to delete it, or no to cancel. | 596 | click yes to delete it, or no to cancel. |
543 | </para> | 597 | </para> |
544 | </section> | 598 | </section> |
545 | <section><title>Finding Tasks</title> | 599 | <section><title>Finding Tasks</title> |
546 | <para> | 600 | <para> |
547 | To find a task, either go to | 601 | To find a task, either go to |
548 | <GUIMenu>Options</GUIMenu><GUIMenuItem>Find</GUIMenuItem> | 602 | <GUIMenu>Options</GUIMenu><GUIMenuItem>Find</GUIMenuItem> |
549 | , or | 603 | , or |
550 | click the find icon (an image of a green magnifying glass), and a dialog should | 604 | click the find icon (an image of a green magnifying glass), and a dialog should |
551 | pop up. Enter the text you want to search for in the description, and select the | 605 | pop up. Enter the text you want to search for in the description, and select the |
552 | category that you want it to search through (this will speed the search up, if | 606 | category that you want it to search through (this will speed the search up, if |
553 | you know what category it is in). You can also select ``case sensative'' which | 607 | you know what category it is in). You can also select "case sensative" which |
554 | makes the search pay attention to the case of what you type (so if you look for | 608 | makes the search pay attention to the case of what you type (so if you look for |
555 | ``mow lawn'', it won't find a task called ``Mow lawn''). ``Search Backwards'' | 609 | "mow lawn", it won't find a task called "Mow lawn"). "Search Backwards" |
556 | will search backwards from the currently selected task. Click ``Find'' to | 610 | will search backwards from the currently selected task. Click "Find" to |
557 | initiate the search, when it finds a task that matches the string, it will | 611 | initiate the search, when it finds a task that matches the string, it will |
558 | select it. If you click Find again, it will find the next one in the list (or | 612 | select it. If you click Find again, it will find the next one in the list (or |
559 | the previous one, if ``Search backwards'' is selected). | 613 | the previous one, if "Search backwards" is selected). |
560 | </para> | 614 | </para> |
561 | </section> | 615 | </section> |
562 | 616 | ||
563 | <section><title>Viewing Tasks</title> | 617 | <section><title>Viewing Tasks</title> |
564 | <para> | 618 | <para> |
565 | To only view tasks filled under certain categories, go to the Category menu, and | 619 | To only view tasks filled under certain categories, go to the Category menu, and |
566 | check the categories you want to view. Also, under the Options menu, you can | 620 | check the categories you want to view. Also, under the Options menu, you can |
567 | select whether or not you want completed tasks to be visible, and whether or not | 621 | select whether or not you want completed tasks to be visible, and whether or not |
568 | you want to see the deadline. | 622 | you want to see the deadline. |
569 | </para> | 623 | </para> |
570 | </section> | 624 | </section> |
571 | 625 | ||
572 | <section><title>Completing Tasks</title> | 626 | <section><title>Completing Tasks</title> |
573 | <para> | 627 | <para> |
574 | To mark a task as completed without deleting it, you can either check the | 628 | To mark a task as completed without deleting it, you can either check the |
575 | checkbox next to it in the main view, or edit it, and check the "completed" | 629 | checkbox next to it in the main view, or edit it, and check the "completed" |
576 | check box in the edit dialog. If <GUIMenu>Options</GUIMenu> | 630 | check box in the edit dialog. If <GUIMenu>Options</GUIMenu> |
577 | <GUIMenuItem>Completed<GUIMenuItem> tasks is not checked, the task will | 631 | <GUIMenuItem>Completed<GUIMenuItem> tasks is not checked, the task will |
578 | disapear when you mark it completed. but do not worry, it is not gone forever, | 632 | disapear when you mark it completed. but do not worry, it is not gone forever, |
579 | just check Completed tasks in the options menu, and you can see and edit it | 633 | just check Completed tasks in the options menu, and you can see and edit it |
580 | again. | 634 | again. |
581 | </para> | 635 | </para> |
582 | </section> | 636 | </section> |
583 | </chapter> | 637 | </chapter> |
584 | 638 | ||
585 | <chapter><title>File Manager</title> | 639 | <chapter><title>File Manager</title> |
586 | <para> | 640 | <para> |
587 | The file manager allows easy access to your file system, letting you browse, | 641 | The file manager allows easy access to your file system, letting you browse, |
588 | copy, move, delete and link files. You can also use it to open the file in an | 642 | copy, move, delete and link files. You can also use it to open the file in an |
589 | application based upon the file type, or add the file to your ``Documents'' tab, | 643 | application based upon the file type, or add the file to your "Documents" tab, |
590 | as well as several other filesystem related things. | 644 | as well as several other filesystem related things. |
591 | <para> | 645 | <para> |
592 | 646 | ||
593 | <section><title>Navigating</title> | 647 | <section><title>Navigating</title> |
594 | <para> | 648 | <para> |
595 | To enter a directory, simply press its icon or name in the main view. There are | 649 | To enter a directory, simply press its icon or name in the main view. There are |
596 | also two buttons in the toolbar which help with navigation. The back arrow will | 650 | also two buttons in the toolbar which help with navigation. The back arrow will |
597 | take you back to the directory you were previously looking at, while the up | 651 | take you back to the directory you were previously looking at, while the up |
598 | arrow will take you up one level in the directory structure (so, if you are in | 652 | arrow will take you up one level in the directory structure (so, if you are in |
599 | /usr/bin, it will take you to /usr, regardless of where you were before). The | 653 | /usr/bin, it will take you to /usr, regardless of where you were before). The |
600 | ``Dir'' menu shows the current path, with each directory as a menu item. So, if | 654 | "Dir" menu shows the current path, with each directory as a menu item. So, if |
601 | you are in /opt/QtPalmtop/bin there will be four entries: /, opt, QtPalmtop, and | 655 | you are in /opt/QtPalmtop/bin there will be four entries: /, opt, QtPalmtop, and |
602 | bin. Selecting one of these will take you immediately to that directory. | 656 | bin. Selecting one of these will take you immediately to that directory. |
603 | </para> | 657 | </para> |
604 | </section> | 658 | </section> |
605 | 659 | ||
606 | <section><title>Selecting Files</title> | 660 | <section><title>Selecting Files</title> |
607 | <para> | 661 | <para> |
608 | When you click on a file, its selection status is toggled. So the first time you | 662 | When you click on a file, its selection status is toggled. So the first time you |
609 | click on it, it will be selected, and the second time it will be deselected. To | 663 | click on it, it will be selected, and the second time it will be deselected. To |
610 | select multiple files, simply click on each one you want to select. | 664 | select multiple files, simply click on each one you want to select. |
611 | </para> | 665 | </para> |
612 | </section> | 666 | </section> |
613 | <section><title>Moving Files</title> | 667 | <section><title>Moving Files</title> |
614 | <para> | 668 | <para> |
615 | To copy a file from one directory to another, press and hold on the filename, | 669 | To copy a file from one directory to another, press and hold on the filename, |
616 | and select ``Copy'' from the menu that pops up. Then, change into the directory | 670 | and select "Copy" from the menu that pops up. Then, change into the directory |
617 | that you want to copy it into, and press the "paste" icon (an image of a | 671 | that you want to copy it into, and press the "paste" icon (an image of a |
618 | clipboard and a piece of paper). To move a file, do the same thing, except | 672 | clipboard and a piece of paper). To move a file, do the same thing, except |
619 | select ``Cut'' from the first menu, instead of ``Copy''. You can also move or | 673 | select "Cut" from the first menu, instead of "Copy". You can also move or |
620 | copy multiple files by selecting all of them and using the cut or copy buttons | 674 | copy multiple files by selecting all of them and using the cut or copy buttons |
621 | in the toolbar. | 675 | in the toolbar. |
622 | </para> | 676 | </para> |
623 | </section> | 677 | </section> |
624 | 678 | ||
625 | <section><title>Deleting Files</title> | 679 | <section><title>Deleting Files</title> |
626 | <para> | 680 | <para> |
627 | To delete a file, press and hold it to bring up its menu, then select | 681 | To delete a file, press and hold it to bring up its menu, then select |
628 | ``Delete'', and click ``Yes'' (or ``No'' to cancel). Delete will delete all the | 682 | "Delete", and click "Yes" (or "No" to cancel). Delete will delete all the |
629 | currently selected files, which may be more than the one that you pressed and | 683 | currently selected files, which may be more than the one that you pressed and |
630 | held on. | 684 | held on. |
631 | </para> | 685 | </para> |
632 | </section> | 686 | </section> |
633 | 687 | ||
634 | <section><title>Renaming Files</title> | 688 | <section><title>Renaming Files</title> |
635 | <para> | 689 | <para> |
636 | To change a file's name, first bring up the input method you want to use (unless | 690 | To change a file's name, first bring up the input method you want to use (unless |
637 | you are going to use the hardware keyboard), then press and hold on the | 691 | you are going to use the hardware keyboard), then press and hold on the |
638 | filename, and select ``rename''. A new file will appear with a ``Name'' field | 692 | filename, and select "rename". A new file will appear with a "Name" field |
639 | that is editable, enter the new name, and click another file to keep the new | 693 | that is editable, enter the new name, and click another file to keep the new |
640 | name. | 694 | name. |
641 | </para> | 695 | </para> |
642 | </section> | 696 | </section> |
643 | 697 | ||
644 | <section><title>Creating Directories</title> | 698 | <section><title>Creating Directories</title> |
645 | <para> | 699 | <para> |
646 | To create a directory, first bring up the input method you want to use (if you | 700 | To create a directory, first bring up the input method you want to use (if you |
647 | are using one), and then click the new directory button (an image of a file | 701 | are using one), and then click the new directory button (an image of a file |
648 | folder with a ``+'' sign). A new folder will be created with the name ``New | 702 | folder with a "+" sign). A new folder will be created with the name "New |
649 | Folder'', and the folder name will be editable. Enter the name you want and then | 703 | Folder", and the folder name will be editable. Enter the name you want and then |
650 | click another file to create the folder. | 704 | click another file to create the folder. |
651 | </para> | 705 | </para> |
652 | </section> | 706 | </section> |
653 | 707 | ||
654 | <section><title>Viewing Files</title> | 708 | <section><title>Viewing Files</title> |
655 | <para> | 709 | <para> |
656 | To view a file, press and hold on a file, and the menu that comes up will | 710 | To view a file, press and hold on a file, and the menu that comes up will |
657 | contain two entries for vieing the file, the first depends on the filetype, but | 711 | contain two entries for vieing the file, the first depends on the filetype, but |
658 | usually lets you open the file in a specific program. The second is ``view as | 712 | usually lets you open the file in a specific program. The second is "view as |
659 | text'' which will open the file up in TextEdit (regardless of whether or not it | 713 | text" which will open the file up in TextEdit (regardless of whether or not it |
660 | is actually a text file). | 714 | is actually a text file). |
661 | </para> | 715 | </para> |
662 | </section> | 716 | </section> |
663 | 717 | ||
664 | <section><title>Adding to ``Documents''</title> | 718 | <section><title>Adding to "Documents"</title> |
665 | <para> | 719 | <para> |
666 | To add a file to your ``Documents'', press and hold the file, and select ``Add | 720 | To add a file to your "Documents", press and hold the file, and select "Add |
667 | to documents'' from the menu. This will add the file to the documents tab, which | 721 | to documents" from the menu. This will add the file to the documents tab, which |
668 | you can use to quickly open the file (simply click on the icon for the file in | 722 | you can use to quickly open the file (simply click on the icon for the file in |
669 | the Documents tab). Some programs also use the Documents list to aid in quickly | 723 | the Documents tab). Some programs also use the Documents list to aid in quickly |
670 | opening files. | 724 | opening files. |
671 | </para> | 725 | </para> |
672 | </section> | 726 | </section> |
673 | 727 | ||
674 | <section><title>Sorting Files</title> | 728 | <section><title>Sorting Files</title> |
675 | <para> | 729 | <para> |
676 | To sort the files, use the ``Sort'' menu to select wich field you want to sort | 730 | To sort the files, use the "Sort" menu to select wich field you want to sort |
677 | the files by (``by Name'', for instance, will sort the file alphabetically by | 731 | the files by ("by Name", for instance, will sort the file alphabetically by |
678 | name). If ``Ascending'' is checked, the files will be sorted in ascending order, | 732 | name). If "Ascending" is checked, the files will be sorted in ascending order, |
679 | if it is not, they will be sorted in descending order. You can also press the | 733 | if it is not, they will be sorted in descending order. You can also press the |
680 | name of the column in the main view to sort by that field. | 734 | name of the column in the main view to sort by that field. |
681 | </para> | 735 | </para> |
682 | </section> | 736 | </section> |
683 | 737 | ||
684 | <section><title>Viewing Options</title> | 738 | <section><title>Viewing Options</title> |
685 | <para> | 739 | <para> |
686 | The ``View'' menu lets you choose which files to view. If ``Hidden'' is checked, | 740 | The "View" menu lets you choose which files to view. If "Hidden" is checked, |
687 | hidden files will be visible (in Linux, hidden files start with a ``.''). If | 741 | hidden files will be visible (in Linux, hidden files start with a "."). If |
688 | ``Symlinks'' is checked, symbolic links (files or directories which are merely | 742 | "Symlinks" is checked, symbolic links (files or directories which are merely |
689 | links to other files or directories) will be visible. | 743 | links to other files or directories) will be visible. |
690 | </para> | 744 | </para> |
691 | </section> | 745 | </section> |
692 | </chapter> | 746 | </chapter> |
693 | 747 | ||
694 | <chapter><title>Embedded Konsole</title> | 748 | <chapter><title>Embedded Konsole</title> |
695 | <para> | 749 | <para> |
696 | EmbeddedKonsole is Opie's terminal emulator. From here you can do pretty much | 750 | EmbeddedKonsole is Opie's terminal emulator. From here you can do pretty much |
697 | anything (since Linux is actually a command line based OS by itself). I will | 751 | anything (since Linux is actually a command line based OS by itself). I will |
698 | not go into much detail on using the linux command line, as that is covered in | 752 | not go into much detail on using the linux command line, as that is covered in |
699 | many other places (http://www.tldp.org is a good place to start, or read | 753 | many other places (http://www.tldp.org is a good place to start, or read |
700 | O'Reilly's \underline{Running Linux} for a comprehensive look at Linux for the | 754 | O'Reilly's \underline{Running Linux} for a comprehensive look at Linux for the |
701 | beginner). I will, however, give a quick overview of using a Linux shell. | 755 | beginner). I will, however, give a quick overview of using a Linux shell. |
702 | </para> | 756 | </para> |
703 | 757 | ||
704 | <section><title>Using Embedded Konsole</title> | 758 | <section><title>Using Embedded Konsole</title> |
705 | <para> | 759 | <para> |
706 | Along the top of the window is a row of menus and icons. The ``Font'' menu lets | 760 | Along the top of the window is a row of menus and icons. The "Font" menu lets |
707 | you select the font size that you want the console to use, while the Options | 761 | you select the font size that you want the console to use, while the Options |
708 | menu lets you select various options. Below this row of menus and icons is a | 762 | menu lets you select various options. Below this row of menus and icons is a |
709 | pulldown list with various common commands in it. | 763 | pulldown list with various common commands in it. |
710 | </para> | 764 | </para> |
711 | 765 | ||
712 | <section><title>Options Menu</title> | 766 | <section><title>Options Menu</title> |
713 | <para> | 767 | <para> |
714 | The first submenu in the options menu is the ``Command List'' menu, which lets | 768 | The first submenu in the options menu is the "Command List" menu, which lets |
715 | you edit or hide the command list pulldown. The ``Tabs on top'' or ``Tabs on | 769 | you edit or hide the command list pulldown. The "Tabs on top" or "Tabs on |
716 | bottom'' (depending on which is currently enabled) allows you to select where | 770 | bottom" (depending on which is currently enabled) allows you to select where |
717 | the tabs representing multiple terminal sessions are drawn. The ``Colors'' | 771 | the tabs representing multiple terminal sessions are drawn. The "Colors" |
718 | submenu lets you select from a color scheme, or make your own, and the ``Scroll | 772 | submenu lets you select from a color scheme, or make your own, and the "Scroll |
719 | Bar'' submenu lets you select where or if the scroll bar is drawn. | 773 | Bar" submenu lets you select where or if the scroll bar is drawn. |
720 | </para> | 774 | </para> |
721 | </section> | 775 | </section> |
722 | <section><title>Icons</title> | 776 | <section><title>Icons</title> |
723 | <para> | 777 | <para> |
724 | The row of icons to the right of the menus allows you to type common keystrokes | 778 | The row of icons to the right of the menus allows you to type common keystrokes |
725 | without having an input method visible, as well as some other things. | 779 | without having an input method visible, as well as some other things. |
726 | </para> | 780 | </para> |
727 | <para> | 781 | <para> |
728 | The icon all the way on the left will open a new terminal session in a new tab, | 782 | The icon all the way on the left will open a new terminal session in a new tab, |
729 | while the icon all the way on the right will paste text from the clipboard into | 783 | while the icon all the way on the right will paste text from the clipboard into |
730 | the terminal. | 784 | the terminal. |
731 | </para> | 785 | </para> |
732 | <para> | 786 | <para> |
733 | The other icons are the same as typing (from left to right) enter, space, tab | 787 | The other icons are the same as typing (from left to right) enter, space, tab |
734 | (for tab completion), up, and down (for the command history). | 788 | (for tab completion), up, and down (for the command history). |
735 | </para> | 789 | </para> |
736 | </section> | 790 | </section> |
737 | <section><title>Command List</title> | 791 | <section><title>Command List</title> |
738 | <para> | 792 | <para> |
739 | The command list is a pulldown menu with a list of commonly used commands. | 793 | The command list is a pulldown menu with a list of commonly used commands. |
740 | Selecting one will type the command into the terminal wherever the cursor is. | 794 | Selecting one will type the command into the terminal wherever the cursor is. |
741 | You can edit or hide this menu from <GUIMenu>Options</GUIMenu> | 795 | You can edit or hide this menu from <GUIMenu>Options</GUIMenu> |
742 | <GUIMenuItem>Command List.</GUIMenuItem> | 796 | <GUIMenuItem>Command List.</GUIMenuItem> |
743 | </para> | 797 | </para> |
744 | </section> | 798 | </section> |
745 | </section> | 799 | </section> |
746 | 800 | ||
747 | <section><title>What is a Shell</title> | 801 | <section><title>What is a Shell</title> |
748 | <para> | 802 | <para> |
749 | A shell is a program that accepts input from a user, and runs commands. Each | 803 | A shell is a program that accepts input from a user, and runs commands. Each |
750 | ``command'' in the shell is actually a separate program (unless you are using a | 804 | "command" in the shell is actually a separate program (unless you are using a |
751 | shell like BusyBox, which makes some of the more common commands part of its own | 805 | shell like BusyBox, which makes some of the more common commands part of its own |
752 | program in order to save space). Shells can actually be very powerful, and many | 806 | program in order to save space). Shells can actually be very powerful, and many |
753 | of them allow you to write something called ``shell scripts'' which are just a | 807 | of them allow you to write something called "shell scripts" which are just a |
754 | sequence of commands, sometimes with some flow control statements, saved to a | 808 | sequence of commands, sometimes with some flow control statements, saved to a |
755 | file and run each time the script is run. For the most part, the average user | 809 | file and run each time the script is run. For the most part, the average user |
756 | does not need to know about any of this, though. If you are running Opie on the | 810 | does not need to know about any of this, though. If you are running Opie on the |
757 | Familiar distribution, it is advisable to install the bash shell (ipkg install | 811 | Familiar distribution, it is advisable to install the bash shell (ipkg install |
758 | bash) because it offers things like tab completion, use of the backspace key, | 812 | bash) because it offers things like tab completion, use of the backspace key, |
759 | and a command history, as well as offering a more advanced scripting languauge | 813 | and a command history, as well as offering a more advanced scripting languauge |
760 | than most other shells. | 814 | than most other shells. |
761 | </para> | 815 | </para> |
762 | </section> | 816 | </section> |
763 | 817 | ||
764 | <section><title>Running Programs</title> | 818 | <section><title>Running Programs</title> |
765 | <para> | 819 | <para> |
766 | To run a program or a command (remember, a command is just another program), you | 820 | To run a program or a command (remember, a command is just another program), you |
767 | simply type the name of the program and hit ``Return'' (in Linux, program names | 821 | simply type the name of the program and hit "Return" (in Linux, program names |
768 | do not have a special suffix like they do in windows, in fact the ``.'' | 822 | do not have a special suffix like they do in windows, in fact the "." |
769 | character has no special meaning unless it is at the begining of a filename, in | 823 | character has no special meaning unless it is at the begining of a filename, in |
770 | which case it makes the file ``hidden''). When you type a program name and hit | 824 | which case it makes the file "hidden"). When you type a program name and hit |
771 | ``Return'' the shell looks in a special list of directories called your | 825 | "Return" the shell looks in a special list of directories called your |
772 | ``path'', and if it cannot find it in any of those directories, it stops looking | 826 | "path", and if it cannot find it in any of those directories, it stops looking |
773 | and tells you it could not find them. If you want to run a program that is not | 827 | and tells you it could not find them. If you want to run a program that is not |
774 | in your path, you must specify an absolute or relative path to that program. | 828 | in your path, you must specify an absolute or relative path to that program. |
775 | For instance, to run a program that is in the directory you are currently in, | 829 | For instance, to run a program that is in the directory you are currently in, |
776 | you would type <literal>./program</literal> (``./'' is a special directory that | 830 | you would type <literal>./program</literal> ("./" is a special directory that |
777 | is explained below), or to run a program in /home/username/ you would call | 831 | is explained below), or to run a program in /home/username/ you would call |
778 | <literal>/home/username/program</literal>. | 832 | <literal>/home/username/program</literal>. |
779 | </para> | 833 | </para> |
780 | <para> | 834 | <para> |
781 | Most programs take ``arguments'' when run from the command line. An argument is | 835 | Most programs take "arguments" when run from the command line. An argument is |
782 | a string that contains no spaces that changes how the program behaves (a text | 836 | a string that contains no spaces that changes how the program behaves (a text |
783 | editor, for instance, might take a single argument, which would be the name of | 837 | editor, for instance, might take a single argument, which would be the name of |
784 | the file you wish to edit). Usually, you can use the arguments ``-h'' or | 838 | the file you wish to edit). Usually, you can use the arguments "-h" or |
785 | ``--help'' to get a list of the common arguments that that program takes, along | 839 | "--help" to get a list of the common arguments that that program takes, along |
786 | with a short usage description, and a short description of what each argument | 840 | with a short usage description, and a short description of what each argument |
787 | does. | 841 | does. |
788 | </para> | 842 | </para> |
789 | </section> | 843 | </section> |
790 | 844 | ||
791 | <section><title>Basic Navigation</title> | 845 | <section><title>Basic Navigation</title> |
792 | <para> | 846 | <para> |
793 | The command that you will use most often in the shell is probably the ``cd'' | 847 | The command that you will use most often in the shell is probably the "cd" |
794 | command, which stands for ``change directory.'' With this command, you can move | 848 | command, which stands for "change directory." With this command, you can move |
795 | around in the file system, by issuing the command like this: <userinput>cd | 849 | around in the file system, by issuing the command like this: <userinput>cd |
796 | <replaceable>[new directory]</replaceable></userinput>, where <replaceable>[new | 850 | <replaceable>[new directory]</replaceable></userinput>, where <replaceable>[new |
797 | directory]</replaceable> is the directory you want to move to. | 851 | directory]</replaceable> is the directory you want to move to. |
798 | This directory name does not have to include the entire directory structure, but | 852 | This directory name does not have to include the entire directory structure, but |
799 | can be ``relative'' which means it assumes you are talking about directories | 853 | can be "relative" which means it assumes you are talking about directories |
800 | relative to the directory you are in. For example, if you are in a directory | 854 | relative to the directory you are in. For example, if you are in a directory |
801 | called /home/username and you want to move to the directory | 855 | called /home/username and you want to move to the directory |
802 | /home/username/other/dir you could simply type <userinput>cd | 856 | /home/username/other/dir you could simply type <userinput>cd |
803 | other/dir</userinput> and you would end up in /home/username/other/dir. You can | 857 | other/dir</userinput> and you would end up in /home/username/other/dir. You can |
804 | also specify a full, or "absolute" path, by specifying the entire path name | 858 | also specify a full, or "absolute" path, by specifying the entire path name |
805 | starting with / ( / is a special directory called the "root" directory, and does | 859 | starting with / ( / is a special directory called the "root" directory, and does |
806 | not have a "parent" directory, which means that it is not in any other | 860 | not have a "parent" directory, which means that it is not in any other |
807 | directory). There are also two special directories called ``./'' and ``../''. | 861 | directory). There are also two special directories called "./" and "../". |
808 | The ``./'' directory is the current directory you are in, and you will probably | 862 | The "./" directory is the current directory you are in, and you will probably |
809 | never use this in conjunction with the cd command (why would you want to move to | 863 | never use this in conjunction with the cd command (why would you want to move to |
810 | the directory you are already in?). The ``../'' directory represents the parent | 864 | the directory you are already in?). The "../" directory represents the parent |
811 | directory of the directory you are currently in, so if you are in | 865 | directory of the directory you are currently in, so if you are in |
812 | /home/username, ../ is the same as /home. You can string several ../'s | 866 | /home/username, ../ is the same as /home. You can string several ../'s |
813 | together, so if you are in /home/username/dir/ ../../ represents /home. There | 867 | together, so if you are in /home/username/dir/ ../../ represents /home. There |
814 | is one other special directory, called "~/" that points to your home | 868 | is one other special directory, called "~/" that points to your home |
815 | directory (usually /home/username or /root for the root user). | 869 | directory (usually /home/username or /root for the root user). |
816 | </para> | 870 | </para> |
817 | </section> | 871 | </section> |
818 | 872 | ||
819 | <section><title>Moving Files</title> | 873 | <section><title>Moving Files</title> |
820 | <para> | 874 | <para> |
821 | To move files around, you need to use the ``cp'' (copy) and ``mv'' (move) | 875 | To move files around, you need to use the "cp" (copy) and "mv" (move) |
822 | commands. Both of these are run the same way: \verb+command originalfile | 876 | commands. Both of these are run the same way: \verb+command originalfile |
823 | newfile+. The only difference is that cp creates a new file without touching | 877 | newfile+. The only difference is that cp creates a new file without touching |
824 | the old one, while mv deletes the original file. The two path names can be | 878 | the old one, while mv deletes the original file. The two path names can be |
825 | either absolute or relative. If you only specify a directory for the | 879 | either absolute or relative. If you only specify a directory for the |
826 | destination, and no filename, it will use the filename for the original file. | 880 | destination, and no filename, it will use the filename for the original file. |
827 | </para> | 881 | </para> |
828 | </section> | 882 | </section> |
829 | 883 | ||
830 | <section><title>Deleting Files</title> | 884 | <section><title>Deleting Files</title> |
831 | <para> | 885 | <para> |
832 | To delete a file, run the ``rm'' command, and to delete a directory, run the | 886 | To delete a file, run the "rm" command, and to delete a directory, run the |
833 | ``rmdir'' command, each of them take the file to be removed as their only | 887 | "rmdir" command, each of them take the file to be removed as their only |
834 | argument. The rmdir command requires the directory to be empty, so if you want | 888 | argument. The rmdir command requires the directory to be empty, so if you want |
835 | to delete a directory that is not empty, along with all its contents, run | 889 | to delete a directory that is not empty, along with all its contents, run |
836 | <userinput>rm -r dir</userinput>. | 890 | <userinput>rm -r dir</userinput>. |
837 | </para> | 891 | </para> |
838 | </section> | 892 | </section> |
839 | 893 | ||
840 | <section><title>Linking Files</title> | 894 | <section><title>Linking Files</title> |
841 | <para> | 895 | <para> |
842 | In Linux, you can have a special file called a ``symbolic link'' that acts just | 896 | In Linux, you can have a special file called a "symbolic link" that acts just |
843 | like a copy of another file, except it takes up less space. This is convinient | 897 | like a copy of another file, except it takes up less space. This is convinient |
844 | if two applications are looking for the same file in two separate places, | 898 | if two applications are looking for the same file in two separate places, |
845 | because the file can be in both places at once, without taking up any extra | 899 | because the file can be in both places at once, without taking up any extra |
846 | space, and any change to one is automatically applied to the other (really, | 900 | space, and any change to one is automatically applied to the other (really, |
847 | there is only one file, the link is just a file pointing to the original file). | 901 | there is only one file, the link is just a file pointing to the original file). |
848 | This is also useful for naming applications independant of their version number. | 902 | This is also useful for naming applications independant of their version number. |
849 | For instance, you could have a link called ``application'' that points to | 903 | For instance, you could have a link called "application" that points to |
850 | ``application1.0''. To create a link, use the following command: | 904 | "application1.0". To create a link, use the following command: |
851 | <userinput>ln -s originalfile link</userinput>. | 905 | <userinput>ln -s originalfile link</userinput>. |
852 | </para> | 906 | </para> |
853 | </section> | 907 | </section> |
854 | </chapter> | 908 | </chapter> |
855 | </part> | 909 | </part> |
856 | 910 | ||
857 | <part><title>Settings</title> | 911 | <part><title>Settings</title> |
858 | <chapter><title>Software</title> | 912 | <chapter><title>Software</title> |
859 | 913 | ||
860 | <para> | 914 | <para> |
861 | The ``Software'' application, also called oipkg, is what is used to install and | 915 | The "Software" application, also called oipkg, is what is used to install and |
862 | remove software. It is actually a frontend to the command line program ``ipkg'' | 916 | remove software. It is actually a frontend to the command line program "ipkg" |
863 | so most things you can do with oipkg you can also do with ipkg. Oipkg can | 917 | so most things you can do with oipkg you can also do with ipkg. Oipkg can |
864 | install things either remotely from a web server (called a ``feed'') or it can | 918 | install things either remotely from a web server (called a "feed") or it can |
865 | install an ipkg package file that resides on the local filesystem. | 919 | install an ipkg package file that resides on the local filesystem. |
866 | </para> | 920 | </para> |
867 | <important> | 921 | <important> |
868 | <para> | 922 | <para> |
869 | Note: There is a bug in oipkg that prevents it from installing packages | 923 | Note: There is a bug in oipkg that prevents it from installing packages |
870 | properly. There is, however, a workaround for it. Simply run oipkg from | 924 | properly. There is, however, a workaround for it. Simply run oipkg from |
871 | Embedded Konsole to avoid the bug. | 925 | Embedded Konsole to avoid the bug. |
872 | </para> | 926 | </para> |
873 | </important> | 927 | </important> |
874 | 928 | ||
875 | <section><title>Installing Software</title> | 929 | <section><title>Installing Software</title> |
876 | <para> | 930 | <para> |
877 | To install software, first select ``Opie'' from the ``Section'' pulldown menu, | 931 | To install software, first select "Opie" from the "Section" pulldown menu, |
878 | the press the ``+'' icon next to ``Feeds'' in the main view. This will show all | 932 | the press the "+" icon next to "Feeds" in the main view. This will show all |
879 | the available Opie packages (you can change which packages to view by selecting | 933 | the available Opie packages (you can change which packages to view by selecting |
880 | something else from the ``Section'' pulldown). Installed packages are marked | 934 | something else from the "Section" pulldown). Installed packages are marked |
881 | with a blue circle, while packages that are not installed are marked with a red | 935 | with a blue circle, while packages that are not installed are marked with a red |
882 | box. If you click on the icon for an uninstalled package, it will turn into an | 936 | box. If you click on the icon for an uninstalled package, it will turn into an |
883 | open box, with a blue circle coming out of it, indicating that you have marked | 937 | open box, with a blue circle coming out of it, indicating that you have marked |
884 | this package to be installed. Mark as many packages as you wish this way, and | 938 | this package to be installed. Mark as many packages as you wish this way, and |
885 | then press the ``Apply'' icon (same red box and blue dot icon) to install all | 939 | then press the "Apply" icon (same red box and blue dot icon) to install all |
886 | the marked packages. It will also remove any packages marked for removal (see | 940 | the marked packages. It will also remove any packages marked for removal (see |
887 | below). Clicking this will open a window showing all the packages marked to be | 941 | below). Clicking this will open a window showing all the packages marked to be |
888 | removed and installed, with some check boxes on the bottom, which represent | 942 | removed and installed, with some check boxes on the bottom, which represent |
889 | arguments to be sent to ipkg, which you can usually ignore. After verifying | 943 | arguments to be sent to ipkg, which you can usually ignore. After verifying |
890 | that all the packages to be installed are correct, press ``Ok'' in the upper | 944 | that all the packages to be installed are correct, press "Ok" in the upper |
891 | right corner (or press ``x'' to cancel and go back to the package selection | 945 | right corner (or press "x" to cancel and go back to the package selection |
892 | window). The packages should then install, and you should see their icons | 946 | window). The packages should then install, and you should see their icons |
893 | appear in the Launcher, if they are Opie applications. | 947 | appear in the Launcher, if they are Opie applications. |
894 | </para> | 948 | </para> |
895 | </section> | 949 | </section> |
896 | 950 | ||
897 | <section><title>Removing Software</title> | 951 | <section><title>Removing Software</title> |
898 | <para> | 952 | <para> |
899 | Removing software is the same as installing software, except you will press the | 953 | Removing software is the same as installing software, except you will press the |
900 | blue circle icon of an installed package, and it will have a red ``X'' over it. | 954 | blue circle icon of an installed package, and it will have a red "X" over it. |
901 | Then press the apply icon, and ``Ok''. You can install and remove packages at | 955 | Then press the apply icon, and "Ok". You can install and remove packages at |
902 | the same time by marking the ones you want to install and the ones you want to | 956 | the same time by marking the ones you want to install and the ones you want to |
903 | remove, and then pressing apply. | 957 | remove, and then pressing apply. |
904 | </para> | 958 | </para> |
905 | </section> | 959 | </section> |
906 | </chapter> | 960 | </chapter> |
907 | </part> | 961 | </part> |
908 | </book> \ No newline at end of file | 962 | </book> |