-rw-r--r-- | docs/usermanual/usermanual.sgm | 194 |
1 files changed, 72 insertions, 122 deletions
diff --git a/docs/usermanual/usermanual.sgm b/docs/usermanual/usermanual.sgm index bfa09fb..0232cd3 100644 --- a/docs/usermanual/usermanual.sgm +++ b/docs/usermanual/usermanual.sgm | |||
@@ -1,14 +1,16 @@ | |||
1 | <!DOCTYPE book PUBLIC "-OASIS//DTD DocBook V4.2//EN"> | 1 | <!DOCTYPE book PUBLIC "-OASIS//DTD DocBook V4.2//EN" [ |
2 | <!ENTITY arrow "-->"> | ||
3 | ]> | ||
2 | <book><title>Opie User Manual</title> | 4 | <book><title>Opie User Manual</title> |
3 | <part><title>Getting Started</title> | 5 | <part><title>Getting Started</title> |
4 | <chapter><title>What is Opie?</title> | 6 | <chapter><title>What is Opie?</title> |
5 | <para> | 7 | <para> |
6 | Opie is a GUI (Graphical User Interface) for the Linux operating system (and | 8 | 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 | 9 | 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 | 10 | computers (such as the Compaq/HP iPAQ and the Sharp Zaurus), but could |
9 | probably function well in other environments requiring a light GUI, such as an | 11 | 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, | 12 | old laptop, or an internet kiosk. It is based upon QT/Embedded from Trolltech, |
11 | which is in turn a graphical environment designed for embedded applications, | 13 | which is in turn a graphical environment designed for embedded applications, |
12 | based upon the QT toolkit. | 14 | based upon the QT toolkit. |
13 | </para> | 15 | </para> |
14 | <para> | 16 | <para> |
@@ -29,11 +31,11 @@ not install X, as it is not necessary, and will only take up space). | |||
29 | </para> | 31 | </para> |
30 | 32 | ||
31 | <note> | 33 | <note> |
32 | <para> | 34 | <para> |
33 | Note: If you had qpe/qtopia installed previously, \emph{completely} remove it, | 35 | If you had qpe/qtopia installed previously, |
34 | and remove the src line for it from your /etc/ipkg.conf file before attempting | 36 | <emphasis>completely</emphasis> remove it, and remove the src line for it from |
35 | to install opie. | 37 | your /etc/ipkg.conf file before attempting to install opie. |
36 | </para> | 38 | </para> |
37 | </note> | 39 | </note> |
38 | <para> | 40 | <para> |
39 | Once you have Familiar installed, set up a network connection between your iPAQ | 41 | Once you have Familiar installed, set up a network connection between your iPAQ |
@@ -69,10 +71,8 @@ finally, start Opie with: | |||
69 | Opie should now be running (if you should have to reboot, which is rare, Opie | 71 | 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" | 72 | 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 | 73 | 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 | 74 | other Opie apps. Check out the various task-opie-* ipkgs to install various sets |
73 | |||
74 | |||
75 | 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 |
76 | 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 |
77 | the command line in Opie. | 77 | the command line in Opie. |
78 | </para> | 78 | </para> |
@@ -81,10 +81,8 @@ the command line in Opie. | |||
81 | <section><title>Zaurus</title> | 81 | <section><title>Zaurus</title> |
82 | <para> | 82 | <para> |
83 | 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, |
84 | 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 | |||
87 | default Zaurus rom. Do not install Opie's launcher on a default Zaurus ROM | 85 | default Zaurus rom. Do not install Opie's launcher on a default Zaurus ROM |
88 | though. | 86 | though. |
89 | </para> | 87 | </para> |
90 | </section> | 88 | </section> |
@@ -103,10 +101,8 @@ installed "applets". | |||
103 | <para> | 101 | <para> |
104 | Getting around in Opie is very easy, you simply click your stylus on whatever | 102 | Getting around in Opie is very easy, you simply click your stylus on whatever |
105 | icon or button you want to click on. The main difference between using the | 103 | icon or button you want to click on. The main difference between using the |
106 | stylus and using a mouse is that you cannot right click with a stylus, so things | 104 | stylus and using a mouse is that you cannot right click with a stylus, so things |
107 | |||
108 | |||
109 | that require a right click are kept to a minimum. However, it is sometimes | 105 | that require a right click are kept to a minimum. However, it is sometimes |
110 | necessary to right click, and this is implemented with a "press and hold". | 106 | necessary to right click, and this is implemented with a "press and hold". |
111 | Any time you want to do something that you think would require a right click on | 107 | Any time you want to do something that you think would require a right click on |
112 | a normal pc, try pressing the stylus down and holding it still for a few | 108 | a normal pc, try pressing the stylus down and holding it still for a few |
@@ -116,38 +112,30 @@ click usually does on a desktop interface. | |||
116 | </section> | 112 | </section> |
117 | 113 | ||
118 | <section><title>Launcher</title> | 114 | <section><title>Launcher</title> |
119 | <para> | 115 | <para> |
120 | The Launcher behaves like the "desktop" on most PC GUIs. When no applications | 116 | The Launcher behaves like the "desktop" on most PC GUIs. When no applications |
121 | |||
122 | |||
123 | are running or visible, you will have access to the Launcher. You can also map | 117 | are running or visible, you will have access to the Launcher. You can also map |
124 | a hardware key to bring the Launcher to the top without closing any of the | 118 | a hardware key to bring the Launcher to the top without closing any of the |
125 | running applications (this is similar to "minimising" all the applications | 119 | running applications (this is similar to "minimising" all the applications |
126 | that are running). | 120 | that are running). |
127 | </para> | 121 | </para> |
128 | <para> | 122 | <para> |
129 | Along the top of the Launcher you will see a list of tabs which function as | 123 | Along the top of the Launcher you will see a list of tabs which function as |
130 | categories for your applications. You can click on the tab for the category you | 124 | categories for your applications. You can click on the tab for the category you |
131 | |||
132 | |||
133 | want to view, and then click on the icon for the application that you wish to | 125 | want to view, and then click on the icon for the application that you wish to |
134 | launch. By default, there will be an Applications tab and a Settings tab (if | 126 | launch. By default, there will be an Applications tab and a Settings tab (if |
135 | you install any games, they will appear in the Games tab). When new | 127 | you install any games, they will appear in the Games tab). When new |
136 | applications are installed, they will usually appear in one of these three tabs, | 128 | applications are installed, they will usually appear in one of these three tabs, |
137 | |||
138 | |||
139 | or in a tab of their own. To add or delete tabs or to move applications between | 129 | or in a tab of their own. To add or delete tabs or to move applications between |
140 | the tabs, you can use the Tab Manager application, or you can edit them by hand, | 130 | the tabs, you can use the Tab Manager application, or you can edit them by hand, |
141 | by changing the directories in /opt/QtPalmtop/apps. | 131 | by changing the directories in /opt/QtPalmtop/apps. |
142 | </para> | 132 | </para> |
143 | <para> | 133 | <para> |
144 | There is also a tab to the far right called the "Documents" tab, which allows | 134 | There is also a tab to the far right called the "Documents" tab, which allows |
145 | you to quickly open your most often used documents. You can click on a document | 135 | you to quickly open your most often used documents. You can click on a document |
146 | |||
147 | |||
148 | to open it up in the proper application. For help on adding files to the | 136 | to open it up in the proper application. For help on adding files to the |
149 | Documents tab see \ref{docadd} on page \pageref{docadd} | 137 | Documents tab see the <xref linkend="adddoc">. |
150 | </para> | 138 | </para> |
151 | </section> | 139 | </section> |
152 | 140 | ||
153 | <section><title>Taskbar</title> | 141 | <section><title>Taskbar</title> |
@@ -185,10 +173,8 @@ In Opie, dialogs, as well as some applications, have a button labeled "Ok" on | |||
185 | the right side of the window title bar, in addition to the normal "x". For | 173 | the right side of the window title bar, in addition to the normal "x". For |
186 | dialogs, the "Ok" button will apply your changes and close the window, while | 174 | dialogs, the "Ok" button will apply your changes and close the window, while |
187 | the "x" will cancel them before closing the window (for people used to most | 175 | the "x" will cancel them before closing the window (for people used to most |
188 | desktop GUI's the "Ok" and "x" behave like the "Ok" and "Cancel" buttons | 176 | desktop GUI's the "Ok" and "x" behave like the "Ok" and "Cancel" buttons |
189 | |||
190 | |||
191 | you would normally see in the bottom right of the dialog window). | 177 | you would normally see in the bottom right of the dialog window). |
192 | </para> | 178 | </para> |
193 | <para> | 179 | <para> |
194 | For applications that have an "Ok" button as well as the "x" button that all | 180 | For applications that have an "Ok" button as well as the "x" button that all |
@@ -209,10 +195,8 @@ Normally, simply running | |||
209 | </literallayout> | 195 | </literallayout> |
210 | </informalexample> | 196 | </informalexample> |
211 | will upgrade Opie. However, if you currently have a version with the 1.5.0 | 197 | will upgrade Opie. However, if you currently have a version with the 1.5.0 |
212 | version number, you will have to upgrade it differently, because Opie now uses a | 198 | version number, you will have to upgrade it differently, because Opie now uses a |
213 | |||
214 | |||
215 | different version number (the 1.5.0 was Qtopia's version number, we now use our | 199 | different version number (the 1.5.0 was Qtopia's version number, we now use our |
216 | own). To upgrade from one of these older versions, run: | 200 | own). To upgrade from one of these older versions, run: |
217 | <informalexample> | 201 | <informalexample> |
218 | <literallayout> | 202 | <literallayout> |
@@ -234,10 +218,11 @@ work for, etc. | |||
234 | <para> | 218 | <para> |
235 | 219 | ||
236 | <section><title>Adding Contacts</title> | 220 | <section><title>Adding Contacts</title> |
237 | <para> | 221 | <para> |
238 | To Add a user, go to <GUImenu>Contact</GUImenu><GUIMenuItem>Add</GUIMenuItem>, | 222 | To Add a user, go to |
239 | or click the add icon in the toolbar (looks like a blank piece of paper). | 223 | <GUImenu>Contact</GUImenu>&arrow;<GUIMenuItem>Add</GUIMenuItem>, |
224 | or click the add icon in the toolbar (looks like a blank piece of paper). | ||
240 | First, you need to give the person a name. You can do this by either entering | 225 | First, you need to give the person a name. You can do this by either entering |
241 | their name in the name field, or by pressing "Full Name...", which will open | 226 | their name in the name field, or by pressing "Full Name...", which will open |
242 | up a new dialog that lets you enter each part of their name individually. Three | 227 | up a new dialog that lets you enter each part of their name individually. Three |
243 | of the entry fields have pulldown menus instead of labels that let you set which | 228 | of the entry fields have pulldown menus instead of labels that let you set which |
@@ -267,39 +252,37 @@ edit their profile later), click the "x" to cancel, and not add the contact. | |||
267 | </section> | 252 | </section> |
268 | <section><title>Editing Contacts</title> | 253 | <section><title>Editing Contacts</title> |
269 | <para> | 254 | <para> |
270 | To edit the contacts, select the person you want to edit, anc click the pencil | 255 | To edit the contacts, select the person you want to edit, anc click the pencil |
271 | icon, or go to <GUIMenu>Contact</GUIMenu><GUIMenuItem>Edit</GUIMenuItem>, and it | 256 | icon, or go to <GUIMenu>Contact</GUIMenu>&arrow;<GUIMenuItem>Edit</GUIMenuItem>, |
272 | will open up the same dialog used to add a user, except their information that | 257 | and it will open up the same dialog used to add a user, except their information |
273 | is already entered will already be filled in. To finalise the changes, click | 258 | that is already entered will already be filled in. To finalise the changes, |
274 | "Ok", or to cancel them, click "x". | 259 | click "Ok", or to cancel them, click "x". |
275 | </para> | 260 | </para> |
276 | </section> | 261 | </section> |
277 | 262 | ||
278 | <section><title>Deleting Contacts</title> | 263 | <section><title>Deleting Contacts</title> |
279 | <para> | 264 | <para> |
280 | To delete a contact, select the person from the list of contacts, and click the | 265 | To delete a contact, select the person from the list of contacts, and click the |
281 | trash can icon, or go to Contact \begin{math}\rightarrow\end{math}Delete. A | 266 | trash can icon, or go to <GUIMenu>Contact</GUIMenu> |
282 | dialog will pop up asking if you want to actually delete that contact, click yes | 267 | &arrow;<GUIMenuItem>Delete</GUIMenuItem>. A dialog will pop up asking if you |
283 | 268 | want to actually delete that contact, click yes to delete it, no will cancel. | |
284 | |||
285 | to delete it, no will cancel. | ||
286 | </para> | 269 | </para> |
287 | </section> | 270 | </section> |
288 | 271 | ||
289 | <section><title>Editing Contacts</title> | 272 | <section><title>Editing Contacts</title> |
290 | <para> | 273 | <para> |
291 | To find a specific person, click the find icon (green magnifying glass), or go | 274 | To find a specific person, click the find icon (green magnifying glass), or go |
292 | to <GUIMenu>Contact</GUIMenu><GUIMenuItem>Find</GUIMenuItem>. A dialog will pop | 275 | to <GUIMenu>Contact</GUIMenu>&arrow;<GUIMenuItem>Find</GUIMenuItem>. A dialog |
293 | up, and in the "Find what" input, enter the string you want to search for. You | 276 | will pop up, and in the "Find what" input, enter the string you want to search |
294 | can also select if you want the search to be case sensative, and if you want it | 277 | for. You can also select if you want the search to be case sensative, and if you |
295 | to search backwards from the currently selected user. The Category drop down | 278 | want it to search backwards from the currently selected user. The Category drop |
296 | menu lets you search only a specific category ("All" to search all of them). | 279 | down menu lets you search only a specific category ("All" to search all of |
297 | When you click "Find", it will start search for the string in all the fields | 280 | them). When you click "Find", it will start search for the string in all the |
298 | in all the contacts. When it finds a match, it will highlight the user in the | 281 | fields in all the contacts. When it finds a match, it will highlight the user in |
299 | main view. You can use this to search for (as an example) who a certain phone | 282 | the main view. You can use this to search for (as an example) who a certain |
300 | number belongs to, by entering the phone number in the "find what" field, and | 283 | phone number belongs to, by entering the phone number in the "find what" field, |
301 | clicking "Find". | 284 | and clicking "Find". |
302 | </para> | 285 | </para> |
303 | </section> | 286 | </section> |
304 | 287 | ||
305 | <section><title>Viewing Contacts</title> | 288 | <section><title>Viewing Contacts</title> |
@@ -346,10 +329,8 @@ same as Day, except that it automatically sets the view to the current day. | |||
346 | The day view shows your day divided up into blocks representing each hour. At | 329 | The day view shows your day divided up into blocks representing each hour. At |
347 | the top is the navigation bar, wher you will see a row of buttons, which | 330 | the top is the navigation bar, wher you will see a row of buttons, which |
348 | represent the days of the current week, and on the left and right sides of the | 331 | represent the days of the current week, and on the left and right sides of the |
349 | navigation bar are arrows, which allow you to move one day in that direction. If | 332 | navigation bar are arrows, which allow you to move one day in that direction. If |
350 | |||
351 | |||
352 | you are on the last day of the week, pressing the arrow will bring you into the | 333 | you are on the last day of the week, pressing the arrow will bring you into the |
353 | first day of the next week (or vice-versa if you are going backwards). There is | 334 | first day of the next week (or vice-versa if you are going backwards). There is |
354 | also a button that lists the current day, which you can press to select a day to | 335 | also a button that lists the current day, which you can press to select a day to |
355 | view from a calendar dialog. | 336 | view from a calendar dialog. |
@@ -357,10 +338,8 @@ view from a calendar dialog. | |||
357 | <para> | 338 | <para> |
358 | In the main view, there is a collumn of buttons, each of which represents one | 339 | In the main view, there is a collumn of buttons, each of which represents one |
359 | hour. If you select one, any new appointments will automatically default to | 340 | hour. If you select one, any new appointments will automatically default to |
360 | begining at that time and ending an hour later (which you can, of course, change | 341 | begining at that time and ending an hour later (which you can, of course, change |
361 | |||
362 | |||
363 | when you create the appointment). | 342 | when you create the appointment). |
364 | </para> | 343 | </para> |
365 | <para> | 344 | <para> |
366 | Clicking on an appointment will open a menu that lets you edit, delete or beam | 345 | Clicking on an appointment will open a menu that lets you edit, delete or beam |
@@ -374,10 +353,8 @@ installed to use this feature. | |||
374 | <para> | 353 | <para> |
375 | The week view allows you to see your week divided up into columns, representing | 354 | The week view allows you to see your week divided up into columns, representing |
376 | each day of the week, and rows, representing each hour of the day. In the | 355 | each day of the week, and rows, representing each hour of the day. In the |
377 | navigation bar at the top, there are two scroll boxes, the one on the left shows | 356 | navigation bar at the top, there are two scroll boxes, the one on the left shows |
378 | |||
379 | |||
380 | the current year, and the one to the right shows which week it is of that year. | 357 | the current year, and the one to the right shows which week it is of that year. |
381 | To the right of both of those is a label which shows the date range for the | 358 | To the right of both of those is a label which shows the date range for the |
382 | currently selected week. | 359 | currently selected week. |
383 | </para> | 360 | </para> |
@@ -385,11 +362,9 @@ currently selected week. | |||
385 | In the main view, you see the week divided up into rows and collumns | 362 | In the main view, you see the week divided up into rows and collumns |
386 | representing the days of the week, and hours of the day. In each cell, you will | 363 | representing the days of the week, and hours of the day. In each cell, you will |
387 | see a blue square which represents an appointment, which you can press to see | 364 | see a blue square which represents an appointment, which you can press to see |
388 | details of the appointment. If you press anywhere in the free space, you will go | 365 | details of the appointment. If you press anywhere in the free space, you will go |
389 | 366 | to the day of the column that you clicked in. | |
390 | |||
391 | to the day of the column that you clicked in. | ||
392 | </para> | 367 | </para> |
393 | </section> | 368 | </section> |
394 | 369 | ||
395 | <section><title>The Week List View</title> | 370 | <section><title>The Week List View</title> |
@@ -397,16 +372,12 @@ to the day of the column that you clicked in. | |||
397 | The week list view shows you all the appointments that you have that week | 372 | The week list view shows you all the appointments that you have that week |
398 | without graphically representing how long they are or showing the free time | 373 | without graphically representing how long they are or showing the free time |
399 | between them. This is convinient if you need to see a list of all your | 374 | between them. This is convinient if you need to see a list of all your |
400 | appointments, but do not need to see how your time is mapped out. The navigation | 375 | appointments, but do not need to see how your time is mapped out. The navigation |
401 | |||
402 | |||
403 | bar has an arrow button on either side, allowing you to move to the next or | 376 | bar has an arrow button on either side, allowing you to move to the next or |
404 | previous week, as well as a button which gives the current week number for that | 377 | previous week, as well as a button which gives the current week number for that |
405 | year. Pressing the week number button will bring up a calendar dialog, which | 378 | year. Pressing the week number button will bring up a calendar dialog, which |
406 | allows you to select the week you are viewing. Selecting a day from the calendar | 379 | allows you to select the week you are viewing. Selecting a day from the calendar |
407 | |||
408 | |||
409 | will bring you to the week that day is in. To the right of that is a button with | 380 | will bring you to the week that day is in. To the right of that is a button with |
410 | a "2" in it. When this is depressed, the main view will show two weeks at a | 381 | a "2" in it. When this is depressed, the main view will show two weeks at a |
411 | time, instead of one. The last item is a label which shows the range of dates | 382 | time, instead of one. The last item is a label which shows the range of dates |
412 | for the currently selected week. | 383 | for the currently selected week. |
@@ -416,37 +387,27 @@ The main view is comprised of several rows, each of which represents a day of | |||
416 | the week. If you have an appointment on that day, the date will be red, | 387 | the week. If you have an appointment on that day, the date will be red, |
417 | otherwise it will be black (the current day is blue). Clicking on the date | 388 | otherwise it will be black (the current day is blue). Clicking on the date |
418 | itself will bring you to the day view for that day. Under each day is a list of | 389 | itself will bring you to the day view for that day. Under each day is a list of |
419 | all the appointments for that day, as well as their start times. If you click on | 390 | all the appointments for that day, as well as their start times. If you click on |
420 | |||
421 | |||
422 | an appointment, you will go to an edit dialog for that appointment, which lets | 391 | an appointment, you will go to an edit dialog for that appointment, which lets |
423 | you view its details. Next to each day heading is a "+" sign, clicking it will | 392 | you view its details. Next to each day heading is a "+" sign, clicking it will |
424 | 393 | create a new appointment for that day. | |
425 | |||
426 | create a new appointment for that day. | ||
427 | </para> | 394 | </para> |
428 | </section> | 395 | </section> |
429 | 396 | ||
430 | <section><title>The Month View</title> | 397 | <section><title>The Month View</title> |
431 | <para> | 398 | <para> |
432 | The month view looks like a normal monthly calendar, allowing you to see on what | 399 | The month view looks like a normal monthly calendar, allowing you to see on what |
433 | |||
434 | |||
435 | days of the month you have appointments. In the navigation bar, there are two | 400 | days of the month you have appointments. In the navigation bar, there are two |
436 | pairs of arrows. The pair with an arrow and a vertical line will take you to the | 401 | pairs of arrows. The pair with an arrow and a vertical line will take you to the |
437 | |||
438 | |||
439 | first or last month of the currently selected year, while the normal arrow | 402 | first or last month of the currently selected year, while the normal arrow |
440 | buttons will take you to the next or previous month. There is a dropdown menu | 403 | buttons will take you to the next or previous month. There is a dropdown menu |
441 | which allows you to select the month, and a entry field which allows you to | 404 | which allows you to select the month, and a entry field which allows you to |
442 | select the year (press the up or down arrows, or enter in your own year). | 405 | select the year (press the up or down arrows, or enter in your own year). |
443 | </para> | 406 | </para> |
444 | <para> | 407 | <para> |
445 | The main view is divided up into a grid, where the columns are the days of the | 408 | The main view is divided up into a grid, where the columns are the days of the |
446 | week, and the rows are the weeks (just like an ordinary calendar). The currently | 409 | week, and the rows are the weeks (just like an ordinary calendar). The currently |
447 | |||
448 | |||
449 | selected day has a bold box drawn around it, and if the day has an appointment, | 410 | selected day has a bold box drawn around it, and if the day has an appointment, |
450 | there will be a small blue square in the bottom right corner of it (that square | 411 | there will be a small blue square in the bottom right corner of it (that square |
451 | will have a smaller white square if it is a recurring appointment). If the | 412 | will have a smaller white square if it is a recurring appointment). If the |
452 | appointment is an all day event, it will be drawn as a green dot instead. When | 413 | appointment is an all day event, it will be drawn as a green dot instead. When |
@@ -458,10 +419,8 @@ day. | |||
458 | 419 | ||
459 | <section><title>Adding Appointments</title> | 420 | <section><title>Adding Appointments</title> |
460 | <para> | 421 | <para> |
461 | To add an appointment, click on the add appointment button in the toolbar at the | 422 | To add an appointment, click on the add appointment button in the toolbar at the |
462 | |||
463 | |||
464 | top of the window (an image of a blank page), and a dialog will open up, | 423 | top of the window (an image of a blank page), and a dialog will open up, |
465 | allowing you to enter information about the appointment (depending on the | 424 | allowing you to enter information about the appointment (depending on the |
466 | current view, and what you may have selected, there may be certain default | 425 | current view, and what you may have selected, there may be certain default |
467 | settings). | 426 | settings). |
@@ -469,10 +428,8 @@ settings). | |||
469 | <para> | 428 | <para> |
470 | At the top of the window is the description field, where you can enter in a | 429 | At the top of the window is the description field, where you can enter in a |
471 | short description of the appointment, or select a common one from the dropdown | 430 | short description of the appointment, or select a common one from the dropdown |
472 | list. The location field allows you to do the same. The category dropdown allows | 431 | list. The location field allows you to do the same. The category dropdown allows |
473 | |||
474 | |||
475 | you to assign the appointment to a category, which you can use later to view | 432 | you to assign the appointment to a category, which you can use later to view |
476 | only some of your appointments. The button labeled "..." to the right of that | 433 | only some of your appointments. The button labeled "..." to the right of that |
477 | will open up a dialog where you can add, delete, or edit certain categories. | 434 | will open up a dialog where you can add, delete, or edit certain categories. |
478 | </para> | 435 | </para> |
@@ -484,10 +441,8 @@ in the text entry field of the time you want to edit, then you need to select | |||
484 | the hour. The first two rows are the hours, click whichever one you want. The | 441 | the hour. The first two rows are the hours, click whichever one you want. The |
485 | third row of numbers are the minutes, in units of five. When you select the | 442 | third row of numbers are the minutes, in units of five. When you select the |
486 | minutes field for the start time, it will automatically set the minutes field | 443 | minutes field for the start time, it will automatically set the minutes field |
487 | for the end time to the same thing, but you can change this by selecting the end | 444 | for the end time to the same thing, but you can change this by selecting the end |
488 | |||
489 | |||
490 | field and giving it its own minutes field. Because of this, it is fastest to set | 445 | field and giving it its own minutes field. Because of this, it is fastest to set |
491 | the start time first and then the end time. There is also an "all day" | 446 | the start time first and then the end time. There is also an "all day" |
492 | checkbox, which will make the appointment take up the entire day. | 447 | checkbox, which will make the appointment take up the entire day. |
493 | </para> | 448 | </para> |
@@ -497,14 +452,10 @@ list. To change the available timezones, click the world icon, and it will open | |||
497 | the City Time application. Refer to its documentation for changing the | 452 | the City Time application. Refer to its documentation for changing the |
498 | timezones. If you want to have an alarm go off, check the "alarm" checkbox, | 453 | timezones. If you want to have an alarm go off, check the "alarm" checkbox, |
499 | and then set the number of minutes before the appointment that you want the | 454 | and then set the number of minutes before the appointment that you want the |
500 | alarm to sound. If you set the dropdown list next to that to "silent" you will | 455 | alarm to sound. If you set the dropdown list next to that to "silent" you will |
501 | |||
502 | |||
503 | only be given a visual alarm, wheras if you set the alarm to "Loud", there | 456 | only be given a visual alarm, wheras if you set the alarm to "Loud", there |
504 | will be an alarm sound as well. Note: opie-alarm must be installed for alarms to | 457 | will be an alarm sound as well. Note: opie-alarm must be installed for alarms to |
505 | |||
506 | |||
507 | work. | 458 | work. |
508 | </para> | 459 | </para> |
509 | <para> | 460 | <para> |
510 | To set whether the appointment repeats, click the "Repeat" button and a new | 461 | To set whether the appointment repeats, click the "Repeat" button and a new |
@@ -512,10 +463,8 @@ dialog will open up. At the top is a row of buttons, which lets you set how | |||
512 | often the appointment repeats. Selecting one of these buttons will change the | 463 | often the appointment repeats. Selecting one of these buttons will change the |
513 | interface below, to represent the available options for that type of repetition | 464 | interface below, to represent the available options for that type of repetition |
514 | (selecting "None" will turn off repetition if you turned it on and no longer | 465 | (selecting "None" will turn off repetition if you turned it on and no longer |
515 | want it). When you are done, click "ok" in the upper right to select that type | 466 | want it). When you are done, click "ok" in the upper right to select that type |
516 | |||
517 | |||
518 | of repetition, or "x" to set it back to what it was (none if it is a new | 467 | of repetition, or "x" to set it back to what it was (none if it is a new |
519 | appointment). | 468 | appointment). |
520 | </para> | 469 | </para> |
521 | <para> | 470 | <para> |
@@ -558,28 +507,29 @@ a certain time. | |||
558 | </para> | 507 | </para> |
559 | 508 | ||
560 | <section><title>Adding Tasks</title> | 509 | <section><title>Adding Tasks</title> |
561 | <para> | 510 | <para> |
562 | Go to Data \begin{math}\rightarrow\end{math}New Task, or click on the new task | 511 | Go to <GUIMenu>Data</GUIMenu>&arrow;<GUIMenuItem>New Task<GUIMenuItem>, or click |
563 | icon (blank page). The priority drop down menu lets you select the priority of | 512 | on the new task icon (blank page). The priority drop down menu lets you select |
564 | the task. The lower the number, the more important it is. The categories behave | 513 | the priority of the task. The lower the number, the more important it is. The |
565 | in much the same way that they do in Calendar, you can select the category from | 514 | categories behave in much the same way that they do in Calendar, you can select |
566 | the drop down menu, or you can click the "..." button to add, delete, or edit | 515 | the category from the drop down menu, or you can click the "..." button to add, |
567 | categories. To give the task a due date, check the "Due" checkbox, and then | 516 | delete, or edit categories. To give the task a due date, check the "Due" |
568 | click the button next to it (it should contain the current date). That will open | 517 | checkbox, and then click the button next to it (it should contain the current |
569 | a calendar from which you can select the due date. The "Completed" check box | 518 | date). That will open a calendar from which you can select the due date. The |
570 | is the same as the checkbox next to each item in the main view. The "Summary" | 519 | "Completed" check box is the same as the checkbox next to each item in the main |
571 | field is for a short summary that will be visible in the main view, as well as | 520 | view. The "Summary" field is for a short summary that will be visible in the |
572 | in the Today application. The down arrow next to it will copy the text in the | 521 | main view, as well as in the Today application. The down arrow next to it will |
573 | "Summary" field into the large text field below it, which is used for a more | 522 | copy the text in the "Summary" field into the large text field below it, which |
574 | detailed description of the task. Click "ok" in the upper right to add the | 523 | is used for a more detailed description of the task. Click "ok" in the upper |
575 | new task, or "x" to close the window without adding the new task. | 524 | right to add the new task, or "x" to close the window without adding the new |
525 | task. | ||
576 | </para> | 526 | </para> |
577 | </section> | 527 | </section> |
578 | <section><title>Editing Tasks</title> | 528 | <section><title>Editing Tasks</title> |
579 | <para> | 529 | <para> |
580 | To edit a task, you can select it, and then go to | 530 | To edit a task, you can select it, and then go to |
581 | <GUIMenu>Data</GUIMenu><GUIMenuItem>Edit | 531 | <GUIMenu>Data</GUIMenu>&arrow;<GUIMenuItem>Edit |
582 | Task</GUIMenuItem>, or click the edit task icon (an image of a pencil). The same | 532 | Task</GUIMenuItem>, or click the edit task icon (an image of a pencil). The same |
583 | dialog should apear as if you were adding a task, but the information for that | 533 | dialog should apear as if you were adding a task, but the information for that |
584 | task should already be filled in. You can change any of it you want to, and then | 534 | task should already be filled in. You can change any of it you want to, and then |
585 | click "ok" in the top right corner to save the changes, or "x" to go back to | 535 | click "ok" in the top right corner to save the changes, or "x" to go back to |
@@ -589,28 +539,27 @@ the way it was. | |||
589 | 539 | ||
590 | <section><title>Deleting Tasks</title> | 540 | <section><title>Deleting Tasks</title> |
591 | <para> | 541 | <para> |
592 | To delete a task, first select it, and then either select | 542 | To delete a task, first select it, and then either select |
593 | <GUIMenu>Data</GUIMenu> | 543 | <GUIMenu>Data</GUIMenu>&arrow; |
594 | <GUIMenuItem>Delete...</GUIMenuItem> or press the Delete icon (an image of | 544 | <GUIMenuItem>Delete...</GUIMenuItem> or press the Delete icon (an image of |
595 | a trash can). A dialog should pop up, asking if you want to delete the task, | 545 | a trash can). A dialog should pop up, asking if you want to delete the task, |
596 | click yes to delete it, or no to cancel. | 546 | click yes to delete it, or no to cancel. |
597 | </para> | 547 | </para> |
598 | </section> | 548 | </section> |
599 | <section><title>Finding Tasks</title> | 549 | <section><title>Finding Tasks</title> |
600 | <para> | 550 | <para> |
601 | To find a task, either go to | 551 | To find a task, either go to |
602 | <GUIMenu>Options</GUIMenu><GUIMenuItem>Find</GUIMenuItem> | 552 | <GUIMenu>Options</GUIMenu>&arrow;<GUIMenuItem>Find</GUIMenuItem> |
603 | , or | 553 | , or click the find icon (an image of a green magnifying glass), and a dialog |
604 | click the find icon (an image of a green magnifying glass), and a dialog should | 554 | should pop up. Enter the text you want to search for in the description, and |
605 | pop up. Enter the text you want to search for in the description, and select the | 555 | select the category that you want it to search through (this will speed the |
606 | category that you want it to search through (this will speed the search up, if | 556 | search up, if you know what category it is in). You can also select "case |
607 | you know what category it is in). You can also select "case sensative" which | 557 | sensative" which makes the search pay attention to the case of what you type (so |
608 | makes the search pay attention to the case of what you type (so if you look for | 558 | if you look for "mow lawn", it won't find a task called "Mow lawn"). "Search |
609 | "mow lawn", it won't find a task called "Mow lawn"). "Search Backwards" | 559 | Backwards" will search backwards from the currently selected task. Click "Find" |
610 | will search backwards from the currently selected task. Click "Find" to | 560 | to 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 | 561 | 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 | ||
613 | the previous one, if "Search backwards" is selected). | 562 | the previous one, if "Search backwards" is selected). |
614 | </para> | 563 | </para> |
615 | </section> | 564 | </section> |
616 | 565 | ||
@@ -626,9 +575,9 @@ you want to see the deadline. | |||
626 | <section><title>Completing Tasks</title> | 575 | <section><title>Completing Tasks</title> |
627 | <para> | 576 | <para> |
628 | To mark a task as completed without deleting it, you can either check the | 577 | To mark a task as completed without deleting it, you can either check the |
629 | checkbox next to it in the main view, or edit it, and check the "completed" | 578 | checkbox next to it in the main view, or edit it, and check the "completed" |
630 | check box in the edit dialog. If <GUIMenu>Options</GUIMenu> | 579 | check box in the edit dialog. If <GUIMenu>Options</GUIMenu>&arrow; |
631 | <GUIMenuItem>Completed<GUIMenuItem> tasks is not checked, the task will | 580 | <GUIMenuItem>Completed<GUIMenuItem> tasks is not checked, the task will |
632 | disapear when you mark it completed. but do not worry, it is not gone forever, | 581 | disapear when you mark it completed. but do not worry, it is not gone forever, |
633 | just check Completed tasks in the options menu, and you can see and edit it | 582 | just check Completed tasks in the options menu, and you can see and edit it |
634 | again. | 583 | again. |
@@ -714,9 +663,9 @@ text" which will open the file up in TextEdit (regardless of whether or not it | |||
714 | is actually a text file). | 663 | is actually a text file). |
715 | </para> | 664 | </para> |
716 | </section> | 665 | </section> |
717 | 666 | ||
718 | <section><title>Adding to "Documents"</title> | 667 | <section id="adddoc"><title>Adding to "Documents"</title> |
719 | <para> | 668 | <para> |
720 | To add a file to your "Documents", press and hold the file, and select "Add | 669 | To add a file to your "Documents", press and hold the file, and select "Add |
721 | to documents" from the menu. This will add the file to the documents tab, which | 670 | to documents" from the menu. This will add the file to the documents tab, which |
722 | you can use to quickly open the file (simply click on the icon for the file in | 671 | you can use to quickly open the file (simply click on the icon for the file in |
@@ -750,10 +699,11 @@ links to other files or directories) will be visible. | |||
750 | EmbeddedKonsole is Opie's terminal emulator. From here you can do pretty much | 699 | EmbeddedKonsole is Opie's terminal emulator. From here you can do pretty much |
751 | anything (since Linux is actually a command line based OS by itself). I will | 700 | anything (since Linux is actually a command line based OS by itself). I will |
752 | not go into much detail on using the linux command line, as that is covered in | 701 | not go into much detail on using the linux command line, as that is covered in |
753 | many other places (http://www.tldp.org is a good place to start, or read | 702 | many other places (http://www.tldp.org is a good place to start, or read |
754 | O'Reilly's \underline{Running Linux} for a comprehensive look at Linux for the | 703 | O'Reilly's <citation>Running Linux</citation> for a comprehensive look at Linux |
755 | beginner). I will, however, give a quick overview of using a Linux shell. | 704 | for the beginner). I will, however, give a quick overview of using a Linux |
705 | shell. | ||
756 | </para> | 706 | </para> |
757 | 707 | ||
758 | <section><title>Using Embedded Konsole</title> | 708 | <section><title>Using Embedded Konsole</title> |
759 | <para> | 709 | <para> |
@@ -791,9 +741,9 @@ The other icons are the same as typing (from left to right) enter, space, tab | |||
791 | <section><title>Command List</title> | 741 | <section><title>Command List</title> |
792 | <para> | 742 | <para> |
793 | The command list is a pulldown menu with a list of commonly used commands. | 743 | The command list is a pulldown menu with a list of commonly used commands. |
794 | Selecting one will type the command into the terminal wherever the cursor is. | 744 | Selecting one will type the command into the terminal wherever the cursor is. |
795 | You can edit or hide this menu from <GUIMenu>Options</GUIMenu> | 745 | You can edit or hide this menu from <GUIMenu>Options</GUIMenu>&arrow; |
796 | <GUIMenuItem>Command List.</GUIMenuItem> | 746 | <GUIMenuItem>Command List.</GUIMenuItem> |
797 | </para> | 747 | </para> |
798 | </section> | 748 | </section> |
799 | </section> | 749 | </section> |
@@ -872,12 +822,12 @@ directory (usually /home/username or /root for the root user). | |||
872 | 822 | ||
873 | <section><title>Moving Files</title> | 823 | <section><title>Moving Files</title> |
874 | <para> | 824 | <para> |
875 | To move files around, you need to use the "cp" (copy) and "mv" (move) | 825 | To move files around, you need to use the "cp" (copy) and "mv" (move) |
876 | commands. Both of these are run the same way: \verb+command originalfile | 826 | commands. Both of these are run the same way: <userinput>command originalfile |
877 | newfile+. The only difference is that cp creates a new file without touching | 827 | newfile</userinput>. The only difference is that cp creates a new file without |
878 | the old one, while mv deletes the original file. The two path names can be | 828 | touching the old one, while mv deletes the original file. The two path names |
879 | either absolute or relative. If you only specify a directory for the | 829 | can be either absolute or relative. If you only specify a directory for the |
880 | destination, and no filename, it will use the filename for the original file. | 830 | destination, and no filename, it will use the filename for the original file. |
881 | </para> | 831 | </para> |
882 | </section> | 832 | </section> |
883 | 833 | ||
@@ -919,17 +869,17 @@ install things either remotely from a web server (called a "feed") or it can | |||
919 | install an ipkg package file that resides on the local filesystem. | 869 | install an ipkg package file that resides on the local filesystem. |
920 | </para> | 870 | </para> |
921 | <important> | 871 | <important> |
922 | <para> | 872 | <para> |
923 | Note: There is a bug in oipkg that prevents it from installing packages | 873 | There is a bug in oipkg that prevents it from installing packages |
924 | properly. There is, however, a workaround for it. Simply run oipkg from | 874 | properly. There is, however, a workaround for it. Simply run oipkg from |
925 | Embedded Konsole to avoid the bug. | 875 | Embedded Konsole to avoid the bug. |
926 | </para> | 876 | </para> |
927 | </important> | 877 | </important> |
928 | 878 | ||
929 | <section><title>Installing Software</title> | 879 | <section><title>Installing Software</title> |
930 | <para> | 880 | <para> |
931 | To install software, first select "Opie" from the "Section" pulldown menu, | 881 | To install software, first select "Opie" from the "Section" pulldown menu, |
932 | the press the "+" icon next to "Feeds" in the main view. This will show all | 882 | the press the "+" icon next to "Feeds" in the main view. This will show all |
933 | the available Opie packages (you can change which packages to view by selecting | 883 | the available Opie packages (you can change which packages to view by selecting |
934 | something else from the "Section" pulldown). Installed packages are marked | 884 | something else from the "Section" pulldown). Installed packages are marked |
935 | with a blue circle, while packages that are not installed are marked with a red | 885 | with a blue circle, while packages that are not installed are marked with a red |