home *** CD-ROM | disk | FTP | other *** search
/ Chip: Shareware for Win 95 / Chip-Shareware-Win95.bin / komunik / esscode / readme.txt < prev    next >
Text File  |  1996-10-06  |  21KB  |  429 lines
  1. ESS-Code 7.8
  2. Copyright 1993, 1994, 1995, 1996, Michel Forget
  3. Electric Storm Software
  4.  
  5.      The documentation for this archive is located in ESSCODE.TXT, which
  6. should be located in the same directory as this document.  This list of
  7. bug fixes and changes made to ESS-Code is in chronological order; the new
  8. information appears at the end of the document.
  9.  
  10. May 30, 1995:  ESS-Code 6.4a
  11. [These problems have been solved.]
  12.  
  13. BUG #1:  ESS-Code 6.4 inserts an "extra" backslash in the
  14.          filename of the program manager item created by the
  15.          installation program.  This would prevent ESS-Code
  16.          from executing properly.
  17.  
  18. BUG #2:  ESS-Code does not prevent the user from executing
  19.          the client modules directly.  The only module that
  20.          can be executed directly is "eshell.exe".
  21.  
  22. June 4, 1995: ESS-Code 6.4b
  23. [These problems have been solved.]
  24.  
  25. BUG #3:  When things go wrong, they rarely do so in an insignificant                   way.  ESS-Code would not operate properly on many system
  26.          because it could not execute the server modules correctly.  An
  27.          extra backslash was mistakenly inserted into the filename at
  28.          execution time, thus causing an error.  This problem did not
  29.          affect Windows95 users or OS/2 Warp users.  For those that it
  30.          did affect, though, ESS-Code would not work at all.
  31.  
  32. July 2, 1995:  ESS-Code 6.6
  33. [These problems have been solved.]
  34.  
  35. BUG #4:  The status display was not being updated correctly.
  36.          Old information, such as parts of words or numbers,
  37.          was not being erased before the new information was
  38.          drawn.
  39.  
  40. BUG #5:  The MIME-Decode file conversion method was capable of
  41.          corrupting the address space of ESS-Code, which would cause
  42.          a system crash.  This problem did not seem to affect anyone,
  43.          but it is now fixed.
  44.  
  45. BUG #6:  The "Split File" & "Join File" commands did not update the status
  46.          display after completion.
  47.  
  48. NEW:     ESS-Code now allows the user to drag a file from the program
  49.          manager (or explorer) and drop it on the ESS-Code application
  50.          window.  If such an action is taken, ESS-Code will display a
  51.          dialog box asking how the file should be processed.
  52.  
  53. July 7, 1995:  ESS-Code 6.7
  54. [These problems have been solved.]
  55.  
  56. There are days when nothing happens the way it should; the days the
  57. previous version of ESS-Code was released was apparently one of those
  58. days.  The drag & drop support did not work in the previous version,
  59. and there were a number of "empty" alert boxes in the installation
  60. program.  This release solves those problems.  I apologize for any
  61. inconvenience my error might have caused you.
  62.  
  63. MIME-Encoding has also been fixed.  This problem only affected the 16-BIT
  64. version, so users of the 32-BIT version were never troubled by it.
  65.  
  66. July 25, 1995:  ESS-Code 6.8
  67.  
  68. NEW:  The Windows95 user interface has now been applied to ESS-Code.
  69.  
  70. NEW:  ESS-Code now has an installation wizard to automate the setup
  71.       process.
  72.  
  73. NEW:  ESS-Code can now be uninstalled automatically by Windows95.
  74.  
  75. July 27, 1995:  ESS-Code 6.9
  76. [These problems are now solved.]
  77.  
  78. BUG #7:  There were several small typographical errors in the setup wizard
  79.          and the application itself.
  80.  
  81. July 29, 1995:  ESS-Code 7.0 (BETA)
  82. [These problems have been solved.]
  83.  
  84. BUG #8:  The CTL3D32.DLL dynamic link library was not being installed
  85.          correctly for Windows95 Build #501 -- it worked fine for previous
  86.          builds, apparently.
  87.  
  88. August 5th, 1995:  ESS-Code 7.1 (Release Version)
  89. [These problems have been solved.]
  90. [ESS-Code has now been tested with Windows95 b490c - no problems were found.]
  91. [ESS-Code has now been tested with WindowsNT 3.51 - no problems were found.]
  92.  
  93. BUG #9:  In some situations, ESS-Code would not be able to locate the
  94.          second and subsequent segments of a multi-part UUEncoded
  95.          file.
  96.  
  97. BUG #10: The F1 key will now actually open the online help instead of
  98.          generating a spurious warning.
  99.  
  100. NEW:     ESS-Code now allows you to view the LOG file.
  101.  
  102. NEW:     ESS-Code now allows you to print the LOG file.
  103.  
  104. NEW:     The setup utility has been improved.
  105.  
  106. August 8th, 1995:  ESS-Code 7.2 (Maint. Release)
  107. [These problems have been solved.]
  108.  
  109. NEW:     The ESS-Code LOG now shows the date and time of each entry.
  110.  
  111. BUG FIX: The "Split File" function now works with Windows95/NT.  When a file
  112.          is split, an extension is appended to the end of the original
  113.          filename.  The original extension is not lost.
  114.  
  115.          EX:  This Is A Long Name.ZIP = This Is A Long Name.ZIP.1
  116.  
  117. BUG FIX: The "Join File" function now works with Windows95/NT.
  118.  
  119. BUG FIX: The "Split File" & "Join File" features now identify themselves
  120.          correctly in the ESS-Code LOG.
  121.  
  122. If you have any problems with ESS-Code, please contact mforget@planet.eon.net
  123. as quickly as possible.  This application is a work-in-progress at all
  124. times, and will continue to be updated frequently as new features are added
  125. and problems are solved.  The more quickly you make your problem known,
  126. the more quickly it will be resolved.
  127.  
  128. ESS-Code has been tested with the latest builds of Windows95 & WindowsNT
  129. without any apparent trouble.
  130.  
  131. September 17th, 1995:  ESS-Code 7.3 
  132. [These problems have been solved.]
  133.  
  134. BUG FIX:  There have been various problems with the "Setup" module; this
  135.           time, it the registry handling has been improved and error
  136.           reporting capabilities have been added.  There is also a manual
  137.           installation method that you can use if the "Setup" module still
  138.           does not work for you.
  139.  
  140. October 24th, 1995:  ESS-Code 7.4
  141.  
  142. NEW:      ESS-Code now supports a complete batch language.  This
  143.           language is documented in the online manual included in this
  144.           archive and is meant to act as an aid to system automation
  145.           for users with specialized needs.
  146.  
  147. NEW:      The online manual has been revised; it now has a much more
  148.           attractive "look & feel", in addition to providing more
  149.           information than previous version of the online manual provided.
  150.  
  151. BUG FIX:  The ESS-Code LOG will no longer be corrupted as it is written.
  152.           Previous versions of ESS-Code did very strange things to the
  153.           formatting of the log file as it was being created.
  154.  
  155. BUG FIX:  Error messages will now be displayed properly on high resolution
  156.           monitors; previously, message boxes would be extremely small.
  157.  
  158. December 25, 1995:  ESS-Code 7.5
  159.  
  160. NEW:      The UUEncode file conversion method allows a destination name to be
  161.           inserted into the encoded data.  At the request of many users, I
  162.           have enabled ESS-Code to automatically detect that name when
  163.           decoding.  If a destination name is found in the encoded data,
  164.           it will be displayed in the "destination" field when you are asked
  165.           to select a destination name.
  166.  
  167. NEW:      If you discover a conversion method that ESS-Code does not
  168.           support, you can now incorporate it directly (and seamlessly)
  169.           into ESS-Code through a new feature known as an extensible menu
  170.           system.  Extensions are menu entries that are displayed at the
  171.           bottom of the file menu.
  172.  
  173.  
  174.           There are two steps involved in creating an ESS-Code extension:
  175.  
  176.           1) In the ESSCODE.INI file (located in c:\windows) add a new line
  177.              using the following format:
  178.  
  179.              EXTENSION = <menu entry name>,<script>
  180.  
  181.              Example:  EXTENSION = "View .&ZIP Contents",c:\viewzip.ess
  182.  
  183.              This command MUST be typed exactly as it appears, since case
  184.              and spacing is expecially important.
  185.  
  186.              In the <menu entry name> field, you may specify a keyboard
  187.              shortcut by typing a "&" immediately before the letter you
  188.              want to be able to press to activate the menu entry.
  189.  
  190.           2) Create an ESS-Code extension script that has the same name
  191.              and location as the <script> specified above.
  192.  
  193.              An example script is shown below, followed by a detailed
  194.              dicussion of all the script commands available.
  195.  
  196.              ' Extract .ZIP File USING PKUNZIP.
  197.              ' This script could be improved by using the "ASK INPUT FILE"
  198.              ' and "ASK OUTPUT FILE" commands.
  199.              SET TEMPLATE C:\PKUNZIP.EXE %RESPONSE %RESPONSE %RESPONSE
  200.              SET YES -d
  201.              SET NO -e
  202.              ASK YN Do you want to preserve the directory structure of the ZIP file?
  203.              ASK INFORMATION What is the name of the ZIP file to extract?
  204.              ASK INFORMATION What folder do you want to extract the ZIP file to?
  205.              ASK CONTINUE Proceed?
  206.              GO
  207.              TELL The file has been extracted.
  208.  
  209.           Extension Script Commands
  210.           -------------------------
  211.  
  212.           Command                 Explanation
  213.           -------                 -----------
  214.           '                       This is the symbol used for a comment.
  215.                                   Any extension script commands or text
  216.                                   that appears on the same line as this
  217.                                   symbol will be ignored.
  218.  
  219.           SET TEMPLATE <text>     This command is required.  It describes
  220.                                   what the final command line passed to the
  221.                                   tool the script is being written for will
  222.                                   look like.  As the other extension script
  223.                                   commands obtain information from the user,
  224.                                   the "%RESPONSE" fields are replaced (from
  225.                                   left to right) with the actual information
  226.                                   supplied by the user.  Several example
  227.                                   templates are shown below:
  228.  
  229.                                   SET TEMPLATE c:\z.exe -%RESPONSE $RESPONSE
  230.  
  231.                                   In this case, the user might be expected to
  232.                                   enter a one letter command switch, which
  233.                                   ESS-Code would then insert immediately
  234.                                   after the "-".
  235.  
  236.                                   SET TEMPLATE type %RESPONSE
  237.  
  238.                                   In this case, the user might be expected to
  239.                                   enter the name of the file, which ESS-Code
  240.                                   would then insert after the text "type "
  241.                                   (including the space).
  242.  
  243.                                   The template is requried because it
  244.                                   determines where the information will be
  245.                                   placed on the command line.
  246.  
  247.           ASK CONTINUE <text>     This command will cause a message box to
  248.                                   appear containing <text>.  If the user
  249.                                   responds by clicking on the "No" button,
  250.                                   the extension script will end.  The most
  251.                                   command use of this command is to ask the
  252.                                   user "Do you really want to proceed with
  253.                                   this operation?".
  254.  
  255.           ASK YN <text>           This command will cause a message box to
  256.                                   appear containing <text> (a question).  The
  257.                                   user can either click on the "Yes" button or
  258.                                   the "No" button in response to the question.
  259.                                   This command must be used in conjunction
  260.                                   with the "SET YES" and "SET NO" commands
  261.                                   discussed below.
  262.  
  263.           SET YES <text>          This command must appear BEFORE the "ASK YN"
  264.                                   command.  It determines what text will be
  265.                                   placed on the command line if the user
  266.                                   clicks on the "Yes" button in response to
  267.                                   an "ASK YN" command.
  268.  
  269.           SET NO <text>           This command must appear BEFORE the "ASK YN"
  270.                                   command.  It determines what text will be
  271.                                   placed on the command line if the user
  272.                                   clicks on the "No" button in response to
  273.                                   an "ASK YN" command.
  274.  
  275.           SET YES ABORT           This command must appear BEFORE the "ASK YN"
  276.                                   command.  It will cause the extension
  277.                                   script to end if the user clicks on the
  278.                                   "Yes" button in response to an "ASK YN"
  279.                                   command.
  280.  
  281.           SET NO ABORT            This command must appear BEFORE the "ASK YN"
  282.                                   command.  It will cause the extension
  283.                                   script to end if the user clicks on the
  284.                                   "No" button in response to an "ASK YN"
  285.                                   command.
  286.  
  287.           TELL <text>             This command will cause a message box to
  288.                                   appear containing <text>.  it is used to
  289.                                   inform the user of information that you
  290.                                   feel they should be aware of.
  291.  
  292.           SET DISPLAY MODE <mode> This command is used to determine how the
  293.                                   tool the script is being written for will
  294.                                   look when it is executed.  There are four
  295.                                   display modes available:
  296.  
  297.                                   Mode            Explanation
  298.                                   ----            -----------
  299.  
  300.                                   HIDDEN          The tool will not be
  301.                                                   visible.  This allows
  302.                                                   seamless integration with
  303.                                                   ESS-Code.
  304.  
  305.                                   MINIMIZED       The tool will not be
  306.                                                   visible, but can be
  307.                                                   made visible by clicking
  308.                                                   on the desktop icon that
  309.                                                   represents it.
  310.  
  311.                                   BACKGROUND      The tool will be visible,
  312.                                                   but only a a background
  313.                                                   window (portions of the
  314.                                                   window may be obscured by
  315.                                                   other windows).
  316.  
  317.                                   FOREGROUND      The tool will be visible,
  318.                                                   and it will execute in the
  319.                                                   foreground (the entire
  320.                                                   window can be seen).
  321.  
  322.           ASK INFORMATION <text>  This command will cause a dialog box
  323.                                   containing <text> (a request for
  324.                                   information) to appear on the screen.
  325.                                   The user can type a response, which
  326.                                   ESS-Code will insert into the template.
  327.  
  328.           ASK INPUT FILE <title>  This command will cause the standard file
  329.                                   selection dialog box to appear, with the
  330.                                   title bar set to <title>.  This command
  331.                                   should be used to request the name of a
  332.                                   file from the user.  It should only be used
  333.                                   for requesting source (input) files, since
  334.                                   it requires that the file selected be a
  335.                                   valid, existing file.
  336.  
  337.           ASK OUTPUT FILE <title> This command will cause the standard file
  338.                                   selection dialog box to appear, with the
  339.                                   title bar set to <title>.  This command
  340.                                   should be used to request the name of a
  341.                                   file from the user.  It should only be used
  342.                                   for requesting destination (output) file
  343.                                   names, since it does not require that the
  344.                                   name selected be an existing file.
  345.  
  346.           GO                      This command instructs ESS-Code to
  347.                                   execute the command line.  This does
  348.                                   not automatically end the script, but
  349.                                   the only command that it would make sense
  350.                                   to use after the tool has been executed is
  351.                                   "TELL".
  352.  
  353. April 26, 1996:  ESS-Code 7.6
  354.  
  355. BUG FIX: The "Join File" command now works properly.  ESS-Code will no
  356.          longer cause an "illegal operation" error when this command is
  357.          used.
  358.  
  359. BUG FIX: When MIME-Encoding, the subject will no longer be placed in
  360.          quotation marks.
  361.  
  362. BUG FIX: The ESS-Code .LOG file will now format information written to
  363.          it correctly.
  364.  
  365. NEW:     You can now decode directly from the clipboard.  To do this,
  366.          select "Decode From Clipboard" from the "File" menu, and
  367.          (when prompted) select the appropriate decoding method.
  368.  
  369. NEW:     After a conversion operation, ESS-Code will now display a list of
  370.          files that were affected.  The list is composed of two sections,
  371.          which are files read/opened and files created/written.  This list
  372.          will also be written to the ESS-Code .LOG file to make it easier
  373.          to track information over time.
  374.  
  375. NEW:     ESS-Code now has a conversion wizard, which allows users to encode
  376.          or decode a file using a wizard style interface.  The user is asked
  377.          questions, and then ESS-Code makes intelligent decisions about how
  378.          to proceed.  The conversion wizard is particularly useful for
  379.          new users, because it makes decoding extremely painless and encoding
  380.          very easy.  To use the conversion wizard, select "Conversion
  381.          Wizard" from the "File" menu.
  382.  
  383. July 6, 1996:  ESS-Code 7.7
  384.  
  385. NEW:     This version of ESS-Code supports the BinHex conversion method.  It
  386.          is now possible to use ESS-Code to decode a file that was encoded
  387.          on a Macintosh (or another platform using a BinHex encoding software
  388.          package).  The BinHex support is made possible through the inclusion
  389.          of xbin, written by Dave Johnson (Brown University Computer Science).
  390.  
  391.          The xbin package has been recompiled (and adapted where necessary)
  392.          for use within ESS-Code.
  393.  
  394.          The conditions of use for xbin (as stated in the source code) allow
  395.          it to be used but not sold.  Therefore, it must be clearly stated
  396.          that xbin is not an official component of ESS-Code.  You may use
  397.          it for as long as you like without feeling any pressure at all to
  398.          register ESS-Code; xbin is included solely for the convenience of
  399.          ESS-Code users.  The source code to xbin (as modified for ESS-Code)
  400.          is freely available to any who request it.
  401.  
  402. October 6, 1996:  ESS-Code 7.8
  403.  
  404. NEW:     The ESS-Code user interface has been enhanced to provide more information in a
  405.          visually pleasing fashion.
  406.  
  407. NEW:     You can now use the conversion wizard when decoding from the clipboard; this
  408.          allows you to use ESS-Code to very quickly decode a file.  After using edit and
  409.          copy in your mail reader to place the file to decode on the clipboard, simply
  410.          select "Decode From Clipboard".  The only question you will be asked is what the
  411.          name and location of the destination file is to be on your computer system.
  412.  
  413. NEW:     There is now an option to automatically launch the conversion wizard when a
  414.          decode from clipboard operation is initiated.  This defaults to active to
  415.          complement the feature described above, but can be deactivated by unchecking
  416.          the "Clipboard AutoWizard" entry in the "Options" menu.
  417.  
  418. NEW:     There are now two new preset segment sizes; 720 Disk & 1.44 MB disk.
  419.  
  420. NEW:     The documentation for ESS-Code has been updated; it is now more up-to-date.
  421.  
  422. BUG FIX: The number of files XBIN-Decoded is now displayed in the main window.  Previously,
  423.          this information was not being displayed.
  424.  
  425. IMPORTANT:
  426.  
  427. My mailing address has changed; it has been updated in the application, help files, and
  428. documentation.
  429.