home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 2 / FFMCD02.bin / new / os20 / util / recall / docs / recallconverter.ascii < prev    next >
Encoding:
Text File  |  1993-12-21  |  5.2 KB  |  153 lines
  1. Documentation for Recall Converter
  2.  
  3.  This document describes the usage of Recall Converter.
  4.  
  5.  All binaries, sourcecodes and documentation  regarding Recall Converter is
  6.  copyrighted to Ketil Hunn 1993.
  7.  
  8.  
  9. Description
  10.  
  11.  This utility is implemented with all you database-users out there in mind.
  12.  As previous releases of Recall did  not include such a utility, converting
  13.  a list of birthdays from a database  to  a Recall project could be quite a
  14.  time consuming task.   Well,  not  any  more!   The  whole  process is now
  15.  automated (Automatic for the people, right?).
  16.  
  17.  By using this handy  utility,  you  can  easily  convert all your database
  18.  direct to Recall project format.  The program  can be run as a stand-alone
  19.  utility or as an automatic process controlled by Recall Preferences!
  20.  
  21.  The utility is self-explaining and easy to use.
  22.  
  23.  
  24. Explaining the source listview
  25.  
  26.  This listview lists  all  possible  source  formats  of  the  project.  By
  27.  selecting one of its items, you describe  what type or format the selected
  28.  source-file will be.  The  selected  item  will be highlighted.  Currently
  29.  these formats and types are supported:
  30.  
  31.  ASCII
  32.  Recall V1.x
  33.  Recall V2.0
  34.  
  35.  
  36. Explaining the destination listview
  37.  
  38.  This listview lists all possible  destination  formats of the project.  By
  39.  selecting one of its items, you describe  what type or format the selected
  40.  destination-file  will  be.   The  selected   item  will  be  highlighted.
  41.  Currently these formats and types are supported:
  42.  
  43.  ASCII
  44.  Recall V2.0
  45.  
  46.  
  47. Using the source stringgadget
  48.  
  49.  This gadget is a standard stringgadget,  in  which  the user may enter the
  50.  name of the source-file to be  loaded  and converted.  The exact path must
  51.  be included in the filename, unless the  file is resident in the currently
  52.  active drawer.
  53.  
  54.  
  55. Using the GetSource gadget
  56.  
  57.  A more convenient  way  of  selecting  a  source  file,  is  of  course by
  58.  selecting it in a filerequester.  Pressing  this gadget pops up a standard
  59.  ASL filerequester, in which you may select your source file.  The selected
  60.  filename will be copied to the source stringgadget.
  61.  
  62.  
  63. Using the destination stringgadget
  64.  
  65.  This gadget is a standard stringgadget,  in  which  the user may enter the
  66.  name of the destination file to  be  loaded and converted.  The exact path
  67.  must be included in  the  filename,  unless  the  file  is resident in the
  68.  currently active drawer.
  69.  
  70.  
  71. Using the GetDestination gadget
  72.  
  73.  A more convenient way of  selecting  a  destination  file, is of course by
  74.  selecting it in a filerequester.  Pressing  this gadget pops up a standard
  75.  ASL filerequester, in which  you  may  select  your destination file.  The
  76.  selected filename will be copied to the destination stringgadget.
  77.  
  78.  
  79. Converting your project
  80.  
  81.  Pressing this gadget starts the  converting  procedure.  The selected file
  82.  will be loaded  in  the  selected  source  format  and  saved  in  the new
  83.  destination format under the selected destination filename.  When convert-
  84.  ing large projects, this process may take a while.
  85.  
  86.  The gadget  will  be  ghosted  as  long  as  long  as  the  sourcename  or
  87.  destinationname are not correct or not entered.
  88.  
  89.  If an error is detected when  loading the sourcefile, the whole converting
  90.  process will be aborted and a requester will pop up, explaining the error.
  91.  If this occurs, please check if you  have selected the right source format
  92.  for the selected file.
  93.  
  94.  
  95.  
  96. Describing the ASCII format
  97.  
  98.  All ASCII texts in the following format are accepted:
  99.  
  100.  EVENT/A,DATE,TIME,TEXT/M
  101.  
  102.  All items must be  enclosed  in  quotation  marks  '"'  and separated by a
  103.  comma.  NOTE! NO comma at end of line!  As stated, DATE, TIME and TEXT may
  104.  be omitted and TEXT may occur as many times as you wish.
  105.  
  106.  As an example, the following lines will be accepted:
  107.  "Event","Text1","Text2"
  108.  "Remember","29.8.1993","11:00","To put your jeans on BEFORE your shoes!"
  109.  "Event2","12.12.1993","00:00"
  110.  
  111.  
  112. Describing the Recall V1.x format
  113.  
  114.  This format is the format used previous  to version 2.0 of Recall.  If you
  115.  have an old project which you want  to  use under V2.0, just select Recall
  116.  V1.x as source and Recall V2.0  as  destination  and go for it!  The 'old'
  117.  V1.x-format may also be imported directly into Recall Preferences.
  118.  
  119.  
  120. Describing the Recall V2.0 format
  121.  
  122.  Beginning with version 2.0, the  format  is  now  standard IFF FORM.  This
  123.  simplifies and standardize  the  reading  and  saving  of  the project, in
  124.  addition to reducing the project's size by 20%!
  125.  
  126.  
  127. Troubleshooting
  128.  
  129.  @{b}How do I load a SuperBase 4 Database file from Recall?@{ub}
  130.  First you must save your database in ASCII format.  Select Process->Export
  131.  from the menu in SuperBase  4  and  press  OK  in the next two requesters.
  132.  Then select the name of  your  ASCII-database-file  and  press OK to save.
  133.  After  this,  all  you  need  is   to  select  Import->ASCII  from  Recall
  134.  Preferences and it will be loaded as a standard Recall V2.0 project file!
  135.  
  136.  SEE ALSO Describing the ASCII format
  137.  
  138.  
  139. Known bugs
  140.  
  141.  No known bugs
  142.  
  143.  
  144.  
  145. Versions
  146.  
  147.  The Recall Converter version  follows   the  notation <version>.<revision>
  148.  (DD.MM.YY), meaning that V2.10  is   greater   than   V2.1.   The  current
  149.  version can be printed  out   using   'Version  full  RecallConverter'  or
  150.  by selecting Project->About from the menu.
  151.  
  152.  17.Nov.93 V1.0:  First released version.
  153.