home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 2: PC / frozenfish_august_1995.bin / bbs / d10xx / d1054.lha / Programs / Recall / Docs / Recall.ASCII next >
Text File  |  1994-04-28  |  59KB  |  1,405 lines

  1.  Documentation for Recall
  2.  ------------------------
  3.  
  4.  This document describes the usage   of   Recall  and  how to make your own
  5.  customized project of  events.   Please  also  read  the documentation for
  6.  ReConvert, describing  how  to  convert  your  project  between  different
  7.  formats.
  8.  
  9.  Description                            
  10.  Credits and requirements               
  11.  Copyrights                             
  12.  Installing                             
  13.  Unstalling                             
  14.  Running the programs                   
  15.  Using Recall Preferences               
  16.  Using Recall                           
  17.  Source                                 
  18.  Known bugs                             
  19.  Future developments and plans          
  20.  Troubleshooting, Tips & Tricks         
  21.  History                                
  22.  How to contact the author              
  23.  
  24.  Users with a 68000 CPU or NO harddrive 
  25.  About MagicUserInterface               
  26.  
  27. Description
  28.  
  29.  Do you keep forgetting about  birthdays, anniversaries and other important
  30.  events?
  31.  
  32.  Well, there are plenty of public  domain  products on the market that will
  33.  prevent that from happening.
  34.  
  35.  But, do you also want to
  36.  - keep track of the remaining days to important events?
  37.  - keep track of the days since important events happened?
  38.  - automatically start certain programs depending on the date and time?
  39.  - be reminded every # day (e.g. every 14th day)?
  40.  - be reminded # days before or after the event
  41.  - be reminded once a day, every time  you  boot, before or after a certain
  42.    date, before or after a certain hour or minute?
  43.  - be reminded about events until you acknowledge them?
  44.  - be reminded with requesters, alerts or  practically anything that can be
  45.    displayed on an Amiga-monitor?
  46.  - display unlimited  lines  of  text  in  the  same  requester/alert (only
  47.    limited by the screen's resolution and memory)
  48.  - group different events in the same requester or alert?
  49.  - keep a simple database of the birthdays of family and friends?
  50.  - let your Amiga keep track of how  old  people are by insterting the date
  51.    of birth in the middle of the string  where you want to display the age?
  52.    (E.g. the text "Adam is {080570}  years  old today" will be displayed as
  53.    "Adam is 23 years old today".)
  54.  - make advanced events which are  displayed  for example after 21:00 every
  55.    3rd day the  first  7  days  of  every  2nd month the next 4 years?
  56.  - combine all of the attributes mentioned above in the same event?
  57.  - enter these events in an easy-to-use environment and without the need of
  58.    programming-knowledge, just by entering the  desired text and pressing a
  59.    few buttons?
  60.  
  61.  Well, then you will  find  this  program  extremely useful, because Recall
  62.  will do exactly  that  for  you!   It  is  an easy-to-use, intuition-based
  63.  utility for the absent-minded!
  64.  
  65.  
  66.  
  67. About Recall and Credits
  68.  
  69.  NAME:         Recall/Recall Preferences/ReConvert
  70.  VERSION:      V2.3
  71.  PROGRAMMER:   Ketil Hunn
  72.  PLACE:        Fredrikstad / Molde - DHMolde 1993-1994, Norway
  73.  COPYRIGHT:    All binaries and docs are ⌐ 1993-1994 Ketil Hunn
  74.  DISTRIBUTE:   Freely Distributable, Public Domain
  75.  MAIL:         ketil@lyr.dhmolde.no
  76.                hunn@dhmolde.no
  77.  TOOLS:        SAS/C V6.3
  78.  
  79.  REQUIREMENTS: Any Amiga with WB2.0+
  80.                At least 1Mb free memory
  81.                Needs WB2.1+ in order to be localized
  82.                MUI V1.4+
  83.                ReqTools.library (optional)
  84.  
  85.  MUI:          Although, MUI is required  to  run  this  program, it is not
  86.                included in this archive as  it  would have made the archive
  87.                too big.  The MUI-package is available on FTP sites, various
  88.                BBS's and Public Domain disks.
  89.  
  90.                On AmiNet mirrors:
  91.                Path: /dev/gui/
  92.                File: MUI20USR.lha
  93.  
  94.  REQTOOLS:     The usage of ReqTools.library is  optional.  This library is
  95.                not included in this archive. It is freely distributable and
  96.                you should be able to find  it  on  any FTP site, BBS or PD-
  97.                disks.
  98.  
  99.  TRANSLATIONS: The Deutsch catalogs were translated by Dirk B÷hmer.
  100.                The Nederlands catalogs were translated by Frank Breedijk
  101.                The Italiano catalogs were translated by Giorgio Demenego.
  102.                The Suomi catalogs were translated by Juha Kettunen.
  103.                The Norwegian catalog was translated by me.
  104.  
  105.                The suomi.language is copyrighted to Tomi Blinnikka
  106.                (I couldn't get in touch  with  you,  but I have included it
  107.                anyway... Hope you don't mind!)
  108.  
  109.  GENERAL:      This package was developed on  an  A3000 25MHz with 6Mb RAM,
  110.                1950 multisync monitor, 105Mb harddrive,  3 drives and a Nec
  111.                P20-printer.  All software were running under WB3.1.
  112.  
  113.                The Graphic User Interface (GUI) was created using the great
  114.                MUImaster.library - Copyrighted  1992/93/94 Stefan Stuntz.
  115.  
  116.                The ReqTools.library is copyrighted to Nico Franτois.
  117.  
  118.  BETATESTERS:  Giorgio Demenego
  119.                Michael Zielinski
  120.                Frank Breedijk
  121.                Frank Duerring
  122.                Philip Graham Meyer
  123.                Nuutti Merilµinen
  124.                Juha Kettonen
  125.                Janne Simonen
  126.  
  127.  THANKS TO:    Thorsten Gau for the SBasePro4 script and all those who sent
  128.                me suggestions and bugs, and  of  course the translators and
  129.                the betatesters.  I would also  like  to thank all those who
  130.                dropped me a note on  my  e-mail  address.  The response has
  131.                been enormous.  If  this  keeps  up,  I'll  have  to  hire a
  132.                secretary :-)
  133.  
  134.  See also How to contact the author
  135.  
  136.  
  137. Copyrights
  138.  
  139.  This application is freely  redistributable as  long as the archive is not
  140.  modified in any way.
  141.  
  142.  Think twice before you:
  143.  - SPREAD or DELETE parts of this  program.   Some people actually read the
  144.    docs (you are, at  the   moment!).   All  of  the  following  files  and
  145.    their icons  MUST be in the archive:
  146.  
  147.    Install/Install       : Installer-script for harddrive-users
  148.    Unstall/Unstall       : Removes the application from a system
  149.    Recall                : Main program
  150.    Prefs/Recall          : Preference-program
  151.    Tools/RecallConverter : Program to import and export projects
  152.    Docs/Recall.guide     : Documentation in AmigaGuide-format
  153.    Docs/Recall.ASCII     : Documentation in ASCII-format
  154.    Docs/ReConvert.guide  : Documentation in AmigaGuide-format
  155.    Docs/ReConvert.ASCII  : Documentation in ASCII-format
  156.    Recall.prefs          : An example-project
  157.    Locale  (dir)         : Contains the language catalogs
  158.    Scripts (dir)         : Various scripts for processing data.
  159.  
  160.  - CRUNCH this program and then spread  it.   Some decrunchers use a lot of
  161.    memory and not all of the users have all that memory available!  Most of
  162.    the Amiga-owners dislike colorcycling pointers  and screens, and not all
  163.    crunchers have available decrunchers, so  the  user  may not be able  to
  164.    decrunch the program if she/he wants to!
  165.  - SELL or INCLUDE this in a commercial package!  This program is dedicated
  166.    to the Amiga society and is placed  in the Public Domain!  If you charge
  167.    more than a reasonable copy  fee  for  this  package, people are sure to
  168.    find out about you sooner or later,  and  that will certainly be the end
  169.    for you in the Amiga-scene!
  170.  - BUY this program.  You have  been  swindled!   If you actually read this
  171.    text, the seller must  be  pretty  dumb  not  removing  this text before
  172.    selling it to you (he  probably  assumes  you're just another lamer that
  173.    can't read!).
  174.  - USE this program.  In spite of  several  test,  no warranty is made that
  175.    there's no more bugs in this application.   You use this program at your
  176.    own risks!  I will not under any circumstances be liable for any damage,
  177.    direct or indirect,  resulting  of  the  use  of  any  programs  in this
  178.    package.  If Recall forgot to remind you about some events, DO NOT BLAME
  179.    ME - if you were not so absent-minded you wouldn't be needing an utility
  180.    like this in the first place:  You  can  either trust Recall and keep on
  181.    with your life, or quit using Recall and start to remember things...
  182.  - READ this document.  I will not  be  liable for any damage this document
  183.    may have caused you; english is not  my native language and I guess this
  184.    document  is full of misspellings and misunderstandings.  You can either
  185.    live with it and  keep on  reading,  run  this through a spellchecker or
  186.    stop  reading.   The  program  is  quite   easy  to  use  and  needs  no
  187.    explanations.
  188.  - LIKE this program.  You may want to  send  me a postcard if you do, just
  189.    telling me how much you like it.   Really,  I wouldn't mind that at all,
  190.    but it is no obligation.  You may  also  drop me a note on the internet.
  191.    The address will be at the end of this document.
  192.  
  193.  
  194. Installing
  195.  
  196.  I am not going to go through   the  whole installation process here, since
  197.  most of  you  are  already   familiar  with  Commodore's  Installer.  Just
  198.  doubleclick on the  install-icon,  and  the  program  will  install itself
  199.  automatically (just answer a few questions...).
  200.  
  201.  Beginning with version 2.1,  the  installation-script  is localized.  Just
  202.  click on the preferred language  and  the  installation and it's questions
  203.  will be given in that language.
  204.  
  205.  The script  needs  Commodore's  'Amiga  Application  Installation Utility'
  206.  (Installer) in order to run.  This is not included in this package because
  207.  it is copyrighted to Commodore.   The  Installer  utility  is shipped with
  208.  WB2.1 and higher.
  209.  
  210.  If not available, please copy the program and its icon as follows:
  211.  Recall                -> SYS:WBStartup/
  212.  Prefs/Recall          -> SYS:Prefs/
  213.  Tools/RecallConverter -> SYS:Tools/
  214.  Recall.prefs          -> ENVARC: and ENV:
  215.  Docs/<guide files>    -> HELP:english/
  216.  Unstall               -> Wherever you like...
  217.  
  218.  If you do not install Recall  and  ReConvert to the listed drawers, Recall
  219.  Preferences will not be able to  find  them,  and  you will not be able to
  220.  test projects nor import and export projects.
  221.  
  222.  If you do not install the guide  files  to the listed drawer, you will not
  223.  be able to use on-line help from Recall Preferences or ReConvert.
  224.  
  225.  
  226. Unstalling
  227.  
  228.  Doubleclicking on the icon  named  UnstallMe!,  will  execute  a script to
  229.  remove the  Recall  package  from  your  harddisk  (all  actions  must  be
  230.  confirmed!).
  231.  
  232.  
  233. Running the programs
  234.  
  235.  Both programs may be run from Shell or from Workbench by doubleclicking on
  236.  their icons.
  237.  
  238.  An absent-minded person like yourself,  is  also  capable of forgetting to
  239.  start Recall every day, so  the   most   secure   way of being reminded of
  240.  events, is to copy Recall to your SYS:WBStartup drawer.   This way it will
  241.  check for events every time you boot your machine.
  242.  
  243.  If Recall is run with  no  parameters  it  will automatically look for the
  244.  project "ENVARC:Recall.prefs".  Any parameters will override this.
  245.  
  246.  "Recall test.script"  forces  Recall  to  open  the  script  "test.script"
  247.  instead of "ENVARC:Recall.prefs".
  248.  
  249.  
  250. Using Recall Preferences
  251.  
  252.  This is where all  the  work  is  done   and   where  the  you create your
  253.  customized project.  The window of Recall  Preferences is dominated by two
  254.  groups of objects, each group containing  a listview.  The listview in the
  255.  Event-group contains all the events you want  to be reminded of, while the
  256.  listview in the Text-group will contain the event's textlines or commands.
  257.  
  258.  The program can either be controlled  by  mouse or keyboard.  Most gadgets
  259.  have an underlined character, meaning that a  hit on this character on the
  260.  keyboard are equal to clicking  on  the  button  with  the mouse.  The two
  261.  Delete-gadgets do not have  short-cuts,  to  prevent you from accidentally
  262.  delete an event or a text.   They  may however be controlled from keyboard
  263.  by cycling you through the gadgets  with  TAB  until the desired gadget is
  264.  highlighted and then pressing return.  Even  the listviews may be control-
  265.  led from keyboard.  Whenever a  listview's  stringgadget is active you may
  266.  select the previous or next item in the list by using the arrow buttons.
  267.  
  268.  Create an event                           
  269.  Duplicate an event                        
  270.  Delete an event                           
  271.  Change the placement of an event          
  272.  Purge events                              
  273.  Sort the list of events                   
  274.  Set the date of an event                  
  275.  Set the time of an event                  
  276.  Finetuning the date and time              
  277.  Setting the number of days before or after
  278.  Making a repeating event                  
  279.  Setting the date and time to now          
  280.  Clearing the date and time                
  281.  Set the type of an event                  
  282.  Selecting a command from a filerequester  
  283.  Set how often the event will be displayed 
  284.  Selecting the method of field calculation 
  285.  Add text to an event                      
  286.  Duplicate a textline                      
  287.  Delete a textline                         
  288.  Change the placement of a textline        
  289.  Sort the list of texts                    
  290.  Save a project of events                  
  291.  Test a project of events                  
  292.  Cancel all changes and quit               
  293.  Saving the size and position of windows   
  294.  
  295.  
  296. Creating an event
  297.  
  298.  You can add an event  to  the  list  by  clicking  on the Add-gadget.  The
  299.  stringgadget above it will become activated, letting you enter the name of
  300.  the event.  The length  of  the  name  is  limited  to 30 characters.  The
  301.  event's name should be short,  consistent  and  describe the type of event
  302.  well.  If you have many events  which  reminds you about e.g. birthdays, a
  303.  good name for all these events could  be 'Birthday: <name>', as this would
  304.  provide a better visualization of the  data  and  make it a lot easier for
  305.  you to seek through the list of events.
  306.  
  307.  The name you have entered, will  only  be  added  to the list if you press
  308.  return.  Failing to do so,  will  cancel  the  creation  of the new event.
  309.  Pressing return will add the new event at  the bottom of the list.  If the
  310.  bottom of the list  is  not  showing,  it  will  automatically jump to the
  311.  bottom to show the  new  event.   The  new  event  will  be highlighted to
  312.  indicate that it is the current active event.
  313.  
  314.  The number of events are only limited by the available memory.
  315.  
  316.  
  317. Duplicate an event
  318.  
  319.  You can duplicate an event by selecting  the desired event and clicking on
  320.  the Copy-gadget.  All attributes as  well  as  all  textlines of the event
  321.  will be duplicated.  The new event will appear just below the source.  The
  322.  stringgadget will be  activated,  allowing  you  change  the  name  of the
  323.  destination event.  The destination is highlighted  to indicate that it is
  324.  the current active event.
  325.  
  326.  
  327. Delete an event
  328.  
  329.  You can delete an event by selecting the desired event and clicking on the
  330.  Delete-gadget.  All attributes as well as  all textlines of the event will
  331.  be deleted.  The next event  in  the  list  will become the current active
  332.  event.
  333.  
  334.  If the project  has  been  previously  saved,   the  deleted  event can be
  335.  restored by selecting Edit->Last saved
  336.  
  337.  
  338. Change the placement of an event
  339.  
  340.  When running a project, the events  will  be  run  in priority from top to
  341.  bottom unless the menu-item  'Group  events?'  is  checked.   So moving an
  342.  event up, will  mean  that  it  will  be  shown  earlier  when running the
  343.  project.
  344.  
  345.  Up
  346.  Moves the current active event up one position.
  347.  
  348.  Down
  349.  Moves the current active event down one position.
  350.  
  351.  Top
  352.  Moves the current active event to the beginning of the list.
  353.  
  354.  Bottom
  355.  Moves the current active event to the end of the list.
  356.  
  357.  
  358.  See also Settings->Group Events?
  359.  
  360.  
  361. Purge Events
  362.  
  363.  When the same project is used for a considerable period of time, it may at
  364.  the end contain several events which  are  expired or said in other words,
  365.  contain events which will never be displayed.  So instead of going through
  366.  the entire list, looking for events  that  is no longer needed, you simply
  367.  click on the  Purge-gadget,  and  the  machine  will  do  the checking and
  368.  deleting for you!
  369.  
  370.  
  371.  See also Settings->AutoDelete events?
  372.  
  373.  
  374. Sorting the list of events
  375.  
  376.  There are three methods of organizing the  list of events.  You can either
  377.  sort the events alphabetically, sort  them  by  date  or by changing their
  378.  placement individually.
  379.  
  380.  The list of events will  be  sorted  whenever clicking on the Sort-gadget.
  381.  The routine used, is determined by the settings in the settings-menu.
  382.  
  383.  When sorting by date, the events with no  date at all will be appearing at
  384.  the beginning of the list, then the  events with one or more components of
  385.  the date replaced by '**' will  appear  and  last, the events with a fixed
  386.  date.
  387.  
  388.  
  389.  See also Settings->Sort by
  390.  
  391.  
  392. Setting date an event
  393.  
  394.  The date of an event is now set from a calendar, very much set up like the
  395.  Commodore's own Time Preferences.  This calendar can be opened by pressing
  396.  the Edit-button.
  397.  
  398.  The textwindow on the left to the Edit-button will always show the date of
  399.  the event.  When no date is set,  the  date  will be substituted by a text
  400.  saying 'Every day', and when no time  is set, the time will be substituted
  401.  by a text saying  'All  day'.   When  a  component  of  the  date is of no
  402.  importance, it will be displayed  as  two  or  more  '*', meaning that any
  403.  value will satisfy.
  404.  
  405.  To set the day of an event,  simply  click  on one the numbered gadgets in
  406.  the calendar-window.  The selected day  will  be highlighted and displayed
  407.  in the date field.  If you want the event to appear on any day, please set
  408.  the day to '0', zero.
  409.  
  410.  The month is  set  by  cycling  through  the  month-cyclegadget  until the
  411.  desired month is activated.  If you want  the event to appear every month,
  412.  please select the item 'Any month'.
  413.  
  414.  NOTE! that selecting 'Any month',  will  mean  the  CURRENT MONTH, thus an
  415.  event set to BEFORE '01/**/****' will never be displayed!  If you want the
  416.  event to be shown x days before the  1st  of every month, please set it up
  417.  like this: x-1 days before the last day in the month or i.e. after 25th.
  418.  
  419.  The year of the event  is  set  by  entering   the  desired  year  in  the
  420.  integer-gadget  next  to  the  month-cyclegadget.   If  you want the event
  421.  to  appear every year,  enter  a  zero  or  nothing.   Entering  a  number
  422.  which length is less than  four,  will  cause  the event to  be  displayed
  423.  each year the given year  match  with  the  current year.  In other words,
  424.  entering year='3' (displayed as '***3') will  display the event every year
  425.  that ends with '3'.
  426.  
  427.  
  428.  See also How to tune the date and time    
  429.           Set the time of an event         
  430.           Setting the time and date to now 
  431.           Clearing the date and time       
  432.  
  433.  
  434. Setting the time of an event
  435.  
  436.  Setting the time is just as simple  as  setting the time under Commodore's
  437.  Time Preferences.  Just  drag  the  sliders  to  the  desired  level.  The
  438.  selected hour and minutes will be  shown  in the main window.  Setting any
  439.  of the sliders to  the  bottom  level  will  replace  its value with '**',
  440.  meaning that any hour/minute will do.
  441.  
  442.  
  443.  See also How to tune the date and time
  444.  
  445.  
  446. Tuning the date and time
  447.  
  448.  It may be times when you do  not  want  the events to appear on a specific
  449.  date or time, but rather before or  after.  This can easily be achieved by
  450.  setting the cycle-gadgets at the top of  both date- and time-groups in the
  451.  calendar.  The default value is 'Exact'.
  452.  
  453.  Exact
  454.  The event will appear ONLY at the given  date or time.  If you do not turn
  455.  your machine on that day, you will never see the event!
  456.  
  457.  Before
  458.  The event will  appear  only  BEFORE   the  given  date  or  time.  If the
  459.  selected date is '07.**.1993', the event  will  appear on the first 6 days
  460.  every month during 1993.  If the selected  time is '11:00', the event will
  461.  appear between '00:00' and (not including) '11:00'.
  462.  
  463.  After
  464.  The event will  appear  only   AFTER   the  given  date  or  time.  If the
  465.  selected date is  '07.06.1993',  the  event  will  appear  every  day from
  466.  '08.06.1993' to eternity.  If the selected time is '11:00', the event will
  467.  appear between '11:01' and (including) '23:59'.
  468.  
  469.  
  470.  See also Setting the number of days before or after
  471.           Making a repeating event                  
  472.  
  473.  
  474.  
  475. Setting the number of days before or after
  476.  
  477.  Allows the user to  set   the  interval  of  days, and the event will only
  478.  be displayed during  that   interval.    Let's  say  the  date  is  set to
  479.  '07.**.1993', days set to   value   '2'  and  the  cyclebutton selected is
  480.  Before, the date  will   only  be displayed on the 5th and 6th every month
  481.  during 1993, in other  words  two days before the 7th day of any month.
  482.  
  483.  This gadget becomes available  only  when  the  date  is  set to Before or
  484.  After.
  485.  
  486.  
  487. Making repeating events
  488.  
  489.  Allows the user to set the interval of repeating days.  If for example the
  490.  field contains the  number '14',  the  event  will be displayed every 14th
  491.  day before/after the specified date.
  492.  
  493.  This gadget becomes available  only  when  the  date  is  set to Before or
  494.  After.
  495.  
  496.  Another way of making a repeat event, is  of course by setting one or more
  497.  of the date's components to a zero (indicated by '**' in the date).
  498.  
  499.  
  500.  See also Setting the date of an event
  501.           Setting the time of an event
  502.  
  503.  
  504.  
  505. Setting the date and time to current values
  506.  
  507.  By pressing the gadget 'Now', the date  and  time of the event will be set
  508.  to the current date and time.
  509.  
  510.  
  511. Clearing the date and time of an event
  512.  
  513.  By pressing the gadget 'Clear', the  date  and  time of the selected event
  514.  will be reset to default values, meaning that the event will appear "Every
  515.  day - All day".
  516.  
  517.  
  518.  
  519. Selecting the type of event
  520.  
  521.  In what way an event will appear, is  determined by which type of event is
  522.  set for that event.  You may select between these modes:
  523.  
  524.  Requester
  525.  All texts will be  displayed  in  a  standard requester with an OK-button.
  526.  Selecting  OK will tell Recall to proceed to the next event.
  527.  
  528.  If the menu-item  'Settings->Confirm  requesters?'  is  checked,  the  re-
  529.  quester  will  also  have  a  Cancel-button.   Selecting  Cancel will tell
  530.  Recall not to show the event more that day.
  531.  
  532.  If the menu-item 'Postpone  requesters?'  is  checked,  the requester will
  533.  also have a 'Postpone'-button.   Selecting  this  button will postpone the
  534.  event until next time you run Recall, even  if the event is of Daily type!
  535.  It will keep reminding you until you press 'OK' or 'Cancel'.
  536.  
  537.  The maximum number of  lines  which  may  be  displayed is only limited by
  538.  the screens resolution and font.   The requester will automatically adjust
  539.  to the font used by your system.
  540.  
  541.  
  542.  Alert
  543.  All texts will be displayed  using  a  standard  RECOVERY ALERT. The alert
  544.  will be opened on a 640*200 screen  on  a NTSC-machine or a 640*256 screen
  545.  on a PAL-machine.   The  font used will always be Topaz8. The frame of the
  546.  alert will be automatically adjusted  to  fit  the number of  lines  shown
  547.  and  all   lines   will   be  centred.   Pressing  either  left  or  right
  548.  mousebutton will continue.  If 'Settings->Confirm alerts?' is checked, the
  549.  alert will contain a  line  at  the  bottom  of  the alert announcing that
  550.  pressing the  left  mousebutton  will  continue  and  pressing  the  right
  551.  mousebutton will cancel the event.  Selecting  cancel will tell Recall not
  552.  to show the event more that day.
  553.  
  554.  
  555.  Execute
  556.  All texts will be  run  as  if  they  were  typed  from Shell.  If several
  557.  programs is requested, they  will  be   run   after each other in priority
  558.  from top to bottom.
  559.  
  560.  Running larger batch-programs can  be   done   easily by entering "execute
  561.  <filename>".  Recall also  accepts  remarks   and   'execute  <filename> ;
  562.  remark' will work without problems.
  563.  
  564.  Instead of typing in  your  commands,  you  can  select  them from a file-
  565.  requester.  Just click on the  GetFile-gadget  to  the left of the string-
  566.  gadget and select the file you want to run.
  567.  
  568.  
  569.  See also How often the event will be displayed   
  570.           Selecting a command from a filerequester
  571.  
  572.  
  573. Selecting a command from a filerequester
  574.  
  575.  Instead of typing in the programs you want to execute from Recall, you can
  576.  simply click on  the  GetFile-gadget  to  the  left  of  the stringgadget.
  577.  Clicking this button will bring up a filerequester, allowing you to select
  578.  the command you want to run.  The name of the selected file will be copied
  579.  to the stringgadget and the cursor  will  be  positioned at the end of the
  580.  string, allowing you to enter any parameters.
  581.  
  582.  
  583. Selecting how often the event will be displayed
  584.  
  585.  The Show-cyclegadget determines how often  the event will appear.  Several
  586.  options are available:
  587.  
  588.  Always
  589.  The event will be displayed every time Recall is run.
  590.  
  591.  Daily
  592.  The event will only be run the first time Recall is run that day, in other
  593.  words; only once a day.
  594.  
  595.  Never
  596.  The event will never  be  displayed.   Useful  if  you want to temporarily
  597.  prevent an event of being displayed.
  598.  
  599.  
  600. Setting the method of calculation
  601.  
  602.  This cycle-gadget determines which  method  will  be used when calculating
  603.  fields.  If the texts do not contain  any fields, this cycle-gadget has no
  604.  effect.
  605.  
  606.  Years
  607.  This method will return the  number of  years between the current date and
  608.  the date in the date field.
  609.  
  610.  If the text of the event is  "Adam  is {080570} years and Dick is {310165}
  611.  years old today", it will  be  displayed  as  (assuming the year is 1993):
  612.  "Adam is 23 and Dick 28 years old today".
  613.  
  614.  When this method is used, it is  not  necessary to enter the whole date in
  615.  the calculation fields.  "Adam  is  {****70}  years  and  Dick is {****65}
  616.  years old today'   will  result  in  the  same  message.   It is, however,
  617.  advisable to always enter the full date in events.
  618.  
  619.  
  620.  Days
  621.  This method will return  the  number  of days between the current date and
  622.  the date of calculation field.
  623.  
  624.  Text containing  "{020693}  days  to   my   exam"  will  for   example  be
  625.  displayed as "4 days to my exam".
  626.  
  627.  NOTE!  Recall will  always  assume  that  the  given  year  is  in the 20.
  628.  century.  Attempting to calculate  the  remaining  days  to year 2000 will
  629.  fail, since {010100} will be interpreted as 01.Jan.1900... :-(
  630.  
  631.  
  632.  See also Adding text to an event
  633.  
  634.  
  635. Adding text to an event
  636.  
  637.  You can add text to  an  event  by  selecting the Add-gadget.  The string-
  638.  gadget will be activated, allowing  you  to  enter  the desired text.  The
  639.  length of the text is limited  to  255  characters.   The text will not be
  640.  added to the list of texts until you  press the return key.  Failing to do
  641.  so, will cancel the creation of the new text.  Although the length of text
  642.  can be as much as 255 character,  you  should keep in mind that alerts and
  643.  requesters with  standard  Topaz8.font  are  limited  to  a  width  of  77
  644.  characters.
  645.  
  646.  The lines of text will either  be  displayed  in  a requester or alert, or
  647.  they will be executed, depending which  type  of event you are adding text
  648.  to.
  649.  
  650.  Another nice feature of  Recall,  is  that  you  can  include a date field
  651.  within  the  textlines.   These  fields  will  be  calculated  during  the
  652.  execution of a project and the  resulting  value will be displayed instead
  653.  of the date field.  There is no limit  to the number of fields in one line
  654.  of text.  The format of the date  field  is {DDMMYY} and MUST  be  exactly
  655.  in that format!  Notice the bracket parenthesis surrounding the date field
  656.  - they can not be omitted!  A  few  examples to clarify (assuming the date
  657.  is 17.11.93), the original on the  left  and  the displayed outcome to the
  658.  right:
  659.  
  660.  "I am {080570} years old"                 -> "I am 23 years old"
  661.  "{120294} days left to the Olympic Games" -> "87 days left to the..."
  662.  
  663.  Notice how the  first  line  displays  the  years,  while  the second line
  664.  displays the number of days.  The  result  of the date field is determined
  665.  of which method of calculation is selected.
  666.  
  667.  
  668.  See also Selecting the method of calculation
  669.  
  670.  
  671. Duplicating a textline
  672.  
  673.  You may duplicate a textline by selecting the desired text and clicking on
  674.  the Copy-gadget.  The destination will appear just below the source and it
  675.  will be highlighted to indicate  that  it  is the current active textline.
  676.  The stringgadget will be activated, allowing you to change the text.
  677.  
  678.  
  679. Deleting a textline
  680.  
  681.  You may delete any textline by selecting  the desired text and clicking on
  682.  the Delete-gadget.
  683.  
  684.  
  685. Changing the placement of a textline
  686.  
  687.  The list of texts may be organized in either two ways, by sorting the list
  688.  alphabetically or by individually change each line's position.
  689.  
  690.  Up
  691.  Moves the current active text up one position.
  692.  
  693.  Down
  694.  Moves the current active text down one position.
  695.  
  696.  
  697.  See also Sort the list of texts
  698.  
  699.  
  700. Sort the list of texts
  701.  
  702.  You can sort  the  list  alphabetically  by  clicking  on the Sort-gadget,
  703.  changing  the order in which they will be displayed.
  704.  
  705.  
  706.  See also Changing the placement of a textline
  707.  
  708.  
  709. Saving the project and quitting
  710.  
  711.  When clicking on the  Save-gadget,  Recall  Preferences  saves the current
  712.  project under the default name and exits.
  713.  
  714.  The project can be saved without  exiting, by selecting Project->Save from
  715.  the Project menu.  If you want to  save the project under a different name
  716.  you can achieve this by selecting Project->Save as...
  717.  
  718.  The settings is always saved with the project.
  719.  
  720.  
  721.  See also Using the Project menu
  722.           Cancel                
  723.           Settings              
  724.  
  725.  
  726. Testing a project
  727.  
  728.  When creating a new project of  events,  there  is sometimes a wish to try
  729.  things out before saving to disk.  This can be achieved by clicking on the
  730.  Test-gadget or by selecting the menu-item Project->Test.
  731.  
  732.  When selected, Recall Preferences will run  through the list of events and
  733.  display them according to their  attributes.   Recall  must be resident in
  734.  the SYS:WBStartup/drawer for this to work.
  735.  
  736.  
  737.  See also Project->Test
  738.  
  739.  
  740. Cancel all changes and quit
  741.  
  742.  Clicking on the Cancel-gadget will terminate the program without question,
  743.  unless the Settings->Confirm? menu-item is  checked.   All changes done to
  744.  the project will be lost.
  745.  
  746.  
  747.  See also Settings->Confirm?
  748.           Save              
  749.  
  750.  
  751. Saving the position and size of windows
  752.  
  753.  To keep the size and position of Recall Preferences's windows permanently,
  754.  you must first start Recall  Preferences  and  select the desired size and
  755.  position of both main and calendar  window.  Then start MUIPrefs and click
  756.  on the Save-gadget in MUIPrefs-window.  That's it, and that's that...
  757.  
  758.  When resizing or changing the position  of Recall Preferences windows, the
  759.  size and position will saved  temporarily  and  used  the next time Recall
  760.  Preferences are started.  However, if  these  changes  are not saved, they
  761.  will be lost  when  rebooting  or  turning  off  your  machine  and Recall
  762.  Preferences will use it's default size and position on next startup.
  763.  
  764.  
  765.  See also the documentation of MUIPrefs.
  766.  
  767.  
  768. Describing the Project menu
  769.  
  770.  New...
  771.  Selecting this item will clear the  list   of  events  and enabling you to
  772.  start from scratch designing your new project of events.  Remember to save
  773.  your changes...
  774.  
  775.  Open...
  776.  Brings up a filerequester and lets  the  user  select  a new project to be
  777.  loaded.  The new project will  replace  the  current project.  Remember to
  778.  save you changes...
  779.  
  780.  Append...
  781.  Brings up a filerequester and lets the  user select a project to be joined
  782.  with the current project.  The new project  will  appear at the end of the
  783.  current project.
  784.  
  785.  Import -> ASCII...
  786.  Brings up a filerequester and  lets  the  user  select an ASCII file which
  787.  will be loaded and converted  into  a  Recall  project.  ReConvert must be
  788.  located in SYS:Tools-drawer.   See  also  the  ReConvert documentation for
  789.  further details on converting projects.
  790.  
  791.  Import -> Recall V1.x...
  792.  Brings up a filerequester and lets  the  user select a Recall V1.x project
  793.  to be imported.  The ReConvert  must  be located in SYS:Tools-drawer.  See
  794.  also  the  ReConvert  documentation  for  further  details  on  converting
  795.  projects.
  796.  
  797.  Save
  798.  Saves the project to disk  under   the  default  name, without exiting the
  799.  program.  The settings are saved with the project.
  800.  
  801.  Save as...
  802.  Lets the user save the  project  in  a  different  name.  The settings are
  803.  saved with the project.
  804.  
  805.  Export ASCII...
  806.  Exports the current loaded project as an ASCII file.
  807.  
  808.  Converter
  809.  Selecting this item will run  ReConvert.   The  program must be located in
  810.  your SYS:Tools-drawer.
  811.  
  812.  Test project
  813.  Runs the current project. Recall must be located in the SYS:WBStartup.
  814.  
  815.  Iconify
  816.  Closes all open windows and iconifies the program to an icon placed on the
  817.  workbench screen.  The program may  be  un-iconified by double-clicking on
  818.  the iconified icon or by  pressing  'Show  Interface' from the Commodore's
  819.  Exchange program.
  820.  
  821.  About...
  822.  Loaded with interesting information.  Try it out immediately!
  823.  
  824.  Quit
  825.  Terminates the program.  All edited events will be lost.  Remember to save
  826.  your changes...
  827.  
  828.  
  829.  Other menus: Edit    
  830.               Settings
  831.  
  832.  
  833. Using the Editmenu
  834.  
  835.  Last saved
  836.  Restores the last saved  project under  the default name to  memory.   All
  837.  edited events will be lost!  Remember to save your changes...
  838.  
  839.  
  840.  Other menus: Project 
  841.               Settings
  842.  
  843.  
  844. Using the Settingsmenu
  845.  
  846.  Group Events?
  847.  When this menu-item is checked, events  of  the  same type will be grouped
  848.  together in the same requester/alert/execute-block.
  849.  
  850.  Flash Screen?
  851.  When this menu-item is checked,  Recall  will  flash/beep  (or both at the
  852.  same time,  depending  on  the  configuration  set  by  Commodore's  Sound
  853.  Preference) before an event is executed or displayed.
  854.  
  855.  Confirm requesters?
  856.  When this menu-item is checked,  Recall  will  add  a Cancel button to all
  857.  requesters.  Selecting Cancel in requesters  will  tell Recall not to show
  858.  that specific event more that  day.   If  events  are grouped and the user
  859.  selects cancel, ALL events which were displayed will be cancelled!
  860.  
  861.  Confirm alerts?
  862.  When this menu-item is checked, Recall  will  add  a line at the bottom of
  863.  all alerts, telling the  user  to  press  left  mousebutton to continue or
  864.  press the right mousebutton to  cancel  the  event.  Selecting cancel will
  865.  tell Recall not to show that event  more  that day.  If events are grouped
  866.  and the user selects  cancel,  ALL  events  which  were  displayed will be
  867.  cancelled!
  868.  
  869.  Confirm executables?
  870.  When this menu-item is checked,  Recall  will  always ask before executing
  871.  any commands.  Selecting 'OK'  will  carry  out the command(s).  Selecting
  872.  'Cancel' will cancel the execution of all grouped executables.
  873.  
  874.  Postpone requesters?
  875.  When this menu-item is checked,  Recall  will  add  an extra button to any
  876.  requester. Pressing this button will postpone the event and force it to be
  877.  displayed every time until you press  'OK'  or 'Cancel', even if the event
  878.  is a daily event!  If events  are  grouped  and the user selects Postpone,
  879.  ALL events which were displayed will be postponed!
  880.  
  881.  Use ReqTools?
  882.  When  this  menu-item  is   checked,   Recall   will   open  and  use  the
  883.  ReqTools.library  instead  of  standard  System's  EasyRequests.   If  the
  884.  library is NOT  available,  Recall  falls  back  to  the  system's default
  885.  requesters.  Using the ReqTools  library  enables  Recall  to centres it's
  886.  requesters and let the requesters follow  the  mouse.  If NOT checked, all
  887.  requesters will appear at the upper left  corner of the screen, unless you
  888.  have installed a patch for requesters.
  889.  
  890.  Centre requesters
  891.  When this menu-item is checked, Recall  will  centre all requesters on the
  892.  default public screen.  This menu-item will  be ghosted if 'Use ReqTools?'
  893.  is not checked.
  894.  
  895.  Confirm
  896.  When this menu-item is  checked,  all  actions  in Recall Preferences that
  897.  alters the project, must be confirmed before they are executed.
  898.  
  899.  AutoOpen Calendar
  900.  When this menu-item is checked, Recall Preferences will automatically open
  901.  the calendar on  startup.   This  option  is  for  users  that  run Recall
  902.  Preferences on an interlaced screen and wish to have the calendar open all
  903.  the time.
  904.  
  905.  AutoDelete Events
  906.  When this menu-item  is  checked,  Recall  will  automatically  remove all
  907.  expired events from the project upon startup.
  908.  
  909.  Sort by
  910.  Lets the user select the sort-criteria used when sorting events.
  911.  
  912.  Other menus: Project
  913.               Edit   
  914.  
  915.  
  916.  
  917. Using Recall
  918.  
  919.  This is the main program.   If  started  without any argument, the program
  920.  will  look  automatically  look  for  the  project  'ENVARC:Recall.prefs'.
  921.  Any given parameter will  override  this.   Depending  on  the type of the
  922.  event, the event will appear in several ways.
  923.  
  924.  
  925.  See also Setting the type of an event 
  926.           Starting Recall              
  927.  
  928.  
  929. Source
  930.  
  931.  The source is not included anymore :-(
  932.  
  933.  
  934. Known bugs and other strange occurrences
  935.  
  936.  Recall:
  937.  - The alert-type may crash on some  machines.  Switch to requester if this
  938.    happens...
  939.  
  940.  Preferences:
  941.  - No known bugs
  942.  
  943.  See also Troubleshooting, Tips & Tricks
  944.  
  945.  
  946. Future developments and plans
  947.  
  948.  I'm almost done with Recall V3.0, but since I have my hands full with work
  949.  to do on my  graduate  thesis,  it  may  take  a  while  before it will be
  950.  completely finished and released...  Here are the so-far implementations:
  951.  
  952.  o Will not need MUI anymore  :-D   Recall  will still be fontadaptable and
  953.    sizeable, though.
  954.  o Multiwindow-environment.  All windows are 'multitasking'.
  955.  o ALL window-positions and sizes (including the ASL requester), as well as
  956.    font, screen, colors, etc. etc. may be saved to disk.
  957.  o Recall preferences will remember all sizes and positions when exiting.
  958.  o The checker may stay resident in memory (optional) and keep on reminding
  959.    you until you quit the program or turn off your machine.  Will check the
  960.    events every minute (idle time may be overridden with a WAIT-tooltype).
  961.  o The checker is a commodity,  and  may  be controlled via the Commodore's
  962.    Commodities Exchange program.  (Deactivate etc.)
  963.  o Tooltypes support.  Here are  the  most  important ones (almost anything
  964.    can be adjusted via the tooltypes):
  965.    o FILE=<project>
  966.    o LANGUAGE=<language>
  967.    o WAIT=<idle time between checking>
  968.    o CHECKER=<location and name of the checker utility>
  969.    o DOC=<location and name of on-line doc>
  970.    o tooltypes to override the settings
  971.    o other tooltypes
  972.  o Executed programs can be launched  either  as  Shell or Workbench tasks.
  973.    Programs started in Workbench-mode  will  use  their  tooltypes in their
  974.    icons.
  975.  o The window of Recall Preferences is  an app-window, allowing you to load
  976.    projects by dragging the project's  icon  over  the window and releasing
  977.    it.
  978.  o Project icon support.   Projects  saved  with  icons  can  be started by
  979.    double-clicking on their icons.   That  way  you  can  put two different
  980.    projects on the workbench (with icons) and start them by double-clicking
  981.    on them.  Taking  advantage  of  the  tooltypes,  you  may  have several
  982.    project icons pointing to the SAME file, but taking usage of the started
  983.    icon's tooltypes (different language, idle time and different settings).
  984.  o Recall can pop up requesters on any screen.
  985.  o Cut and paste of events and texts between events.
  986.  o Load- and save-modules will replace the converter-program.
  987.  o The alerts can be timed out.
  988.  o Catchup of events so that you wont skip events anymore.
  989.  o New type of event: Hotkey - generates a hotkey-press.
  990.  o Possibility to group only certain events, flash certain events etc. etc.
  991.  o Recursive directories, allows you to make folders of events i.e. keeping
  992.    all birthday-events in a folder  called  Birthdays.  Unlimited number of
  993.    levels!
  994.  o Possibility to set the stack of executed programs.
  995.  o Possibility to set the current dir for executed programs.
  996.  o Possibility to set the priority of executed programs.
  997.  o Possibility to set a timeout-value for alerts (V39).
  998.  o Unlimited number of dates can be attached to the same event.
  999.  o Events can now pop up on certain weekdays.
  1000.  o You can combine weekdays and  date,  allowing  you  to make events which
  1001.    will be shown i.e. the third sunday in a month etc. etc.
  1002.  o The calendar will put each day on its right weekday in the calendar.
  1003.  o Possibility to set the period before or after a specified time.
  1004.  o Major update of the calculation fields: allowing you to include both the
  1005.    current date, current time, calculation  of  days, calculation of years,
  1006.    current weekday and such  in  the  SAME  event!   The  attributes can be
  1007.    selected from a listview.
  1008.  o Lots of new calc-fields...
  1009.  o Lot's of other goodies...
  1010.  ---
  1011.  
  1012.  
  1013.  Other implementations to do:
  1014.  
  1015.  - Possibility to print the project.   Will  probably  be implemented as an
  1016.    export module.
  1017.  
  1018.  - Possibility to generate a list containing  the  text of all events (with
  1019.    calc-fields replaced by its value). (Suggested by Per Sverre
  1020.    Vogt-Hansen)
  1021.  
  1022.  - Graphical overview of the events within  a year or month.  (Suggested by
  1023.    Dirk B÷hmer).
  1024.  
  1025.  
  1026. Troubleshooting, Tips & Tricks
  1027.  
  1028.  The event does not show even if the date and time is set right
  1029.  Try setting 'Show' to 'Always' and  try  again.  The event might have been
  1030.  run earlier that day...   If  you  cycle  through  the Show-gadget, Recall
  1031.  Preferences will reset the daily flag.
  1032.  
  1033.  The event will not execute!
  1034.  Recall needs the full path!  If for  example use the Say-command, you must
  1035.  enter "SYS:Utilities/say" or else it will not be able to find it.
  1036.  
  1037.  How do I make an annual event?
  1038.  Set the date of the event to   DD.MM.****,  where DD and MM represents the
  1039.  day and the month you want  the   event   to  pop up.  Setting the year to
  1040.  **** is the same as saying 'every year'.
  1041.  
  1042.  How do I make a birthday event?
  1043.  There is unlimited number of   ways   to enter a birthday-event, depending
  1044.  of how you want the event to be shown.  Here's one suggestion.
  1045.  (Problem: Remind me of Rebecca's birthday on 08.05.1970)
  1046.  Set the date to 'Before', '09.05.****'
  1047.  Set the time to 'After', '11:00'
  1048.  Days='3'
  1049.  Repeat='0'
  1050.  Text='Rebecca is {080570} on 8th of May'
  1051.  Show='Daily'
  1052.  
  1053.  This event will be displayed daily on the 6th, 7th and 8th of May, leaving
  1054.  enough time to buy her a  flower  or  whatever... (...am I getting soft or
  1055.  what???).
  1056.  
  1057.  How do I create events that pop up on certain weekdays?
  1058.  If you want  an  event  to  be  displayed  every  monday,  you  must first
  1059.  determine the date of a monday (any  monday  -  last monday will be a good
  1060.  choice).  Enter that day in the date-field  and  set Repeat to '7', and it
  1061.  will appear every monday from now on...
  1062.  
  1063.  Testing an event with Show set to 'Daily'
  1064.  When testing such a project the event  will  ALWAYS be shown if it has not
  1065.  been displayed that day.  Furthermore will  it  not show if it already has
  1066.  been displayed that day.  This is  inevitable, since Recall Preferences do
  1067.  not alter the project's private structure.
  1068.  
  1069.  How to make events appear both x days BEFORE and y days AFTER a date?
  1070.  If you want an event to be displayed 3 days before the 10.10.93 AND 2 days
  1071.  AFTER, you must simply set the date to BEFORE 16.10.93 and days to 5!
  1072.  
  1073.  When I try to execute a program from Recall it crashes!
  1074.  When running Recall  from  the  WBStartup-drawer,  some   programs seem to
  1075.  cause an out of memory-guru.  This is  not   a bug in Recall!  I have only
  1076.  discovered this  error  while   running   ToolManager  from  WBStartup and
  1077.  Maxiplan V4.09 (started as an   event   within Recall) while running under
  1078.  WB3.0. Other programs  might  cause  similar  problems.  The   solution is
  1079.  however,  quite simple; enter 'Wait 2' on the line above your program, and
  1080.  your program will work just fine.
  1081.  
  1082.  Why not include a new type 'Echo' which prints the message to CLI
  1083.  This can easily be done setting the  type  of event to Execute, and adding
  1084.  something like this to the list of texts: '"echo "this will be printed out
  1085.  in CLI"'.
  1086.  
  1087.  How do I play a tune while displaying an event?
  1088.  You have to create two events to  do  a  thing like that (or by creating a
  1089.  little batch-file to execute).  The  first  event must be of execute-type:
  1090.  "run >NIL: play birthday.mod".   The  second  event  must  be of alert- or
  1091.  requester-type with the desired text.  The dates of the two events must of
  1092.  course be the same.
  1093.  
  1094.  Annoying shell-windows when executing events
  1095.  If the executed program echoes a text to the screen or if you use the Run-
  1096.  
  1097.  command, you should enter  ">NIL:"  after  your  commands  to suppress any
  1098.  popping up shell-window.
  1099.  
  1100.  
  1101.  See also Known bugs
  1102.  
  1103.  
  1104. History
  1105.  
  1106.  The Recall version follows the notation <version>.<revision>, meaning that
  1107.  V2.10 is greater than V2.1.  The current  version can be printed out using
  1108.  'Version full Recall'  or  by  selecting  About  from  the Project-menu in
  1109.  Recall Preferences.
  1110.  
  1111.  24.May.93 V1.0
  1112.  First released version.
  1113.  
  1114.  25.May.93 V1.1
  1115.  RecallPrefs used to crash when   it   loaded  an  old project and the user
  1116.  selected 'Use'.  Now fixed.
  1117.  
  1118.  29.May.93 V1.2
  1119.  RecallPrefs now  tries  to  open  its  window  using  the current font set
  1120.  by  the  user.   If  this  fails  (usually  when  the window  becomes  too
  1121.  big  for   the   screen),  it  settles  for  the   standard   Topaz8-font.
  1122.  RecallPrefs now uses NewLook-style in menus.
  1123.  
  1124.  04.Jun.93 V1.3
  1125.  Recall now only updates  the   project  when  it's  absolutely necessary .
  1126.  This saves a lot of disk-access.  Fixed  a  bug in the compare date & time
  1127.  header  file.  Fixed a bug in the  purge-function  which  removed   events
  1128.  with  empty dates...  Updating  the   attributes   of   the   event is now
  1129.  speeded     up.      RecallPrefs       disables      the     corresponding
  1130.  (Exact/Before/After)-cyclebutton  if  Datestring      or  Timestring   are
  1131.  empty.    Made   more compliant with Commodore's Style Guide.
  1132.  
  1133.  08.Jun.93 V1.4
  1134.  Oooooops, made a  MAJOR  mistake   by   releasing   V1.3 too soon!  In the
  1135.  last minute a minor bug was fixed, and  this resulted of course in a MAJOR
  1136.  bug at another location in the program! Selecting 'Before' or 'After' with
  1137.  dates did not work at  all...  nor  did  #  Days  or  Repeat every #...  I
  1138.  PROMISE to check more   thoroughly   in  the  future...   When testing the
  1139.  project from  RecallPrefs,  the program asked  for a assign called 'REC:'.
  1140.  Now removed...  Recall  must  be   located    in    your   working   path.
  1141.  (i.e.  >path work:recall).  Fixed  a  bug   which   resulted  in a ghosted
  1142.  textstring  when editing a line of text...
  1143.  
  1144.  30.Oct.93 V1.5
  1145.  Fixed a bug which caused  Recall  to  return  a returncode and generate an
  1146.  error when testing a project from 'Recall Preferences'.  Now fixed.
  1147.  
  1148.  08.Nov.93 V1.6
  1149.  Fixed two  tiny  bugs  which  caused  Enforcer  hits.   Since  they  where
  1150.  positioned in the main loop of  both 'Recall Preferences' and Recall, hits
  1151.  appeared on every GADGETUP  IDCMP  and  event.   Now  fixed.  (Reported by
  1152.  Henning Schmiedehausen).  Selecting the GetFile  gadget  when no event was
  1153.  selected also caused an Enforcer hit.  Now fixed.  The Add Text gadget was
  1154.  sometimes not disabled, making it possible  to  add text to a non-existing
  1155.  event.  Now fixed.  Added an extra menu item to save project under default
  1156.  name without terminating  the  program.   (Suggested  by Raoul Rodriguez).
  1157.  Also, the new archive is  better  organized  with drawers for preferences,
  1158.  install and documentation.  The Installer-script  has been rewritten.  The
  1159.  documentation has been processed once  again, making (hopefully) easier to
  1160.  read (all chapter has a right justified margin...).
  1161.  
  1162.  12.Nov.93 V1.7
  1163.  The two binaries is now reduced in  size.  The sources may now be compiled
  1164.  by double-clicking on the  Build-icon  in  the  Source drawer.  Added more
  1165.  tips to 'Troubleshooting'.  The installer-script  is made more generic and
  1166.  will also detect if the user already has a Recall project and rename it to
  1167.  'Recall_OLD.prefs' when installing new example project. Also   reorganized
  1168.  the .guide, so that the chapters  appear  in  the same order as when using
  1169.  browse.  Corrected a few mistakes  and  misspellings in the documentation.
  1170.  Fixed a bug which caused repeating  events   not to be displayed when they
  1171.  should.  Also, when counting days  between  different months and years did
  1172.  not come out right.  Now fixed.   (thanks to Juha Kallioinen for questions
  1173.  about weekly events, which led me into finding this bug!)
  1174.  
  1175.  16.Nov.93 V2.0
  1176.  This version  is  re-written  from  scratch.  Uses  MUImaster.library  for
  1177.  creating  a great looking  GUI.   Font-adaptable  window.  Sizable window.
  1178.  Short-cuts for  most  functions.   IFF-FORM  .prefs-file.   Possibility to
  1179.  group  events, flash screen  before  event, automatically  delete  expired
  1180.  events, acknowledging events alerts.   Confirm   actions  in  Preferences.
  1181.  Setting the date and  time   from  a  'calendar'.  Possibility to copy and
  1182.  sort lines of text.   Better   readability   and  better organized .guide.
  1183.  Documentation also included in ASCII-format.  Unstall-script to delete the
  1184.  Recall package on  your  harddisk.   Importing  and  exporting projects of
  1185.  different formats (may be  controlled  via  the  Preferences).  More show-
  1186.  options.  More date fields in the  same line.  Do not use reqtools.library
  1187.  if not requested.  The program  may be iconified.  On-line-HELP.  Although
  1188.  Recall has gained a lot  of  functions,  it  is  actually smaller in size!
  1189.  Optimized code if a faster CPU is available.  Much more...
  1190.  
  1191.  07.Dec.93 V2.1
  1192.  NEW All  binaries  and  the  installation-script  is  localized.  English,
  1193.      french, spanish, german, swedish and norwegian catalogs are included.
  1194.  NEW Speeded up Recall 30%!!!
  1195.  NEW All binaries has reduced in size!  Rewritten to use tiny ROM-routines!
  1196.  NEW Postponing events!  If you put off an  event, it will keep nagging you
  1197.      until you acknowledge it!
  1198.  NEW Updating event's attributes is now speeded up (a lot!) in Preferences.
  1199.  NEW Safer IFF-saving.
  1200.  NEW Settings menu-item: Confirm executables?
  1201.  NEW Recall requesters now state the  current  date  in their titles.  Uses
  1202.      the selected dateformat.
  1203.  NEW Recall uses less memory than before!
  1204.  NEW Rearranged the GUI a little:  The date and time are separated from the
  1205.      text-group, the getfile-gadget now  uses  the button-background set in
  1206.      MUIprefs.
  1207.  NEW The  day-of-the-month  gadgets  are  now   of  BOOL  type  (like  Time
  1208.      Preferences).
  1209.  NEW The calendar can now be controlled from the keyboard.
  1210.  FIX Events with x days BEFORE  or  AFTER  were  not displayed (Reported by
  1211.      Dirk B÷hmer).
  1212.  FIX Acknowledging alerts did not  work,  unless  'Acknowledge events?' was
  1213.      NOT checked.  This  bug  did  not  appear  when  the  binaries was not
  1214.      optimized by the compiler... Strange...
  1215.  FIX The GUI of the installation-script was  messy  if  you did not use the
  1216.      Topaz.font (Reported by Heikki Kantola).
  1217.  FIX The GetFile-gadget did not work! (Reported by Olav Mⁿller).
  1218.  FIX GetFile did not allocate it's memory properly.
  1219.  FIX The GetFile-gadget was not documented.
  1220.  FIX Purging did not remove all the events that it should.
  1221.  FIX Corrected several bugs regarding  ghosted  buttons  and  the update of
  1222.      attributes.
  1223.  FIX One node in  the  documentation  of  Recall  was  not linked properly.
  1224.      (Reported by Olav Mⁿller).
  1225.  FIX Recall and Recall Preferences did not  deallocate all used memory when
  1226.      terminating.
  1227.  FIX Recall crashed if Use ReqTools? was checked but not available!
  1228.  FIX Events set to whenever or anytime did  not show if BEFORE or AFTER was
  1229.      selected.
  1230.  FIX The stringgadgets do no  longer  get  activated  when  selecting a new
  1231.      event/text from the listviews, making  it  easier  to use the keyboard
  1232.      short-cuts.
  1233.  FIX Recall Prefs no longer  asks  for  a  file  to  import  or export when
  1234.      SYS:Tools/ReConvert is not available...
  1235.  FIX Changed the name of some  items.   'Whenever' and 'Anytime' changed to
  1236.      'Every day' and  'All  day',  respectively.   'Once  a  day'  has been
  1237.      changed to 'Daily'.
  1238.  FIX Enforcer Hit when accidentally loading certain non Recall IFF-files.
  1239.  FIX All output to shell from Recall will  now be routed to the same shell-
  1240.      window!
  1241.  
  1242.  03.Mar.94 V2.2
  1243.  NEW Italiano catalogs included.
  1244.  NEW Nederlands catalogs included.
  1245.  NEW SBasePro 4 batch script for  converting  a  database of birthdays to a
  1246.      Recall project included.  Script provided by Thorsten Gau.
  1247.  NEW Recall only updates the project  when  the  user has selected a button
  1248.      which alters any of the internal flags.  Less disk-access.
  1249.  NEW The ASL requester now excludes the .info-files.
  1250.  FIX Recall now handles dates after 30. january 2000.
  1251.  FIX When displaying requesters with  only  one  button (no Cancel-button),
  1252.      pressing OK was interpreted as Cancel.
  1253.  FIX Events of type 'Execute' were only run once when 'Confirm executables'
  1254.      was not checked.
  1255.  FIX You could always cancel an  alert,  even  if the 'Confirm Alerts?' was
  1256.      not checked...
  1257.  FIX Prefs only allocates memory for the Asl-requester when needed.
  1258.  FIX Fixed a bug in  the  IFF  save-routine,  which  caused  a GURU on some
  1259.      machines.
  1260.  FIX Safer IFF-saving.
  1261.  FIX All binaries reduced in size (again).  The checker is now only 8Kb!
  1262.  FIX Recall used c-lib routines to get  and  calculate date and time.  This
  1263.      could be quite annoying when  running  SnoopDOS  in the background, as
  1264.      these  functions  access  ENV:TZ  a  lot.   Switched  to  ROM-routines
  1265.      instead.
  1266.  FIX Recall Preferences did not show events which printed texts to a shell-
  1267.      window when testing the project.
  1268.  FIX Recall Preferences would not update the  list  of texts when the first
  1269.      event in the list was highlighted, and user opened another project.
  1270.  FIX Corrected some mistakes and misleadings in the docs.
  1271.  
  1272.      The ReqTools.library will not be  included  from  V2.2  and later in a
  1273.      desperate try to reduce the size  of  the archive.  Anyway, 99% of all
  1274.      Amiga-owners already have this library...
  1275.  
  1276.  28.Apr.94 V2.3
  1277.  NEW Suomi catalogs included.
  1278.  FIX Better Nederlands translation.  Now fits on a 640x200 screen.
  1279.  FIX Faster rendering of alerts.
  1280.  FIX Fixed a bug which caused Alerts to  crash on some machines.  Thanks to
  1281.      Olaf Seibert for suggesting the byte-split...
  1282.  FIX The Recall-documentation  contained  an  unknown  link.   Reported  by
  1283.      Philip Meyer.
  1284.  FIX The calendar crashed on some machines when using MUI V2.0.
  1285.  
  1286.      The source will not be included in  V2.3  and later in order to reduce
  1287.      the size of the  archive.  (Not  many  were  interested in the source,
  1288.      anyway...)
  1289.  
  1290.  
  1291.  
  1292. Afterword
  1293.  
  1294.  Send e-mail, bug-reports, comments, suggestions, postcards, A4000 etc. to:
  1295.  
  1296.  Between 15th of August and 5th of June (every year) I will be available at
  1297.  the following address:
  1298.  
  1299.    Ketil Hunn
  1300.    Leilighet 107
  1301.    Fabrikkveien 4-8 / Blokk C
  1302.    N-6400 Molde
  1303.    NORWAY
  1304.  
  1305.  or by e-mail:
  1306.    ketil@lyr.dhmolde.no
  1307.  
  1308.  In the summertime however, I  will  be  available at the following address
  1309.  and only by ordinary mail:
  1310.  
  1311.    Ketil Hunn
  1312.    Nabbetorpveien 35B
  1313.    N-1632 Gamle Fredrikstad
  1314.    NORWAY
  1315.  
  1316.  no e-mail (you can send e-mail to  ketil@dhmolde.no  - I may be logging in
  1317.  from another university during the summer...)
  1318.  
  1319.  ********************************** NOTE **********************************
  1320.  If you are to report  a  bug,  it  is  extremely important that you  state
  1321.  which version of Recall  you  use,  what  your system-configuration is and
  1322.  what programs you launch  in  WBStartup  and  your startup-sequence.  This
  1323.  will make it easier for me to locate  bugs and problems.  It would also be
  1324.  of help if you mentioned where you got this application.
  1325.  ********************************** NOTE **********************************
  1326.  
  1327.  Please  check  'Future',    'Known   bugs'   and  'Troubleshooting' before
  1328.  reporting any bugs!
  1329.  
  1330.  I hope you agree with me,  that  this program is the BEST reminder-utility
  1331.  available for the Amiga.  If not, tell my why!
  1332.  
  1333.  
  1334.  Enjoy!
  1335.  
  1336.  Ketil Hunn
  1337.  Molde, March 1994
  1338.  
  1339.  
  1340.  
  1341. 68000 CPU or NO harddrive
  1342.  
  1343.  This version of Recall uses MUImaster.library  to  create its GUI.  Due to
  1344.  the modular concept of MUI, it  takes  a  little  longer to open the first
  1345.  application that uses the  MUImaster.library.   Running  Recall from a OFS
  1346.  disk will take a while.
  1347.  
  1348.  Also, since the management  of  the  layout  of  the objects requires many
  1349.  complex calculations, running this application on a "bare" 68000, could be
  1350.  a bit slow.
  1351.  
  1352.  If you are using  a  8-colour  high  resolution,  interlaced workbench and
  1353.  think the application seems slow,  just  enter  the MUIPrefs and force the
  1354.  Recall-package to open on  a  non-interlaced,  4-colour screen, and every-
  1355.  thing will go smoother...   Change  the  size  and  position of the Recall
  1356.  windows according to your  wishes  and  SAVE  it.   Change these values as
  1357.  little as possible, as changing this  needs  a lot of calculation and will
  1358.  probably be quite slow at small machines.
  1359.  
  1360.  Also, the calendar window should  be  closed  when  you're not setting the
  1361.  date or time, since scrolling through the  list  of events will be a great
  1362.  deal slower when the window needs to updated.
  1363.  
  1364.  Changing the window refresh  type  and  window  redraw  routine  to a type
  1365.  matching your machine, will also help.
  1366.  
  1367.  If you still think the application seems too slow, you should either buy a
  1368.  faster computer or use any version of Recall prior to V2.0 instead...
  1369.  
  1370.  
  1371.  See also Describing MUI
  1372.  
  1373.  
  1374. About MagicUserInterface
  1375.  
  1376.                            This application uses
  1377.  
  1378.  
  1379.                          MUI - MagicUserInterface
  1380.  
  1381.                    (c) Copyright 1993 by Stefan Stuntz
  1382.  
  1383.  
  1384.  MUI is a system to generate  and  maintain graphical user interfaces. With
  1385.  the  aid  of  a  preferences program,  the  user of an application has the
  1386.  ability to customize the outfit according to his personal taste.
  1387.  
  1388.  MUI is distributed as shareware.  To  obtain a complete package containing
  1389.  lots of examples and more information about registration please look for a
  1390.  file  called "muiXX.lha" (XX  means  the  latest  version  number) on your
  1391.  local bulletin boards or on public domain disks.
  1392.  
  1393.            If you want to register directly, feel free to send
  1394.  
  1395.  
  1396.                            DM 20.-  or  US$ 15.-
  1397.  
  1398.                                    to
  1399.  
  1400.                               Stefan Stuntz
  1401.                          Eduard-Spranger-Stra▀e 7
  1402.                               80935 Mⁿnchen
  1403.                                  GERMANY
  1404.  
  1405.