A5 - Readme File

req.:    min. OS3.5
rem.:    flash compatible
site:    http://www.a5agenda.com (other languages, documentation)

****************************************************************************************

NO WARRANTY

This is a beta
Don't forget to make a backup...

****************************************************************************************

Thank you for volunteering to test this beta version.
If you experience any problems/bugs feel free to contact me.

****************************************************************************************


0.1L(4) 5 Aug

New:
- beam a single item (menu on the edit form of an *existing* item)

change:
- "Show end time" has moved from the grid and list options form to the main menu. 

fix: 
- forwarding UTD: setting not "sticky" - doesn't keep "move to today".
  ( version of 2 Aug was wrong)
- options forms: 5-Way left/right Navigation (T5,Treo)  (again ;) )
- options forms: error when leaving
- convert: description got truncated on a newline. 


------------------------------------------------------------------------------------


0.1L(3) 2 Aug

fix: 
- forwarding UTD: setting not "sticky" - doesn't keep "move to today".
  For this fix the previous A5Prefs change uses "a time" instead of the modification time.

------------------------------------------------------------------------------------


0.1L(3) 1 Aug

change:
- time filter: moved from the menu to the title bar
- time filter: view/list type depended
- A5Prefs: When sharing A5Prefs the receiving party could have all the uncompleted
  to do items moved to today (depending on the forward option). 
  To prevent this from happening the modification time is saved in to the Saved-Preferences database. 
  If this time doesn't match the time of A5Prefs this specific option is changed.
- info window larger "top left tap area" (to operate with fingers)

fix:
- crash: with moved utd area
- Week_divider + empty days on => the divider was shown after the current day.
  (now the divider isn't shown for the active week since this information is already
   in the title bar)
- Wakeup alarm: daylabels not displayed on Mulitbyte font
- listview and description of one character long + "wrap on".
- options forms: 5-Way left/right Navigation (T5,Treo)
- Prefixes: adding an empty Prefix didn't select the already existing prefix
- Sony Clie OS 4.x: FreeTime Graph hour lines where drawn wrongly
- A "fix" for Chaigm (http://www.freewarepalm.com/clock/chagim.shtml) data.
- Event Edit form: If you tap on the down arrow, it overlaps a little the 
  hour-info items of the gui.
- The 'Hide Prefix' setting wasn't properly saved.

------------------------------------------------------------------------------------

0.1L(2) [4 Jul]

fix:
- Alarm info.

------------------------------------------------------------------------------------


0.1L(2) [2 Jul]


change:
- Grid: max rows is back.

fix:
- crash: with custom labels.
- crash/error: paste action after closing the preferences.
- Grid: Switch label and nr for Mulibyte font.
- Alarm info.
- grid view: small arrows when scrolling all days (page up/down) & moved utd area 

------------------------------------------------------------------------------------

0.1L(1) [27 jun]

fix: 
- crash when using prefixes
- grid view: after switching positions from a day with with utd area,
  the items on this day couldn't be tapped on.
- error when changing a non repeating event to a weekly repeating one.

------------------------------------------------------------------------------------

0.1L [23 jun]

new:
- forwarding uncompleted to do items has been enhanced by allowing to show them in the UTD area
  without changing the due date. In the UTD area an "!" is shown in front off the item and
  in the info window there is show how many days they are due.
- A5 preferences are now stored in a separate database called A5Prefs.pdb.
  Pro's:
  + easier to restore (only A5's settings instead of the whole Saved_Preferences.PRC)
  + by renaming the pdb a new one will be created, this way you can try out various color schemes without loosing older ones.
  + you can share (beam) your preferences with other A5 users.
  Notes:
   1) A5Prefs doesn't contain privacy information;( the only free texts are the labels and prefixes)
   2) if you share your preferences with others please consider to change "Forwarding uncompleted to do items" when "move to today" is selected.
- Time filter ("View | Time filter on/off" and "View | Time filter inverse") makes it possible to see only events that are happening before or after a certain time.
  The time which is filtered on can be set on On "Options | General" you can set the time filter value (hh:mm).
-  "Bar option" (Options | Grid)  switch the texts from the day number and day label.
  ( the "Bar" settings are moved to a separate form )
