Updated 2005/11/01

Sun[tm] Studio 11: Integrated Development Environment (IDE) Readme

  1. Introduction
  2. About the Sun Studio 11 IDE
  3. New and Changed Features
  4. Supported Source Code Control Software
  5. Components of the Sun Studio 11 Software
  6. Ensuring That the IDE Operates Correctly in a Client/Server Installation
  7. Ensuring That the IDE Can Find the Core Platform
  8. Ensuring That the IDE Can Find the Correct J2SE Technology
  9. Starting the IDE
  10. Software Corrections
  11. Problems and Workarounds
  12. Limitations and Incompatibilities
  13. Documentation Errata

 

A. Introduction

This document contains information about the Sun Studio IDE.

Product Documentation

 

B. About the Sun Studio 11 IDE

The Sun Studio 11 IDE provides modules for creating, editing, building, debugging, and analyzing the performance of a C, C++, or Fortran application. It includes a set of basic Java[tm] language support modules that can be enabled if needed for JNI (Java[tm] Native Interface) development.

This release of the IDE is available on the following platforms:

 

C. New and Changed Features

D. Supported Source Code Control Software

The Sun Studio 11 IDE supports the following source code control software:

E. Components of the Sun Studio 11 Software

The Sun[tm] Studio 11 software consists of two major components:

The IDE, compilers, and tools are installed by default in the /opt/SUNWspro directory on Solaris, but an alternate location can be specified during installation. The IDE and tools are installed in the /opt/sun/sunstudio11 directory on Linux platforms, but an alternate location can be specified during installation.

The core platform is installed by default in the /opt/netbeans/3.5V11 directory on Solaris platforms, but an alternate location can be specified during installation. The core platform is installed by default in the /opt/sun/netbeans/3.5V11 directory on Linux platforms, but an alternate location can be specified during installation.

On Solaris platforms, the J2SE 1.4.2_08 technology or the 32-bit J2SE 5.0 Update 3 technology is installed by default in the /usr/jdk/j2sdk1.4.2_08 directory or /usr/jdk/jdk1.5.0 directory, but an alternate directory in /usr can be specified during installation. On Linux platforms, the J2SE 1.4.2_08 technology is installed by default in the /usr/java/j2sdk1.4.2_08 directory; but an alternate directory in /usr can be specified during installation.

The correct operation of the IDE depends on the IDE being able to find the core platform, and the core platform being able to find the J2SE technology.

 

F. Ensuring That the IDE Operates Correctly in a Client/Server Installation

The Sun Studio 11 software can be installed on a server. To ensure that the IDE can find the core platform when you start the IDE from a client system, you must mount the directories that contain the IDE and the core platform from the server if they are not installed on the client system.

For convenience, both the IDE and the core platform are installed in the same base directory, so you can use a single mount point on the client system for both.

Note: If the mount point on the client system is the default installation directory, it might hide the installation of other software on the client system. In this case, do not mount the /opt directory. Instead, on Solaris platforms, mount the /opt/SUNWspro directory and /opt/netbeans directory separately. On Linux platforms, mount the /opt/sun/sunstudio11 directory and /opt/sun/netbeans separately.

 

G. Ensuring That the IDE Can Find the Core Platform

The sunstudio command that starts the IDE looks for the core platform in two locations:

If the core platform is not installed or mounted to either of the locations where the sunstudio command looks for it, then each user on a client system must set the environment variable SPRO_NETBEANS_HOME to the location where the core platform is installed or mounted (installation_directory/netbeans/3.5V11).

On Solaris platforms, each user of the IDE also must add /installation_directory/SUNWspro/bin to their $PATH in front of the path to any other release of Forte Developer software, Sun ONE Studio software, or Sun Studio software. On Linux platforms, each user of the IDE also must add /installation_directory/sunstudio11/bin to their path in front of the path to any other release of Sun Studio software.

Note: The path /installation_directory/netbeans/3.5V11/bin should not be added to the user's $PATH.

 

H. Ensuring That the IDE Can Find the Correct J2SE Technology

The IDE requires the J2SE 1.4.2_08 technology or the 32-bit J2SE 5.0 Update 3 technology. Each client system must have one of the following:

To determine whether a valid technology is installed in a standard location on your local system or is in your $PATH, type: 

checkjava

If the checkjava command finds a valid J2SE technology, the output of the command is: 

  Using J2SDK version version from path

If you receive this output, you have the required J2SE available to your system, and the IDE will find it.

If the command does not find a valid J2SE technology, the output of the command is: 

  Could not find valid J2SDK in $PATH or in a standard location

In this case, you have several choices:

 

I. Starting the IDE

The command to start the IDE is sunstudio. For details on this command, see the sunstudio(1) man page. (To display the sunstudio(1) man page, you must have /installation_directory/SUNWspro/man in your $MANPATH on Solaris platforms, and /installation_directory/sunstudio11/man in your $MANPATH on Linux platforms.)

