Project Viewer Readme

Program build: 25EA
Readme last changed: 21.05.2002


I. Introduction

Using Project Viewer you can visualize projects and events in a clearly arranged manner.
Heart of the program is the 4-weeks overview, where up to ten tasks or resources per category
can be displayed at the same time (you can manage more of course). The tasks and resources
are assigned to categories and can have their own color (only avaliable on color devices).
You can select of ten different event types for the presentation of different events.
The data of projects displayed with Project Viewer can be saved in DB 0.2.x-compatible tables
(s. Installation section). Using the DB tools you will be able to exchange with Desktop
applications.


II. Installation and Usage

FIRST INSTALLATION: Please see documentation file or on-device documentation for further
information about the usage of Project Viewer after installing as described below.

Installation:

Project Viewer comes as stand-alone PocketC application (SA). You need to install ALL files
located in the "First_Installation" folder via Hotsync. Execute "PV install" application from
your Palm Launcher to finish installation.
Memory usage: 215 kB (temporary additionally 130 kB required)
Please follow the Tutorial after installation to get a first impression.

HOW TO UPDATE: Install ALL files located in the folder "Update" to update your ProjectViewer
(via Hotsync).

Notes for those updating from a build prior 18BN (ignore at first installation):
 1. Please delete any prior build of ProjectViewer before installing this new release !!!
 2. Before updating from any prior build please consider the following information:
      - Database structure has changed! If you use DB compatible databases and would like to
      do so in future, please add the following fields at the end of the named databases with
      DB:
	  - ProjDB Preferences :
	      1 field type string name proposal "T/R" usage: Task and resource diasplay
	      switch
	  - ProjDB Projects :
	      1 field type string name proposal "Color" usage: Color identifier
	  - ProjDB Events :
	      1 field type string name proposal "Name link" usage: Identifier of the
	      task/resource the event is assigned to
	      1 field type string name proposal "Not on WE" usage: Disables/enables the
	      presentation of the event on weekends or holidays

Notes for those updating from a build prior 197I (ignore at first installation):
 1. Before updating from any prior build please consider the following information:
      - Database structure has changed! If you use DB compatible databases and would like to
      do so in future, please add the following fields at the end of the named databases with
      DB:
	  - ProjDB Preferences :
	      PLEASE NOTE: Field "T/R" has been added as of build 18BN, but has not been
	      listed in this update section. Please append field "T/R" first as described in
	      the previous paragraph before adding the following field.
	      1 field type string name proposal "AdvO" usage: Disables/enables advanced
	      overlap recognition

Notes for those updating from a build prior 19MH (ignore at first installation):
 1. Before updating from any prior build please consider the following information:
      - Database structure has changed! If you use DB compatible databases and would like to
      do so in future, please add the following fields at the end of the named databases with
      DB:
	  - ProjDB Projects :
	      1 field type string name proposal "Valid from" usage: contains first day, the
	      task/resource can have events
	      1 field type string name proposal "Valid to" usage: contains last day, the
	      task/resource can have events

Notes for those updating from a build prior 1B3K (ignore at first installation):
 1. Delete indices database or install the provided empty indices database
 ("ProjDB_Indices.PDB") before starting Project Viewer.


PLEASE NOTE: As of today the documentation does not describe the functions added with build
18BN and newer - check history, on-device documentation and tutorial file instead.


III. Build history

E=Error correction; F=Functional change; T=Technical change; C=Cosmetic change

21.05.2002 [25EA]
	- E: working with more than 9 projects resulted in wrong event presentation sometimes

14.04.2002 [24EC]
	- E: changing an event type does result in a wrong indices update sometimes
	- C: info about current time, date and year were displayed at the end of the indices
	sorting after changes in preferences dialog sometimes

13.04.2002 [24DA]
	- E: created wrong memo header when creating a new memo for a resource (which has no
	address book entry)
	- E: info about current time, date and year was not shown immediately after
	creating/changing an holiday again

20.03.2002 [23KM]
	- E: validity period check for tasks/resources didn't work properly
	- F: creating or changing an event does now execute more often a validity period
	check for tasks/resources
	- F: time displayed in 4-weeks view header is refreshed after most actions on main
	screen now

20.03.2002 [23K9]
	- E: recently added selected day and current timeon 4-weeks view header has been
	shown even when category dropdown was activated
	- E: Totals report didn't calculate events with set "Not on weekend" parameter
	properly

19.03.2002 [23JB]
	- E: creating an event from within event list view didn't return to main screen
	correctly
	- E: week numbers haven't been displayed correctly with DMY date format setting
	- E: "Searching Address book entry..." message was located on top of screen sometimes
	- F: date output uses date format separator from PalmOS preferences ("." or "/" or
	"-")
	- F: added selected day and current time to 4-weeks view header (made week numbers
	bold for better recognition)
	- T: as Advanced Overlay is not supported on Sony Cli hi-res devices, activating
	this function disables Sony Cli hi-res support on next program run

