home *** CD-ROM | disk | FTP | other *** search
/ BUG 11 / BUGCD1998_02.ISO / email / sime / simdemo.z / v3tov4.txt < prev    next >
Text File  |  1996-07-26  |  7KB  |  127 lines
  1. Simeon 3.x to Simeon 4.0.x Upgrade Notes
  2.  
  3. This document describes the issues involved with upgrading from Simeon 3.x
  4. to Simeon 4.0.x.
  5.  
  6. Viewer Associations
  7. -----------------
  8.  
  9. Viewer Associations in Simeon  3.x have been replaced  by Helper Applications
  10. in Simeon 4.0.x.  Simeon 4.0.x does NOT automatically convert V3.x Assocations into
  11. V4.0.x Helper Applications. The following paragraphs contain the detailed
  12. discussion of the differences between the two, the reasons why we changed to the
  13. new format and the tools which have been provided in Simeon 4.0.x to ease the
  14. transition from 3.x.
  15.  
  16. There are major differences between Simeon  3.x Association definitions
  17. and Simeon  4.0.x Helper Application definitions.  The V3.x Association
  18. description was based (centered) on the MIME type, whereas V4.0.x Helper
  19. Applications is centered on the helper application.   As a result, in
  20. version 4.0.x, a helper application can act as a viewer for many MIME types, and
  21. a particular MIME type may be used for  many file types.  In practice, there is
  22. generally one file type for each MIME type -- but not always.
  23.  
  24. The key motivation for the format change is that the version 4.0.x
  25. format makes it much easier to bind with and use operating system provided
  26. association information.   For example, we can now incorporate Windows
  27. application registry databases and Mac Finder databases into our "list
  28. of available helper applications" transparently.   Version 4 is helper
  29. application centric, rather than MIME centric.
  30.  
  31. Following is a pseudo syntax for the option formats that an administrator
  32. has to deal with.
  33.  
  34. Version 3.x Association Option Format:
  35.  
  36.   Associations.IDList                        '{' id_list '}'
  37.   Associations.{assoc_id}.Name               string
  38.   Associations.{assoc_id}.MimeType           MIME_major '/' MIME_minor
  39.   Associations.{assoc_id}.Mac                Mac_file_creator '/' Mac_file_type
  40.   Associations.{assoc_id}.Unix               extension '/' Unix_pathname
  41.   Associations.{assoc_id}.Win                extension '/' DOS_pathname
  42.  
  43. Version 4.0.x Association Option Format:
  44.  
  45.   Viewers.IDList                                        '{' id_list '}'
  46.   Viewers.{viewer_id}.Name                              string
  47.   Viewers.{viewer_id}.MimeList                          '{' id_list '}'
  48.   Viewers.{viewer_id}.MimeType.{mime_id}.Name           MIME_major '/' MIME_minor
  49.   Viewers.{viewer_id}.MimeType.{mime_id}.UnixExtensions (extension '/')+ 
  50.   Viewers.{viewer_id}.MimeType.{mime_id}.WinExtensions  (extension '/')+ 
  51.   Viewers.{viewer_id}.MimeType.{mime_id}.MacExtensions  (Mac_file_type '/')+ 
  52.   Viewers.{viewer_id}.UnixCommand                       Unix_pathname
  53.   Viewers.{viewer_id}.WinCommand                        DOS_pathname
  54.   Viewers.{viewer_id}.MacCommand                        Mac_pathname
  55.   Viewers.{viewer_id}.MacCreator                        Mac_file_creator
  56.  
  57. Rules for translation from 3.x to 4.0.x
  58.  
  59.   Associations.{assoc_id}.Name -> Viewers.{viewer_id}.Name
  60.   Associations.{assoc_id}.MimeType -> Viewers.{viewer_id}.MimeType.1.Name
  61.   Associations.{assoc_id}.Unix -> Viewers.{viewer_id}.MimeType.1.UnixExtensions
  62.                                -> Viewers.{viewer_id}.UnixCommand
  63.   Associations.{assoc_id}.Win  -> Viewers.{viewer_id}.MimeType.1.WinExtensions
  64.                                -> Viewers.{viewer_id}.WinCommand
  65.   Associations.{assoc_id}.Mac  -> Viewers.{viewer_id}.MimeType.1.MacExtensions
  66.                                -> Viewers.{viewer_id}.MacCommand
  67.                                -> Viewers.{viewer_id}.MacCreator
  68.  
  69. Note that there is no way to automatically convert between these formats
  70. because of the fundamental change to the basis of the format.  A program
  71. cannot make a decision about what to name the new association, because
  72. the v3 associations were named from the MIME type -- not the
  73. application.  We believe that automatic conversion will lead to
  74. confusing configuration for users, and require that they somehow try to
  75. "clean up" the results of the conversion.  We have instead provided the 
  76. following alternative mechanisms and work arounds to getting the v3
  77. association information into v4.
  78.  
  79. 1.  Simeon v4 supports the concept of an "association wizard".   The
  80. wizard does two key things to help users manage their associations
  81. without having to know too much about file types (extensions) and MIME.
  82. First, it will access and merge any operating system association
  83. information with the list of defined Simeon associations (either user or
  84. sysdflt.tcl defined).   This allows Simeon to always present association
  85. options that are immediately quite complete in terms of what is
  86. available to run on your platform.   Secondly, Simeon is capable of
  87. learning about new associations by asking for any information it does
  88. not have, then remembering that information as new or extended
  89. association information in the user's configuration.
  90.  
  91. We believe that this defines a mechanism for "evolving" association
  92. information over time, making it much easier and a much less onerous
  93. task for users.
  94.  
  95. 2.  Modify the shipped sysdflt.tcl to include your favorite site
  96. associations in the new format.   The new format uses a completely
  97. different namespace to keep the two sets of options completely separate.
  98. You can quickly generate new sets of association information using the
  99. new association management preference dialogue, saving options to a
  100. file, then copying the appropriate section back to a site "sysdflt.tcl"
  101. file.
  102.  
  103. Note that Simeon 4.0.x does an automatic conversion of any other
  104. configuration options that have changed format or semantics from version
  105. 3.x.
  106.  
  107. Local Address Books
  108. -------------------
  109.  
  110. Simeon 4.0.x 16 bit will automatically convert version 3.x local address
  111. books the first time it accesses them.  Once they have been converted,
  112. Simeon 3.x will be unable to read them. If you wish to access your version 3.x
  113. local address books with the 32 bit version of Simeon 4.0.x, you will have to
  114. export them via the 16 bit version first. 
  115.  
  116. Note:
  117. Local address book formats are platform specific.  This means that local address
  118. books created by the Win 16 version of Simeon 4.0.x can only be read by Win 16
  119. Simeon 4.0.x.  This is true for all platforms: Win16,Win32, Macintosh and Motif.
  120. As a result, Win 16 Simeon cannot read local address books created by Win 32
  121. Simeon 4.0.x and vice versa. If you wish to access an address book created on a
  122. different platform you must export it into a text file using the address book
  123. export utility provided in Simeon and then import it with
  124. the new platform version you wish to use.
  125.  
  126. End Simeon 3.x to Simeon 4.0.x Upgrade Notes
  127.