home *** CD-ROM | disk | FTP | other *** search
-
- README for Symantec Visual Cafe Version 1.0d
- ============================================f====================
- Copyright (c) 1997 by Symantec Corporation. All Rights Reserved.
-
-
- Table of Contents:
- I. Welcome
- II. Installation Notes
- III. User Tips
- IV. Known Problems
- V. Revision history
- VI. Contacting Symantec for Technical Support
-
- I. Welcome!
- =================================================================
- Welcome to Symantec Visual Cafe Version 1.0d for Windows 95
- and Windows NT. Please take a few minutes to read this file,
- which contains the latest information regarding this release.
-
-
- II. Installation Notes
- ================================================================
- If you have previously downloaded the Preview Releases, you must
- remove them before installing Visual Cafe 1.0d.
-
- Run setup.exe. The installation is smooth and intuitive. As with
- any new software, please install Visual Cafe in a clean directory.
-
- If you are using Microsoft's NTFS do not install into a directory
- that has a name containing spaces.
-
-
- Installing and Running the Tutorial
- ---------------------------------------------------------------
- If you are new to Java development, please take the time to work
- through the exciting and informative tutorial that is part of
- Visual Cafe. This tutorial will provide you with an overview
- of Visual Cafe's most powerful features.
-
- What's in the Tutorial?
- ---------------------------------------------------------------
- In the Tutorial you will learn how to:
-
- * Design an applet, build it, and install it in a Web page.
- * Run the applet in a Web browser.
- * Design an application, then build, test, debug, and run it.
-
-
- III. User Tips
- =================================================================
- How do I add values for each column in a MultiList component?
-
- When using multiple columns in the MultiList component, you must
- separate the column values with a semicolon. Each row is separated
- with a Ctrl + Enter.
-
- *
-
- How do I configure my Web browser to run an applet I created
- using custom classes?
-
- When you are ready to view your applet outside the Visual Cafe
- environment, you need to make sure that the AppletViewer or your
- favorite Web browser can find the custom classes included with
- Visual Cafe. For local browsing, add an environment variable to
- your autoexec.bat file, such as:
-
- SET CLASSPATH=C:\visualcafe\java\lib\vecclass.zip
-
- *
-
- How do I distribute my applet on a Web server?
-
- -When placing the applet on a Web server, contact your
- Webmaster and verify that the Symantec classes are
- available. If the classes are not available on your server,
- the Webmaster will need to add them or tell you how
- to add them.
-
- -A solution that works locally, or from a server, is to copy the
- \VisualCafe\Java\Lib\symantec directory and all of its contents to
- the directory containing the applet. (The subdirectories of the
- "symantec" directory contain the Visual Cafe Java runtime classes.)
- Make sure to keep the same uppercase and lowercase letters for the
- subdirectories and class files; Java is case-sensitive.
-
- -Due to a large number of requests late in the beta cycle of
- Visual Cafe, we have included an early version of our Bundler
- utility that will allow you to easily figure out which class
- files are used by your applet or application, and need to be
- uploaded to your Web server. Once your Java app is ready, execute
- the following command at the command prompt (make sure that
- \visualcafe\bin is in your path):
-
- Bundler.exe -make -cdb mainclass.cdb -depend listname.dep mainclass.java
-
- mainclass is the name of the main class Java file or the
- project name. In this example, listname.dep is the file
- where the list of classes used by your app will be generated.
- In this version, the file listname.dep has to have a .dep extension.
- Bundler lists the name of the zip file (if any) where the class file
- was found. This helps you determine what class files you would need
- to unzip from each class zip file used by your app. Note that
- while the java.* class files are logged in this file, you are not
- actually required to copy those to your Web server, as they are
- usually available with most Internet browsers.
-
- Bundler takes the same other command line options as the sj command
- line compiler. So, you can add additional class paths, etc.
-
- *
-
- What is the "Execute applet in default HTML viewer" option in the
- Project Options dialog?
-
- The "Execute applet in default HTML viewer" option, located in
- the Project Options dialog box, allows you to view your applet
- in your favorite Web browser, instead of the AppletViewer,
- when executing from the Visual Cafe environment.
-
- *
-
- Will Visual Cafe recognize my own source code?
-
- When adding controls directly within the source editor, it
- is recommended that you adhere to the same coding style as
- generated by Visual Cafe. This will allow controls you add to
- be displayed in the form editor. Controls you add outside
- Visual Cafe's tags (which are comments that indicate where Visual
- Cafe generates Java code for the form editor) will not be displayed in
- the form editor and will not be affected by automatic code generation.
-
- So, if you are adding controls within Visual Cafe's tags
- in the source editor, you should adhere to Visual Cafe's coding
- style. Otherwise, you can add controls outside of Visual Cafe's
- tags using your own coding style.
-
- *
-
- What do I need to do to enable remote debugging?
-
- If you are using cafeRemote on a remote computer for remote
- debugging, you must modify the autoexec.bat file on that
- computer. You must also include VisualCafe\java\bin your
- PATH, and create and set a CLASSPATH system variable
- to include all necessary classes for the applet or application
- you are debugging. Here is an example:
-
- set PATH=C:\VisualCafe\Java\Bin;%PATH%
- set CLASSPATH=C:\VisualCafe\Java\Lib;
- C:\VisualCafe\Java\Lib\SYMCLASS.ZIP;
- C:\VisualCafe\Java\Lib\VECCLASS.ZIP;
- C:\VisualCafe\Java\Lib\SYMANTEC.ZIP;
- C:\VisualCafe\Java\Lib\SYMANTEC.ZIP;C:\YOUR_CLASSES
-
- Note that a PATH or CLASSPATH statement in your system files
- is one continuous line with no spaces or carriage returns.
-
- *
-
- I'm charged for Web server space on a per megabyte basis. Is
- there a more efficient way to deploy other than copying the
- \symantec class subdirectory to each of my applet directories?
-
- The use of a CODEBASE="URL of applet directory" attribute within
- the <APPLET></APPLET> tags can be used to specify the URL of the
- directory in which the applet resides. That way your applets can
- access the symantec classes no matter where they reside.
-
- *
-
- When I open a project in the Form Designer, the dialog for Dial
- Up Networking appears. If I log on, all is well. If I cancel,
- Visual Cafe "hangs" for several minutes.
-
- The use of relative URLs (for example, IMAGES/*.GIF) can cause this
- behavior on some systems. To avoid it, use absolute URLs (for example,
- C:\...\PROJECT\IMAGES\*.GIF) during design time and then switch to relative
- URLs for deployment.
-
- *
-
- Each time I attempt to launch Visual Cafe, I get this message: An incorrect
- version of the AWT is found in the path (check your system directory).
- Visual Cafe runs if I click OK, but live controls are disabled.
-
- It is not uncommon for files that Visual Cafe relies upon to be replaced
- by other vendors (Java development tools or other software). In most cases,
- the files can be one or more of the following: JAVAI.DLL, AWT.DLL, MFC30.DLL,
- and/or MSVCRT20.DLL. Copy these files from VISUALCAFE\JAVA\BIN to
- VISUALCAFE\BIN. This will ensure that the correct files are being loaded
- since the current working directory, VISUALCAFE, is searched first (allowing
- the use of live controls). This solution is also applicable if a runtime error
- is generated when Visual Cafe is launched.
-
-
- *
-
- How can I increase the size of a form within the Form Designer larger
- than the resolution of my screen?
-
- A form in the Form Designer is limited to the resolution of your
- display. If your display system is capable, increase the its resolution
- to allow more information on the screen such as changing from 800x600
- to 1024x768. If your display system supports the use of a "viewport"
- or "virtual desktop" where only a portion of the desktop is displayed
- on the monitor, the form size can be increased to the size of the desktop.
- Note that this has not been thoroughly tested with all display systems.
-
- *
-
- Can I integrate Netscape's IFC into the Visual Cafe environment?
-
- Symantec will provide Netscape IFC integration instructions for Visual
- Cafe on our Web site at HTTP://CAFE.SYMANTEC.COM.
-
- *
-
- I would like to distribute my applications created with Visual Cafe along
- with the Symantec Virtual Machine. Do I need to obtain a license?
-
- Yes. Please contact Symantec Developer Relations for additional
- information. The .class files included with Visual Cafe are freely
- distributable.
-
- *
-
- I receive parsing errors when I attempt to define a custom color.
-
- Custom colors must be defined in the INIT_CONTROLS to avoid
- parsing errors.
-
- *
-
- If I overlap components, why do they behave differently in Internet Explorer
- and Netscape?
-
- The Java z-order implementation within Internet Explorer for Windows is
- opposite to that of Netscape for Windows. For example, take a look at the
- slide show in VISUALCAFE\TUTORIAL\APPLET\SLIDESHOW.JAVA. We've placed one
- Next InvisibleButton in front of the CLICKER.GIF image and one behind it so
- it will work for both browsers. If only one Invisible Button was used
- behind the CLICKER.GIF image in the SlideShow, the applet would not function
- correctly in Internet Explorer. To accommodate different Java z-order
- implementations, it is necessary to place an InvisibleButton in front of the
- component as well as behind it in order for events to be generated.
-
-
- How do I add third party components to Visual Cafe?
-
- Refer to the Component Integration document at
- FTP://ITOOLS.SYMANTEC.COM/PUB/DEVREL/VISUALCAFE/PAPERS/
- for instructions.
-
- *
-
- Where can I find additional learning materials for Visual Cafe/java?
-
- The following publishers have announced books for Visual Cafe:
-
- Discovering Visual Cafe
- IDG Books
- Wall & Griffith
-
- Visual Cafe Frontrunner
- Corolis
-
- Symantec Visual Cafe Sourcebook
- John Wiley & Sons
- Cary Jardin
-
- Visual Cafe Programming for Dummies
- IDG Books
- Tittel & Gaither
-
- Visual Cafe
- Addison Wesley Germany
- Guido Krueger
-
- Visual Cafe Pro
- WROX Press UK
- Roger Lee
-
-
- IV. Known Problems
- ================================================================
- This section lists information about known problems:
-
- * If you encounter certain errors when starting Visual Cafe or
- if your tool palette appears empty, delete the following files
- from \visualcafe\bin:
- *.rps
- *.reg
- *.vws
-
- Note: Some of the errors are:
- "No starter templates could be found"
- "Cannot open local repository"
- "Cannot open registry"
-
- These files are platform-dependent and must be regenerated
- when switching from one operating system to another.
-
- * Due to architectural changes within Visual Cafe projects, this
- version of Visual Cafe is not compatible with Preview 1 or 2 .VPJ
- files.
-
- * When using the Parse All Imports option, we recommend that you
- allow the parser to finish parsing before editing or changing
- a file. To view the status of the parser, select Messages
- from the Visual Cafe Window menu.
-
- * The x and y dimension properties in the Property Inspector are
- not applicable for root level objects. If you change these settings,
- it doesn't affect these objects.
-
- * Visual Cafe introspects class files when they are added to the
- Component Library, and allows the setting of basic properties
- in the property list if the class follows the Java Beans spec.
- Supported properties are: int, boolean, String, String arrays,
- Color, Font, URL, and URL arrays. Currently, the additional is/set
- design pattern for boolean properties is not supported.
-
- * If you would like to disable live controls, you can rename
- jblender.dll to jblender.sav.
-
- * The use of alignment tools within a borderPanel is not supported in this release.
-
- * When using border panels with snap to grid turned on, panel contents can shift
- when the panel itself is moved on a form. To prevent this, turn snap to grid off.
-
- Low-memory warning on startup
- -----------------------------------------------------------------
- If the sum of your system's available physical memory (RAM) and
- swap space on disk is below a minimal level when Visual
- Cafe starts up, a warning dialog will notify you of this condition.
- It advises you to increase swap space (see below). You have the
- option of ignoring this warning (answer "No" to the "Quit?" prompt),
- and proceeding to run Visual Cafe. With light use, you may not
- experience any problems at all. But with typical use, at some time
- in the course of your Visual Cafe session you may begin to see
- "low virtual memory" warnings from the operating system. Typical
- symptoms of running any complex application with too little available
- memory are sluggish performance and unstable system behavior.
-
- If the warning dialog recommends that you increase swap space by
- some small amount, such as 2 or 3 MB, please increase minimum
- swap space on Windows NT or free disk space on Windows 95, by
- at least 5 MB.
-
- On Windows 95, if the option is selected in Settings | Control Panel |
- System | Performance | Virtual Memory to let the OS manage swap space
- (this is the default), then available swap space is simply the amount
- of free disk space; but note that there is no guaranteed minimum:
- if the disk is full, there is no swap space available.
-
- On Windows NT 3.51, Control Panel is started from Program Manager;
- on Windows NT 4.0, Control Panel is started from the Settings
- menu item, as on Windows 95. The page file setting that matters
- most to an application on NT is the minimum page size setting.
- On a system with 32 MB RAM, the minimum swap space should be not
- less than 20 MB, and 32 MB is better. A reasonable setting for
- the maximum is at least twice the minimum.
-
- For further details about virtual memory, see the OS Help on the
- System dialog.
-
-
- JDK Version Incompatibilities
- -----------------------------------------------------------------
- Symantec Visual Cafe 1.0d supports version 1.0.2 of the Java
- Development Kit from Sun Microsystems.
-
- Some behaviors of the java.awt components are not correct on
- Microsoft Windows platforms.
-
- These platform-dependent problems include:
-
- * Buttons and labels do not support foreground or background colors.
- * Checkbox/radiobuttons don't support foreground color.
- * Lists size themselves to specific increments (to completely hold
- lines of text).
- * When building applets/applications for Microsoft Internet Explorer
- you should not use the project option for Java Optimization or the
- -O switch.
- * When calculating the Client area, awt does not take into account
- the menubar. As a result your forms may not appear as WYSIWYG.
- * Choice and List components incorrectly display their size and
- position if not used in conjunction with a layout manager.
-
- Visual Cafe issues a reshape after the component is added,
- which addresses this problem. However, if you try to use
- descendants of these classes you will need to add a call to reshape
- after the component has been added. For example,
-
- Assuming newChoice extends Choice
- //{{INIT_CONTROLS
- newChoice1 = new newChoice();
- newChoice1.reshape(119,72,135,21);
- add(newChoice1);
- //}}
-
- // Add this section after the init block:
- newChoice1.reshape(119,72,135,21);
-
-
- JDK 1.1 Support:
- -----------------------------------------------------------------
-
- We are now working on the integration of JDK 1.1 support into Visual Cafe and
- expect to have a release available soon. The upgrade to JDK 1.1 support will
- be free for 1 year from the date of purchase of 1.0, so make sure to register
- on cafe.symantec.com and subscribe to the mailing list so we can notify you
- when new updates to Visual Cafe are available.
-
-
- V. Revision History:
- ================================================================
- 1.0d
-
- 1. Resolved crash drawing InvisibleHTMLLink component partially onto another
- component.
- 2. Resolved crash setting Preview Component to "true" for Animator without
- specifying URL.
- 3. Resolved various Menu Editor crashes and inability to copy or paste menus
- or menu items within Menu Editor, Project Windows, or Form Designer.
- 4. Resolved crash when Menu Editor remained open after parent is deleted.
- 5. Resolved crash when import statements were deleted from source.
- 6. Resolved crash when inserting a Canvas into a Calendar.
- 7. Resolved crash with non-existent within a Tab Panel.
- 8. Resolved crash when closing project with an invalid applet name.
- 9. Resolved NervousText 100% CPU usage when paused.
- 10. Resolved horizontal and vertical sliders that were "see through."
- 11. Resolved Border Panel contents shifting up and left when Form
- Editor is opened and closed.
- 12. Resolved Sound Player component that failed to parse.
- 13. Resolved List Box shrinkage on opening and closing the Form Editor.
- 14. Resolved setDate method in Calendar that failed to set date.
- 15. Resolved labelButton label that was missing until clicked on execute.
- 16. Resolved left alignment issues within Label and textFields.
- 17. Resolved various Numeric Spinner issues.
- 18. Resolved the adding of more than 14 files to the URL property
- of Animator or Slideshow.
- 19. Resolved various issues with saving projects on a network.
- 20. Resolved various back parser failures.
- 21. Resolved various GridBag failures.
- 22. Resolved failure with extending java.awt.Canvas
- 23. Resolved Slider not painting correctly if the default value isn't 0.
- 24. Resolved NumericSpinner default values not functioning.
- 25. Resolved LabelButton's label not showing until clicked as well as other
- issues.
- 26. Removed "?invalid row" in messages window.
- 27. Inserting a package statement no longer prevents future visual
- design code generation.
- 28. Sample applets modified.
- 29. Various component documentation enhancements.
- 30. Live Controls now disabled if foreign Java .DLL files are found in the
- system path.
- 31. Variables are now available with an applet connection.
- 32. Resolved accelerator conflicts with Window Menu.
- 33. Added installation prompts for Classpath addition to environment.
- 34. Added "double" capability in GridBag layout.
- 35. Added "Applet to Dialog" interactions.
- 36. Added Macro Recorder.
- 37. Added Macro Recorder help.
- 38. Added support for name, label, or values greater than 256 characters.
- 39. Added default tab property for TabPanel.
- 40. Added "Generate Debug Information" into project options.
- 41. Resolved MultiList clear method where list would not clear until clicked.
- 42. Resolved preformatted text fields with KeyPressManagerPanel so tabbing is supported.
- 43. Resolved CardLayout so that card names are now generated into the source file.
-
- VI. Contacting Symantec for Technical Support
- ================================================================
-
- During the first 90 days of your purchase, you may call Technical support free
- of charge at (541) 465-8470.
-
- 1. Free and unlimited electronic support is available at on Symantec's news
- server at service.symantec.com.
-
- Please refer to the news groups under
- symantec.support.devtools.pc.visual-cafe
-
- Note: your company's firewall may prevent you from accessing this service.
-
- Support is also available on the usenet newsgroup
- comp.lang.java
-
- Send bug reports to Support_javawin@symantec.com
-
- 2. If your User ID and Password become inoperative, please send
- e-mail notification to Customer Service at custserv@symantec.com
- with your name, address, daytime phone number, ID and password.
- Please type "Visual Cafe" in the subject field. We will respond shortly
- thereafter.
-
- 3. If you have lost your Cafe ID set, please send notification to
- Customer Service at custserv@symantec.com. In the event that
- your information does not appear in our registration database,
- we will provide additional avenues for verification of ownership.
-
- 4. For CD purchases or damaged disks please call Customer Service
- at 800-441-7234.
-
-
- * * * * *
-
- Thank you for using Visual Cafe. We are confident it will assist you
- with your development efforts.
-
- Sincerely,
-
- The Symantec Internet Tools Team
-
-
-