
	Commute is THE application for the Palm Pilot for managing your schedules.
	Bus, train, ferry, whatever.  With Commute you'll always know when
	that next bus leaves and what train it will connect with.

	Commute is shareware.  Registration is US $10.	If you use it,
	please register.  At this time I am only able to accept payment
	via normal postal mail.  I will be setting up some means of
	registering online, probably Kagi, but until then you can send
	registrations to:

					Michael Koehler
					2886 Cleveland Avenue
					Oceanside, NY  11572
					USA

	Comments and suggestions can be sent to koehler@liii.com


Entering your Schedules:

	Commute is very boring until you enter your schedules.	There are two
	ways to do this at this time.  You can enter them directly on your
	Palm Pilot or you can import them using a DOS utility call MakeSchd.exe.


Entering Schedules Using Graffiti:

	It's not as bad as it sounds.  Besides, this way you can put that
	commuting time to good use.

	To create a new schedule, simply tap the New button on the main form.
	A dialog will appear asking you to provide some information about
	the schedule:

		Name:	Just a name for the schedule to go by.	Name it
				something that is meaningful to you.

		From:	Name the place this bus/train/whatever leaves from.

		To: 	Name the place this bus/train/whatever goes to.

		Dates:	You can enter a start and end date for the schedule
				here.  This is used by the Filter on Time of Year
				option.  Leave it blank if this schedule is
				useful all year.

		Times:	You can enter a start and end time for the schedule
				here.  This is used by the Filter on Time of Day
				option.  This is useful for hiding "morning"
				schedules in the evening and vice-versa.
				You can leave it blank if you want.

		Days:	Indicate what days of the week this schedule
				is good for by highlighting those days.
				This is used by the Filter on Day of Week
				option.  If none are selected it is
				treated as is all are selected.

	Fill in the information and tap Done.

	Now you need to create the list of departures and arrivals.  Tap New
	to add a departure.  Fill in both departure and arrival times.	The
	software is somewhat flexible when it comes to entering the times.
	All of the following are equivalent:

	1:36pm
	1:36p
	13:36
	1.36pm
	1.36p
	13.36
	1336

	In addition, the following are equivalent:

	1:00p
	1.00p
	1300
	13

	Just choose the method you like best.

	For arrival times, you can also enter the time as +23 meaning that the
	arrival happens 23 minutes after departure.

	After entering the departure and arrival times, you may enter a short
	note.  For example, this train might require a transfer.  Leave it blank
	if you like.  Tap Done when you're ready.

	Simply repeat this process for each of the departures.	When you are
	entering more than one new departure you can save a tap by tapping the
	New button instead of the Done button on the Departure dialog.	It is
	the same as tapping Done and then New.

	If you are entering departures that occur at a regular interval you
	can enter them like this:

		Leaves:  17-20+15
		Arrives: 23

	Entries will be created for departures starting at 17:00 (5pm) until
	20:00 (8pm) at 15 minute intervals.  Arrivals will start at 23:00
	(11pm) and also continue at 15 minute intervals until 02:00 (2am).
	You can also make the arrivals arrive every 10 minutes by entering
	23+10, but I can't picture how that would happen in real life.

	Another variant would be:

		Leaves:  17-20+15
		Arrives: +60

	Entries will be created for departures starting at 17:00 (5pm) until
	20:00 (8pm) at 15 minute intervals.  Arrivals will start at 18:00 (6pm)
	and also continue at 15 minute intervals until 21:00 (9pm).



Importing/Exporting Schedules On Your PC Using MakeSchd:

	MakeSchd.exe is a DOS utility that imports schedules into Commute's
	database: SchedDB.pdb.	It can also export them back out.

	Getting a copy of SchedDB.pdb:

	SchedDB.pdb is the name of Commute's schedule database on the Palm Pilot.
	To get a copy of an existing SchedDB.pdb file for importing or exporting
	just HotSync.  The SchedDB.pdb file will be saved in the
	\pilot\username\backup directory (where username is your username).  After
	importing schedules you can replace the copy on your Palm Pilot using
	the Palm Pilot Install Tool.

	MakeSchd.exe does not require that you already have a SchedDB.pdb file.
	If you import schedules and the SchedDB.pdb file does not exist, it will
	create one.

	Importing:

	MakeSchd.exe imports schedules from a text file, adding them to the
	database.  For an example of what the text file must look like, see the
	import.txt file included in the .zip file.

	Once you have some schedules in a text file, you can add them to the
	SchedDB.pdb file with this command at a DOS prompt:

		makeschd -i SchedDB.pdb import.txt

	The -i tells MakeSchd to import.  SchedDB.pdb is simply the name of the
	file that contains the database.  If it is in another directory you need
	to provide the full name of the file including it's path.  Finally
	import.txt is just the name of the text file that contains the schedules
	to import.

	An important note:	If you import a schedule that has the same Name,
	From name, and To name as one that is already in the database, it will
	replace the one that is in the database.

	Exporting:

	MakeSchd can also convert the schedules in a SchedDB.pdb file into
	text form.	You export using this command at a DOS prompt:

		makeschd -e SchedDB.pdb export.txt

	The -e tells MakeSchd to export.  SchedDB.pdb is simply the name of the
	file that contains the database.  If it is in another directory you need
	to provide the full name of the file including it's path.  Finally
	export.txt is just the name of the text file that you want the schedules
	written to.


