home *** CD-ROM | disk | FTP | other *** search
/ PC-Online 1998 February / PCOnline_02_1998.iso / filesbbs / win3x / wc273r16.arj / WC273R16 / README.TXT < prev    next >
Text File  |  1996-10-31  |  16KB  |  359 lines
  1.      Wincode: Multi-Purpose Encoder/Decoder for Windows
  2.               (C) _Snappy_ (1993-1996)
  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.           WCESOCK.EXE    a companion Winsock e-mail/post daemon
  15.           WCEPADDR.WAB   default Wincode address book
  16.           WINSORT.EXE    a companion file-sort utility
  17.           UNINSTLL.EXE   Wincode package UnInstall program
  18.           ZIPLINK.EXE    executable link to PKZIP/PKUNZIP
  19.           ZIPLINK.PIF    ZIPLINK.EXE program information file
  20.           VSWLINK.EXE    Windows executable link to VSDLINK
  21.           VSDLINK.EXE    executable link to DOS Virus Scan software
  22.           VSDLINK.PIF    VSDLINK.EXE program information file
  23.           VSDLINK.DAT    VSDLINK Virus Scanner exit codes
  24.           MACAPPFC.DAT   MAC Finder information database
  25.           WCEDCSIG.DAT   Application information database
  26.           WCEMIME.DAT    MIME information database
  27.           WAOL.HKS       Hook Script for AOL software
  28.           WINCIM.HKS     Hook Script for WinCIM software
  29.           SUM.EXE        a BONUS "sum -r/size" DOS utility
  30.           README.NOW     important info file
  31.           README.TXT     this file
  32.           HELPME.HLP     Wincode basics and information for obtaining
  33.                          the real HELP file (WINCODE.HLP)
  34.           LICENSE.TXT    _Snappy_ "User-Friendly" FREEWARE License
  35.           INSTALL.EXE    the Install/Upgrade program
  36.           INSTALL.HLP    the Installer HELP file
  37.           INSTALL.INF    the Installer information file
  38.           CHECKSUM.REF   checksum reference file
  39.           FILE_ID.DIZ    BBS identification file
  40.  
  41.         ****************************************************
  42.  
  43.         PLEASE SEE THE FOLLOWING FILES FOR MORE INFORMATION:
  44.  
  45.         README.NOW
  46.         HELPME.HLP (formerly HELPME.TXT -> now a Windows HELP file)
  47.         VSDLINK.DAT
  48.         LICENSE.TXT
  49.  
  50.         ****************************************************
  51.  
  52.  
  53. This file contains the following information:
  54.  
  55. I.    About Wincode
  56. II.   Wincode Features (very brief list! - MANY NEW FEATURES :-)
  57. III.  Coming Soon
  58. IV.   Requirements
  59. V.    Installing/Running/UnInstalling Wincode
  60. VI.   Availability
  61. VII.  Note to HELP Registered Users
  62. VIII. Copyrights
  63.  
  64.  
  65. NOTE: There is alot of helpful information in the file HELPME.HLP.
  66. You can now automatically access this file from Wincode by selecting
  67. any "Help" option (this file is now the "default help file" if you
  68. are not a registered user - if you are registered, this file is not
  69. needed since it duplicates portions of the *real* HELP file :-).
  70.  
  71.  
  72.  
  73. I. *** About Wincode ***
  74.  
  75. Wincode is a Windows 3.1x program which converts 8-bit BINARY (EXE,
  76. COM,GIF, etc) files to 7-bit ASCII (Text) files (and vice versa)
  77. through a process known as bit-shifting. Wincode currently supports
  78. UU, XX, USR, Base64 (MIME 1.0 conformant), BINHEX, BTOA and BOO
  79. encoding/decoding. This BINARY/ASCII conversion allows you to send
  80. and receive binary files via e-mail or any other ascii-based
  81. communications system. It provides a quick and easy way to distribute
  82. programs to people all over the world (it takes a few minutes, on
  83. average, for e-mail to reach across the world). UUcoding is a common
  84. practice on many Internet NewsGroups in which users wish to exchange
  85. binary data. Base64 coding is used by MIME (Multipurpose Internet
  86. Mail Extensions) conformant e-mail software as a method for attaching
  87. binary data to ascii e-mail. BINHEX is a popular encoding algorithm
  88. used mainly on Apple Macintosh computers. BTOA is a somewhat
  89. different variation of the common BINARY/ASCII conversion process
  90. which supports simple compression, several checksum options and will
  91. generally create encoded files that are smaller than other methods
  92. due to its conversion algorithm (mod 85). BOO is an older (extinct?)
  93. algorithm used in cross-platform file transfers that is provided for
  94. compatibility (it requires previous knowledge of decoded output
  95. filesize and may hence be unreliable). All these methods perform the
  96. same overall function (i.e. allow binary data to be safely
  97. transmitted through e-mail) but require different formatting
  98. algorithms (e.g. BINHEX supports Run-Length Encoding, BTOA uses mod
  99. 85 coding, etc).
  100.  
  101. Wincode and the associated executables and DLLs (NOT including the
  102. HELP file) are distributed as FREEWARE. However, we want to make a
  103. distinction: the program is FREEWARE, but it is NOT Public Domain.
  104. _Snappy_ still retains the Copyright to the source code and to the
  105. use and distribution of the program (see the file LICENSE.TXT). The
  106. HELP file is available for a small fee ($10.00 US) but is NOT
  107. required for Wincode to function correctly. Ordering the HELP file
  108. also entitles you to future updates and e-mail based support. The
  109. $10.00 fee is mainly to offset development costs and the amount of
  110. personal time invested. See below and the file HELPME.HLP for more
  111. information on obtaining support.
  112.  
  113. Wincode is 100% compatible with all standard UUcoders, MIME 1.0
  114. conformant software, BINHEX 4.0 and BTOA v4.0 and v5.2 coders. The
  115. MIME (Base64) support was developed under the guidelines of RFC 1521
  116. (September 1993) and is subject to our understanding of the document.
  117. The BINHEX support was developed under the guidelines of RFC 1741
  118. (December 1994) and is subject to our understanding of the document.
  119. The BTOA v4.0 and v5.2 support was developed based on freely
  120. available documents by Paul Rutter, Joe Orost & Stefan Parmark (the
  121. creators of BTOA). We welcome all comments and error corrections. 
  122.  
  123. As part of our goal to support all BINARY/ASCII conversion methods in
  124. one (quality :-) product, Wincode now supports encoding/decoding of
  125. *seven* different formats. We have tried to incorporate as many extra
  126. features as possible to make the en/de-coding process painless (check
  127. out the two forms of auto-detection used by the decode algorithm -
  128. refer to the HELPME.HLP file (Decode section) for details). The
  129. average user may not need/use all of Wincode's features, but they
  130. *are* Free!
  131.  
  132. NOTE TO DEVELOPERS: WCENGINE.DLL contains ALL of Wincode's 'working'
  133. code (currently) accessed through 80+ functions/procedures. We
  134. created this SIMPLE interface to allow Developers to integrate the
  135. Wincode Engine into any program. We will provide the API and royalty
  136. free usage to interested developers under certain conditions. Please
  137. contact the _Snappy_ development team for more details:
  138.  
  139.    development@snappy-software.com
  140.  
  141.  
  142.  
  143. II. *** Wincode Features (very brief list!) ***
  144.  
  145.        - Full featured Windows 3.1 program
  146.        - Easy access ButtonBar for hassle-free operation
  147.        - Drag and Drop support (use for batch en/de-coding -> Wincode
  148.          also allows multi-file selection from File Open dialogs)
  149.        - SMART decoding (handles single files, multi-part files, can
  150.          determine what is encoded or not, etc. -> see the HELP file
  151.          for more information)
  152.        - Fully configurable...We're not joking!
  153.        - EMBL UUcode compatible
  154.        - Supports UU, XX or User defined En/De-coding
  155.        - Supports Base64 (MIME conformant) En/De-coding
  156.        - Supports BINHEX En/De-coding (with option to include MAC
  157.          finder info when encoding to make decoding on a MAC *very*
  158.          easy!)
  159.        - Supports BTOA v4.0 and v5.2 En/De-coding
  160.        - Supports BOO En/De-coding
  161.        - Supports En/De-coding to/from the Clipboard!
  162.        - Supports automatic CODE TYPE detection - either "quick-pass"
  163.          (Auto-1) or "full-pass" (Auto-2) - see HELPME.HLP.
  164.        - Powerful Scripting language can be used to "program" Wincode
  165.          (includes new automatic "Repair" damaged files option!)
  166.        - Supports automatic ZIP/UNZIP (requires PKWare's
  167.          ZIP/UNZIP 2.0)
  168.        - Supports automatic Virus Scanning (requires a DOS Virus
  169.          Scanner - see the VSDLINK.DAT file for more information)
  170.        - Application menu hooking option to integrate Wincode's menu
  171.          into any application. New scripting feature makes encoding
  172.          *into* application documents a SNAP!
  173.        - Includes INSTALL program for upgrades
  174.        - Includes UNINSTALL program for removal
  175.        - Integrated file-sorting companion program (separate
  176.          executable for easier upgrading) which handles MANY types
  177.          of file header formats
  178.        - Integrated Winsock compatible e-mail/post daemon (separate
  179.          executable for easier upgrading) to allow for automatic
  180.          e-mailing and posting of encoded documents (see
  181.          Requirements)
  182.        - Multimedia support - see the HELP file for details
  183.        - It's ALL FREE...
  184.  
  185.  
  186.  
  187. III. *** Coming Soon ***
  188.  
  189.        - 32-bit Win95/WinNT version. In progress but no date set yet.
  190.          Keep an eye on our HomePage for early BETAs...
  191.        - User suggestions...?
  192.  
  193.  
  194.  
  195. IV. *** Requirements ***
  196.  
  197.       - IBM compatible running DOS 3.3 or higher
  198.       - 286 or higher processor with at least 2MB memory
  199.       - Windows 3.1/3.11 running in standard or enhanced mode OR
  200.         Win95/NT
  201.       - About 1.8MB of disk space without HELP file (~2.5MB with HELP
  202.         file) Sorry about the disk space - this should be reduced in
  203.         the coming months with the release of 32-bit version.
  204.       - ***NOTE*** To use Wincodes built-in E-Mail/Post capabilities,
  205.         you must have a Winsock setup. This means that you are using
  206.         a Windows Socket stack (WINSOCK.DLL) of some sort connected
  207.         directly to the internet (ethernet, SLIP, PPP, TwinSock, TIA,
  208.         SLiRP, etc). The E-Mail/Post Daemon is a Winsock v1.1
  209.         compatible app and has been tested with Trumpet Winsock,
  210.         SunSoft PCNFSPro Winsock, and Winsock running under Win95.
  211.         Improper or missing Winsock setup will only result in
  212.         harmless error messages :-)
  213.  
  214.  
  215.  
  216. V. *** Installing/Running/UnInstalling Wincode ***
  217.  
  218. If you have not already done so, expand the ZIP archive into a
  219. temporary directory (or a floppy-disk). Start Windows, select
  220. FILE|RUN from Program Manager or File Manager and type in the full
  221. path of the INSTALL.EXE program (run it). The INSTALL program will
  222. copy/expand all the files to a directory you specify (overwriting
  223. older files), upgrade your WINCODE.INI (if you are running an older
  224. version of Wincode) and create a Program Manager Group and/or icon.
  225. See the HELPME.HLP file for basic instructions on using Wincode.
  226.  
  227. ***IMPORTANT NOTES:
  228.    1) ALL files (listed above) must be present in the same directory
  229.       for Installer to function properly. You should INSTALL first,
  230.       then move selected files to directories of your choice (i.e.
  231.       delete the README.TXT, place SUM.EXE in your DOS directory,
  232.       etc). The install program uses the Windows LZEXPAND.DLL to
  233.       decompress and copy the required files. If you receive any
  234.       error messages during install, please contact _Snappy_ for
  235.       assistance.
  236.    2) If you receive a Program Manager DDE failure (usually under
  237.       Windows95), try RE-STARTING Windows. We have only observed this
  238.       error under Win95 on computers that have been used extensively
  239.       without restart. If this fails, installation WILL proceed but
  240.       PM Groups will not be created.
  241.  
  242. Wincode can now be un-installed in 2 easy steps. First, run Wincode
  243. and select 'Options|Configuration...' (CTRL-F) from the menu. You
  244. will see the configuration dialog which has an 'UnInstall...' button.
  245. Choose this to select the UnInstall method. You may also use the
  246. "Uninstall Wincode" icon in your "Wincode" Program Manager group. The
  247. UnInstaller will remove/copy/list all files included in the Wincode
  248. package. However, it does NOT remove itself OR the directories that
  249. Wincode may have used. Therefore, the second step is to remove these
  250. directories and UNINSTLL.EXE from your drive. Wincode should now be
  251. completely erased from your drive.
  252.  
  253.  
  254.  
  255. VI. *** Availability ***
  256.  
  257. Recent versions of Wincode (or other _Snappy_ software) are always
  258. available at the following locations:
  259.  
  260.     - The Internet - the _Snappy_ Software site! All of our software
  261.       is available by three different methods:
  262.  
  263.       1) WWW forms - point your browser at:
  264.          
  265.          http://snappy-software.com/
  266.  
  267.          and check out our HomePage! If you can't get through, try
  268.          our MIRROR site at:
  269.          
  270.          http://www.global2000.net/users/snappy/snappy/
  271.          (YES, there are two "snappy/" in the address! :-)
  272.  
  273.          You can also try one of the many WWW search engines to
  274.          locate "Wincode".
  275.  
  276.       2) Anonymous FTP - visit us at: snappy-software.com
  277.          MIRROR: www.global2000.net/users/snappy/
  278.  
  279.       3) Automated e-mail - send a request to our server and receive
  280.          an encoded copy by e-mail. Visit our HomePage for more info
  281.          or send a BLANK e-mail to: snappy@snappy-software.com for
  282.          a TEXT copy of our HomePage.
  283.  
  284.       In the future, we will try to establish mirror sites for our
  285.       software. Please visit our HomePage for recent developments...
  286.  
  287.     - CompuServe (check the WinShare forum; keyword: Snappy,
  288.       Wincode, etc)
  289.  
  290.     - America Online (keyword: Snappy, Wincode, etc)
  291.  
  292.  
  293.       
  294. VII. *** Note to HELP Registered Users ***
  295.  
  296. If you are a registered user but have not received your HELP file,
  297. *please* contact us at: support@snappy-software.com with your
  298. registration info (name, address, e-mail address, etc). Many orders
  299. arrived with illegible and/or missing e-mail addresses. _Snappy_ uses
  300. your e-mail address as your user registration code. Further, some
  301. orders were shipped but *not received*. We can't track mail failures
  302. (we don't have the resources) so we rely on customers to please get
  303. in touch with us if they have a problem.
  304.  
  305. Please note that registration is a ONE-TIME fee. In other words, your
  306. initial registration keeps you in our database to be eligible for
  307. future HELP file updates! However, it is up to YOU to keep us up to
  308. date with your registration info (e-mail address) and to request the
  309. HELP file updates from our server (this is now a built-in feature of
  310. Wincode).
  311.  
  312. If you need phone support, drop us an e-mail and we'll send you a
  313. contact number. This service is ONLY for registered users and calls
  314. are INCOMING ONLY.
  315.  
  316.  
  317.  
  318. VIII. *** Copyrights ***
  319.  
  320. Wincode is a TradeMark of _Snappy_ Software.
  321.  
  322. - portions of this program are copyright (C) 1983,1995 Borland
  323. - Windows is a trademark of Microsoft Corporation
  324. - PKZIP/UNZIP are copyright (C) 1989-1993 PKWARE Inc. All Rights
  325.   Reserved.
  326. - GIF is a service mark of CompuServe Incorporated
  327. - WordPerfect is a registered trademark of Corel Corporation.
  328. - Procomm Plus for Windows is copyright (C) 1992-1993 Datastorm
  329.   Technologies, Inc.
  330. - Star Trek: The Next Generation is a registered trademark of
  331.   Paramount Pictures
  332. - The Simpsons is trademark and copyright (C) Twentieth Century Fox
  333.   Film Corporation. All Rights Reserved.
  334. - Pinky and the Brain is copyright (C) Amblin Entertainment in
  335.   association with Warner Bros. Animation
  336. - DOOM is copyright (C) 1993 Id Software, Inc.
  337.  
  338. Copyrights or Trademarks referenced in any material accompanying this
  339. software but not mentioned above have been omitted in error. _Snappy_
  340. observes and respects all copyrights and trademarks.
  341.  
  342.  
  343.  
  344. Have fun!
  345.  
  346. _Snappy_ Software ;-)
  347.  
  348.  
  349. _Snappy_ Info:  snappy@snappy-software.com
  350. Wincode Info:   wincode@snappy-software.com
  351. Bug Reports:    bugs@snappy-software.com
  352. FeedBack:       feedback@snappy-software.com
  353. HomePage:       http://snappy-software.com/
  354. MIRROR:         http://www.global2000.net/users/snappy/snappy/
  355.                (YES, there are two "snappy/" in the address! :-)
  356. --------------------------------------------------------------------------
  357.  
  358. [GHS 10/31/96]
  359.