- Customizable grid. With "Options | Display | Appearance" you can change the order of the days in the grid by "drag and drop".
- list view shows bar color when "Date in row" is not selected
- Week divier: list view, type long => shows week divider when "Date in row" is not selected
- Gui update for OS5
- Navigation (T5,Treo one-hand-style) support. (btw in the grid view you can use 1 - 7 to popup the etp lists)
- Graffiti strokes '1' through '5' switches between the saved lists (for when e.g. the side bar is disabled)
- am/pm time shown in grid.
- xcode. There where some request for which (because of various reasons) there are no preferences screens ;)
  But they can be enabled by using A5's xcodes.
  These codes can be entered in the x-code dialog.
  To open this dialog type 'x' on the "Options | General " form.
  a) xcode_jumpdb         value: 1 => When using the App. button A5 won't switch views but jump to the database application 
  b) xcode_nojump         value: 2 => As a) but no jump at all
  c) xcode_disableVA      value: 4 => Disables the virtual graffiti area
  d) xcode_smallbar       value: 8 => Smaller bars in the grid view for hires devices.
  e) xcode_lowresETP      value:16 => Show the "ETP" list instead of the grahpical ETP list.
  f) xcode_noWeekDivider  value:32 => Disables the week divider for the long list view.
  g) xcode_noListBarColor value:64 => Disables the bar color (when "Date in row" is not checked)

  If you would like e.g. the lowresETP list together with a disabled virtual graffiti area the value that needs to be entered is 16+4 = 20.
- "Options | Alarm Info" shows the time of the next alarm
- "+" button on the edit form creates a new item without leaving the edit screen
- internal update.

fix:
- if the device was off and the application button, assigned to A5, was pressed the last visited view
  is now shown (instead off switching/jumping right away)
- hires+, last two area -> tab day label
- always asked for delete confirmation
- "Display | Appearance | Top" -> sometimes setting not saved
- on some devices the bottom arrow in the list view wasn't always activated.
- 0.1j fix is back: "save archive copy to pc" is always used on NVFS devices (T5, Treo650) to prevent 
  a crash when deleting items because of a T5/T650 bug.
- moving a repeated item with a repeat end date to an earlier date did set a "no repeating end date" when 
  a newly choosen repeating end date was before the original (instead of new) end date.
- freetime graph: didn't make sense for the utd area
- convert event <-> to do: category was not kept (when possible)
- list view no longer shows the "empty" page where the only item was the (bottom) last item of the previous page.
- The truncate symbol is now shown when the whole first line of the description does fit but there are more description lines.

changed:
- wakeup alarm: 
  If no "ok" or "snooze" button has been choosen the alarm will ring again after a minute.
  After that the dialog closes. 
  If "snooze" has been choosen the alarm will ring again after 9 minutes.
- tapable area for the time colom has extended a little.
- Tasks "Done" is now visible as soon as the 'Task' option is selected.

-----------------------------------------------------------------------------------------------

0.1k [30 march]

- NOTE: 
A5 is not T5 compatible: The hotsync process, on the calendar application, seems to hang.
On the simulator I have not been able to reproduce this problem yet.
Any help in this area (testing, bug reporting, solution?) would be greatly appreciated.


new:
- note is now included when copying an item.
- convert from to do item to event and v.v. (implemented on the paste form)
- free time graph (press+hold on the day label); (still in progress...)
- "Jump to Week number dialog" pops up with Graffiti "W"
- new pim: Info screen shows the location field
- new pim: location field is kept when an event is changed/copied/moved
- On some new pim device there is no room for datebookDB, CalendarDB is used instead.
- old pim: when hot syncing the categories (which are stored in the datebook database) are lost.
  If you have external memory (sd card, memory stick) A5 can create a copy of the datebook.
  When needed (e.g. a hard reset) this datebook can be restored and the categories will be back.
  Note: The backup is just a copy and is not encrypted.
- separate bar colors
- grid: bar position

change:
- untimed to do area in the list view has increased with 2 rows.
- The day-label of the bottom areas is for some devices too small to tap on.
  If (one off) the tiny arrows is not shown this area can be used to tapped on too.
- The battery friendly option has been removed. Please turn off blinking to save battery.
- current day marker: Label, Rectangle, Bar (bar is new)
- "Hide prefix" moved to "Options | Display | Prefixes"
- "Use priority as marker" "Options | Display | Markers & priorities" is selectable.

-fix:
- check box and system icons (note etc) where not shown on Japanese rom OS5
- wrong background color of utd area (grid view) after editing a to do item.
- The cancel button on the icon form cleared the icon
- icon on event edit form not redrawn after choosing a (repeat end) date.
- display errors when the custom day labels where one position long
------------------------------------------------------------------------------------

0.1j(6) [19 jan]

fix: 
- pasting events didn't keep the original category
- changing only a description didn't hotsync the event on some devices (only the new PIM devices?: T3 TE...)
- T5 and Treo650: crash when deleting items (T5/T650 bug?); 
  "save archive copy to pc" is now always used to prevent this.
- GUI: current week marker (inverse) display in the grid view.
- GUI: 320x320 + small font + no big icons + "Max rows" -> line height to high.

