W E E K V I E W - Version 2.0  -- Week-at-a-glance View from Pimlico Software

OVERVIEW

   WeekView brings a one or two week-at-a-glance view to the 3Com PalmPilot (and V-1.0 USR Pilots). Unlike the built-in week view in the datebook application, WeekView displays the text of the appointments (and optionally the time) in a fixed format that makes it easy to see all the appointments at once along with selected Todo's from the Todo database. A single tap takes you to the Datebook or Todo application to make changes or updates.

INSTALLATION

   Follow the standard PalmPilot installation procedure for WeekView:
   In Windows, run the PALMPILOT INSTALL TOOL program which will be in the same group as your PalmPilot Desktop application. When the dialog appears, click on the BROWSE button and navigate to the directory where you unzipped the WEEKVIEW.PRC file. Select that file by double-clicking it in the FILE OPEN dialog and then click on the INSTALL button. On the next HotSync, the WEEKVIEW application will appear in your list of applications. If you are a registered user, make sure you remember your registration code as you will need to re-enter it after upgrading to a new version. (if you don't have it stored somewhere, bring up the REGISTER WEEKVIEW menu option BEFORE you upgrade as it will list your registration number.

OPERATION

   When started, WeekView will either remember the previously displayed week(s) or will automatically display the current week (See PREFERENCES). WeekView always remembers whether you were last displaying one or two weeks at a time and brings up the Weekly View.

   WEEKLY VIEW

   In the Weekly view, the title line shows the month and year of the week being displayed followed by the week number. Tap on the title bar to briefly see the time and also an indication of the +- offset from the current week in parentheses after the time.

   To move forwards and backwards, use the UP and DOWN buttons on the PalmPilot or click on the Left or Right arrows in the title line. When displaying two weeks at a time, the buttons will move two weeks in either direction, but the arrows will only move one week (that way you can display two weeks starting with any week).

   To jump quickly to a specific date in Weekview, click on the GO button on the title bar and the standard PalmPilot Date Picker dialog will appear.

   To jump to a day in the datebook application, click on the inverted date in that day cell (i.e. that has the day of week and day of month displayed in white on black). If there is only one appointment on that day, the cursor will be placed in that appointment (provided that one appointment is not a repeat appointment), otherwise, the cursor will be placed in the first hour of that day.

   To jump quickly to a specific week of the year, select the Goto Week Number item in the OPTIONS menu (or stroke Command/W in the graffiti area) and then press the button corresponding to the week you want to go to. In the Week Number dialog, the current week number is in bold, and the currently displayed week has a bold border around it.

   To jump to today's date, you can either stroke the letter 't' (or 'T') or a period ('.') on the graffiti area. The period is convenient because it is just a double tap (easy to do even with a finger). On V-2 PalmPilots, if the Datebook button is "overloaded" to launch WeekView instead, you can press that button while WeekView is running to go to today's date.

   To jump forwards or backwards by a number of days, select the GO FWDS/BKWDS BY DAY option in the OPTIONS menu. A dialog appears where you can type in a number of days (use a minus sign to go backwards). For example, you can easily move to a week that is 125 days before the current week by typing in -125.

   To switch between the 1 week and 2 week view, tap the button on the title bar and the legend will toggle between a 1 and a 2 indicating how many weeks will be displayed if the button is tapped.

`   Today's cell will have the first appointment set in bold type. If there are no appointments for today's date, the legend "Today" will appear in a box in the middle of the cell. The cell with today's date is always flashed briefly on the screen to attract attention.

   If there is only one appointment on the day, there is a preference option to wordwrap the text to the cell to show as much text as possible (normally this preference is checked). If there are too many appointments to display in the cell, the last appointment will end with a round bullet as a signal that there are more appointments. Also, if ANY cell has more appointments, the scrollbox will be displayed (see below).

   If there are some appointments in one or more days that are not being shown, there will be a down arrow in the box just to the left of the GO button. Tap that button to scroll forwards to  the next set of events on those day(s). If there are events before AND after those being shown, there will be both an up and a down arrow in the display. When the last set of events is being shown, there will be only an up-arrow in the scroll box. If you tap the scroll box again, it will cycle back to the beginning. If there is no arrow and no scroll box, that shows that all events in the period being shown are being displayed.
 
   To hide an appointment so it will not display in WeekView, put ~HIDE~ anywhere in the note field for that appointment (see also preference item to hide daily repeat events).

   To view all the appointments for a day (up to 16), just click anywhere on the cell for that day to bring up the DETAILS view. When that view appears, you can tap on the Note icon for an event or Todo to bring up that note for editing (in either the Datebook or Todo application).

   To display the week number and number of weeks from the current week, just tap the date in the title line. The display will toggle between showing the Month and Year and the week number. by default, the week number displayed matches the week number displayed in the Datebook application (but this can be changed with a preference item - see Preferences). The Pilot appears to adhere to the ISO specification for Week Numbers (the first week of the year is the first week in which there are four or more days of that year in that first week). This may not necessarily match your usage of week Numbers (for example, the Psion series PDA's use a different algorithm and their week numbers differ by 1 throughout 1998).  Note that the initial setting for the title can be set as a preference item. Note: MenuHack will not work with WeekView because there is actually no title bar on the main window (it just *looks* like a title bar).

   DETAILS VIEW

   To return to the WEEKLY view, just click below the last appointment line or the Done button. In the one case where there are 16 or more appointments you will have to click on the Done button.

   If the current item has a note, the note symbol will appear at the end of the line. You can tap the note symbol to bring up the note in a read-only window which will display up to 16 lines of the note. Just tap anywhere on the screen below the title line to return to the details view, or tap the EDIT button to jump to the datebook or todo application with that note displayed so you can modify the note. Repeat items are flagged with the standard Repeat symbol (V-2 PalmPilots) or a diamond (V-1 Pilots) after the time.

   To jump to a specific appointment in the Datebook application or todo in the Todo application (where you can edit, make changes, etc.), tap on the appointment. NOTE: for repeat appointments, the cursor will be placed at the beginning of the day that contains the repeat appointment and not on the appointment itself (this is a limitation imposed by the built-in datebook application).

   To create a new entry, tap the NEW button which will switch to the Datebook application and put the cursor in the first time slot for the day.

PREFERENCES

   To change the appearance of the view, select the PREFERENCE item in the OPTIONS menu or stroke Command/P in the graffiti area. In the preference dialog you can change:

   TIME FORMAT. The drop down list box allows you to omit the time or display the time in 12 or 24 hour formats with/without the minutes. This setting is distinct from the Time format in the PalmPilot's system preferences.

   WORDWRAP. If checked, a single entry will be wordwrapped to multiple lines.

   WORDWRAP ALL IN DETAILS. If checked, all entries in the Details dialog will be wordwrapped. This is probably the preferred setting unless you often have a very large number of appointments in each day.

   CONDENSED FONT. If checked, a condensed font is used which will display more text but with a corresponding loss of legibility.

   SHOW END TIME. If checked, the ending time of each appointment will be displayed in the Details view.

   HIDE DAILY REPEAT EVENTS. If checked, daily repeat events (with an interval of 1) will not be displayed. This avoids cluttering up the display when there are many standard, daily repeat events.

   REMEMBER DATE/GOTO TODAY. On startup, WeekView either remembers whatever date was being displayed the last time it ran, or will automatically go to today.

   PILOT WEEK#/CUSTOM WK#. Normally, Datebk3 will display week numbers which match the numbers used in the PalmPilot's datebook application. However, if you click on CUSTOM WK#, a date picker dialog appears where you can set any week of the year to be week 1. All Week numbers will then be calculated from the starting week number.

   Note: The Pilot appears to adhere to the ISO specification for Week Numbers (the first week of the year is the first week in the year that contains a Thursday). However, there is ambiguity if the week starts on Sunday since the ISO standard also mandates that Monday is the start of the week. The Psion, for example treats the ISO specification as meaning the first week has 4 or more days of that week. As a result, the Psion series PDA's have week numbers that differ by 1 from the Palm Pilot throughout 1998.  Note that the initial setting for the title can be set as a preference item. You may wish to use week numbers that match your fiscal year, etc.


TODO PREFERENCES

   To change the way in which Todo items are displayed, select the TODO PREFERENCE item in the OPTIONS menu or stroke Command/T in the graffiti area. When this menu item is selected, a dialog appears listing all the categories defined in your Todo database along with a priority number next to it. For each category, this number specifies the lowest priority item to be included in WeekView. A value of 5 means include ALL todo's (since 5 is the lowest priority). 0 means include NO todo's since 1 is the highest priority available.

To change the priority for a specific category, tap on the priority button and it will toggle from 0-1-2-3-4-5 and then back to 0 again.

The dialog also includes three checkboxes at the bottom:

HIDE ALL. If this is checked, ALL todo's will be hidden from the display. When checked, it also resets the individual priority associated with each category to 0. If changed from checked to unchecked, all category priorities are reset to 5 to force them all to be included. If you are not interested in displaying todo's make sure this checkbox is checked as WeekView will then completely skip the todo database. If it is not checked, but every category is set to 0, no todo's will be displayed, but WeekView will still read the entire todo database.

UNDATED. If checked, undated todo's will appear on today's date. If unchecked, undated todo's will not be displayed.

DONE. If checked, completed todo's will be displayed. If unchecked, completed todos' will not be displayed.

HIDE PRIORITY. If checked, the priority of the todo will be hidden in the weekly view, but will still be displayed in the details view.

Note that past-due Todo's are never displayed on a date earlier than today. Incomplete, past-due Todo's have a bold, exclamation mark displayed before the checkbox. When a past-due todo is checked off, it may then move to the day on which it was originally marked as due.

SUPPORT

   If you have any problems or questions about this product or suggestions for improvements, please send them in an email to cesd@gorilla-haven.org

   Pimlico Software has a web page at: http://www.gorilla-haven.org/pimlico which will always have the very latest version of all Pimlico programs. You may wish to check that page from time to time for updates to WeekView.

FUTURES

   Currently planned/being studied/already done for the next version of WeekView:

   Some hack or patch to the existing V-2/V-2 datebook applications to run WeekView as a 4th view under that application, or possibly to use the existing week button to display WeekView instead of the graphical weekly view.
   Adding a specially designed condensed font to display more text without the current loss of legibility
   A List View that displays a scrolling/paging list of up to 16 appointments/Todo's with date/times

DATEBK3

If you have enough room on your Pilot, you may want to take a good look at Datebk3. DATEBK3 is an enhanced version of the V-2 Datebook Application. It includes a 2nd weekly view with text (Pimlico's WeekView), iconic monthly view, appointments to the nearest minute, selectable purge date, integrated Todo's to which times and alarms can be set, checkoff, appointment templates and selectable startup view. Runs on both V-1 and V-2 PalmPilots. Note: requires 123k memory. Shareware $20. $5 upgrade from WeekView.

ACKNOWLEDGEMENTS

   Many thanks to Jeremy Laurenson for his assistance in solving a thorny problem (i.e. thorny for me - not for Jeremy!) with the Palm O/S!

   The Shareware Registration fees go to support the Dewar Wildlife Trust's Gorilla Haven project (http://www.gorilla-haven.org)