Settings:

	These settings are reached by tapping Menu, then Options, then Settings.

	When you're trying to get someplace, you need to find schedule
	information quickly.  Commute can help you by hiding schedules.
	You can enable hiding schedules based on the day of the week, the
	time of day, and the time of year.

	In addition, you can choose what is shown in the third column of
	the main screen.  By default the departure's note is shown.  You
	may choose to display the schedule's To or From name instead.


Usage:

	Now that your schedules have been entered you can start to use it.

	When you start Commute it will list all the schedules and the next
	departure time for each schedule.  Commute automatically updates
	the list of current departures every 15 seconds.

	If the departure is too soon for you to catch it, tap on the + to see
	when the next departure is.  You can work backward by tapping the -,
	or come back to the current time with Now.

	Tapping a schedule will bring up that entire schedule scrolled to that
	departure.	This allows you to see all the following departures, as well
	as their arrival times.

	The Conn button on the Schedule form allows you to see the list of
	current departures that connect with this schedule.  Commute determines
	connections by comparing the To and From names.  Tapping the Main
	button will return you to the main form.


Improvements:

	Please send comments and suggestions to koehler@liii.com.  You will
	find my current list of improvements in progress at Commute's home
	page (http://www.liii.com/~koehler/pilot.htm).


The following is a list of changes made to Commute:

Changes made in v1.2:

	1) Schedules may now have up to 200 departures. If you need more,
	   just ask.
	2) Optional column titles
	3) Arrival time can now be displayed on the Main form instead of
	   From, To, or Note.
	4) Tapping an arrival time in the Schedule form will show connections
	   for that arrival.
	5) Arrival time can be entered as +11, meaning that the arrival is 11
	   minutes after departure.
	6) The SMTWTFS flags on the Schedule Detail dialog will now display as
	   MTWTFSS if you have set your Palm Pilot to start the week on Monday.
	7) The clock has been moved as far right as it will go.
	8) A few odd bugs have been corrected.

Changes made in v1.10:

	1) Added option to sort schedules.
	2) Added "Conn" button to Departure Detail dialog.  Tapping it
	   will display a list of connections for that departure.
	3) Added a confirmation dialog when deleting a schedule.
	4) Tapping the third column of the list of schedules will change the
	   information in that column from Note of the departure,
	   to From name, to To name and then back again.
	5) Corrected all the bugs that have been reported to me as well as
	   a few that I found myself.
	6) Added a DOS utility, MakeSchd, to the package for importing and
	   exporting schedules to/from SchedDB.pdb on the PC.

Changes made in v1.00:

	1) Added option to display To or From name on main form.
	2) Added Conn button to schedule form..
	3) Added Adjust Times menu option.
	4) Fixed scrolling on main form.

Changes made in v0.97:

	1) Added Go Top, and Go Bottom to Edit menu
	2) Added fields to the Schedule detail dialog.
	   You can now specify during what time of day
	   and of year you most care about this schedule.
	   This is used for filtering the list of
	   current departures.

	   I have also added From name and To name fields.
	   These are not used for anything yet, but I plan
	   to use them in the next release
	3) Added options to filter schedules on time of day
	   and time of year.
	4) Added ability to enter departures that occur
	   at regular intervals.  So now you can to this:

	   Leaves:	17-20+15
	   Arrives: 23

	   And entries will be created for departures starting
	   at 17:00 (5pm) until 20:00 (8pm) at 15 minute intervals.
	   Arrivals will start at 23:00 (11pm) and also continue
	   at 15 minute intervals until 02:00 (2am).  You could
	   make the arrivals arrive every 10 minutes by entering
	   23+10, but I can't picture how that would happen
	   in real life.

Changes made in v0.96:

	1) Fixed a bug where day of week settings were not saved
	   unless a departure was added or changed.
	2) Changed Menus.  Added Edit menu with Cut, Copy, Paste, etc.

Changes made in v0.95:

	1) Fixed bug that corrupt schedules during some edits
	2) Added support for entering times as 0700, 0815, like that.
	3) Added support for the down-up and up-down strokes for
	   moving between fields on the departure dialog
	4) Departure list will update every 15 seconds.

	   Note that the auto update does not work when the Palm Pilot
	   is off.	So if the list of current departures is showing
	   when you turn the Palm Pilot on, the information is probably
	   old.  Tap the now button to get up to date information.
	   It will update by itself after about 30 seconds.

Changes made in v0.94:

	1) Fixed bug where the next departure was not always selected.
	2) Schedule list now automatically scrolls up as you add new entries.
	3) Prev/Next now work properly and wraps around at the beginning and
	   end of the schedule.
	4) If you leave a departure or arrival time blank it stays blank
	   rather than being taken as 12:00am.
	5) Times are now displayed per your selection in the Palm Pilot's
	   Preferences.
	6) Added a clock in the upper right of the screen so you can see what
	   time it is.
	7) Scrolling the lists doesn't flash so much anymore.
	8) Added New button to the Departure dialog.  Thanks to Greg McMullan
	   for the idea.


Mike Koehler
koehler@liii.com
9/16/1997