The sunstudio command requires that you have the GNU Bourne-Again shell (bash)software, no earlier than version 2.05.0(1), installed in /bin/bash, as it is in the standard installation of the Solaris OS, versions 8 (except for the Developer System), 9, and 10. If you have a custom installation of the Solaris OS, check to be sure that you have the required shell by typing ls /bin/bash.

If you are running the Solaris 8 OS Developer System, you can install the SUNWbash package from the Solaris 8 CD2. Or you can download bash from http://www.sunfreeware.com by selecting the appropriate processor and OS in the menu on the right, and then selecting bash-3.0.

 

J. Software Corrections

This section describes problems that were fixed in the Sun Studio 10 update 1 re lease of the IDE.

No new information is available at this time.

 

K. Problems and Workarounds

This section discusses known software problems and possible workarounds for those problems. For updates or patches, check the updated information at http://developers.sun.com/sunstudio/support/.

  1. External Browser Might Not Start or Display Requested Link
  2. The New Breakpoints dialog often is not correctly seeded with the current file and line information when using the external editors GVim or XEmacs
  3. Sometimes get a FileStateInvalidException when startin g to debug an executable
  4. Closing and reopening the Output window causes tabs to disappear
  5. GVIM Corrupts File That Has Multibyte Characters
  6. XEmacs Corrupts File That Has Multibyte Characters
  7. GVIM Crashes On Find or Find and Replace
  8. Setting a Breakpoint Does Not Highlight Correct Line in GVIM
  9. GVIM Writes Multibyte Contents Over Other Strings< /A>
  1. External Browser Might Not Start or Display Requested Link

    If you choose the Compiler/Tools Documentation item on the Help menu, or click the link for the Developer Portal in the Welcome screen, the IDE might not successfully start your external browser or use an external browser you are already running to display the documentation index or the Developer Portal.

    Workaround:

    Start your external browser outside the IDE and use the following URLs:

    • For the documentation index page for the Sun Studio 10 for Solaris platforms or Sun Studio 10 for Linux platforms product, which has links to all o f the man pages, readmes, and manuals, use installation_directory/SUNWspro/docs
    • For the Developer Portal for Sun Studio, which provides code samples, technical articles, knowledge base items, and documentation, use http://developers.sun.com/sunstudio/.

  2. The New Breakpoints dialog often is not cor rectly seeded with the current file and line information when using the external editors GVim or XEmacs (4981442)

    When the New Breakpoints dialog is displayed, it is supposed to have the Breakpoint Type set to File:Line and the File and Line text fields set according to the cursor in the editor. In many cases, the File and Line fields are blank when the dialog is displayed, so that you must type in the file and line information.

    Workaround:

    There are three ways to display this dialog. If you display it from the Breakpoints view in the Debugger window you almost never see File and l Line information. If you display it from an external editor (GVim or XEmacs) using Shift+Ctrl+F8, File and Line information is correctly set. If you display the dialog from the Debug menu, it depends on where you last typed or clicked in the IDE windows.

  3. Sometimes get a FileStateInvalidException when starting to debug an executable (4960929)

    If you get this exception when starting the debugger, you also get a bad window layout. Exit the IDE and restart.

  4. Closing and reopening the Output window cause s tabs to disappear

    If you are running a single debugging session and you close the Output window and subsequently reopen it, the reopened window has only the Output tab.

    Workaround:
    Terminate your debugging session and start a new one, and the Output window will have all of its tabs.

  5. GVIM Corrupts File That Has Multibyte Characters (6203574)

    When GVIM is started from the Sun Studio IDE in the C locale, GVIM corrupts files that contain multibyte characters. Multibyte characters in a file are replaced with question marks.

  6. XEmacs Corrupts File That Has Multibyte Characters (6203595)

    When XEmacs is started from the Sun Studio IDE in the C locale, XEmacs corrupts files that contain multibyte characters. Multibyte characters in a file are replaced with question marks.

  7. GVIM Crashes On Find or Find and Replace (5078 549)
    When GVIM is started from the Sun Studio IDE in the Chinese (zh) locale , GVIM crashes when you choose Edit -> Find or Edit -> Find and Replace.

  8. Setting a Breakpoint Does Not Highlight Correct Line in GVIM (6205511)

    When GVIM is started from the Sun Studio IDE in the Japanese (ja) locale, and you set a breakpoint, GVIM does not highlight the correct line in the source file.

  9. GVIM Writes Multibyte Content Over Other Strings (4985433)

    When you run GVIM in the Japanese (ja) locale or the Chinese (zh) locale, you cannot save multibyte contents because GVIM overwrites other strings with the multibyte characters.

 

L. Limitations and Incompatibilities

This section discusses limitations and incompatibilities with systems or other software. For last-minute information, see the release notes for Solaris platforms at http://developers.sun.com/sunstudio/documentation/ss11/release_notes.html and the release notes for Linux platforms at http://developers.sun.com/sunstudio/documentation/ss11/Linux_release_notes.html

The Sun Studio 11 IDE has the following limitations:

 

M. Documentation Errata

There is no new information at this time. Additional information might be made available at http://developers.sun.com/sunstudio/

 

Copyright © 2005 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.