home *** CD-ROM | disk | FTP | other *** search
/ Chip Special: HTML & Java / Chip-Special_1997-01_HTML-a-Java.bin / actvx31.sdk / coresdk / inetsdk / readme.txt < prev    next >
Encoding:
Text File  |  1996-10-30  |  13.9 KB  |  337 lines

  1. =======================================================================
  2.  
  3. Release notes for the Microsoft ActiveX Development Kit:
  4.  
  5. Copyright (c) Microsoft Corporation, 1996
  6. =======================================================================
  7.  
  8.  
  9. Note: If you did not access this document from \INetSDK\Help\Default.htm, 
  10. that is probably a better place to begin reading documentation.  This 
  11. readme.txt is the second URL in that document's right hand frame.
  12.  
  13. -----------------------------------------------------
  14. WELCOME TO THE ACTIVEX SDK:
  15. -----------------------------------------------------
  16. Welcome to the Microsoft ActiveX Software Development Kit. These are the 
  17. release notes of the November'96 release of the ActiveX SDK.  It 
  18. is intended to be installed with the Internet Explorer 3.01 (final
  19. version) and the latest release of the  Win32 SDK (dated Aug. 96).  The 
  20. operating system for this release of the SDK is intended to 
  21. be Windows 95 or Windows NT 4.0 SUR (final version).
  22.  
  23. Here's a brief description of the contents of this folder, followed
  24. by release notes.
  25.  
  26. BIN       SDK Tools, Redistributables, DLLs and self extracting .exe's
  27. HELP      HTML reference files for all SDK components
  28. INCLUDE   Include files for Win32 Internet Services and OLE Interfaces
  29. LIB       Libraries for the ActiveX SDK
  30. LICENSE      License for ActiveX SDK and Redistributable components.
  31. SAMPLES   ActiveX SDK Samples
  32. SPECS     Additional SDK documentation not yet in HTML references.
  33.  
  34. -----------------------------------------------------
  35. PREREQUISITE OF THIS RELEASE OF THE ACTIVEX SDK:
  36. -----------------------------------------------------
  37. Notes on which VC++, MFC, Internet Explorer, and Win32 SDK are required.
  38.  
  39. This release introduces for the first time development support for RISC
  40. (Alpha, MIPs, and PowerPC).  This is early beta level support for
  41. RISC.  This release of the ActiveX SDK requires that you have downloaded 
  42. and installed:
  43. * Internet Explorer 3.01. (final version)
  44.   (http://www.microsoft.com/ie/iedl.htm) 
  45. * The latest Win32 SDK (dated Aug '96, available on 
  46.   MSDN Level II.)
  47. * Windows 95 or Windows NT 4.0 SUR (final version)
  48. * A compiler: 
  49.   for Intel, Microsoft Visual C++ 4.1 is the most tested.
  50.   Do not use VC++ 4.2, unless you have obtained the VC++ 4.2b patch
  51.   on the web at http://www.microsoft.com/visualc.  
  52.  
  53.   For RISC development you should use VC++ 4.0a.  (later versions of 
  54.   MFC, which is needed for some of the samples, is not yet available 
  55.   on all RISC platforms).
  56.  
  57.   If you are using VC++ 4.2b, you will need to modify the URLPad's
  58.   MAKEFILE in order to get the sample to build.   You will need to
  59.   uncomment (remove the "#" symbol from) the line that reads
  60.     # _MFC_LIB_ = 42
  61.  
  62.   If you use MFC 4.2 in your sample development, you should include
  63.   that line to your makefile if you include INetSDK.MAK. 
  64.  
  65. If you have Visual C++ 4.1 and the later release of the Win32 SDK,
  66. you should set your environment variables by executing the following
  67. commands on your command line (note, make exceptions to make sure 
  68. you go the correct directories)
  69.  
  70.   cd c:\msdev\bin
  71.   vcvars32 x86
  72.   cd c:\mstools
  73.   setenv c:\mstools
  74.   cd c:\inetsdk
  75.   setenv c:\inetsdk
  76.  
  77. Assuming the above file structure represents your installation, you
  78. you can cut and paste the following into a batch file and execute it before
  79. building samples.  This assumes you are building on an Intel machine; use 
  80. the string "mips", "alpha", or "ppc" accordingly in place of "x86" below.
  81.  
  82.     REM Batch file starts here.
  83.     set lib =
  84.     set include=
  85.  
  86.     c:
  87.     cd c:\msdev\bin
  88.     call vcvars32 x86
  89.     cd c:\mstools
  90.     call setenv c:\mstools
  91.     cd c:\inetsdk
  92.     call setenv c:\inetsdk
  93.  
  94.     REM Batch file ends here.
  95.  
  96.  
  97. -----------------------------------------------------
  98. SOME NEW DOCUMENTATION:
  99. -----------------------------------------------------
  100. Cross Platform Downloading Issues:
  101. Now that we have RISC support becoming available, how do you download 
  102. controls to different kinds of client platforms.  Because the examples 
  103. are better illustrated in HTML, you will find information on this in 
  104. the SDK's Overview.  (the overview of ...\INetSDK\Help\Default.htm)
  105.  
  106. Installing Issues:
  107. Because adding RISC support increased the size of the SDK significantly,
  108. I've broken up some of the documentation into separate downloads.  I will
  109. refer to the three doc sets as MVB, OLE Refs., and ActiveX Refs.  
  110.  
  111. The MVB doc set consist of the entire SDK doc set (OLE Refs., and 
  112. ActiveX Refs.) in MVB format, and the InfoViewer for each of the 
  113. supported NT platforms.  ISVs have asked me to be sure to include this 
  114. doc set in the SDK because it offers string search capability 
  115. and the ability to print "books".  They now account for about 13MB of 
  116. the SDK however; so if you are getting the SDK on a CD, the MVB is 
  117. probably included and installed by default; if you are downloading 
  118. from the web, you are seeing it as a separate download that you 
  119. can choose if you wish.  The setup of the MVB will allow you to 
  120. install right into the SDK if you choose to.  See that download for 
  121. more details.
  122.  
  123. The OLE Refs. (or ActiveX COM HTML References) integrates with the
  124. ActiveX Refs. doc set.  It makes up less than 5MB of the SDK; however it 
  125. consist of nearly 1500 individual files.  A limitation of the FAT file
  126. system is that regardless of how small a file is, it takes up a full
  127. cluster on the hard drive.  This means these files will take up considerable
  128. space if installed, about 50MB on some machines.  If you are using NTFS,
  129. or if disk space is not an issue for you, you can install these docs
  130. in the SDK; or you can choose to browse the same information in the
  131. MVB file.  I have included OLERefs.zip as a download
  132. from the download site.  To install the OLE Refs. in your SDK, unzip it
  133. in ..\INetSDK\Help\OLE.  Make sure to use the -d option of your
  134. unzip utility so that the subdirectories are properly extracted.  You can
  135. get unzipping utilities at http://www.winzip.com, or 
  136. http://quest.jpl.nasa.gov/Info-Zip/
  137.  
  138. The ActiveX Refs. are what I refer to as the rest of the HTML documentation
  139. found starting in your \Help directory.  They are downloaded and 
  140. installed by default.  They contain all of the other ActiveX documentation
  141. other than that found in the ActiveX COM references.
  142.  
  143. New Content: 
  144. There is a difference in the way Internet Explorer 3.01 uses CSS1 
  145. (Cascading Stylesheet Specifications)  properties which causes pages
  146. formatted for version 3.01 to appear differently when viewed with 
  147. Internet Explorer 3.0.   The problem is that stylesheet properties can 
  148. be "inherited" at different object levels within the document.   
  149. Version 3.01 correctly interprets inherited properties for margins 
  150. and version 3.0 does not.    A "readme" chapter with a section 
  151. regarding stylesheets was added to the HTML Reference to explain the 
  152. issue, and it gives a solution for creating stylesheets compatible with 
  153. both versions of Internet Explorer.
  154.  
  155. -----------------------------------------------------
  156. REFRESHED SDKs: Conferencing and CAB Technology    
  157. -----------------------------------------------------
  158. The CabRscKit.exe has been added as a companion to CabDevKt.exe.  These
  159. are self extracting .exe which provide you with everything you need
  160. to add CAB support to your applications.  CabRscKt.exe adds support
  161. for the compression and decompression API, with documentation and 
  162. sample code.  To install this, drop it into a sub directory and 
  163. execute.  Read the Readme.txt from there.
  164.  
  165.  
  166. The ActiveX Conferencing Technology has now been made available in
  167. a NetMeeting SDK 1.0a.  Because this is now available as a self extracting
  168. .exe file in the \bin directory, I have pulled the \MSConf samples that
  169. normally installed with the ActiveX SDK.  These are now in the self
  170. extracting .exe MSCNF10a.exe.  You can visit their web site at  http://www.microsoft.com/intdev/msconf.
  171.  
  172. ActiveX SDK for the Macintosh:
  173. See it at http://www.microsoft.com/intdev/SDK/Mac 
  174.  
  175.  
  176. -----------------------------------------------------
  177. SOME NEW SAMPLES:
  178. -----------------------------------------------------
  179. CARD:
  180. Do you like to play Poker, or maybe Solitaire?  Well now you can do it
  181. via your browser and ActiveX Controls.  See the sample 
  182. ...\INetSDK\Samples\BaseCtl\Card.
  183.  
  184. OBJVW:
  185. Quite a few ISVs who have been using the WebBrowser Control have run
  186. into similar issues.  A new sample has been added to address some of
  187. these issues, like: how to access IE's Automation model and scripting
  188. model from within a contained control, how to enumerate controls and
  189. Java applets in a page, getting a controls ID or Name as specified in the
  190. OBJECT tag, how to know when a page is completely loaded, how to make a 
  191. generic class to sink events, marking controls "Safe for Scripting", etc.
  192. This new sample is in ...\INetSDK\Samples\BaseCtl\ObjVw.
  193.  
  194. =======================================================================
  195. REDISTRIBUTABLE DLLs.
  196. =======================================================================
  197. WINTDist.exe APRXDist.exe, WINT351.exe, and AXDist.exe
  198. -----------------------
  199. |New with this release: The Intel version of the Redistributables have
  200. |been refreshed with the same bits as ships in IE3.01.  
  201. |
  202. |There are now RISC versions of the Redistributables.  Note however
  203. |that the RISC versions contain prerelease code, and these 
  204. |Redistributables should not be release with your finished product.
  205. |These are beta only, and should be used for testing only.
  206. |
  207. |There are also 3 international versions of the Redistributables: 
  208. |German, Japanese, and Taiwan.  These are prefixed with DE, JA, and TW.
  209. |These are mapped out specifically in the Redist.txt file.
  210. |
  211. |Because of the size of the combined redistributables, and because
  212. |the list of file will grow in the future, I have now seperated these
  213. |out into a seperate download from the web.  You can download this
  214. |file, AXReDist.exe, and extract it according to the download page's
  215. |instructions.
  216. |
  217.  
  218.  
  219. The following executables install the following redistributable files.  
  220. Note that these redistributable packages are targeted at Windows NT 4.0
  221. final release and Windows 95, unless otherwise specified to be for Windows
  222. NT 3.51.  The redistributables break out as follows:
  223.  
  224. WINTDIST.exe:
  225. - WinInet.dll
  226. - InLoader.dll
  227. - SChannel.dll
  228.  
  229. WINT351.exe:
  230. Note: SChannel.dll requires Windows NT 4.0 or Windows 95 system
  231. components, so WINT351 does not install SChannel.dll.  WINT351.exe
  232. will install WinInet functionality on Windows NT 3.51, but note,
  233. it requires enhancements to WinInet for asynchronous operations
  234. only available with Windows NT 3.51 Service Pack 4 (SP4).  WINT351.exe
  235. will only work on Windows NT 3.51 with SP4.
  236. - WinInet.dll
  237. - InLoader.dll
  238.  
  239. AXDist.exe:
  240. - WinInet.dll
  241. - InLoader.dll
  242. - SChannel.dll
  243. - URLMon.dll
  244. - HLink.dll
  245. - HLinkPrx.dll
  246. - OLEAut32.dll
  247. - StdOLE2.tlb
  248.  
  249. CCDist.exe: (now available only in the Win32 SDK)
  250. - ComCat.dll
  251.  
  252. CCDist35.exe: (now available only in the Win32 SDK)
  253. - ComCat.dll
  254.  
  255. APRXDist.exe:
  256. - ActXPrxy.dll
  257.  
  258. Please read redist.txt for more details.  
  259.  
  260. The purpose of making the redistributable is so ISVs can redistribute
  261. ActiveX files and target systems that may not have Internet Explorer
  262. 3.0 installed on them; but also to know that the files will be 
  263. installed; with file dependencies and registry settings set correctly.
  264.  
  265. These DLLs are ONLY redistributable through the use of the self
  266. extracting executables listed above.  See details on redistribution 
  267. rights in redist.txt (which has recently been moved into your 
  268. ActiveX SDK installation to \InetSDK\License.) 
  269.  
  270. AXDist.exe, WINTDist.exe, APRXDist.exe, and CCDist.exe, work on 
  271. Windows NT 4.0 and Windows 95.  WINT351.exe install WinInet.dll 
  272. and dependencies on Windows NT 3.51 (note, it is not meant to work 
  273. on Windows NT 4.0).  CCDist35.exe will soon be available for
  274. Windows NT 3.5.
  275.  
  276. WINT351.exe is silent by default.  The other redistributable that
  277. run on Windows 95 and Windows NT 4.0 are totally silent if executed
  278. with the /Q switch i.e. "WINTDist.exe /Q".  Note, this does not
  279. work on Windows NT 4.0 betas, only on the final release.  As part of
  280. their default behavior, the redistributables will version check and
  281. will not install older components over newer system files.  In silent
  282. mode the user will not be prompted to make a choice.
  283.  
  284. If you have previously shipped earlier versions of these files, with
  285. your product; your installed base should be upgraded with these releases.
  286.  
  287. To test your WinInet code with these redistributables:
  288. * Start with a clean Windows 95 or Windows NT machine <without SDKs or
  289.   Internet Explorer installed>.
  290. * Run WINTDist.exe (or WINT351.exe)
  291. * Run and test your code.
  292.  
  293. To test your URLMon code with these redistributables: 
  294. * Start with a clean Windows 95 or Windows NT machine <without SDKs or
  295.   Internet Explorer installed>.
  296. * Run AXDist.exe
  297. * Run and test your code.
  298.  
  299. Alternately, for testing your code, do the following:
  300.  
  301. To test these files: 
  302. * Start with a clean Windows 95 or Windows NT machine.
  303. * Install the Win32 SDK (a release dated May '96 or later).  
  304. * Install the ActiveX SDK (dated August '96 or later).  
  305.   <note, the Internet Explorer should not be installed>
  306.  
  307. then ... For WinInet only code:
  308. * Run WINTDist.exe to install WinInet.dll and dependencies.
  309. * Build and run your WinInet.dll dependent code.
  310.  
  311. or/then ... For URLMon code:
  312. * Run AXDist.exe to install the rest of the files described
  313.   above.
  314. * Build and run your code.
  315.  
  316. All of the files in each of the redistributables has been classified
  317. as a "Core Component".  This essentially means that once these files
  318. are installed, they should not be uninstalled from a system.  Your 
  319. setup applications can distribute and execute these files, and will
  320. not have to be concerned with keeping usage count or uninstalling the
  321. files.  
  322.  
  323. Note, if the redistributables don't meet your distribution needs, report
  324. problems to AXDistB1@microsoft.com
  325.  
  326.  
  327. ==============
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336. 
  337.