home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / busi / tikler.com / TIKLER.DOC < prev    next >
Text File  |  1989-09-17  |  25KB  |  490 lines

  1.  
  2.                               TIKLER
  3.                             Version 3.2
  4.                            by Dick Olsen
  5.  
  6.        Welcome  to  TIKLER.   TIKLER is an easy to use program that will
  7.        help you keep track of upcoming events.  It  is  intended  to  be
  8.        added  as the last item in your AutoExec.Bat file so that it will
  9.        be run automatically each time you turn on your computer.  TIKLER
  10.        displays the coming events for any number of days in the  future,
  11.        or  it can display events that have occurred during any number of
  12.        days  past  up  until  the  present.   It's  kind   of   a   note
  13.        taker/reminder/calendar  program  that you should find useful, if
  14.        not indispensable.  Unlike many commercial programs that  perform
  15.        similar  functions,  TIKLER  was  designed  to  be quick, easy to
  16.        learn, and free-form in its note entries. Chances  are  that  you
  17.        won't need to refer to this document in order to make full use of
  18.        TIKLER.   I suggest, however, that you read it in its entirety so
  19.        that you'll have a fuller understanding of the program.   If  you
  20.        have  a  color monitor, TIKLER displays today's events in yellow,
  21.        tomorrow's events in light green, and all other events in cyan on
  22.        your screen.  All functions only require a  single  keystroke  to
  23.        activate.   TIKLER  creates  and  maintains  a  file on your disk
  24.        called COMEVENT.  This is the default file that TIKLER  will  use
  25.        each  time it is run. Once TIKLER is running, you can change to a
  26.        different event  file  if  you  wish.  The  file  is  created  in
  27.        ordinary  text mode so that it can be edited with almost any word
  28.        processor program or editor, however, it is recommended that  you
  29.        use  the built in editor to make any changes. If you must edit an
  30.        event file with a word processing program,  BE  CAREFUL!  If  you
  31.        have  too  few  lines  or too many lines, TIKLER will be confused
  32.        when it reads the event file.
  33.  
  34.        When you first install and run TIKLER, you will be asked how many
  35.        days  notice  you  would like. What you enter here determines the
  36.        default number of days  that  TIKLER  will  look  ahead  to  find
  37.        events.  A  good  number  seems  to be 14 days, but you can enter
  38.        whatever you would like. Once you have specified  the  number  of
  39.        days  notice  you  would  like,  TIKLER will create a file in the
  40.        current directory called COMEVENT, which  is  the  default  event
  41.        file.  The  first entry in this file is the number of days notice
  42.        you have specified. This  number  can  be  changed  by  selecting
  43.        number  five  in  the FLUSH EVENT mode. Each time you enter a new
  44.        event, it will be added to the  COMEVENT  file,  or  to  whatever
  45.        event  file  is  currently active. TIKLER, beginning with version
  46.        3.0, also contains a simple 'what you see is what you get'  event
  47.        editor.  This  built  in editor makes it easy and fast for you to
  48.        change events or their dates.
  49.  
  50.  
  51.        If you have used older versions of TIKLER......CONVERT!
  52.  
  53.        If  you  have  used a version of TIKLER prior to version 3.0, and
  54.        you have an event archive file  (TIKARC.EVT)  created,  you  will
  55.        need  to  convert  it  to the new format required by version 3.1.
  56.        This is a simple process since a  program  is  provided  on  your
  57.        TIKLER   disk   to  do  this  for  you.  The  program  is  called
  58.        CONVARC.EXE. Copy it from the distribution disk to the  directory
  59.        on  your  hard  disk where TIKLER is installed. Then type CONVARC
  60.        and the program will take care of the conversion  for  you.  Once
  61.        the  conversion  has been made, don't do it again! No other files
  62.        should need to be changed.
  63.  
  64.  
  65.        While TIKLER is running, the bottom two  lines  of  your  display
  66.        will show eleven function keys. The operations performed by these
  67.        function keys are as follows:
  68.  
  69.  
  70.        F1 <EXIT>
  71.  
  72.        This key is pretty self explanatory. When pressed, it will return
  73.        to DOS at whatever directory TIKLER is installed in. You can  run
  74.        TIKLER  at  any time by changing to the directory where it is and
  75.        typing TIKLER. A batch file could be created that would  do  this
  76.        for you.
  77.  
  78.        F2 <add event>
  79.  
  80.        Press this key if you want to add an event to your  active  event
  81.        file.   TIKLER will ask you first for the date of the event, then
  82.        for the description  of  the  event.  You  can  enter  up  to  64
  83.        characters  for the event description, but it's best to keep your
  84.        entries as short as possible. The built in editor  will  truncate
  85.        all  events  so that the date plus the event text all fits on one
  86.        80 character line.  When entering the date of the event, you  can
  87.        use several formats. Some examples are shown below:
  88.  
  89.                           8/8/87
  90.                           08/08/87
  91.                           8/8
  92.                           8-8-1987
  93.                           8-08/1987
  94.  
  95.        In the above  examples,  TIKLER  will  add  missing  digits,  and
  96.        convert  the  "  -  "  characters to " / " characters so that for
  97.        August 8, 1987, TIKLER would convert the date as entered  in  any
  98.        of  the  above  formats  to  08/08/1987, if 1987 were the current
  99.        year. If the event date is going to occur in  the  current  year,
  100.        the  year  portion  of  the  date can be skipped by just pressing
  101.        enter.  TIKLER will get the year from DOS and add it for you.  If
  102.        you just press ENTER in response to  the  date  question,  TIKLER
  103.        will get the current date from DOS.
  104.  
  105.  
  106.        When adding events, there are two more special keys you should be
  107.        aware of.  One of these is the DITTO key. When you  press  the  "
  108.        key,  the  previously entered date or event string is copied. For
  109.        example, suppose you had a meeting every  Monday  morning.  After
  110.        you  add  this  event to TIKLER for the first time, simply change
  111.        the date then press " when you are asked to enter the event.  The
  112.        same  information  used in the previous event will be copied into
  113.        the current event, saving you lots of typing. The ditto  function
  114.        also  works on the date.  The other special key is the back-slash
  115.        (\). If TIKLER finds this character anywhere in either your  date
  116.        or your event entry, it will abort the saving of that event. When
  117.        events  are listed on the screen, TIKLER will get the appropriate
  118.        day of the week from DOS and print it next to the date.  As  each
  119.        event is entered, it is sorted by date before being added to your
  120.        event file. Beginning with version 1.80, the day of the week will
  121.        also be added to your event date as it is saved  in  your  active
  122.        event  file.  Compatibility  is  maintained  with  existing EVENT
  123.        files.
  124.  
  125.  
  126.        F3 <view past events>
  127.  
  128.        This  key  allows  you  to  temporarily change the NUMBER OF DAYS
  129.        NOTICE to some number of days in the past. For  example,  suppose
  130.        you  want  to  view  the  events  that occurred within the past 3
  131.        weeks. When TIKLER asks for the number of days  past,  you  would
  132.        enter 21. Now TIKLER will display events that happened during the
  133.        three  weeks  preceding  TODAY, as well as TODAY'S events. If you
  134.        have more events than TIKLER can fit on the screen,  TIKLER  will
  135.        pause  and  wait for you to press ENTER and then it will show you
  136.        the remaining events.
  137.  
  138.        F4 <list ALL events>
  139.  
  140.        When you press this key, all of the events from your ACTIVE EVENT
  141.        FILE  will  be  listed.   TIKLER  will pause at the end of a full
  142.        screen and wait for you to press the 'ENTER' key  before  showing
  143.        you the rest of the events in your file.
  144.  
  145.        F5 <search for event>
  146.  
  147.        Pressing this key will cause the message 'enter KEYWORD:'  to  be
  148.        displayed in a window on your screen. You can enter a single word
  149.        or  phrase  that  you want TIKLER to look for. TIKLER will search
  150.        your entire ACTIVE EVENT FILE for event descriptions that contain
  151.        your  keyword  or  words.   Each  event containing the keyword or
  152.        phrase will be displayed on your screen.
  153.  
  154.  
  155.        F6 <flush & MORE>
  156.  
  157.        Pressing the F6 function key will present you with  six  choices.
  158.        If  you  pick choice number 1, you will be asked for a date prior
  159.        to which events are to be deleted. You can use any  of  the  date
  160.        formats  specified  under the F2 key description.  After entering
  161.        the date, TIKLER will ask you if you would like  to  ARCHIVE  the
  162.        events that are to be deleted. If you answer "yes" or "y" to this
  163.        question,  TIKLER will delete all events that occurred before the
  164.        date you entered from your ACTIVE EVENT FILE file, but they  will
  165.        be added to a file called TIKARC.EVT in case you need to refer to
  166.        them at a later time. Answering "no" or "n" will cause the events
  167.        to be deleted without archiving them. Selecting choice number two
  168.        will  allow  you to selectively delete events one at a time. Each
  169.        event will be displayed sequentially until you press "e" to  exit
  170.        or  the  end  of  your ACTIVE EVENT FILE file is reached. As each
  171.        event is displayed, you can press "a" to flush the event but  add
  172.        it  to  your ARCHIVE, "f" to just flush it from your ACTIVE EVENT
  173.        FILE file, or any other key to keep it.  You can press "e" at any
  174.        time to stop flushing events. If you choose choice number  three,
  175.        TIKLER will ask you for a date.  You can enter the date in any of
  176.        the  formats described under the F2 key description.  TIKLER will
  177.        then search your ACTIVE EVENT FILE file for events that  have  or
  178.        will  occur on that date, and display them one at a time. As each
  179.        event is displayed, you can enter "a" to flush the event but  add
  180.        it  to your ARCHIVE, "f" to just flush the event, "e" to exit the
  181.        flush mode, or any other key to continue searching for  the  date
  182.        you  entered. Choice number four will give you the opportunity to
  183.        delete ALL of the events in your ACTIVE EVENT FILE file.  If  you
  184.        answer  "y" when asked "are you sure ?", TIKLER will give you the
  185.        choice of adding the flushed events to  your  ARCHIVE  or  simply
  186.        deleting  them  ALL. Any other response will get you out of flush
  187.        mode. Choice number five really has nothing to do  with  flushing
  188.        events.  This  choice  allows you to change the default NUMBER OF
  189.        DAYS NOTICE that is used each time TIKLER is run. Just answer the
  190.        question, and TIKLER will do the rest.
  191.  
  192.        Choice  number  six, CHANGE EVENT FILE, is something new that was
  193.        added  at  version 3.0. Selecting it allows you to change from or
  194.        to the default event file, COMEVENT, or to some other event  file
  195.        that is compatible with TIKLER. If you enter the name of an event
  196.        file that does not exist, TIKLER will give you the opportunity to
  197.        create it. If TIKLER finds the event file you have specified, all
  198.        succeeding activity will be done to that file. If you ARCHIVE any
  199.        events  from  this  new  file,  they  will still be added to your
  200.        TIKARC.EVT file.
  201.  
  202.  
  203.        If  you  have  used  versions of TIKLER prior to version 3.0, you
  204.        will find that the older TIKARC.EVT files are not compatible with
  205.        those created by version 3.1. However, the TIKLER disk contains a
  206.        conversion program called CONVARC.EXE which will convert your old
  207.        TIKARC.EVT file to the new format required by version  3.1.  Once
  208.        the  conversion  is  made, the TIKARC.EVT file can be edited just
  209.        like  any  other  event  file  using  the  built  in  edit  mode.
  210.        Therefore, it is suggested that you perform this conversion prior
  211.        to running version 3.1. The ARCHIVE file created by TIKLER can be
  212.        viewed  by  any  text  editor or word processing program.  If you
  213.        decide to edit it, or any other TIKLER event  file,  BE  CAREFUL!
  214.        Make sure you retain the same format as the original file.  Extra
  215.        lines can cause strange looking displays! Instead of using a word
  216.        processor or text editor, it is suggested  that  you  change  the
  217.        ACTIVE  EVENT FILE file as described above, then use the built in
  218.        editor to preserve compatibility. If you decide to  ARCHIVE  some
  219.        of your events, TIKLER will create the ARCHIVE file for you.  The
  220.        name  of the file created is TIKARC.EVT. All archived events will
  221.        be added to this file regardless of what your ACTIVE  EVENT  FILE
  222.        is.
  223.  
  224.        F7 <find a date>
  225.  
  226.        When  you press this key, you will be asked for the date that you
  227.        want to find. TIKLER will search through your ACTIVE  EVENT  FILE
  228.        file  and  display all events that match the date you've entered.
  229.        You  can  enter  the  date  in  any  of  the  formats  previously
  230.        described.
  231.  
  232.  
  233.        F8 <print events>
  234.  
  235.        When you press this key, TIKLER will ask you if you want to print
  236.        all events, or only those events within the number of days notice
  237.        you  have  specified.  The  events from the ACTIVE EVENT FILE are
  238.        printed in order of date. Don't forget that you can also  use the
  239.        DOS  print  screen command. It will print whatever you see on the
  240.        screen by pressing SHIFT-PRTSC.
  241.  
  242.        F9 <change number of days notice>
  243.  
  244.        This key will allow you to change how far  ahead  (or  back)  you
  245.        want  TIKLER to look for events. The change is only temporary and
  246.        will not be saved to your file. You may  want  to  view  all  the
  247.        events that are scheduled for the next month (meetings, birthdays
  248.        etc.).  Just press the F9 key and enter 30 for the number of days
  249.        notice. TIKLER will immediately look for the events for the  next
  250.        30 days and display them for you. TIKLER can also show you events
  251.        that  occurred  before  the  current  date by entering a negative
  252.        number for the number of days notice. For example, if you were to
  253.        enter '-7', TIKLER would find  and  display  the  events  of  the
  254.        previous  week.  You can change the number of days notice as many
  255.        times as you wish, but TIKLER will always use the  default  value
  256.        from  your  ACTIVE  EVENT FILE file each time you run it.  If you
  257.        want to change the default number of days  notice,  use  F6,  the
  258.        flush mode key.
  259.  
  260.  
  261.        F10 <list again>
  262.  
  263.        This key will list the events again, based on the current  number
  264.        of days notice.
  265.  
  266.  
  267.        ALT-E <EDIT MODE>
  268.  
  269.        The built in editor is a new feature  added  at  the  release  of
  270.        version  3.0.  It  is  something  many people have asked for. The
  271.        editor  is  a  WYSIWYG  (what-you-see-is-what-you-get)  type   of
  272.        editor.  This  means  that  once you have an event edited to your
  273.        satisfaction on the screen, it will be saved to your ACTIVE EVENT
  274.        FILE  just  as  it appears on the screen. TIKLER will recalculate
  275.        the day of the week for you if you change the date.
  276.  
  277.        To invoke the editor, just press ALT-E (hold  down  the  ALT  key
  278.        while you press the E key). TIKLER will then enter the EDIT mode,
  279.        and  display  a screen full of events from the event file you are
  280.        currently using.  A hilite bar will appear  at  the  first  event
  281.        listed  on your screen. This bar is used to select the event that
  282.        you want to edit. Use the UP or DOWN arrow keys to move  the  bar
  283.        up  or  down one event at a time, or you can use the PGUP or PGDN
  284.        keys  to  move a page at a time through your event file. The HOME
  285.        key will move the bar to the beginning of the file, and  the  END
  286.        key will position it at the end of the event file.
  287.  
  288.        Edit  mode  can be aborted without saving the changes made during
  289.        the CURRENT EDIT SESSION by pressing ALT-A.
  290.  
  291.        The bottom three lines of your  screen  will  change  to  display
  292.        what  keys  perform  what  while in edit mode. When you exit edit
  293.        mode, these  lines  will  be  replaced  by  the  general  command
  294.        function  keys. After you have positioned the hilite bar over the
  295.        event you want to edit, use the  left  or  right  arrow  keys  to
  296.        position the cursor where your change is to be made. Pressing the
  297.        DEL  key  will delete the character at the cursor, while pressing
  298.        any other key will cause that character to  be  inserted  at  the
  299.        cursor  position.   You  cannot delete any characters in the date
  300.        field or the day-of-week field because  this  will  mess  up  the
  301.        event  file.   You  can  however,  change  the  date, but not the
  302.        day-of-week.  If the hilite bar is positioned over an  event  you
  303.        want  to  delete,  pressing  ALT-D  will  delete  it.  ALT-I will
  304.        increment the year of the event by  one.  As  mentioned  earlier,
  305.        TIKLER will compute a new day-of-the-week for you if you change a
  306.        date.
  307.  
  308.        When you have finished editing all of  the  events  you  want  to
  309.        change, press ESC to exit the EDIT MODE, and your event file will
  310.        be  updated to reflect the changes you have made. You can edit as
  311.        many events as you like while in edit mode, since all changes are
  312.        made to your event file at the end of the edit session.
  313.  
  314.  
  315.  
  316.        ALT-C Show Calendar
  317.  
  318.        When  you  are  in EDIT MODE or at the main  command  level,  you
  319.        can  pop a calendar on the screen by pressing ALT-C. The calendar
  320.        will show the current month, with the  current  date  hilited  in
  321.        yellow.  While  the  calendar is displayed, pressing the UP arrow
  322.        key will show you the previous month, the  DOWN  arrow  key  will
  323.        show  the  next month, the LEFT arrow key will show the currently
  324.        displayed month of the previous  year,  and  pressing  the  RIGHT
  325.        arrow  key will display the currently displayed month of the next
  326.        year.  Pressing ESC will erase the calendar from the screen.  The
  327.        calendar   is   not  operational  while  any  other  windows  are
  328.        displayed.
  329.  
  330.        The  range  of the calendar is limited by DOS. It will display as
  331.        far back as 1/1/80 and as far ahead as December 2099.
  332.  
  333.  
  334.        Installing TIKLER
  335.  
  336.        To install TIKLER on your computer, first change to the directory
  337.        in  which  you  want  it  installed. Then simply copy it from the
  338.        floppy disk to the current directory. Once you've copied it, just
  339.        type 'TIKLER', and your COMEVENT file will  be  created,  with  a
  340.        default number of days notice set for whatever number of days you
  341.        entered  when  asked  to  do so. TIKLER will run, and display the
  342.        message 'there are no coming events...'. At this point,  you  can
  343.        begin entering your events with the F2 key. If you  have  used  a
  344.        version  of  TIKLER  prior  to 3.0, you will need to convert your
  345.        ARCHIVE FILE  (TIKARC.EVT)  to  the  newer  format.  Instructions
  346.        describing how to do this appear earlier in this document.
  347.  
  348.        To  make TIKLER run each time you turn on your computer, just add
  349.        the TIKLER command to your  autoexec.bat  file,  similar  to  the
  350.        example shown below:
  351.  
  352.  
  353.                 CD\<directory where TIKLER is installed>
  354.                 TIKLER
  355.  
  356.        At  this  time,  TIKLER  is  limited to 300 events. The number of
  357.        events you have in your ACTIVE EVENT FILE file  is  displayed  on
  358.        the  top  line  of  the  screen and is updated anytime you add or
  359.        delete an event. If you exceed 290 events, TIKLER will remind you
  360.        that you are approaching the maximum of 300  events.  You  should
  361.        delete events that are no longer needed. This limit of 300 events
  362.        is  an  arbitrary  number that seems to satisfy the needs of most
  363.        people. I chose this value  in  order  to  save  disk  space  and
  364.        optimize  speed. Although TIKLER runs quite fast with 300 events,
  365.        the fewer you have, the faster it will run.
  366.  
  367.  
  368.  
  369.        A few extra words....
  370.  
  371.        TIKLER  is distributed under the concept of SHAREWARE. Under this
  372.        concept, you are free to use, copy and  distribute  this  program
  373.        without charge. You are not permitted to sell it either by itself
  374.        or  as part of a package. The author retains all of the rights to
  375.        the program. The idea of SHAREWARE is a good one. It helps us all
  376.        to obtain some really good software at a price we can all afford.
  377.        If the SHAREWARE concept is going to continue, we need to support
  378.        the efforts of the software authors. Most of these  people  would
  379.        gladly  accept  a  small  donation as a token of appreciation for
  380.        their work. These donations don't even come close to compensating
  381.        an author  for  the  many  hours  of  work  his  or  her  program
  382.        represents, but it sure makes them feel more inclined to continue
  383.        the  SHAREWARE  practice.  All  of  us  benefit then!
  384.  
  385.        If you find TIKLER to be as handy and helpful as I  have,  please
  386.        register your copy of the program. To register, just fill out the
  387.        registration  form  on  the  next page, and send it together with
  388.        your  registration fee of $10.00 (cash,  check  or  money  order)
  389.        to the address shown. Registered  users  will  receive,  free  of
  390.        charge,  the  latest version of TIKLER if the one you have is not
  391.        recent.  If you pass this program on to others, either on  floppy
  392.        disk  or  through  bulletin boards, please be sure to attach this
  393.        document.
  394.  
  395.  
  396.                 Please address all correspondence to:
  397.  
  398.                  Richard Olsen
  399.                  68 Hartwell Ave.
  400.                  Littleton, Mass. 01460
  401.  
  402.                     Tikler v3.1 REGISTRATION FORM
  403.  
  404.        Dear Dick,
  405.  
  406.        Enclosed please find my check or money order for $10.00. Please
  407.        register me as a TIKLER user and send me the latest version if
  408.        the version I currently have is not the latest.
  409.  
  410.        Thanks!
  411.  
  412.  
  413.        YOUR NAME________________________________________________
  414.  
  415.        STREET ADDRESS___________________________________________
  416.  
  417.        CITY, STATE, ZIP_________________________________________
  418.  
  419.        COUNTRY__________________________________________________
  420.  
  421.        TIKLER Version you have__________________________________
  422.  
  423.        WHERE DID YOU GET TIKLER?________________________________
  424.  
  425.        COMMENTS_________________________________________________
  426.  
  427.        _________________________________________________________
  428.  
  429.        _________________________________________________________
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.                     Mail To:
  437.  
  438.                     Richard Olsen
  439.                     68 Hartwell Ave.
  440.                     Littleton, MA  01460
  441.  
  442.  
  443. Other programs available from the author:
  444.  
  445.              BASSTOUR......A bass fishing tournament game. Comes with
  446.                            six different areas to fish. You control a
  447.                            fully rigged bass boat with on-screen contour
  448.                            maps, LCD graph, over 2300 lure/color choices.
  449.                            Superb graphics in EGA. Also runs on Hercules
  450.                            and CGA systems.
  451.  
  452.              LAKES #1......A collection of 7 new fishing areas you can
  453.                            add to BASSTOUR. Installation instructions
  454.                            are included.
  455.  
  456.              LAKES #2......Another  seven  fishing  areas  to  use  with
  457.                            BASSTOUR.  Use  of both LAKES #1 and LAKES #2
  458.                            will bring the total number of fishing  areas
  459.                            to 20. Includes installation instructions.
  460.  
  461.              FISHBASE ][...A fisherman's data base/statistics program
  462.                            for color or monochrome systems.
  463.  
  464.              BASSTIPS......A great way for the fisherman  to  start  his
  465.                            day! Over 100 fishing tips that pop onto your
  466.                NEW!!       screen.  You can also add your own tips. More
  467.                            tips   are added all the time.  Color or Mono
  468.                            systems.
  469.  
  470.        Available   for  $10  each.  Plus  $2.00  to  cover  postage  and
  471.        materials. Please specify what you want by  circling  the  titles
  472.        and send this form to the address shown below.
  473.  
  474.        Mail TO:
  475.  
  476.        Richard Olsen
  477.        68 Hartwell Ave.
  478.        Littleton, MA.  01460
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.