home *** CD-ROM | disk | FTP | other *** search
/ PDA Software Library / pdasoftwarelib.iso / PILOT / database / COMMUTE / COMMUTE.TXT < prev    next >
Encoding:
Text File  |  1997-09-17  |  11.5 KB  |  322 lines
  1.  
  2.     Commute is THE application for the Palm Pilot for managing your schedules.
  3.     Bus, train, ferry, whatever.  With Commute you'll always know when
  4.     that next bus leaves and what train it will connect with.
  5.  
  6.     Commute is shareware.  Registration is US $10.    If you use it,
  7.     please register.  At this time I am only able to accept payment
  8.     via normal postal mail.  I will be setting up some means of
  9.     registering online, probably Kagi, but until then you can send
  10.     registrations to:
  11.  
  12.                     Michael Koehler
  13.                     2886 Cleveland Avenue
  14.                     Oceanside, NY  11572
  15.                     USA
  16.  
  17.     Comments and suggestions can be sent to koehler@liii.com
  18.  
  19.  
  20. Entering your Schedules:
  21.  
  22.     Commute is very boring until you enter your schedules.    There are two
  23.     ways to do this at this time.  You can enter them directly on your
  24.     Palm Pilot or you can import them using a DOS utility call MakeSchd.exe.
  25.  
  26.  
  27. Entering Schedules Using Graffiti:
  28.  
  29.     It's not as bad as it sounds.  Besides, this way you can put that
  30.     commuting time to good use.
  31.  
  32.     To create a new schedule, simply tap the New button on the main form.
  33.     A dialog will appear asking you to provide some information about
  34.     the schedule:
  35.  
  36.         Name:    Just a name for the schedule to go by.    Name it
  37.                 something that is meaningful to you.
  38.  
  39.         From:    Name the place this bus/train/whatever leaves from.
  40.  
  41.         To:     Name the place this bus/train/whatever goes to.
  42.  
  43.         Dates:    You can enter a start and end date for the schedule
  44.                 here.  This is used by the Filter on Time of Year
  45.                 option.  Leave it blank if this schedule is
  46.                 useful all year.
  47.  
  48.         Times:    You can enter a start and end time for the schedule
  49.                 here.  This is used by the Filter on Time of Day
  50.                 option.  This is useful for hiding "morning"
  51.                 schedules in the evening and vice-versa.
  52.                 You can leave it blank if you want.
  53.  
  54.         Days:    Indicate what days of the week this schedule
  55.                 is good for by highlighting those days.
  56.                 This is used by the Filter on Day of Week
  57.                 option.  If none are selected it is
  58.                 treated as is all are selected.
  59.  
  60.     Fill in the information and tap Done.
  61.  
  62.     Now you need to create the list of departures and arrivals.  Tap New
  63.     to add a departure.  Fill in both departure and arrival times.    The
  64.     software is somewhat flexible when it comes to entering the times.
  65.     All of the following are equivalent:
  66.  
  67.     1:36pm
  68.     1:36p
  69.     13:36
  70.     1.36pm
  71.     1.36p
  72.     13.36
  73.     1336
  74.  
  75.     In addition, the following are equivalent:
  76.  
  77.     1:00p
  78.     1.00p
  79.     1300
  80.     13
  81.  
  82.     Just choose the method you like best.
  83.  
  84.     For arrival times, you can also enter the time as +23 meaning that the
  85.     arrival happens 23 minutes after departure.
  86.  
  87.     After entering the departure and arrival times, you may enter a short
  88.     note.  For example, this train might require a transfer.  Leave it blank
  89.     if you like.  Tap Done when you're ready.
  90.  
  91.     Simply repeat this process for each of the departures.    When you are
  92.     entering more than one new departure you can save a tap by tapping the
  93.     New button instead of the Done button on the Departure dialog.    It is
  94.     the same as tapping Done and then New.
  95.  
  96.     If you are entering departures that occur at a regular interval you
  97.     can enter them like this:
  98.  
  99.         Leaves:  17-20+15
  100.         Arrives: 23
  101.  
  102.     Entries will be created for departures starting at 17:00 (5pm) until
  103.     20:00 (8pm) at 15 minute intervals.  Arrivals will start at 23:00
  104.     (11pm) and also continue at 15 minute intervals until 02:00 (2am).
  105.     You can also make the arrivals arrive every 10 minutes by entering
  106.     23+10, but I can't picture how that would happen in real life.
  107.  
  108.     Another variant would be:
  109.  
  110.         Leaves:  17-20+15
  111.         Arrives: +60
  112.  
  113.     Entries will be created for departures starting at 17:00 (5pm) until
  114.     20:00 (8pm) at 15 minute intervals.  Arrivals will start at 18:00 (6pm)
  115.     and also continue at 15 minute intervals until 21:00 (9pm).
  116.  
  117.  
  118.  
  119. Importing/Exporting Schedules On Your PC Using MakeSchd:
  120.  
  121.     MakeSchd.exe is a DOS utility that imports schedules into Commute's
  122.     database: SchedDB.pdb.    It can also export them back out.
  123.  
  124.     Getting a copy of SchedDB.pdb:
  125.  
  126.     SchedDB.pdb is the name of Commute's schedule database on the Palm Pilot.
  127.     To get a copy of an existing SchedDB.pdb file for importing or exporting
  128.     just HotSync.  The SchedDB.pdb file will be saved in the
  129.     \pilot\username\backup directory (where username is your username).  After
  130.     importing schedules you can replace the copy on your Palm Pilot using
  131.     the Palm Pilot Install Tool.
  132.  
  133.     MakeSchd.exe does not require that you already have a SchedDB.pdb file.
  134.     If you import schedules and the SchedDB.pdb file does not exist, it will
  135.     create one.
  136.  
  137.     Importing:
  138.  
  139.     MakeSchd.exe imports schedules from a text file, adding them to the
  140.     database.  For an example of what the text file must look like, see the
  141.     import.txt file included in the .zip file.
  142.  
  143.     Once you have some schedules in a text file, you can add them to the
  144.     SchedDB.pdb file with this command at a DOS prompt:
  145.  
  146.         makeschd -i SchedDB.pdb import.txt
  147.  
  148.     The -i tells MakeSchd to import.  SchedDB.pdb is simply the name of the
  149.     file that contains the database.  If it is in another directory you need
  150.     to provide the full name of the file including it's path.  Finally
  151.     import.txt is just the name of the text file that contains the schedules
  152.     to import.
  153.  
  154.     An important note:    If you import a schedule that has the same Name,
  155.     From name, and To name as one that is already in the database, it will
  156.     replace the one that is in the database.
  157.  
  158.     Exporting:
  159.  
  160.     MakeSchd can also convert the schedules in a SchedDB.pdb file into
  161.     text form.    You export using this command at a DOS prompt:
  162.  
  163.         makeschd -e SchedDB.pdb export.txt
  164.  
  165.     The -e tells MakeSchd to export.  SchedDB.pdb is simply the name of the
  166.     file that contains the database.  If it is in another directory you need
  167.     to provide the full name of the file including it's path.  Finally
  168.     export.txt is just the name of the text file that you want the schedules
  169.     written to.
  170.  
  171.  
  172. Settings:
  173.  
  174.     These settings are reached by tapping Menu, then Options, then Settings.
  175.  
  176.     When you're trying to get someplace, you need to find schedule
  177.     information quickly.  Commute can help you by hiding schedules.
  178.     You can enable hiding schedules based on the day of the week, the
  179.     time of day, and the time of year.
  180.  
  181.     In addition, you can choose what is shown in the third column of
  182.     the main screen.  By default the departure's note is shown.  You
  183.     may choose to display the schedule's To or From name instead.
  184.  
  185.  
  186. Usage:
  187.  
  188.     Now that your schedules have been entered you can start to use it.
  189.  
  190.     When you start Commute it will list all the schedules and the next
  191.     departure time for each schedule.  Commute automatically updates
  192.     the list of current departures every 15 seconds.
  193.  
  194.     If the departure is too soon for you to catch it, tap on the + to see
  195.     when the next departure is.  You can work backward by tapping the -,
  196.     or come back to the current time with Now.
  197.  
  198.     Tapping a schedule will bring up that entire schedule scrolled to that
  199.     departure.    This allows you to see all the following departures, as well
  200.     as their arrival times.
  201.  
  202.     The Conn button on the Schedule form allows you to see the list of
  203.     current departures that connect with this schedule.  Commute determines
  204.     connections by comparing the To and From names.  Tapping the Main
  205.     button will return you to the main form.
  206.  
  207.  
  208. Improvements:
  209.  
  210.     Please send comments and suggestions to koehler@liii.com.  You will
  211.     find my current list of improvements in progress at Commute's home
  212.     page (http://www.liii.com/~koehler/pilot.htm).
  213.  
  214.  
  215. The following is a list of changes made to Commute:
  216.  
  217. Changes made in v1.2:
  218.  
  219.     1) Schedules may now have up to 200 departures. If you need more,
  220.        just ask.
  221.     2) Optional column titles
  222.     3) Arrival time can now be displayed on the Main form instead of
  223.        From, To, or Note.
  224.     4) Tapping an arrival time in the Schedule form will show connections
  225.        for that arrival.
  226.     5) Arrival time can be entered as +11, meaning that the arrival is 11
  227.        minutes after departure.
  228.     6) The SMTWTFS flags on the Schedule Detail dialog will now display as
  229.        MTWTFSS if you have set your Palm Pilot to start the week on Monday.
  230.     7) The clock has been moved as far right as it will go.
  231.     8) A few odd bugs have been corrected.
  232.  
  233. Changes made in v1.10:
  234.  
  235.     1) Added option to sort schedules.
  236.     2) Added "Conn" button to Departure Detail dialog.  Tapping it
  237.        will display a list of connections for that departure.
  238.     3) Added a confirmation dialog when deleting a schedule.
  239.     4) Tapping the third column of the list of schedules will change the
  240.        information in that column from Note of the departure,
  241.        to From name, to To name and then back again.
  242.     5) Corrected all the bugs that have been reported to me as well as
  243.        a few that I found myself.
  244.     6) Added a DOS utility, MakeSchd, to the package for importing and
  245.        exporting schedules to/from SchedDB.pdb on the PC.
  246.  
  247. Changes made in v1.00:
  248.  
  249.     1) Added option to display To or From name on main form.
  250.     2) Added Conn button to schedule form..
  251.     3) Added Adjust Times menu option.
  252.     4) Fixed scrolling on main form.
  253.  
  254. Changes made in v0.97:
  255.  
  256.     1) Added Go Top, and Go Bottom to Edit menu
  257.     2) Added fields to the Schedule detail dialog.
  258.        You can now specify during what time of day
  259.        and of year you most care about this schedule.
  260.        This is used for filtering the list of
  261.        current departures.
  262.  
  263.        I have also added From name and To name fields.
  264.        These are not used for anything yet, but I plan
  265.        to use them in the next release
  266.     3) Added options to filter schedules on time of day
  267.        and time of year.
  268.     4) Added ability to enter departures that occur
  269.        at regular intervals.  So now you can to this:
  270.  
  271.        Leaves:    17-20+15
  272.        Arrives: 23
  273.  
  274.        And entries will be created for departures starting
  275.        at 17:00 (5pm) until 20:00 (8pm) at 15 minute intervals.
  276.        Arrivals will start at 23:00 (11pm) and also continue
  277.        at 15 minute intervals until 02:00 (2am).  You could
  278.        make the arrivals arrive every 10 minutes by entering
  279.        23+10, but I can't picture how that would happen
  280.        in real life.
  281.  
  282. Changes made in v0.96:
  283.  
  284.     1) Fixed a bug where day of week settings were not saved
  285.        unless a departure was added or changed.
  286.     2) Changed Menus.  Added Edit menu with Cut, Copy, Paste, etc.
  287.  
  288. Changes made in v0.95:
  289.  
  290.     1) Fixed bug that corrupt schedules during some edits
  291.     2) Added support for entering times as 0700, 0815, like that.
  292.     3) Added support for the down-up and up-down strokes for
  293.        moving between fields on the departure dialog
  294.     4) Departure list will update every 15 seconds.
  295.  
  296.        Note that the auto update does not work when the Palm Pilot
  297.        is off.    So if the list of current departures is showing
  298.        when you turn the Palm Pilot on, the information is probably
  299.        old.  Tap the now button to get up to date information.
  300.        It will update by itself after about 30 seconds.
  301.  
  302. Changes made in v0.94:
  303.  
  304.     1) Fixed bug where the next departure was not always selected.
  305.     2) Schedule list now automatically scrolls up as you add new entries.
  306.     3) Prev/Next now work properly and wraps around at the beginning and
  307.        end of the schedule.
  308.     4) If you leave a departure or arrival time blank it stays blank
  309.        rather than being taken as 12:00am.
  310.     5) Times are now displayed per your selection in the Palm Pilot's
  311.        Preferences.
  312.     6) Added a clock in the upper right of the screen so you can see what
  313.        time it is.
  314.     7) Scrolling the lists doesn't flash so much anymore.
  315.     8) Added New button to the Departure dialog.  Thanks to Greg McMullan
  316.        for the idea.
  317.  
  318.  
  319. Mike Koehler
  320. koehler@liii.com
  321. 9/16/1997
  322.