home *** CD-ROM | disk | FTP | other *** search
/ Netscape Plug-Ins Developer's Kit / Netscape_Plug-Ins_Developers_Kit.iso / UTILS / COMPRESS / WINCODE / README.TXT next >
Encoding:
Text File  |  1995-09-09  |  12.9 KB  |  293 lines
  1.      Wincode: Multi-Purpose Encoder/Decoder for Windows
  2.              (C) _Snappy_ (1993-1995)
  3. ------------------------------------------------------------
  4.              written by George H. Silva
  5.  
  6.  
  7.      ***PLEASE DISTRIBUTE FREELY WITH ALL FILES INTACT***
  8.  
  9. Files:    WINCODE.EXE    the main executable program
  10.           WCENGINE.DLL   dynamic link library of coding functions
  11.           WCEHOOK.DLL    dynamic link library of menu hook functions
  12.           WCEFMEXT.DLL   File Manager Extension dynamic link library
  13.           WCHLPKEY.DLL   Help file option dynamic link library
  14.           WINSORT.EXE    a companion file-sort utility
  15.           UNINSTLL.EXE   Wincode package UnInstall program
  16.           ZIPLINK.EXE    executable link to PKZIP/PKUNZIP
  17.           ZIPLINK.PIF    ZIPLINK.EXE program information file
  18.           SUM.EXE        a BONUS "sum -r/size" DOS utility
  19.           README.NOW     important info file
  20.           README.TXT     this file
  21.           HELPME.TXT     Wincode basics and information for obtaining
  22.                          the HELP file (WINCODE.HLP)
  23.           INSTALL.EXE    the Install/Upgrade program
  24.           INSTALL.HLP    the Installer HELP file
  25.           INSTALL.INF    the Installer information file
  26.           CHECKSUM.REF   checksum reference file
  27.  
  28.      ***SEE THE HELPME.TXT FILE FOR MORE INFORMATION***
  29.  
  30. This file contains the following information:
  31.  
  32. I.    About Wincode
  33. II.   Wincode Features (very brief list!)
  34. III.  Coming Soon
  35. IV.   Requirements
  36. V.    Installing/Running/UnInstalling Wincode
  37. VI.   BONUS 'sum -r/size' Utility
  38. VII.  Availability
  39. VIII. Other _Snappy_ Software
  40. IX.   Mailing List
  41. X.    Known Limitations
  42. XI.   Note to AOL Users
  43. XII.  Copyrights
  44.  
  45.  
  46.  
  47. I. *** About Wincode ***
  48.  
  49. Wincode is a Windows 3.1x program which converts 8-bit BINARY (EXE, COM,GIF,
  50. etc) files to 7-bit ASCII (Text) files (and vice versa) through a process
  51. known as bit-shifting. Wincode currently supports UU/XX/Base64 (MIME 1.0
  52. conformant) en/de-coding and BINHEX decoding (encode support will follow).
  53. This BINARY/ASCII conversion allows you to send and receive binary files via
  54. e-mail or any other ascii-based communications system. It provides a quick
  55. and easy way to distribute programs to people all over the world (it takes
  56. a few minutes, on average, for e-mail to reach across the world). UUcoding
  57. is a common practice on many Internet NewsGroups in which users wish to
  58. exchange binary data. Base64 coding is used by MIME (Multipurpose Internet
  59. Mail Extensions) conformant e-mail software as a method for attaching binary
  60. data to ascii e-mail. BINHEX is a popular encoding algorithm used mainly on
  61. Apple Macintosh computers. All these methods perform the same overall
  62. function (i.e. allow binary data to be safely transmitted through e-mail)
  63. but require different formatting algorithms (e.g. BINHEX supports Run-Length
  64. Encoding). In the future, Wincode will also support BINHEX encoding and will
  65. handle the actual "e-mailing" of the data...
  66.  
  67. Wincode and the associated executables and DLLs (NOT including the HELP file)
  68. are distributed as FREEWARE. However, we want to make a distinction: the
  69. program is FREEWARE, but it is NOT Public Domain. _Snappy_ still retains the
  70. Copyright to the source code and to the use and distribution of the program.
  71. The HELP file is available for a small fee ($5.00 US) but is NOT required for
  72. Wincode to function correctly. Ordering the HELP file also entitles you to
  73. future updates and e-mail based support. The $5.00 fee is mainly to offset
  74. development costs and the amount of personal time invested. See below and the
  75. file HELPME.TXT for more information on obtaining support.
  76.  
  77. Wincode is 100% compatible with all standard UUcoders, MIME 1.0 conformant
  78. software and BINHEX 4.0 coders. The MIME (Base64) support was developed under
  79. the guidelines of RFC 1521 (September 1993) and is subject to our understanding
  80. of the document. We welcome all comments and error corrections. We have tried
  81. to incorporate as many extra features as possible to make the en/de-coding
  82. process painless. The average user may not need/use all of Wincode's features,
  83. but they *are* Free!
  84.  
  85. NOTE TO DEVELOPERS: WCENGINE.DLL contains ALL of Wincode's 'working' code
  86. (currently) accessed through 73 functions/procedures. We created this SIMPLE
  87. interface to allow Developers to integrate the Wincode Engine into any
  88. program. We will provide the API and royalty free usage to interested
  89. developers under certain conditions. Please contact _Snappy_ for more
  90. details or send a BLANK e-mail to:
  91.  
  92.    development@snappy.globalone.net
  93.  
  94. to receive current development information.
  95.  
  96.  
  97.  
  98. II. *** Wincode Features (very brief list!) ***
  99.  
  100.        - Full featured Windows 3.1 program
  101.        - Easy access ButtonBar for hassle-free operation
  102.        - Drag and Drop support (use for batch en/de-coding -> Wincode also
  103.          allows multi-file selection from File Open dialogs)
  104.        - SMART decoding (handles single files, multi-part files, can
  105.          determine what is encoded or not, etc. -> see the HELP file for
  106.          more information)
  107.        - Fully configurable...We're not joking!
  108.        - EMBL UUcode compatible
  109.        - Supports UU, XX or User defined En/De-coding
  110.        - Supports Base64 (MIME conformant) En/De-coding
  111.        - Supports BINHEX DECODING (encoding is coming).
  112.        - Supports En/De-coding to/from the Clipboard!
  113.        - Supports automatic ZIP/UNZIP (requires PKWare's ZIP/UNZIP 2.0)
  114.        - Application menu hooking option to integrate Wincode's menu
  115.        - Includes INSTALL program for upgrades
  116.        - Includes UNINSTALL program for removal
  117.        - Integrated file-sorting companion program (separate
  118.          executable for easier upgrading) which handles MANY types
  119.          of file header formats
  120.        - Multimedia support - see the HELP file for details
  121.        - It's ALL FREE...
  122.  
  123.  
  124.  
  125. III. *** Coming Soon ***
  126.  
  127.           - BINHEX encoding support. DECODING IS HERE NOW.
  128.           - The ability to handle actual "e-mailing" of encoded data files.
  129.           - The ability to decode MULTIPLE file code-types automatically.
  130.             Winsort will be able to TRY (it can't always be right!) and
  131.             determine CODE TYPE so that you could drop multiple files on
  132.             Wincode and it will decode by CODE TYPE also. What this boils
  133.             down to is that you can, for example, select a BINHEX file, three
  134.             UUEncoded files and two BASE64 files - and Wincode will be able
  135.             to decode them all in one drag/drop or file decode selection. No
  136.             more changing the CODE TYPE for each file.
  137.           - User suggestions...?
  138.  
  139.  
  140.  
  141. IV. *** Requirements ***
  142.  
  143.          - IBM compatible running DOS 3.3 or higher
  144.          - 286 or higher processor with at least 2MB memory
  145.          - Windows 3.1/3.11 running in standard or enhanced mode OR Win95
  146.          - About 1MB of disk space without HELP file (~1.3MB with HELP file)
  147.            (Sorry about the disk space - this should be reduced in the coming
  148.             months with the release of Delphi32)
  149.  
  150.  
  151.  
  152. V. *** Installing/Running/UnInstalling Wincode ***
  153.  
  154. If you have not already done so, expand the ZIP archive into a temporary
  155. directory (or a floppy-disk). Start Windows, select FILE|RUN from Program
  156. Manager or File Manager and type in the full path of the INSTALL.EXE program
  157. (run it). The INSTALL program will copy/expand all the files to a directory
  158. you specify (overwriting older files), upgrade your WINCODE.INI (if you are
  159. running an older version of Wincode) and create a Program Manager Group and/or
  160. icon. See the HELPME.TXT file for basic instructions on using Wincode.
  161.  
  162. ***IMPORTANT NOTE: ALL files (listed above) must be present in the same
  163. directory for Installer to function properly. You should INSTALL first,
  164. then move selected files to directories of your choice (i.e. delete the
  165. README.TXT, place SUM.EXE in your DOS directory, etc.). The install program
  166. uses the Windows LZEXPAND.DLL to decompress and copy the required files. If
  167. you receive any error messages during install, please contact _Snappy_ for
  168. assistance.
  169.  
  170. Wincode can now be un-installed in 2 easy steps. First, run Wincode and
  171. select 'Options|Configuration...' (CTRL-F) from the menu. You will see the
  172. configuration dialog which has an 'UnInstall...' button. Choose this to select
  173. the UnInstall method. The UnInstaller will remove/copy/list all files
  174. included in the Wincode package. However, it does NOT remove itself OR the
  175. directories that Wincode may have used. Therefore, the second step is to
  176. remove these directories and UNINSTLL.EXE from your drive. Wincode should now
  177. be completely erased from your drive.
  178.  
  179.  
  180.  
  181. VI. *** BONUS 'sum -r/size' Utility ***
  182.  
  183. We have included a small DOS executable which will quickly calculate 
  184. UNIX 'sum -r/size' checksums. This program is useful for checking the
  185. integrity of files that have been transferred over communications lines
  186. that are questionable (or, to some extent, checking for virus infections).
  187. Wincode supports both line and/or file Checksum checking while decoding
  188. and will insert Checksums (line and/or file) while encoding. This utlity is 
  189. provided as a stand-alone DOS program. For program usage, type 'SUM' (with 
  190. no parameters) at the DOS prompt. The included file 'CHECKSUM.REF' contains
  191. the proper checksum values for all of the files in the Wincode package.
  192.  
  193.  
  194.  
  195. VII. *** Availability ***
  196.  
  197. Recent versions of Wincode (or other _Snappy_ software) are always
  198. available at the following locations:
  199.  
  200.     - The Internet - the _Snappy_ Software site! All of our software is
  201.       available by three different methods:
  202.  
  203.       1) WWW forms - point your browser at: http://snappy.globalone.net/
  204.          and check out our HomePage!
  205.  
  206.       2) Anonymous FTP - visit us at: snappy.globalone.net
  207.  
  208.       3) Automated e-mail - send a request to our server and receive an
  209.          encoded copy by e-mail. Visit our HomePage for more info or send
  210.          a BLANK e-mail to: snappy@snappy.globalone.net for a TEXT copy
  211.          of our HomePage.
  212.  
  213.     - CompuServe (check the WinShare forum; keyword: Snappy, Wincode, etc.)
  214.  
  215.     - America Online (keyword: Snappy, Wincode, etc.)
  216.  
  217.  
  218.       
  219. VIII. *** Other _Snappy_ Software ***
  220.  
  221. We generally develop utility programs for Windows 3.1x and (soon) Win95. We
  222. currently have a handful of programs that we're working on which we will
  223. release as FREEWARE. We welcome all ideas for future projects. Please check
  224. out our internet site to see what we have to offer!
  225.  
  226.  
  227.  
  228. IX. *** Mailing List ***
  229.  
  230. We have been trying to maintain a mailing list of all users who have
  231. offered advice, bug reports or helped in BETA testing. Being on this
  232. list entitles you to FREE upgrades (personally e-mailed pre-releases) 
  233. and support. (in other words, you don't have to download Wincode from
  234. the Internet or an Online Service/BBS). For more information see the
  235. HELPME.TXT file.
  236.  
  237.  
  238.  
  239. X. *** Known Limitations ***
  240.  
  241. 1) Certain video hardware/software combinations (such as ATI cards/drivers)
  242.    are known to cause irregular displays of various Wincode dialogs. Common
  243.    symptoms include misaligned text, irregularly spaced progress bars and
  244.    "absent menus".
  245. 2) The Hooking feature is not fully supported by all applications. If you
  246.    have problems hooking an application, try using the "Hook Tuning" options.
  247.    If you experience any other difficulties, please let us know.
  248.    
  249. These known problems do NOT affect Wincode's coding functionality.
  250.  
  251.  
  252.  
  253. XI. *** Note to AOL Users ***
  254.  
  255. Here are answers to two common problems experienced by AOL Users:
  256.  
  257. 1) When downloading USENET posts from AOL, be certain that you receive the
  258.    ENTIRE message. You do this by pressing the 'More...' button until it
  259.    disappears or grays-out. AOL downloads files in 28K chunks and usually
  260.    does NOT receive the entire post when you select it. We have been told that
  261.    the 'Logging' option is the way to go for capturing LARGE files. For more
  262.    info, please contact the AOL support personnel.
  263. 2) If you want to Hook the AOL menu, use 'America  Online' as the Application
  264.    Name (do NOT include the quotes). The point is that there are TWO spaces
  265.    between 'America' and 'Online'.
  266.  
  267.  
  268.  
  269. XI. *** Copyrights ***
  270.  
  271. - portions of this program are copyright (C) 1991,1993 Borland
  272. - Windows is a trademark of Microsoft Corporation
  273. - PKZIP/UNZIP are copyright 1989-1993 PKWARE Inc. All Rights Reserved.
  274. - GIF is a service mark of CompuServe Incorporated
  275. - WordPerfect is a registered trademark of Novell, Inc.
  276. - Procomm Plus for Windows is copyright 1992-1993 Datastorm Technologies, Inc.
  277. - Star Trek: The Next Generation is a registered trademark of Paramount
  278.   Pictures
  279.  
  280.  
  281. Have fun!
  282.  
  283. _Snappy_ Software ;-)
  284.  
  285.  
  286. _Snappy_ Info:  snappy@snappy.globalone.net
  287. Wincode Info:   wincode@snappy.globalone.net
  288. Bug reports:    bugs@snappy.globalone.net
  289. FeedBack:       feedback@snappy.globalone.net
  290. --------------------------------------------------------------------------
  291.  
  292. [GHS 8/18/95]
  293.