The following release notes should have been included in the mail sent when you registered JBuilder for Mac OS X. It seems that this was not the case for everyone, so I've included them here for reference.

- Blake Stone

  Chief Scientist
  Borland

IMPORTANT NOTE: JBuilder 5 requires a newer version of the Java runtime than Apple includes in the current release of Mac OS X. JBuilder will detect MRJ 3.0 and display a message indicating that you must upgrade using Software Update. The newer Java runtime is not yet available via Software Update. Apple has provided the following instructions for downloading a beta version of the updated Java runtime:

   'To get the Java Seed developers should login to ADC (Apple
   Developer Connection) or join the ADC at http://connect.apple.com/.
   After you have logged into the ADC Member site, click the Download
   Software link, and then click the Java link to view a list of the
   Java software seeds. Once you have decided which software seed to
   download, press the Download Button on the right hand side of the
   seed description.'

Once the update has been installed, please update JBuilder's knowledge of the Java SDK using the following steps:

   1) Select the Tools | Configure JDKs... menu item
   2) Click the "Change..." button beside the JDK home path
   3) Make no changes on the path selection dialog, just press OK to
      rescan the existing location
   4) Press OK to close the Configure JDKs dialog

Disabling Aqua Look and Feel

Some problems appear only when using the Aqua look and feel (eg: the invisible vertical scroll bar thumb in database tables.) Before reporting a problem to the newsgroup please switch JBuilder's look and feel to Metal using the "Tools | IDE Options..." dialog's Browser tab to determine whether the problem is Aqua-specific.

Hardware Acceleration

JBuilder runs significantly faster when using hardware graphics acceleration, which is turned off by default in Apple's Java runtime preview. These steps will enable hardware acceleration when using JBuilder:

  1) Create a new file using TextEdit
  2) Select the "Format | Make Plain Text" menu item
  3) Add the text "vmparam -Dcom.apple.hwaccel=true", omitting the quotes
  4) Save the file in /Applications/JBuilder5/OpenTools as
  "HardwareGraphics.config"
  5) Select "Don't append" when TextEdit asks to add a .txt extension
  6) Restart JBuilder

Hardware acceleration is dependant on having enough video RAM to cache images. PowerBook / iBook users are under tighter constraints in this respect and should switch to "thousands" of colors to take full advantage of hardware acceleration.

If hardware acceleration causes unacceptable problems on your system it may be disabled by deleting the "HardwareGraphics.config" file and restarting JBuilder.

Enabling Java Sharing

Apple's Java memory sharing technology is disabled by JBuilder non-standard boot class path. Running and debugging Java applications with 128MB of memory may be faster if memory sharing is re-enabled by following these steps:

  1) Create a new file using TextEdit
  2) Select the "Format | Make Plain Text" menu item
  3) Add the text "addskippath ../lawt.jar", omitting the quotes
  4) Save the file in /Applications/JBuilder5/OpenTools as "EnableSharing.config"
  5) Select "Don't append" when TextEdit asks to add a .txt extension
  6) Restart JBuilder

This change will make using it difficult or impossible to use the GUI designer with AWT components. This functionality can be re-enabled by deleting the "EnableSharing.config" file and restarting JBuilder.
2001-Jun-15 8:25am gyles19@visi.com