home *** CD-ROM | disk | FTP | other *** search
/ Total C++ 2 / TOTALCTWO.iso / visual / readme.txt < prev    next >
Text File  |  1997-03-19  |  21KB  |  518 lines
  1.   
  2. README for Symantec Visual Cafe Version 1.0d
  3. ============================================f====================
  4. Copyright (c) 1997 by Symantec Corporation. All Rights Reserved.
  5.  
  6.  
  7. Table of Contents:
  8. I.     Welcome
  9. II.    Installation Notes
  10. III.   User Tips
  11. IV.    Known Problems
  12. V.     Revision history
  13. VI.    Contacting Symantec for Technical Support
  14.  
  15. I.  Welcome!
  16. =================================================================
  17. Welcome to Symantec Visual Cafe Version 1.0d for Windows 95
  18. and Windows NT.  Please take a few minutes to read this file,
  19. which contains the latest information regarding this release.
  20.  
  21.  
  22. II.  Installation Notes
  23. ================================================================
  24. If you have previously downloaded the Preview Releases, you must 
  25. remove them before installing Visual Cafe 1.0d.
  26.  
  27. Run setup.exe. The installation is smooth and intuitive. As with
  28. any new software, please install Visual Cafe in a clean directory.   
  29.  
  30. If you are using Microsoft's NTFS do not install into a directory
  31. that has a name containing spaces.
  32.  
  33.  
  34. Installing and Running the Tutorial
  35. ---------------------------------------------------------------
  36. If you are new to Java development, please take the time to work
  37. through the exciting and informative tutorial that is part of 
  38. Visual Cafe.  This tutorial will provide you with an overview 
  39. of Visual Cafe's most powerful features. 
  40.  
  41. What's in the Tutorial?
  42. ---------------------------------------------------------------
  43. In the Tutorial you will learn how to:
  44.  
  45. * Design an applet, build it, and install it in a Web page.
  46. * Run the applet in a Web browser.
  47. * Design an application, then build, test, debug, and run it.
  48.  
  49.  
  50. III.  User Tips
  51. =================================================================
  52. How do I add values for each column in a MultiList component?
  53.  
  54. When using multiple columns in the MultiList component, you must
  55. separate the column values with a semicolon.  Each row is separated
  56. with a Ctrl + Enter.
  57.  
  58.             *
  59.  
  60. How do I configure my Web browser to run an applet I created 
  61. using custom classes?
  62.  
  63. When you are ready to view your applet outside the Visual Cafe 
  64. environment, you need to make sure that the AppletViewer or your 
  65. favorite Web browser can find the custom classes included with 
  66. Visual Cafe.  For local browsing, add an environment variable to 
  67. your autoexec.bat file, such as:
  68.  
  69.     SET CLASSPATH=C:\visualcafe\java\lib\vecclass.zip
  70.  
  71.             *
  72.  
  73. How do I distribute my applet on a Web server?
  74.  
  75. -When placing the applet on a Web server, contact your  
  76.  Webmaster and verify that the Symantec classes are 
  77.  available.  If the classes are not available on your server, 
  78.  the Webmaster will need to add them or tell you how 
  79.  to add them.
  80.  
  81. -A solution that works locally, or from a server, is to copy the 
  82.  \VisualCafe\Java\Lib\symantec directory and all of its contents to 
  83.  the directory containing the applet. (The subdirectories of the
  84.  "symantec" directory contain the Visual Cafe Java runtime classes.)
  85.  Make sure to keep the same uppercase and lowercase letters for the 
  86.  subdirectories and class files; Java is case-sensitive.
  87.  
  88. -Due to a large number of requests late in the beta cycle of 
  89.  Visual Cafe,  we have included an early version of our Bundler 
  90.  utility that will allow you to easily figure out which class 
  91.  files are used by your applet or application, and need to be 
  92.  uploaded to your Web server.  Once your Java app is ready, execute 
  93.  the following command at the command prompt (make sure that 
  94.  \visualcafe\bin  is in your path):
  95.  
  96.  Bundler.exe -make -cdb mainclass.cdb -depend listname.dep mainclass.java
  97.  
  98.  mainclass is the name of the main class Java file or the
  99.  project name. In this example, listname.dep is the file 
  100.  where the list of classes used by your app will be generated.  
  101.  In this version, the file listname.dep has to have a .dep extension.
  102.  Bundler lists the name of the zip file (if any) where the class file 
  103.  was found.  This helps you determine what class files you would need 
  104.  to unzip from each class zip file used by your app.  Note that
  105.  while the java.* class files are logged in this file, you are not 
  106.  actually required to copy those to your Web server, as they are 
  107.  usually available with most Internet browsers.
  108.  
  109.  Bundler takes the same other command line options as the sj command 
  110.  line compiler.  So, you can add additional class paths, etc.
  111.  
  112.             *
  113.  
  114. What is the "Execute applet in default HTML viewer" option in the 
  115. Project Options dialog?
  116.  
  117. The "Execute applet in default HTML viewer" option, located in 
  118. the Project Options dialog box, allows you to view your applet 
  119. in your favorite Web browser, instead of the AppletViewer, 
  120. when executing from the Visual Cafe environment.
  121.  
  122.             *
  123.  
  124. Will Visual Cafe recognize my own source code?
  125.  
  126. When adding controls directly within the source editor, it 
  127. is recommended that you adhere to the same coding style as 
  128. generated by Visual Cafe.  This will allow controls you add to 
  129. be displayed in the form editor.  Controls you add outside 
  130. Visual Cafe's tags (which are comments that indicate where Visual
  131. Cafe generates Java code for the form editor) will not be displayed in 
  132. the form editor and will not be affected by automatic code generation.
  133.  
  134. So, if you are adding controls within Visual Cafe's tags 
  135. in the source editor, you should adhere to Visual Cafe's coding 
  136. style.  Otherwise, you can add controls outside of Visual Cafe's 
  137. tags using your own coding style.
  138.  
  139.             *
  140.  
  141. What do I need to do to enable remote debugging?
  142.  
  143. If you are using cafeRemote on a remote computer for remote 
  144. debugging, you must modify the autoexec.bat file on that 
  145. computer.  You must also include VisualCafe\java\bin your
  146. PATH, and create and set a CLASSPATH system variable 
  147. to include all necessary classes for the applet or application 
  148. you are debugging. Here is an example:
  149.  
  150. set PATH=C:\VisualCafe\Java\Bin;%PATH% 
  151. set CLASSPATH=C:\VisualCafe\Java\Lib;
  152. C:\VisualCafe\Java\Lib\SYMCLASS.ZIP;
  153. C:\VisualCafe\Java\Lib\VECCLASS.ZIP;
  154. C:\VisualCafe\Java\Lib\SYMANTEC.ZIP;
  155. C:\VisualCafe\Java\Lib\SYMANTEC.ZIP;C:\YOUR_CLASSES
  156.  
  157. Note that a PATH or CLASSPATH statement in your system files 
  158. is one continuous line with no spaces or carriage returns.
  159.  
  160.                         *
  161.  
  162. I'm charged for Web server space on a per megabyte basis.  Is
  163. there a more efficient way to deploy other than copying the 
  164. \symantec class subdirectory to each of my applet directories?
  165.  
  166. The use of a CODEBASE="URL of applet directory" attribute within
  167. the <APPLET></APPLET> tags can be used to specify the URL of the
  168. directory in which the applet resides.  That way your applets can
  169. access the symantec classes no matter where they reside. 
  170.  
  171.                         *
  172.  
  173. When I open a project in the Form Designer, the dialog for Dial
  174. Up Networking appears.  If I log on, all is well.  If I cancel,
  175. Visual Cafe "hangs" for several minutes.
  176.  
  177. The use of relative URLs (for example, IMAGES/*.GIF) can cause this 
  178. behavior on some systems. To avoid it, use absolute URLs (for example, 
  179. C:\...\PROJECT\IMAGES\*.GIF) during design time and then switch to relative 
  180. URLs for deployment.
  181.  
  182.                         *
  183.  
  184. Each time I attempt to launch Visual Cafe, I get this message: An incorrect
  185. version of the AWT is found in the path (check your system directory).  
  186. Visual Cafe runs if I click OK, but live controls are disabled.
  187.  
  188. It is not uncommon for files that Visual Cafe relies upon to be replaced
  189. by other vendors (Java development tools or other software). In most cases,
  190. the files can be one or more of the following: JAVAI.DLL, AWT.DLL, MFC30.DLL,
  191. and/or MSVCRT20.DLL.  Copy these files from VISUALCAFE\JAVA\BIN to
  192. VISUALCAFE\BIN. This will ensure that the correct files are being loaded
  193. since the current working directory, VISUALCAFE, is searched first (allowing
  194. the use of live controls).  This solution is also applicable if a runtime error
  195. is generated when Visual Cafe is launched.
  196.  
  197.  
  198.                         *
  199.  
  200. How can I increase the size of a form within the Form Designer larger
  201. than the resolution of my screen?
  202.  
  203. A form in the Form Designer is limited to the resolution of your
  204. display.  If your display system is capable, increase the its resolution
  205. to allow more information on the screen such as changing from 800x600
  206. to 1024x768.  If your display system supports the use of a "viewport"
  207. or "virtual desktop" where only a portion of the desktop is displayed
  208. on the monitor, the form size can be increased to the size of the desktop.
  209. Note that this has not been thoroughly tested with all display systems.
  210.  
  211.                         *
  212.  
  213. Can I integrate Netscape's IFC into the Visual Cafe environment?
  214.  
  215. Symantec will provide Netscape IFC integration instructions for Visual
  216. Cafe on our Web site at HTTP://CAFE.SYMANTEC.COM.
  217.  
  218.                         *
  219.  
  220. I would like to distribute my applications created with Visual Cafe along
  221. with the Symantec Virtual Machine.  Do I need to obtain a license? 
  222.  
  223. Yes. Please contact Symantec Developer Relations for additional
  224. information.  The .class files included with Visual Cafe are freely
  225. distributable.
  226.  
  227.                         *
  228.  
  229. I receive parsing errors when I attempt to define a custom color.
  230.  
  231. Custom colors must be defined in the INIT_CONTROLS to avoid
  232. parsing errors.
  233.  
  234.                         *
  235.  
  236. If I overlap components, why do they behave differently in Internet Explorer
  237. and Netscape?
  238.  
  239. The Java z-order implementation within Internet Explorer for Windows is
  240. opposite to that of Netscape for Windows.  For example, take a look at the
  241. slide show in VISUALCAFE\TUTORIAL\APPLET\SLIDESHOW.JAVA.  We've placed one
  242. Next InvisibleButton in front of the CLICKER.GIF image and one behind it so
  243. it will work for both browsers.  If only one Invisible Button was used
  244. behind the CLICKER.GIF image in the SlideShow, the applet would not function
  245. correctly in Internet Explorer.  To accommodate different Java z-order
  246. implementations, it is necessary to place an InvisibleButton in front of the
  247. component as well as behind it in order for events to be generated.
  248.  
  249.  
  250. How do I add third party components to Visual Cafe?
  251.  
  252. Refer to the Component Integration document at
  253. FTP://ITOOLS.SYMANTEC.COM/PUB/DEVREL/VISUALCAFE/PAPERS/
  254. for instructions.
  255.  
  256.                         *
  257.  
  258. Where can I find additional learning materials for Visual Cafe/java?
  259.  
  260. The following publishers have announced books for Visual Cafe:
  261.  
  262. Discovering Visual Cafe
  263. IDG Books
  264. Wall & Griffith
  265.  
  266. Visual Cafe Frontrunner
  267. Corolis
  268.  
  269. Symantec Visual Cafe Sourcebook
  270. John Wiley & Sons
  271. Cary Jardin
  272.  
  273. Visual Cafe Programming for Dummies
  274. IDG Books
  275. Tittel & Gaither
  276.  
  277. Visual Cafe
  278. Addison Wesley Germany
  279. Guido Krueger
  280.  
  281. Visual Cafe Pro
  282. WROX Press UK
  283. Roger Lee
  284.  
  285.  
  286. IV.  Known Problems
  287. ================================================================
  288. This section lists information about known problems:
  289.  
  290. * If you encounter certain errors when starting Visual Cafe or 
  291.   if your tool palette appears empty, delete the following files 
  292.   from \visualcafe\bin:
  293.     *.rps
  294.     *.reg
  295.     *.vws
  296.  
  297.   Note: Some of the errors are:
  298.     "No starter templates could be found"
  299.     "Cannot open local repository"
  300.     "Cannot open registry"
  301.  
  302.   These files are platform-dependent and must be regenerated
  303.   when switching from one operating system to another.  
  304.  
  305. * Due to architectural changes within Visual Cafe projects, this 
  306.   version of Visual Cafe is not compatible with Preview 1 or 2 .VPJ 
  307.   files.
  308.  
  309. * When using the Parse All Imports option, we recommend that you
  310.   allow the parser to finish parsing before editing or changing 
  311.   a file.  To view the status of the parser, select Messages 
  312.   from the Visual Cafe Window menu.
  313.  
  314. * The x and y dimension properties in the Property Inspector are 
  315.   not applicable for root level objects.  If you change these settings, 
  316.   it doesn't affect these objects.
  317.  
  318. * Visual Cafe introspects class files when they are added to the 
  319.   Component Library, and allows the setting of basic properties 
  320.   in the property list if the class follows the Java Beans spec.  
  321.   Supported properties are: int, boolean, String, String arrays, 
  322.   Color, Font, URL, and URL arrays.  Currently, the additional is/set 
  323.   design pattern for boolean properties is not supported.
  324.  
  325. * If you would like to disable live controls, you can rename 
  326.   jblender.dll to jblender.sav.   
  327.  
  328. * The use of alignment tools within a borderPanel is not supported in this release.
  329.  
  330. * When using border panels with snap to grid turned on, panel contents can shift
  331.   when the panel itself is moved on a form. To prevent this, turn snap to grid off.
  332.  
  333. Low-memory warning on startup
  334. -----------------------------------------------------------------
  335. If the sum of your system's available physical memory (RAM) and
  336. swap space on disk is below a minimal level when Visual 
  337. Cafe starts up, a warning dialog will notify you of this condition.
  338. It advises you to increase swap space (see below).  You have the 
  339. option of ignoring this warning (answer "No" to the "Quit?" prompt), 
  340. and proceeding to run Visual Cafe. With light use, you may not 
  341. experience any problems at all. But with typical use, at some time 
  342. in the course of your Visual Cafe session you may begin to see 
  343. "low virtual memory" warnings from the operating system.  Typical 
  344. symptoms of running any complex application with too little available 
  345. memory are sluggish performance and unstable system behavior.
  346.  
  347. If the warning dialog recommends that you increase swap space by 
  348. some small amount, such as 2 or 3 MB, please increase minimum 
  349. swap space on Windows NT or free disk space on Windows 95, by 
  350. at least 5 MB.
  351.  
  352. On Windows 95, if the option is selected in Settings | Control Panel | 
  353. System | Performance | Virtual Memory to let the OS manage swap space 
  354. (this is the default), then available swap space is simply the amount 
  355. of free disk space; but note that there is no guaranteed minimum:  
  356. if the disk is full, there is no swap space available.
  357.  
  358. On Windows NT 3.51, Control Panel is started from Program Manager;
  359. on Windows NT 4.0, Control Panel is started from the Settings
  360. menu item, as on Windows 95.  The page file setting that matters
  361. most to an application on NT is the minimum page size setting.
  362. On a system with 32 MB RAM, the minimum swap space should be not 
  363. less than 20 MB, and 32 MB is better. A reasonable setting for
  364. the maximum is at least twice the minimum.
  365.  
  366. For further details about virtual memory, see the OS Help on the
  367. System dialog.
  368.  
  369.  
  370. JDK Version Incompatibilities
  371. -----------------------------------------------------------------
  372. Symantec Visual Cafe 1.0d supports version 1.0.2 of the Java 
  373. Development Kit from Sun Microsystems.  
  374.  
  375. Some behaviors of the java.awt components are not correct on 
  376. Microsoft Windows platforms.  
  377.  
  378. These platform-dependent problems include:
  379.  
  380. * Buttons and labels do not support foreground or background colors.
  381. * Checkbox/radiobuttons don't support foreground color.
  382. * Lists size themselves to specific increments (to completely hold 
  383.   lines of text). 
  384. * When building applets/applications for Microsoft Internet Explorer 
  385.   you should not use the project option for Java Optimization or the 
  386.   -O switch.
  387. * When calculating the Client area, awt does not take into account 
  388.   the menubar.  As a result your forms may not appear as WYSIWYG.
  389. * Choice and List components incorrectly display their size and 
  390.   position if not used in conjunction with a layout manager.
  391.  
  392.   Visual Cafe issues a reshape after the component is added, 
  393.   which addresses this problem. However, if you try to use 
  394.   descendants of these classes you will need to add a call to reshape
  395.   after the component has been added.  For example,
  396.     
  397.     Assuming newChoice extends Choice
  398.     //{{INIT_CONTROLS
  399.     newChoice1 = new newChoice();
  400.     newChoice1.reshape(119,72,135,21);
  401.     add(newChoice1);
  402.     //}}
  403.     
  404.     // Add this section after the init block:
  405.     newChoice1.reshape(119,72,135,21);
  406.     
  407.  
  408. JDK 1.1 Support:
  409. -----------------------------------------------------------------
  410.  
  411. We are now working on the integration of JDK 1.1 support into Visual Cafe and
  412. expect to have a release available soon.  The upgrade to JDK 1.1 support will 
  413. be free for 1 year from the date of purchase of 1.0, so make sure to register 
  414. on cafe.symantec.com and subscribe to the mailing list so we can notify you 
  415. when new updates to Visual Cafe are available.
  416.  
  417.  
  418. V. Revision History:
  419. ================================================================
  420. 1.0d
  421.  
  422. 1.  Resolved crash drawing InvisibleHTMLLink component partially onto another
  423.     component.
  424. 2.  Resolved crash setting Preview Component to "true" for Animator without
  425.     specifying URL.
  426. 3.  Resolved various Menu Editor crashes and inability to copy or paste menus
  427.     or menu items within Menu Editor, Project Windows, or Form Designer.
  428. 4.  Resolved crash when Menu Editor remained open after parent is deleted.
  429. 5.  Resolved crash when import statements were deleted from source.
  430. 6.  Resolved crash when inserting a Canvas into a Calendar.
  431. 7.  Resolved crash with non-existent within a Tab Panel.
  432. 8.  Resolved crash when closing project with an invalid applet name.
  433. 9.  Resolved NervousText 100% CPU usage when paused.
  434. 10. Resolved horizontal and vertical sliders that were "see through."
  435. 11. Resolved Border Panel contents shifting up and left when Form
  436.     Editor is opened and closed.
  437. 12. Resolved Sound Player component that failed to parse.
  438. 13. Resolved List Box shrinkage on opening and closing the Form Editor.
  439. 14. Resolved setDate method in Calendar that failed to set date.
  440. 15. Resolved labelButton label that was missing until clicked on execute.
  441. 16. Resolved left alignment issues within Label and textFields.
  442. 17. Resolved various Numeric Spinner issues.
  443. 18. Resolved the adding of more than 14 files to the URL property
  444.     of Animator or Slideshow.
  445. 19. Resolved various issues with saving projects on a network.
  446. 20. Resolved various back parser failures.
  447. 21. Resolved various GridBag failures.
  448. 22. Resolved failure with extending java.awt.Canvas
  449. 23. Resolved Slider not painting correctly if the default value isn't 0.
  450. 24. Resolved NumericSpinner default values not functioning.
  451. 25. Resolved LabelButton's label not showing until clicked as well as other
  452.     issues.
  453. 26. Removed "?invalid row" in messages window.
  454. 27. Inserting a package statement no longer prevents future visual
  455.     design code generation.
  456. 28. Sample applets modified.
  457. 29. Various component documentation enhancements.
  458. 30. Live Controls now disabled if foreign Java .DLL files are found in the
  459.     system path.
  460. 31. Variables are now available with an applet connection.
  461. 32. Resolved accelerator conflicts with Window Menu.
  462. 33. Added installation prompts for Classpath addition to environment.
  463. 34. Added "double" capability in GridBag layout.
  464. 35. Added "Applet to Dialog" interactions.
  465. 36. Added Macro Recorder.
  466. 37. Added Macro Recorder help.
  467. 38. Added support for name, label, or values greater than 256 characters.
  468. 39. Added default tab property for TabPanel.
  469. 40. Added "Generate Debug Information" into project options.
  470. 41. Resolved MultiList clear method where list would not clear until clicked.
  471. 42. Resolved preformatted text fields with KeyPressManagerPanel so tabbing is supported.
  472. 43. Resolved CardLayout so that card names are now generated into the source file.
  473.  
  474. VI. Contacting Symantec for Technical Support
  475. ================================================================
  476.  
  477. During the first 90 days of your purchase, you may call Technical support free 
  478. of charge at (541) 465-8470.
  479.  
  480. 1.  Free and unlimited electronic support is available at on Symantec's news 
  481.     server at service.symantec.com.
  482.  
  483.     Please refer to the news groups under 
  484.     symantec.support.devtools.pc.visual-cafe
  485.   
  486.     Note: your company's firewall may prevent you from accessing this service.   
  487.   
  488.     Support is also available on the usenet newsgroup  
  489.     comp.lang.java
  490.  
  491.     Send bug reports to Support_javawin@symantec.com
  492.  
  493. 2.  If your User ID and Password become inoperative, please send 
  494.     e-mail notification to Customer Service at custserv@symantec.com 
  495.     with your name, address, daytime phone number, ID and password. 
  496.     Please type "Visual Cafe" in the subject field.  We will respond shortly
  497.     thereafter.
  498.   
  499. 3.  If you have lost your Cafe ID set, please send notification to 
  500.     Customer Service at custserv@symantec.com.  In the event that 
  501.     your information does not appear in our registration database, 
  502.     we will provide additional avenues for verification of ownership.
  503.  
  504. 4.  For CD purchases or damaged disks please call Customer Service 
  505.     at 800-441-7234.   
  506.  
  507.  
  508.         *  *  *  *  *
  509.  
  510. Thank you for using Visual Cafe.  We are confident it will assist you 
  511. with your development efforts.
  512.  
  513. Sincerely,
  514.  
  515. The Symantec Internet Tools Team 
  516.             
  517.  
  518.