













                                Perfect Timing
                                Perfect Timing

                                  Version 0.7

                                      By

                                Chor-ming Lung
                                Chor-ming Lung

































                      SideKick (c) Borland International
















 Perfect Timing V0.7           By Chor-ming Lung                  June 22, 1989


     Preface:
     _______
               I have  used some  of the  Side-Kick typed programs on my ST
          and I do not feel satisfactory with them.  When I  was working on
          SHEET  last  year,  I  wrote  some codes for the calendar program
          which is pre-released version of Perfect  Timing. I  dropped this
          project because SHEET occupied all my time.

               After one and half year spent on SHEET, I started to work on
          this old project again and named it Perfect  Timing (or  PT). The
          current version  is 0.7 because PT is not done. Even though it is
          not finished, I feel it is still quite useful.

               This is the first in a series of productive programs  I plan
          to  work   on  for  ST.  Each  program  will  cost  you  $10  for
          registration. If you love to support  them, please  send your $10
          donation to me. My address is:

                              Mr. Chor-ming Lung
                             34 S. Russell ST, #1A
                               Boston, MA 02114
                                    U.S.A.


     Disclaimer:
     __________
               I  have  made  every  effort  to  insure the accuracy of the
          program. However, there is no warranty either express  or implied
          for its uses.


     Requirements:
     ____________
          * Atari ST/Mega ST
          * Monochrome or color monitor
          * PTxx.PRG  (xx is version number, currently it is 07 -- version 
            0.7)
          * You must know how to operate with GEM




















                                    Page 1









 Perfect Timing V0.7           By Chor-ming Lung                  June 22, 1989



     Introduction:
     ____________
          The idea  of PT  is not  new. It  is generated  from the Calendar
     program on  Side-kick. PT  is a  calendar, diary, memopad, appointment
     book and anniversary marker.
          When PT is booted, the current month will  be displayed.  You can
     change your calendar by mouse click.
          Diary is intended for keeping your daily record. Before you type,
     you should select the  date for  your input.  By default,  the current
     date will  be slected  by PT. To change a date, you should change your
     calendar first.
          Memopad is intended for writing reminder for coming events. There
     is no link between memo and date.
          Appointment  book  is  intended  to  link date, time and upcoming
     events. It is not implemented yet!
             _________________________
          Anniversary marker is intended to mark  dates for  annual events.
     It is not implemented yet!
     _________________________
          PTPRINT.PRG is  used to  print diary  or memo files. You can also
     change the default directory of PT07.ACC!

          NOTE:     PT is intended  to  be  ACC,  so  all  the  options are
                    crowded on the upper half of the window.


     Bug Fix:
     _______
               There is  a serious  bug in  version prior  to 0.7. When you
          move the editing area by vertical slider, the  content of current
          line is incorrectly changed. It has been fixed.

     New Features:
     ____________
          -    Whenever you  close the window, the content of your diary or
               memo files will be  saved automatically.  In case  of system
               crash, your record is saved.
          -    Load option  allows you to load different memo file or diary
               files for  different months.  It keeps  thing more organized
               and use less memory.
          -    Searching for a string is possible now.
          -    PTPRINT.PRG to  change default  directory for storing MEM or
               DIA files. It also prints content of those files.

     Calendar:
     ________
               When PT is booted, the current month of current year will be
          displayed.

               To change the month:
                 -  move the mouse cursor over the month desired
                 -  press the left button on your mouse

               To increase or decrease the year number by one:
                 -  move the mouse cursor over the year number desired
                 -  press the left button on your mouse.

               To go back to current month of current year:
                 -  press the <Home> key.

                                    Page 2









 Perfect Timing V0.7           By Chor-ming Lung                  June 22, 1989


               Whenever you change the month or the year, the calendar will
          update to display the desired month.


     Diary:
     _____
               When PT is booted,  the current  date will  be selected. The
          middle box  will show  the date being selected. To select another
          date for your input:
                 -  change the calendar by the method mentioned above.
                 -  move the mouse cursor over the day desired
                 -  press the left button on your mouse

               Whenever you change the  date, the  middle box  will reflect
          its change.If  that date has some messages stored, those messages
          will be placed on the editor. Otherwise, the editing area will be
          cleaned up for new messages.

            NOTE1:  The current date is displayed in italic style.
            NOTE2:  The date  which has something stored in it is displayed
                    in light style.


     Memo:
     ____
               When PT is booted, Diary is selected. If you want to use the
          memopad, you  should move  the mouse over Memo and press the left
          button. Since memo has nothing to do with date, you cannot change
          or select a new date by the method mentioned on Diary.


     Editor:
     ______
               The  editing  area  of  PT  occupies  the  lower half of the
          window. The  editing cursor  can be  moved by  arrow keys, shift-
          arrow keys, mouse click and vertical slider bar.

          Arrow keys:
               Up:       move one line up.
               Down:     move one line down.
               Left:     move one character left.
               Right:    move one character right.
          Shift with arrow keys:
               Up:       move  one  page  up  (on  mono,  11 lines/page; on
                         color, 10 lines/page).
               Down:     move one page down.
               Left:     move editing cursor to  the  beginning  of current
                         line.
               Right:    move editing cursor to the end of current line.
          Mouse click:
               - move the mouse cursor to the desired position
               - press the left button on the mouse.
          Vertical slider bar:
               move the vertical bar slider to the desired position.
          <Undo>:
               The  Undo  key  can  be  used  to throw away current editing
               session. After <Undo>, you should change the contents of the
               editor by  selecting another  date or by moving from Memo to
                                    Page 3









 Perfect Timing V0.7           By Chor-ming Lung                  June 22, 1989


               Diary or vice versa.
          <ALT_S>:
               The ALT_S (press Alternate and S simultaneously) is used for
               searching  a  string.  It  is case-insensitive. It means the
               search method does not care about  upper or  lower case. For
               example,  if  you  want  to  find out which date contain the
               person  Tim,  you  can  press  <ALT_S>.  The  current editor
               content  will  be  saved  and  a  string  "Search:"  will be
               displayed, you can enter  TIM or  tim to  start your search.
               The date which contains this string will be displayed. NOTE:
               DO NOT CHANGE THE  STRING "Search:".  ADD YOUR  STRING AFTER
               IT.
          <ALT_N>:
               <ALT_S> defines  the string being searched, and you can keep
               searching the same string by pressing <ALT_N>.

     Improvements:
     ____________
          - Editor:      Tab is not working and character styles like bold,
                         italic  and  underline  are  not supported. Future
                         versions should provide those features.
          - Appointment: I  will   finish   the   print,   appointment  and
                         anniversary options in the future versions.

     File:
     ____
          PT.DIA:   Diary file of PT
          PT.MEM:   Memo file of PT

          - File format of PT.DIA:
             Record:
               - 2 bytes: Year
               - 2 bytes: Month
               - 2 bytes: Day
               - 2 bytes: Length of content of that date
               - defined by Length: actual content of that date.
             Last Record:
               - 2 bytes: 0
               - 2 bytes: 0
               - 2 bytes: 0
               - 2 bytes: 0

          - File format of PT.MEM:
               - 2 bytes: Length of memo
               - actual content of memo.












                                    Page 4









 Perfect Timing V0.7           By Chor-ming Lung                  June 22, 1989


                                  PTPRINT.PRG
                                  ___________


          PTPRINT is  the print  program for PT. PT07.ACC uses about 44k of
     your precious memory. To minimize memory consumption, the print option
     of PT a stand-alone program.

     Change default:
     ______________
          This option  changes the  default directory  of PT07.ACC. So, you
     can store your DIA and MEM files on a special folder.

          -    Select this option from the menu.
          -    Enter the  new path  for PT07.ACC  for looking  up PT.DIA or
               PT.MEM.
          -    Select the  PATCH data (PT07ACC.PAT or PT07PRG.PAT) from the
               file selector.
          -    Select the ACC or PRG  of  PT  for  changing  from  the file
               selector. The  new directory  will stored  on the ACC or PRG
               version of PT.

     PRINT:
     _____

          Dest:
          Dest
               Enter the destination of your output in here. It is supposed
               to be a file name. "PRN:" outputs to printer. "CON:" outputs
               to screen.
          Use:
          Use
               Select which kind of PT files.  If  you  want  to  print DIA
               file, you should select Diary.

               If you want to print DIA file, you should enter the range of
               dates in the editing  field Date  from and  Date to.  Skip 2
                                           Date  from      Date to   Skip
               means skip  2 blank  lines for each different date. Indent 2
                                                                   Indent
               means 2 characters indention.
          Page:
          Page
               Enter the width and  length which  your printer  can handle.
               Normally, they are 80 and 66 respectively.
          Margins:
          Margins
               Margins define the printable area on your paper.


          After  you  select  OK  from  the  Print Setup dialog, you should
                                             Print Setup
     select the desired file to be printed.












                                    Page 5






