| -rw-r--r-- | docs/usermanual/usermanual.sgm | 693 |
1 files changed, 693 insertions, 0 deletions
diff --git a/docs/usermanual/usermanual.sgm b/docs/usermanual/usermanual.sgm new file mode 100644 index 0000000..1fe8c52 --- a/dev/null +++ b/docs/usermanual/usermanual.sgm | |||
| @@ -0,0 +1,693 @@ | |||
| 1 | <!DOCTYPE book SYSTEM "/usr/local/sgml/4.2sgml/docbook.dtd"> | ||
| 2 | <book><title>Opie User Manual</title> | ||
| 3 | <part><title>Getting Started</title> | ||
| 4 | <chapter><title>What is Opie?</title> | ||
| 5 | <para> | ||
| 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 | ||
| 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 | ||
| 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, | ||
| 12 | based upon the QT toolkit. | ||
| 13 | </para> | ||
| 14 | <para> | ||
| 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 | ||
| 17 | designed to fit in a relatively small amount of storage space (about 5 megabytes | ||
| 18 | for the base libraries and the launcher). | ||
| 19 | </para> | ||
| 20 | </chapter> | ||
| 21 | <chapter><title>Installation</title> | ||
| 22 | <section><title>iPAQ</title> | ||
| 23 | <para> | ||
| 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 | ||
| 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 | ||
| 28 | not install X, as it is not necessary, and will only take up space). | ||
| 29 | </para> | ||
| 30 | |||
| 31 | <note> | ||
| 32 | <para> | ||
| 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 | ||
| 35 | to install opie. | ||
| 36 | </para> | ||
| 37 | </note> | ||
| 38 | <para> | ||
| 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), | ||
| 41 | and then run this command: | ||
| 42 | <informalexample> | ||
| 43 | <literallayout> | ||
| 44 | echo src opie "http://131.152.105.154/feeds/ipaq/unstable/" \ | ||
| 45 | >> /etc/ipkg.conf | ||
| 46 | </literallayout> | ||
| 47 | </informalexample> | ||
| 48 | then, run: | ||
| 49 | <informalexample> | ||
| 50 | <literallayout> | ||
| 51 | ipkg update && ipkg install task-opie | ||
| 52 | </literallayout> | ||
| 53 | </informalexample> | ||
| 54 | If you have a 3100 or 3800 series iPAQ, run: | ||
| 55 | <informalexample> | ||
| 56 | <literallayout> | ||
| 57 | ipkg install qt-embedded-rotation | ||
| 58 | </literallayout> | ||
| 59 | </informalexample> | ||
| 60 | finally, start Opie with: | ||
| 61 | <informalexample> | ||
| 62 | <literallayout> | ||
| 63 | /etc/init.d/opie start | ||
| 64 | </literallayout> | ||
| 65 | </informalexample> | ||
| 66 | </para> | ||
| 67 | |||
| 68 | <para> | ||
| 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'' | ||
| 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 | ||
| 73 | 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 | ||
| 75 | the command line in Opie. | ||
| 76 | </para> | ||
| 77 | </section> | ||
| 78 | |||
| 79 | <section><title>Zaurus</title> | ||
| 80 | <para> | ||
| 81 | 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 | ||
| 83 | default Zaurus rom. Do not install Opie's launcher on a default Zaurus ROM | ||
| 84 | though. | ||
| 85 | </para> | ||
| 86 | </section> | ||
| 87 | </chapter> | ||
| 88 | |||
| 89 | <chapter><title>Using Opie</title> | ||
| 90 | <para> | ||
| 91 | 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 | ||
| 93 | 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 | ||
| 95 | installed ``applets''. | ||
| 96 | </para> | ||
| 97 | |||
| 98 | <section><title>Getting Around</title> | ||
| 99 | <para> | ||
| 100 | 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 | ||
| 102 | stylus and using a mouse is that you cannot right click with a stylus, so things | ||
| 103 | 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''. | ||
| 105 | 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 | ||
| 107 | seconds. This usually opens up a context sensative menu, much like a right | ||
| 108 | click usually does on a desktop interface. | ||
| 109 | </para> | ||
| 110 | </section> | ||
| 111 | |||
| 112 | <section><title>Launcher</title> | ||
| 113 | <para> | ||
| 114 | The Launcher behaves like the ``desktop'' on most PC GUIs. When no applications | ||
| 115 | 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 | ||
| 117 | running applications (this is similar to ``minimising'' all the applications | ||
| 118 | that are running). | ||
| 119 | </para> | ||
| 120 | <para> | ||
| 121 | 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 | ||
| 123 | 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 | ||
| 125 | 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, | ||
| 127 | 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, | ||
| 129 | by changing the directories in /opt/QtPalmtop/apps. | ||
| 130 | </para> | ||
| 131 | <para> | ||
| 132 | 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 | ||
| 134 | 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} | ||
| 136 | </para> | ||
| 137 | </section> | ||
| 138 | |||
| 139 | <section><title>Taskbar</title> | ||
| 140 | <para> | ||
| 141 | 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 | ||
| 143 | 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. | ||
| 145 | 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 | ||
| 147 | 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 | ||
| 149 | (unless you installed task-opie-minimal), which is actually just another applet | ||
| 150 | that draws the time instead of an icon. | ||
| 151 | </para> | ||
| 152 | <para> | ||
| 153 | 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 | ||
| 155 | 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. | ||
| 157 | </para> | ||
| 158 | <para> | ||
| 159 | 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 | ||
| 161 | 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 | ||
| 163 | 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. | ||
| 165 | </para> | ||
| 166 | </section> | ||
| 167 | |||
| 168 | <section><title>Dialogs</title> | ||
| 169 | <para> | ||
| 170 | 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 | ||
| 172 | 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 | ||
| 174 | desktop GUI's the ``Ok'' and ``x'' behave like the ``Ok'' and ``Cancel'' buttons | ||
| 175 | you would normally see in the bottom right of the dialog window). | ||
| 176 | </para> | ||
| 177 | <para> | ||
| 178 | 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 | ||
| 180 | close the application, while the ``x'' button will close the application without | ||
| 181 | saving. | ||
| 182 | </para> | ||
| 183 | </section> | ||
| 184 | </chapter> | ||
| 185 | |||
| 186 | <chapter><title>Upgrading</title> | ||
| 187 | <para> | ||
| 188 | First, you should shutdown Opie from the ``Shutdown'' app in the Settings tab. | ||
| 189 | Normally, simply running | ||
| 190 | <informalexample> | ||
| 191 | <literallayout> | ||
| 192 | ipkg update && ipkg upgrade | ||
| 193 | </literallayout> | ||
| 194 | </informalexample> | ||
| 195 | 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 | ||
| 197 | 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: | ||
| 199 | <informalexample> | ||
| 200 | <literallayout> | ||
| 201 | ipkg update | ||
| 202 | ipkg install opie-update | ||
| 203 | </literallayout> | ||
| 204 | </informalexample> | ||
| 205 | Opie should then be upgraded. | ||
| 206 | </para> | ||
| 207 | </chapter> | ||
| 208 | </part> | ||
| 209 | |||
| 210 | <part><title>Applications</title> | ||
| 211 | <chapter><title>Contacts</title> | ||
| 212 | <para> | ||
| 213 | 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 | ||
| 215 | work for, etc. | ||
| 216 | <para> | ||
| 217 | |||
| 218 | <section><title>Adding Contacts</title> | ||
| 219 | <para> | ||
| 220 | 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). | ||
| 222 | 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 | ||
| 224 | 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 | ||
| 226 | 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 | ||
| 228 | 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 | ||
| 230 | 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 | ||
| 232 | them). | ||
| 233 | </para> | ||
| 234 | <para> | ||
| 235 | 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 | ||
| 237 | 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 | ||
| 239 | parameter). | ||
| 240 | </para> | ||
| 241 | <para> | ||
| 242 | The Details tab is used for miscelaneous things like the person's position, the | ||
| 243 | name of their spouse, etc. | ||
| 244 | </para> | ||
| 245 | <para> | ||
| 246 | 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. | ||
| 248 | </para> | ||
| 249 | </section> | ||
| 250 | <section><title>Editing Contacts</title> | ||
| 251 | <para> | ||
| 252 | 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 | ||
| 254 | 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 | ||
| 256 | ``Ok'', or to cancel them, click ``x''. | ||
| 257 | </para> | ||
| 258 | </section> | ||
| 259 | |||
| 260 | <section><title>Deleting Contacts</title> | ||
| 261 | <para> | ||
| 262 | 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 | ||
| 264 | dialog will pop up asking if you want to actually delete that contact, click yes | ||
| 265 | to delete it, no will cancel. | ||
| 266 | </para> | ||
| 267 | </section> | ||
| 268 | |||
| 269 | <section><title>Editing Contacts</title> | ||
| 270 | <para> | ||
| 271 | 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 | ||
| 273 | 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 | ||
| 275 | 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). | ||
| 277 | 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 | ||
| 279 | 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 | ||
| 281 | clicking ``Find''. | ||
| 282 | </para> | ||
| 283 | </section> | ||
| 284 | |||
| 285 | <section><title>Viewing Contacts</title> | ||
| 286 | <para> | ||
| 287 | To view only the contacts in a certain category, go to the View menu, and check | ||
| 288 | the categories you want to view. | ||
| 289 | </para> | ||
| 290 | <para> | ||
| 291 | 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 | ||
| 293 | 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 | ||
| 295 | 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 | ||
| 297 | times to get to ``B'' and 2 more times to get back to all letters. 2+2=4). | ||
| 298 | </para> | ||
| 299 | </section> | ||
| 300 | |||
| 301 | <section><title>Personal Details</title> | ||
| 302 | <para> | ||
| 303 | Change your personal details by going to <GUIMenu>Contact </GUIMenu> | ||
| 304 | <GUIMenuItem>My Personal Details</GUIMenuItem>. This is used in today to | ||
| 305 | display who the device belongs to, as well as other apps. | ||
| 306 | </para> | ||
| 307 | </section> | ||
| 308 | </chapter> | ||
| 309 | |||
| 310 | <chapter><title>Calendar</title> | ||
| 311 | <para> | ||
| 312 | 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. | ||
| 314 | </para> | ||
| 315 | |||
| 316 | <section><title>Navigation</title> | ||
| 317 | <para> | ||
| 318 | 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 | ||
| 320 | 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 | ||
| 322 | same as Day, except that it automatically sets the view to the current day. | ||
| 323 | </para> | ||
| 324 | <section><title>The Day view</title> | ||
| 325 | <para> | ||
| 326 | 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 | ||
| 328 | 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 | ||
| 330 | 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 | ||
| 332 | also a button that lists the current day, which you can press to select a day to | ||
| 333 | view from a calendar dialog. | ||
| 334 | </para> | ||
| 335 | <para> | ||
| 336 | 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 | ||
| 338 | begining at that time and ending an hour later (which you can, of course, change | ||
| 339 | when you create the appointment). | ||
| 340 | </para> | ||
| 341 | <para> | ||
| 342 | 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 | ||
| 344 | Obex protocol (PalmOS based devices, cellphones, etc). libopieobex must be | ||
| 345 | installed to use this feature. | ||
| 346 | </para> | ||
| 347 | </section> | ||
| 348 | |||
| 349 | <section><title>The Week View</title> | ||
| 350 | <para> | ||
| 351 | 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 | ||
| 353 | navigation bar at the top, there are two scroll boxes, the one on the left shows | ||
| 354 | 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 | ||
| 356 | currently selected week. | ||
| 357 | </para> | ||
| 358 | <para> | ||
| 359 | 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 | ||
| 361 | 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 | ||
| 363 | to the day of the column that you clicked in. | ||
| 364 | </para> | ||
| 365 | </section> | ||
| 366 | |||
| 367 | <section><title>The Week List View</title> | ||
| 368 | <para> | ||
| 369 | 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 | ||
| 371 | 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 | ||
| 373 | 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 | ||
| 375 | 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 | ||
| 377 | 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 | ||
| 379 | time, instead of one. The last item is a label which shows the range of dates | ||
| 380 | for the currently selected week. | ||
| 381 | </para> | ||
| 382 | <para> | ||
| 383 | 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, | ||
| 385 | 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 | ||
| 387 | all the appointments for that day, as well as their start times. If you click on | ||
| 388 | 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 | ||
| 390 | create a new appointment for that day. | ||
| 391 | </para> | ||
| 392 | </section> | ||
| 393 | |||
| 394 | <section><title>The Month View</title> | ||
| 395 | <para> | ||
| 396 | The month view looks like a normal monthly calendar, allowing you to see on what | ||
| 397 | 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 | ||
| 399 | 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 | ||
| 401 | 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). | ||
| 403 | </para> | ||
| 404 | <para> | ||
| 405 | 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 | ||
| 407 | 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 | ||
| 409 | 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 | ||
| 411 | you click on the sqaure of a day, you will be taken to the day view for that | ||
| 412 | day. | ||
| 413 | </para> | ||
| 414 | </section> | ||
| 415 | </section> | ||
| 416 | |||
| 417 | <section><title>Adding Appointments</title> | ||
| 418 | <para> | ||
| 419 | To add an appointment, click on the add appointment button in the toolbar at the | ||
| 420 | 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 | ||
| 422 | current view, and what you may have selected, there may be certain default | ||
| 423 | settings). | ||
| 424 | </para> | ||
| 425 | <para> | ||
| 426 | 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 | ||
| 428 | list. The location field allows you to do the same. The category dropdown allows | ||
| 429 | 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 | ||
| 431 | will open up a dialog where you can add, delete, or edit certain categories. | ||
| 432 | </para> | ||
| 433 | <para> | ||
| 434 | 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 | ||
| 436 | 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 | ||
| 438 | 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 | ||
| 440 | 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 | ||
| 442 | 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'' | ||
| 444 | checkbox, which will make the appointment take up the entire day. | ||
| 445 | </para> | ||
| 446 | <para> | ||
| 447 | 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 | ||
| 449 | 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, | ||
| 451 | 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 | ||
| 453 | 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 | ||
| 455 | work. | ||
| 456 | </para> | ||
| 457 | <para> | ||
| 458 | 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 | ||
| 460 | 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 | ||
| 462 | (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 | ||
| 464 | of repetition, or ``x'' to set it back to what it was (none if it is a new | ||
| 465 | appointment). | ||
| 466 | </para> | ||
| 467 | <para> | ||
| 468 | 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 | ||
| 470 | ``ok'' to accept the changes to the notes, ``x'' to cancel. | ||
| 471 | </para> | ||
| 472 | <para> | ||
| 473 | 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. | ||
| 475 | </para> | ||
| 476 | </section> | ||
| 477 | <section><title>Editing Appointments</title> | ||
| 478 | <para> | ||
| 479 | 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 | ||
| 481 | Appointment dialog, except that the fields will already be filled in with the | ||
| 482 | information that the appointment contains. Clicking ``ok'' will keep your | ||
| 483 | changes, ``x'' will revert them to what they were before you edited them. | ||
| 484 | </para> | ||
| 485 | </section> | ||
| 486 | |||
| 487 | <section><title>Finding Appointments</title> | ||
| 488 | <para> | ||
| 489 | 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 | ||
| 491 | 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. | ||
| 493 | Click ``Find'' to find the next appointment that matches your criteria. | ||
| 494 | </para> | ||
| 495 | </section> | ||
| 496 | </chapter> | ||
| 497 | |||
| 498 | <chapter><title>Todo</title> | ||
| 499 | <para> | ||
| 500 | 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 | ||
| 502 | lawn". You can also give todo items a deadline, if they have to be completed by | ||
| 503 | a certain time. | ||
| 504 | </para> | ||
| 505 | |||
| 506 | <section><title>Adding Tasks</title> | ||
| 507 | <para> | ||
| 508 | 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 | ||
| 510 | 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 | ||
| 512 | 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 | ||
| 514 | 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 | ||
| 516 | 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 | ||
| 518 | 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 | ||
| 520 | 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. | ||
| 522 | </para> | ||
| 523 | </section> | ||
| 524 | <section><title>Editing Tasks</title> | ||
| 525 | <para> | ||
| 526 | To edit a task, you can select it, and then go to | ||
| 527 | <GUIMenu>Data</GUIMenu><GUIMenuItem>Edit | ||
| 528 | 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 | ||
| 530 | 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 | ||
| 532 | the way it was. | ||
| 533 | </para> | ||
| 534 | </section> | ||
| 535 | |||
| 536 | <section><title>Deleting Tasks</title> | ||
| 537 | <para> | ||
| 538 | To delete a task, first select it, and then either select | ||
| 539 | <GUIMenu>Data</GUIMenu> | ||
| 540 | <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, | ||
| 542 | click yes to delete it, or no to cancel. | ||
| 543 | </para> | ||
| 544 | </section> | ||
| 545 | <section><title>Finding Tasks</title> | ||
| 546 | <para> | ||
| 547 | To find a task, either go to | ||
| 548 | <GUIMenu>Options</GUIMenu><GUIMenuItem>Find</GUIMenuItem> | ||
| 549 | , or | ||
| 550 | 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 | ||
| 552 | 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 | ||
| 554 | 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'' | ||
| 556 | 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 | ||
| 558 | 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). | ||
| 560 | </para> | ||
| 561 | </section> | ||
| 562 | |||
| 563 | <section><title>Viewing Tasks</title> | ||
| 564 | <para> | ||
| 565 | 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 | ||
| 567 | select whether or not you want completed tasks to be visible, and whether or not | ||
| 568 | you want to see the deadline. | ||
| 569 | </para> | ||
| 570 | </section> | ||
| 571 | |||
| 572 | <section><title>Completing Tasks</title> | ||
| 573 | <para> | ||
| 574 | 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" | ||
| 576 | check box in the edit dialog. If <GUIMenu>Options</GUIMenu> | ||
| 577 | <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, | ||
| 579 | just check Completed tasks in the options menu, and you can see and edit it | ||
| 580 | again. | ||
| 581 | </para> | ||
| 582 | </section> | ||
| 583 | </chapter> | ||
| 584 | |||
| 585 | <chapter><title>File Manager</title> | ||
| 586 | <para> | ||
| 587 | 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 | ||
| 589 | application based upon the file type, or add the file to your ``Documents'' tab, | ||
| 590 | as well as several other filesystem related things. | ||
| 591 | <para> | ||
| 592 | |||
| 593 | <section><title>Navigating</title> | ||
| 594 | <para> | ||
| 595 | 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 | ||
| 597 | 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 | ||
| 599 | /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 | ||
| 601 | 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. | ||
| 603 | </para> | ||
| 604 | </section> | ||
| 605 | |||
| 606 | <section><title>Selecting Files</title> | ||
| 607 | <para> | ||
| 608 | 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 | ||
| 610 | select multiple files, simply click on each one you want to select. | ||
| 611 | </para> | ||
| 612 | </section> | ||
| 613 | <section><title>Moving Files</title> | ||
| 614 | <para> | ||
| 615 | 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 | ||
| 617 | 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 | ||
| 619 | 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 | ||
| 621 | in the toolbar. | ||
| 622 | </para> | ||
| 623 | </section> | ||
| 624 | |||
| 625 | <section><title>Deleting Files</title> | ||
| 626 | <para> | ||
| 627 | 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 | ||
| 629 | currently selected files, which may be more than the one that you pressed and | ||
| 630 | held on. | ||
| 631 | </para> | ||
| 632 | </section> | ||
| 633 | |||
| 634 | <section><title>Renaming Files</title> | ||
| 635 | <para> | ||
| 636 | 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 | ||
| 638 | 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 | ||
| 640 | name. | ||
| 641 | </para> | ||
| 642 | </section> | ||
| 643 | |||
| 644 | <section><title>Creating Directories</title> | ||
| 645 | <para> | ||
| 646 | 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 | ||
| 648 | 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 | ||
| 650 | click another file to create the folder. | ||
| 651 | </para> | ||
| 652 | </section> | ||
| 653 | |||
| 654 | <section><title>Viewing Files</title> | ||
| 655 | <para> | ||
| 656 | 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 | ||
| 658 | 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 | ||
| 660 | is actually a text file). | ||
| 661 | </para> | ||
| 662 | </section> | ||
| 663 | |||
| 664 | <section><title>Adding to ``Documents''</title> | ||
| 665 | <para> | ||
| 666 | 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 | ||
| 668 | 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 | ||
| 670 | opening files. | ||
| 671 | </para> | ||
| 672 | </section> | ||
| 673 | |||
| 674 | <section><title>Sorting Files</title> | ||
| 675 | <para> | ||
| 676 | 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 | ||
| 678 | 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 | ||
| 680 | name of the column in the main view to sort by that field. | ||
| 681 | </para> | ||
| 682 | </section> | ||
| 683 | |||
| 684 | <section><title>Viewing Options</title> | ||
| 685 | <para> | ||
| 686 | 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 | ||
| 688 | ``Symlinks'' is checked, symbolic links (files or directories which are merely | ||
| 689 | links to other files or directories) will be visible. | ||
| 690 | </para> | ||
| 691 | </section> | ||
| 692 | </chapter> | ||
| 693 | </book> \ No newline at end of file | ||