17.03.2002 [23HB]
	- E: indices update didn`t return to main screen after creating a new event sometimes
	- E: "Not on Weekend" option didn't work properly on "Create Event" dialog
	- E: some event types shortcuts haven't been displayed in the evnt detail view (got
	lost in code cleaning)
	- E: starting/ending event hasn't been selected in event list sometimes
	- E: restored event selection depending on their event type group (effects event list
	now too)
	- E: restored output of MDY format to be displayed with a 2-digit year
	- E: changing week start in preferences didn't paint the events properly until next
	program run
	- E: in 4-weeks view displayed year depends on first displayed day now
	- F: added reporting function collecting all events of a task/resource and displaying
	its usage in days:
		- Milestones/normal events and Interuptions are summarized separately
		- values per event type and day:
			Mlstn    = 1.0 day
			Prio 1   = 1.0 day
			Prio 2   = 2/3 day
			Prio 3   = 1/3 day
			Prio [1] = 1.0 day
			Prio [2] = 2/3 day
			Prio [3] = 1/3 day
			Break	 = 1.0 day
			Brk AM	 = 1/2 day
			Brk PM	 = 1/2 day
		- values of events with set "Not on weekend" flag are reduced following the
		expectation that they cross a weekend every 7th day and a holiday every 28th
		day (formula: y=x*19/28+2)
		- full color support
		- considering this all, the reporting function should not be used for serious
		actions like performance controlling or even billing - but it provides a good
		general overview
	- F: added reporting function displaying all events of the current event list (up to
	eleven at once)
	- F: supports PalmPrint for printing both reports described above
	- F: supports Export to MemoPad for both reports described above
	- F: if creating a task/resource from within a resource category its type is preset
	to "resource" (but can be changed)
	- T: uses much faster sorting and searching functions of the new PToolbox version
	(thanks again Joe)
	- T: added warning if one required database is not available (as mentioned in the
	readme, it is recommended to install the provided DB databases)
	- T: ProjectViewer requires PToolbox Library 7.2.4 now
	- C: texts that are too long to be displayable in full length, end with ".." now in
	every case
	- C: reduced year digits in event detail window to two if dates become to long
	- C: added progress indicator for the task/resource operations moving, copying,
	deleting and reporting

24.02.2002 [22OC]
	- F: lookup function for resources looks alternatively for a memo if no address has
	been found (and offers to create a memo if none exists for the resource)

For more read PVhistory.txt


IV. License

Project Viewer is shareware. Thus you can test the program and check if it is of use for you
before buying. The shareware version of Project Viewer has no major functional limitations
against the registered version except the following restrictions:
    - on odd days you can only select display periods 45 day prior today if you work with
    more than a few tasks and resources,
    - the 4-weeks view title is set to "Unregistered" on every program run
    - the dialog backgrounds show a "Unregistered" message
    - scrolling within the Extended period is available via scroll arrows only
    - some minor speed improvements take effect for registered users only
Please register via www.PalmGear.com, www.PDAssi.com or contact me via mail if you live in
the EU, especially in Germany. Registration fee is $19.95 per license.


V. Known Issues

Following odd (but not critical!) situations might occur sometimes (no solution yet):
	- the preferences screen shows strange values for all settings
	- calling the preferences (or an edit) window does raise a "Global ref out of range"
	error or a soft reset
	- tapping at the very bottom of the event list in detail window can cause the call of
	a wrong event
Please note: the named issues are mainly caused by tight ressources and may not occur on
newer devices like Palm IIIx, Palm Vx, m500, m505 or similiar.


VI. Contact

Please check the homepage http://www.Project-Viewer.com for updates and support - or contact
me directly via Support@Project-Viewer.com (only in German or English please!).


VII. Thanks and Credits

Project Viewer uses adapted versions of "PocketGui" and "CControls", the free native library
"PToolboxLib.prc" and the free font database "Ants-XS.pdb". My thanks go to the
programmers/creators of this softwares/databases. See reference information at the end of
this document.
My thanks go also to Jeremy and Kevin from OrbWorks for developing PocketC, to Maxime for
developing CryptoPad (which I both used while programming Project Viewer on my daily way
to/from work via Berlin suburban trains the last half year) and to the developers of PRCedit
(www.individeo.net).
Thank to Nelson Ferreira (nelsonf@brturbo.com) ProjectViewer is available in Portuguese now!


VIII. Recommended Software

I do recommend some software in the documentation file that is not owned nor developed or
supported by me. Please check the following information about these 3rd party programs.

DB
This free (GPL-ed) program is in development, but has already a stable interface for
importing/exporting  several database formats - including its own. The format supported by
Project Viewer is the DB 0.2.x format which is not the current one, but the tools continue to
support this format. Please check http://sourceforge.net/projects/palm-db-tools/ for updates,
the import/export tools and support if desired. I thank Tom Dyas for developing this
software.

Afterburner III
I'm (of course) registered user of Afterburner III. If you get used to this hack you wan't
miss speeding up your Palm even in simple applications - as you will see a difference on
every action. I was lucky to be able to overclock my Palm IIIx to 45MHz and above (but above
doesn't seem to add any speed) and my m505 runs on 52MHz, but has problems with font painting
sometimes. Check the Afterburner III documentation! Because overclocking is not recommended
by Palm Inc. and you may lose your manufacturer warranty! Check PalmGear for updates of
Afterburner III - and register if you would like to use all features and support Daniel
(danwee@cyberway.com.sg).

X-Master
This programs in general does the same as HackMaster from Edward Keyes - it manages Palm OS
system extensions (aka Hacks). But it is better in some way and it is free. X-Master is
required to run Afterburner III. Please check the homepage http://linkesoft.com/ for updates
and support. I thank the programmer(s) of LinkeSoft.

PalmPrint
This software is required to use the recently added printing capabilities of ProjectViewer.
The program is available in two versions: "PalmPrint" (including user interface) and "SCS
Print Server" (no user interface, cheaper than PalmPrint). ProjectViewer requires the "SCS
Print Server" for printing, but works the same way with PalmPrint. Visit
http://www.stevenscreek.com/ for more.


IX. Reference information

DBiced - Icon Editor

Modifications by me:
	-  Changed name of the icon memo from "DATBK3" to "PVicons"
	-  Term "DBiced" has been changed to "DBiced for PV" in all texts and menues

Legal statement of the author: DBiced is free!

Contact: http://www.inertron.com/

____________________

CControls

Modifications by me:
	-  When setting the current selection (Csetcursel) in a dropdown the current shown
	part of the dropdown is "scrolled" down so the selection is visible (paying attention
	to the scroll steps).
	-  Text fields which are longer than 80 characters raise a warning message as the
	getsd() function of PocketC does not support longer text
	-  Added support for ProjectViewer icons (=two DateBk3 icons) in dropdowns (kinda
	slow momentary, but works)
	-  Replaced getsd() function with getsm() function for multi-line text input without
	the 80 character limit (to 256)
	-  Added color support for most GUI elements (was not that simple, as inverting a
	marked item does not lead to white text on blue ground)
	-  Cdestroy() command does now delete the control completely

Legal statement of the author: CControls and CEditor can be used for free. I am a freelancing
consultant and these programs are part of my "active advertising".
The only "price" for the usage of CControls is that you may mail me a copy of an interesting
application which you have programmed using CControls (it would be great to see what can be
done with PocketC and CControls).

Contact: http://www.mscon.de/

____________________

PocketGui 1.2

Modifications by me:
	-  When setting the current selection (GSelect) in a list the current shown part of
	the list is "scrolled" down so the selection is visible (paying attention to the
	scroll steps).
	-  Added support for hard keys when scolling through lists.
	-  Marks only an item if one has been selected before.
	-  Minor design adjustments for Project Viewer Main screen.
	-  List entry interface assimilated (resistance was futile :-) - uses an internal
	table of Project Viewer now.
	-  Adjusted dropdowns to show the selected value right oriented
	-  Added color support for all used GUI elements (was not that simple, as inverting a
	marked item does not lead to white text on blue ground)

Legal statement of the author: PocketGui comes as source code. You are welcomed to include it
into any applications written for your personal use for free. If you want to use it in
compiled form in an application which is sold, used commercially or distributed as shareware,
you must send me a registered copy of your application.

Contact: http://www.geocities.com/siliconvalley/orchard/1936/

____________________

PToolboxLib.prc

Legal statement of the author: I am making the Pocket Toolbox Library freely available to the
general public. You may use it in a commercial product, but you may not sell the library. If
you do use it in any publicly available commercial or freeware product, please give me
(Joseph Stadolnik) due credit and please include a link to this web page in your
documentation. The Pocket Toolbox Library comes with absolutely NO WARRANTY of any kind. I
cannot be held liable for any data loss or damage to a system resulting from the use of this
library.
As for payment for my efforts, I only request that you send me a complementary copy of any
software that you publicly release which uses the Pocket Toolbox Library.


Contact: http://www.geocities.com/retro_01775/PToolboxLib.htm

____________________

Ants-XS.pdb

Legal statement of the author: For freeware it's free, of course.

Contact: http://www.rainerzenz.de/palm/alphafonts.html


X. Legal Disclaimer for Project Viewer and all related documents

THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING (BUT NOT
LIMITED TO) THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES INCLUDING (BUT NOT LIMITED
TO) PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, LOSS OF USE, DATA OR PROFITS; OR BUSINESS
INTERRUPTION HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

***
