home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD1.bin / new / util / misc / recall / docs / reconvert.ascii < prev    next >
Text File  |  1994-04-28  |  8KB  |  209 lines
  1.  Documentation for ReConvert
  2.  ---------------------------
  3.  This document describes the usage of ReConvert.
  4.  
  5.  
  6.  Description                        
  7.  Selecting the source format        
  8.  Selecting the destination format   
  9.  Using the Source stringgadget      
  10.  Using the GetSource gadget         
  11.  Using the Destination stringgadget 
  12.  Using the GetDestination gadget    
  13.  Converting your projects           
  14.  Troubleshooting                    
  15.  Known bugs                         
  16.  History                            
  17.  
  18.  
  19.  All  binaries,  source-codes  and  documentation  regarding  ReConvert  is
  20.  copyrighted to Ketil Hunn 1993-1994.  The copyrights stated for the Recall
  21.  package applies to this program also.
  22.  
  23.  
  24. Description
  25.  
  26.  This utility is implemented with all you database-users out there in mind.
  27.  As previous releases of Recall did  not include such a utility, converting
  28.  a list of birthdays from a database  to  a Recall project could be quite a
  29.  time consuming task.   Well,  not  any  more!   The  whole  process is now
  30.  automated (Automatic for the people, right?).
  31.  
  32.  By using this handy utility, you can easily convert your database directly
  33.  to Recall project format.  The program can be run as a stand-alone utility
  34.  or as an automatic process controlled by Recall Preferences!
  35.  
  36.  The utility is self-explaining and easy to use.
  37.  
  38.  
  39. Explaining the source listview
  40.  
  41.  This listview lists  all  possible  source  formats  of  the  project.  By
  42.  selecting one of its items, you describe  what type or format the selected
  43.  source-file will be.  The  selected  item  will be highlighted.  Currently
  44.  these formats and types are supported:
  45.  
  46.  ASCII       
  47.  Recall V1.x 
  48.  Recall V2.x 
  49.  
  50.  
  51. Explaining the destination listview
  52.  
  53.  This listview lists all possible  destination  formats of the project.  By
  54.  selecting one of its items, you describe  what type or format the selected
  55.  destination-file  will  be.   The  selected   item  will  be  highlighted.
  56.  Currently these formats and types are supported:
  57.  
  58.  ASCII       
  59.  Recall V2.x 
  60.  
  61.  
  62. Using the source stringgadget
  63.  
  64.  This gadget is a standard stringgadget,  in  which  the user may enter the
  65.  name of the source-file to be  loaded  and converted.  The exact path must
  66.  be included in the filename, unless the  file is resident in the currently
  67.  active drawer.
  68.  
  69.  
  70. Using the GetSource gadget
  71.  
  72.  A more convenient  way  of  selecting  a  source  file,  is  of  course by
  73.  selecting it in a filerequester.  Pressing  this gadget pops up a standard
  74.  ASL filerequester, in which you may select your source file.  The selected
  75.  filename will be copied to the source stringgadget.
  76.  
  77.  
  78. Using the destination stringgadget
  79.  
  80.  This gadget is a standard stringgadget,  in  which  the user may enter the
  81.  name of the destination file which  will  be created.  The exact path must
  82.  be included in the filename,  or  else  the  file  will  be created in the
  83.  current active drawer.
  84.  
  85.  
  86. Using the GetDestination gadget
  87.  
  88.  A more convenient way of  selecting  a  destination  file, is of course by
  89.  selecting it in a filerequester.  Pressing  this gadget pops up a standard
  90.  ASL filerequester, in which  you  may  select  your destination file.  The
  91.  selected filename will be copied to the destination stringgadget.
  92.  
  93.  
  94. Converting your project
  95.  
  96.  Pressing this gadget starts the  converting  procedure.  The selected file
  97.  will be loaded  in  the  selected  source  format  and  saved  in  the new
  98.  destination format under the selected destination filename.  When convert-
  99.  ing large projects, this process may take a while.
  100.  
  101.  The gadget will be ghosted as  long as the source-name or destination-name
  102.  are not correct or not entered.
  103.  
  104.  If an error is detected when  loading the sourcefile, the whole converting
  105.  process will be aborted and a requester will pop up, explaining the error.
  106.  If this occurs, please check if you  have selected the right source format
  107.  for the selected file.
  108.  
  109.  
  110. Describing the ASCII format
  111.  
  112.  All ASCII texts in the following format are accepted:
  113.  
  114.  EVENT/A,DATE/A,TIME/A,TEXT/M
  115.  
  116.  All items must be  enclosed  in  quotation  marks  '"'  and separated by a
  117.  comma.  NOTE! NO comma at end of line!   As stated, TEXT may occur as many
  118.  times as you wish.  If  these  fields  do  not  exist  in you database, it
  119.  should quite easy to create them globally and then save the database as an
  120.  ASCII-file.
  121.  
  122.  As an example, the following lines will be accepted:
  123.  "Remember","29.8.1993","11:00","To put your jeans on BEFORE your shoes!"
  124.  "Event2","12.12.1993","00:00"
  125.  
  126.  
  127. Describing the Recall V1.x format
  128.  
  129.  This format is the format used previous  to version 2.0 of Recall.  If you
  130.  have an old project which you want  to  use under V2.x, just select Recall
  131.  V1.x as source and Recall V2.0  as  destination  and go for it!  The 'old'
  132.  V1.x-format may also be imported directly into Recall Preferences.
  133.  
  134.  
  135. Describing the Recall V2.x format
  136.  
  137.  Beginning with version 2.0, the  format  is  now  standard IFF FORM.  This
  138.  simplifies and standardize  the  reading  and  saving  of  the project, in
  139.  addition to reducing the project's size by 20%!
  140.  
  141.  
  142. Troubleshooting
  143.  
  144.  How do I load a SuperBase 4 Database file from Recall?
  145.  First you must save your database in ASCII format.  Select Process->Export
  146.  from the menu in SuperBase  4  and  press  OK  in the next two requesters.
  147.  Then select the name of  your  ASCII-database-file  and  press OK to save.
  148.  After  this,  all  you  need  is   to  select  Import->ASCII  from  Recall
  149.  Preferences and it will be loaded as a standard Recall V2.x project file!
  150.  
  151.  An example script is included  in  the  Scripts  drawer and shows how data
  152.  from a database may be extracted and converted into a Recall project file.
  153.  The script is copyrighted Thorsten Gau.
  154.  
  155.  
  156.  SEE ALSO Describing the ASCII format
  157.  
  158.  
  159. Known bugs
  160.  
  161.  - When setting the source type to ASCII,  any  attempt to load a NON ASCII
  162.    file will crash the program!
  163.  - The ASCII-module is not very stable  and  will  not accept data in other
  164.    formats than described.
  165.  
  166.  
  167. History
  168.  
  169.  The ReConvert version follows  the  notation <version>.<revision>, meaning
  170.  that V2.10 is  greater  than  V2.2.   The  current  version can be printed
  171.  out  using  'Version  full  RecallConverter'  or  by selecting
  172.  Project->About from the menu.
  173.  
  174.  16.Nov.93 V1.0
  175.  First released version.
  176.  
  177.  05.Dec.93 V1.1
  178.  NEW The program is now localized.
  179.  NEW Great deal of the source  was  rewritten to use internal rom-routines.
  180.      This reduces the size almost 5K!
  181.  FIX The program did not deallocate all memory used.
  182.  FIX The default source is now "ENVARC:in  file" and default destination is
  183.      "ENVARC:out file", making it easier to access the ENVARC: drawer.
  184.  FIX Import  from  ASCII  interpreted  the  date  and  time  values  wrong.
  185.      (Reported by Dirk Böhmer).
  186.  FIX Enforcer Hit when accidentally  loading  certain  non Recall IFF-files
  187.      (such as ReqTools.prefs).
  188.  FIX It was not possible to save the converted file under the default name.
  189.  
  190.  04.Mar.94 V1.2
  191.  NEW Italiano catalogs included.
  192.  NEW Nederlands catalogs included.
  193.  FIX ASCII import did  not  handle  commas  inside  strings.   (Reported by
  194.      Thorsten Gau).
  195.  FIX ReConvert  was  looking   for   the   on-line-guide   under  the  name
  196.      'RecallConverter.guide', while it in fact was named 'ReConvert.guide'.
  197.      (Reported by Michael Zielinski).
  198.  FIX Fixed a bug in  the  IFF  save-routine,  which  caused  a GURU on some
  199.      machines.
  200.  FIX Safer IFF-saving.
  201.  FIX Prefs only allocates memory for the Asl-requester when used.
  202.  FIX ReConvert caused a guru on  some  machines,  when it was controlled by
  203.      Recall Preferences.
  204.  
  205.  28.Apr.94 V1.3
  206.  NEW Suomi catalogs included.
  207.  FIX Update of Nederlands catalogs.
  208.  
  209.