0.1j(5) [12 jan]
- Oops 0.1j(4) was a debug version :(


0.1j(4) [12 jan]
fix:
- crash when deselecting skin.
- moved repeating items didn't get synced
- list view: day-date on some devices printed in the wrong color
- list view: wrong background color of untimed to do when "appended" and no untimed to do items exists
- list view: hide completed items -> checked items are visible for a brief moment.
- copy problem when all categories (including 'Unfiled') where deleted
- A5 didn't jumped to "today" when launched using a hardkey on a new day. (in some situations)
- App.button: switch only worked only if "Clock: switch only" was checked too.
- utimed symbol & "item with note in bold" checked.

change:
- Some taps are handled on "pen up" instead off "pen down" (like e.g. (un) checking to do items)

0.1j(3) [30 Dec]
fix:
- when the day marker is set to "blink" (or blink fast) this particular day is highlighted in every year
- "Ok" button on Option forms was not always validated.
- Setting depended App.btn/ clock didn't jump to the current day.
- The multiple lists shared the last 3 options off the view menu (which are now list depended)


0.1j(2) [22 Dec]
fix:
- Private record is opened without password by a tap on the left edge
  of the item in the list view when "Date in Row" is checked.
- When the Action on tapping the "description" set to display "info + note", 
  and the item has a note, the info box does not contain the item description
- After the repeating "move" operation (in "List"-view only), the screen is blank.
- Copy & "respect filter" option in list view.
- 5-way Nav & list bar (menu) buttons
- gui update:  bar size, daylabels  and "side" buttons


0.1j(1) [18 Dec]
fix:
- crash when the last icon in an icon set was deleted.


0.1j [18 Dec]
new:
- show/hide end time ("Options | Grid" and "Options | List")
- "Strict" with "Show higher priorities" ; in- or exclude items without a priority. ("Options | General")
- configurable list types; which can be assigned to the grid view's clock, day bar and utd area bar. ("Options | Hotspots")
  also accessible by the button on the list view's bar.
  To change:
    * set the list options for the active list OR
    * tap on the active list button (on the list's bar)
- Use priority 1 as item marker ("Options | Display | Markers & priorities"),
  When set the background color of the text is colored; this for highlighting prio 1 better.
- Untimed event can be aligned to the left ("Options |General")
- Clock and App.button are now separate functions. (Clock and 5-way Nav are the same) ("Options |Control")
- The category 'Unfiled' can be renamed.

fix:
- Event edit form: third "-" uses duration of the current meeting instead of the default duration
- date label year truncated when snooze icon
- long list and tap on clock to current day
- move repeating event from edit form without changing new repeat end date
- an utd & list error (sometimes an untimed todo was shown...)
- list could (?) display one row to many
- "cancel" on preference screens
- "color" error on older OS devices
- 480 screen, shows a truncated row at the bottom
- descriptions and newline display.
- memory error & leaving A5 while the "alarm sounds pick list" was open

------------------------------------------------------------------------------------


0.1i [29 Oct]
fix:
- Crash on some devices when tapped on an empty row in the list view. 
- double alarm on visor (datebook and datebook+)
  A5 doesn't handle alarms but let the date book application handle them.
  This could lead to double alarms if on a visor datebook+ was the alarm handling application.
  Because of this a new option has been implemented to choose which application should take care
  of the alarms (for events).
  At the moment only two applications are known/valid: 'Date Book' and 'DateBookPlus'.
  For the new pim devices (TE, T3) the default is 'Calendar-PDat'.
  The reason for this dynamic list instead of the fixed values is that it makes a third-party "A5 alarm handling module" possible.
- respect filter (change filters so that newly created item is always visible)
- wakeup alarm was cleared when installing a new version

new:
- "Options | System | alarm handeling application" (see 'fix' above)
- priority color shows on the edit form
- events can default be tasks (Options | Items | Task)
- "no-black-blob-option" (the "no time symbol" can be hidden: Options | General)
- Repeat option on "Paste" form, repeats the last copy or move action (to the same day) for the newly selected item.
  So no need to scroll to the destination day when moving/copying several items to another week.
  You can paste (and select repeat) on the day where you select the items.
- Custom "month" and "week" labels; meant for "no rom language support", 
  "MulitByte" is for languages like e.g. Japanese, Chinese etc. 
  If the day labels in the grid view are not positioned right this option might make a difference.
- edit event : between the start and end time there are 3 buttons.
  The first  '-' means 'no time', 
  the second '-' means 'current time' and 
  the third  '-' means 'add duration' (endtime = starttime + duration)
- Max screen depth: When checked A5 will switch to the maximum screen depth.
  Default it is turned off. If you are using a hires skin or if you have a monochrome device and you
  would like to turn on the gray scale this feature might be of help.



0.1h(3) [19 Aug]
fix: Despite of what the documentation says, A5 was not OS3.5 compatible at all :(


0.1h(2) [15 Aug]
fix: 
- Zire 31 compatible
- Marker dialog (colors) and crash
- Category Items "All" range fell of the screen 


0.1h(1) [06 Aug]
fix: 
- wrong label ("Thursday 31 31") for (appended) undated to do items
- alarm icon (normal font) on some devices 1 pixel to low
- T3 hide VG area when slider opens.
- NX80, NX73? VG area handling

change:
- slower checking of todo items (with hide option).
- Undated to do items are purged too when "completed To Do Items" on the purge dialog
  is checked.



0.1h [4 Aug]

new:
- Default duration (Options | Items)
- Show/hide prefix (Options | General | Hide prefix)
- Category foreground color. "Options | Display | Appearance |Text" is removed.
  The priority color is leading but you can set the transparent color to see the category color.
- current day marker: box/rectangle can be turned off and 
  its color (curentday nr) can be set (Options | Grid )
- keyboard: 1 through 8 will show the (E)TP list in the grid view.
  Creating an event on Wednesday next week would e.g. be [PAGEDOWN][3]
- Dana wide screen support
- Daily alarm (Options | General ) Snooze: 9 minutes.
- List: date in row/heading (Options | List)

changed:
- silkscreen handling revised (now also for OS5.3 etc)
- up to 9 user definable prefixes (you'll need to recreate them though)
- The end time on the events' edit form behaves a little different once set.
  (If you need it to follow the start time +duration press on the "no time" symbol first.)
- allignment (description, icons)

fixed:
- list view: actions
- If the date book database is corrupted A5 will crash frequently -> not for empty events anymore.
- T3 time beond midnight
- moving a moved event 
- move a repeating event: paste -> keeps "duration", from within Edit form -> keeps "end date"
- copying items while the "hidden category group" was active (got the category of the hidden group)
- changing a daily repeat event to a weekly repeat
- Clie NR70: info+note; info window was half a screen width
- dynamic height info screen (for some devices)
- background color of utd when appended to list
- If only an event's description was changed, the item didn't get synced (with outlook)



----------------------------------------------------------------------------------------

0.1g(2) [9 Apr]
new:
- list type: 7 (days)
- long list: date selector by day
- list: scroll beyond startpoint ( arrows in the bar )
- TH55 silk screen enabled

changed:
- day/area markers (see description below) implemented as '***' event.
- prefix max 20 length
- icons window, scroll with keys + jog

fixed:
- prefix icons & second line (again ;) )
- uses default category when "hide group" selected
- third party (tbmp) icon sets
- changing a event to a repeat-monthly-day event
- "today in top left"
- the current day wasn't advanced when alarm was going off
- blinking and keyboard driver
- changing a (multiple day) weekly repeating event

fixed:?
- start on power on button


open:
- list view: actions
- display problem when returning from DA's.
- If the date book database is corrupted A5 will crash frequently.


DAY MARKERS CHANGED
The day/area markers where initialy meant as a temporarily aid only.
They needed to be cleared explicite, other wise they wuld show up again.
In the previous version version they where stored in the 'a5_data' database.
In this version they are stored as an event ('***') in the default date book.
This way you'll see it in the palm desktop too.
The 'a5data' data base can be deleted.
If you where using of day/area markers you'll have to recreate them though.


----------------------------------------------------------------------------------------
Also included in the zip: (NOT CHANGED)
----------------------------------------------------------------------------------------
 The hacks are not required to run A5. 
 
- A5WeekHack: (not OS5 )
  This is a little program (hack) that replaces the default week view with A5.
  You have to use a hack manager to enable it.

 - A5AgendaHack: (not OS5 )
  Works like A5WeekHack but replaces the Agenda (combined events - to do items) view.

 - A5AgendaListHack: (included one not OS5 compatible)
  Works like A5AgendaHack but always starts with the list view
   
  ***********************************************
  * OS5 with Old PIM                            *
  * See: http://yahm.palmoid.com/               *
  * (http://yahm.palmoid.com/A5AgendaHack.prc)  *
  *                                             *   
  ***********************************************

  
- Icon sets
  A5_basic and A5_icons

- Skins
  image for the top bar (color devices)

----------------------------------------------------------------------------------------
Known issues:
(Perhaps not A5 errors?)
- UX50 crashes/gui distorts when silkscreen is positioned on the left.
- display problem when returning from (some?) DA's.
