                                                   更新日付： 2004 年 5 月 26 日

 Sun[tm] Studio 9: 統合開発環境 (IDE) Readme 

     目次

       A.はじめに 
       B.Sun Studio 9 IDE について 
       C.新規および変更された機能 
       D.サポートされているソースコード管理ソフトウェア 
       E.Sun Studio 9 ソフトウェアのコンポーネント 
       F.クライアント/サーバー環境で IDE が正しく動作しない場合の対処法
       G.IDE がコアプラットフォームを検出できない場合の対処法 
       H.IDE が適切な J2SE テクノロジを検出できない場合の対処法 
       I.IDE の起動 
       J.問題点と回避策 
       K.制限事項と互換性の問題 



     ------------------------------------------------------------------

     A. はじめに

     この文書には、Sun Studio 9 統合開発環境 (IDE) の使用方法に関する情
     報が記載されています。 

     製品マニュアル 

        * リリースノート (Solaris プラットフォーム) : 
          http://docs.sun.com から入手可能です。リリースノートの情報は、
          すべての README ファイルの情報を更新および補足します。 
        * リリースノート (Linux プラットフォーム) : 
          http://docs.sun.com から入手可能です。リリースノートの情報は、
          すべての README ファイルの情報を更新および補足します。 
        * Sun Studio 9 のドキュメント :
          /installation_directory/docs/ja/index.html からは、製品のマ
          ニュアルページ、README の HTML バージョン、およびマニュアル~
          にアクセスできます。Solaris でのデフォルトの 
          installation_directory は /opt/SUNWspro です。Linux でのデ
          フォルトの installation_directory は /opt/sun/sunstudio9 です。 
        * IDE のドキュメント : IDE の「ヘルプ」メニューからは、Sun 
          Studio 9 IDE のすべてのコンポーネントに関するオンラインヘルプ
          にアクセスできます。 
        * 開発者向けリソースのポータル : 技術資料、サンプルコード、ド
          キュメント、ナレッジベースについては、開発者向けポータルの 
          http://developers.sun.com/prodtech/cc を参照してください。 
     


     ------------------------------------------------------------------

     B. Sun Studio 9 IDE について

     Sun Studio 9 IDE には、C や C++、Fortran アプリケーションを作成、
     編集、構築、デバッグ、パフォーマンス解析するためのモジュールが用意
     されています。また、JNI (Java[tm] Native Interface) 開発に必要な場
     合に有効にすることができる基本的な Java[tm] 言語サポートモジュール
     群も含まれています。 

     このリリースの IDE は、次のプラットフォームで利用できます。 

        * Solaris[tm] オペレーティングシステム: 
             o SPARCAE; プラットフォーム版のバージョン 8、9、10 
             o x86 プラットフォーム版のバージョン 8、9、10 
        * Linux オペレーティングシステム: 
             o Sun[tm] Java Desktop System, 2003 
             o SuSE Linux Enterprise Server 8 
             o RedHat Enterprise Linux 3 
     


     ------------------------------------------------------------------

     C. 新規および変更された機能

     ここでは、このリリースで IDE に新たに追加された機能と変更された機
     能を説明します。

     Sun Studio 9 IDE で新しく追加された、または変更された機能は次のと
     おりです。 

        * ss_attach - プロセスの実行後に dbx デバッガを接続するのではな
          く、プログラムの実行開始とともにプログラムを捕捉し、dbx デ
          バッガを接続してただちにデバッグを開始できます。 
        * ソースエディタの「クイックブラウズ」コンボボックス - ソース
          ファイルのクラスメソッドや関数、#define、その他要素に簡単に移
          動できます。 

     gcc や g++ コンパイラでコンパイルされたプログラム、あるいは Linux 
     プラットフォームで動作するプログラムの場合、dbx デバッガの一部機能
     は利用できません。詳細は、制限事項と互換性の問題を参照してください。 

     Solaris プラットフォーム版のその他の Sun Studio 9 コンポーネントに
     ついては、http://docs.sun.com から入手可能な『Sun Studio 9 の新機
     能』を参照してください。 
     


     ------------------------------------------------------------------

     D. サポートされているソースコード管理ソフトウェア
     Sun Studio 9 IDE では、次のソースコード管理ソフトウェアをサポート
     しています。 

        * CVS 1.11 
        * ClearCase V2002 u2 
        * PVCS 6.7.00 
     


     ------------------------------------------------------------------

     E. Sun Studio ソフトウェアのコンポーネント

     Sun Studio[tm] 9 ソフトウェアは、次の 2 つの主要コンポーネントに分
     けられます。 

        * IDE、コンパイラ (Solaris プラットフォーム版のみ)、ツール、コ
          アプラットフォームなどの Sun Studio コンポーネント 
        * コアプラットフォームの土台となる Java 2 Platform, Standard 
          Edition (J2SE) v 1.4.2_02 テクノロジ 

     デフォルトでは、Sun Studio 9 コンポーネントは、Solaris プラット
     フォームの場合 /opt/SUNWspro ディレクトリ、Linux プラットフォーム
     の場合 /opt/sun/sunstudio9 ディレクトリにインストールされます。た
     だし、インストールするときに別の場所を指定することもできます。 

     デフォルトでは、コアプラットフォームは、Solaris プラットフォームの
     場合 /opt/netbeans/3.5M ディレクトリ、Linux プラットフォームの場合
     /opt/sun/netbeans/3.5M ディレクトリにインストールされます。ただし、
     インストールするときに別の場所を指定することもできます。 

     Solaris プラットフォームの場合、デフォルトでは、J2SE 1.4.2_02 テク
     ノロジは /usr/jdk/j2sdk1.4.2_02 ディレクトリにインストールされます
     が、/usr 内の別のディレクトリを指定してインストールすることもでき
     ます。Linux プラットフォームの場合、デフォルトでは、
     /usr/java/j2sdk1.4.2_02 ディレクトリにインストールされますが、/usr
     内の別のディレクトリを指定してインストールすることもできます。 

     IDE が正しく動作するかどうかは、IDE がコアプラットフォームを検出で
     きるかどうか、またコアプラットフォームが J2SE テクノロジを検出でき
     るかどうかに依存します。
     


     ------------------------------------------------------------------

     F. クライアント / サーバー環境で IDE が正しく動作しない場合の
     対処法

     Sun Studio 9 ソフトウェアはサーバーにインストールすることができま
     す。IDE およびコアプラットフォームがクライアントシステムにインス
     トールされていない場合、クライアントシステムから IDE を起動したと
     きに IDE がコアプラットフォームを検出できるようにするには、IDE お
     よびコアプラットフォームを含むディレクトリをサーバーからマウントす
     る必要があります。 

     便宜上、IDE およびコアプラットフォームは同じベースディレクトリに
     インストールされるため、両方に対してクライアントシステム上で単一の
     マウントポイントを使用することができます。 

     注: クライアントシステム上のマウントポイントがデフォルトの /opt 
     ディレクトリの場合、クライアントシステムにインストールされている他
     のソフトウェアが隠されることがあります。その場合は、/opt ディレク
     トリはマウントしないでください。代わりに、Solaris プラットフォーム
     の場合は、/opt/SUNWspro ディレクトリと /opt/netbeans ディレクトリ
     を別々にマウントしてください。Linux プラットフォームの場合は、
     /opt/sun/sunstudio9 ディレクトリと /opt/sun/netbeans ディレクトリ
     を別々にマウントします。
     


     ------------------------------------------------------------------

     G. IDE がコアプラットフォームを検出できない場合の対処法

     IDE を起動する sunstudio コマンドは、コアプラットフォームを探す際
     に 2 つの場所を検索します。 

        * 最初に探すのはデフォルトのインストールディレクトリで、Solaris
          プラットフォームでは /opt/netbeans/3.5M、Linux プラットフォー
          ムでは /opt/sun/netbeans/3.5M です。 
        * デフォルトのこのディレクトリでコアプラットフォームが見つから
          ない場合は、IDE とコアプラットフォームが同じ場所にインストー
          ルされているか、あるいはそれらを含むディレクトリが同じ場所に
          マウントされているとみなします。たとえば Solaris プラット
          フォームの場合、IDE を含むディレクトリのパスが /foo/SUNWspro 
          であれば、/foo/netbeans/3.5M にコアプラットフォームがないかど
          うかを調べます。Linux プラットフォームの場合、IDE を含むディ
          レクトリのパスが /foo/sunstudio9 であれば、/foo/netbeans/3.5M
          にコアプラットフォームがないかどうかを調べます。 

     コアプラットフォームが sunstudio コマンドが検索する場所のどちらに
     もインストールされていないか、マウントされていない場合、クライアン
     トシステムのユーザーは各自、コアプラットフォームがインストールされ
     ているか、マウントされている場所 
     (installation_directory/netbeans/3.5M) を環境変数 
     SPRO_NETBEANS_HOME に設定する必要があります。 

     Solaris プラットフォームの場合、Forte Developer ソフトウェアか Sun
     ONE Studio ソフトウェア、あるいは Sun Studio ソフトウェアの他のリ
     リースが存在する場合、IDE ユーザーはまた、各自の $PATH のそのパス
     の前に installation_directory/SUNWspro/bin を追加する必要がありま
     す。Linux プラットフォームの場合は、各自のパスの Sun Studio ソフト
     ウェアの他のリリースへのパスの前に 
     /installation_directory/sunstudio9/bin を追加する必要があります。

     注: ユーザーの $PATH にパス 
     /installation_directory/netbeans/3.5M/bin を追加しないでください。
     



     ------------------------------------------------------------------

     H. IDE が適切な J2SE テクノロジを検出できない場合の対処法

     IDE には、J2SE 1.4.2_02 テクノロジが必要です。すべてのクライアント
     システムが、以下のいずれかの条件を満たしている必要があります。 

        * J2SE 1.4.2_02 テクノロジがシステムにインストールされている。 
        * J2SE 1.4.2_02 テクノロジがインストールされているパスにネット
          ワークからアクセスできる。 

     適切な J2SE 1.4.2_02 テクノロジがローカルシステムの標準の場所に
     インストールされているか、あるいはそのパスが自分の $PATH に設定さ
     れているかどうかを確認するには、以下を入力します。 

     checkjava

     checkjava コマンドが適切な J2SE テクノロジを検出すると、以下のよう
     に表示されます。 

       Using J2SDK version <バージョン> from <パス>

     この出力があった場合は、必要な J2SE にシステムがアクセスできるとい
     うことであり、IDE は J2SE を検出します。 

     適切な J2SE テクノロジが検出されなかった場合は、コマンドの出力は以
     下のように表示されます。 

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

     この場合は、いくつか選択肢があります。 

        * 製品に付属する J2SE 1.4.2_02 テクノロジをローカルシステムに
          インストールする。方法については、インストールガイドを参照し
          てください。 
        * ネットワーク上にインストールされている J2SE 1.4.2_02 テクノロ
          ジのパスをシステム管理者に確認する。パスが確認できたら、以下
          を行います。 
             o ネットワーク上の J2SE 1.4.2_02 テクノロジのパスを $PATH 
               に追加します。 
             o sunstudio コマンドに --jdkhome オプションを使用して、
               ネットワーク上の J2SE 1.4.2_02 のパスを指定します。詳細
               は、sunstudio(1) のマニュアルページを参照してください。
               (sunstudio(1) のマニュアルページを表示するには、Solaris 
               プラットフォームの場合は /installation_directory/man、
               Linux プラットフォームの場合は /
               installation_directory/sunstudio9/man が $MANPATH に設定
               されている必要があります。) 
             o JDK_HOME 環境変数にネットワーク上の J2SE 1.4.2_02 のパス
               を設定します。 
     


     ------------------------------------------------------------------

     I. IDE の起動

     IDE を起動するコマンドは、sunstudio です。このコマンドの詳細は、
     sunstudio(1) のマニュアルページを参照してください。(sunstudio(1) 
     のマニュアルページを表示するには、Solaris プラットフォームの場合は
     /installation_directory/man、Linux プラットフォームの場合は 
     /installation_directory/sunstudio9/man が $MANPATH に設定されてい
     る必要があります。) 
     


     ------------------------------------------------------------------

     J. 問題点と回避策

     ここでは、これまでにわかっているソフトウェアの問題点とその回避策に
     ついて説明します。最新情報については、開発者向けのポータルサイト、
     http://developers.sun.com/prodtech/cc/support_index.html をご覧く
     ださい。 

       1. 外部ブラウザによって要求したリンクが起動または表示されないこ
          とがある 
       2. 外部エディタ XEmacs、GVim を使用する場合、「新規ブレークポ
          イント」ダイアログで、現在のファイルおよび行の情報が正しく表
          示されない場合がある 
       3. スワップファイルが存在する場合、GVim が NetBeans の外部エディ
          タ機能に対して応答しない 
       4. 外部エディタ機能を使用して XEmacs および GVim を使用した場合、
          日本語や中国語等の複数バイト文字が含まれたファイルが正しく保
          存されない 
       5. 日本語環境で外部エディタを使用した場合、ブレークポイントが
          誤った位置に表示される場合がある 
       6. XEmacs ウィンドウで行った選択操作が解除されてしまう 
       7. 実行可能ファイルのデバッグを開始したときに、
          FileStateInvalidException が発生する場合がある 
       8. 最終行を削除すると外部エディタ文書が閉じる 
       9. ~ 文字が GVim に変更要求を送らない 
      10. GVim での cw コマンドによりファイルが破壊される 
      11. 「出力」ウィンドウを閉じたり再度開いたりするとタブが表示され
          なくなる 

       1. 外部ブラウザによって要求したリンクが起動または表示されないこ
          とがある

          「ヘルプ」メニューから「コンパイラ/ツールのドキュメント」を選
          択、あるいは開始画面で「開発者ポータル」のリンクをクリックし
          ても、IDE が外部ブラウザを正しく起動しなかったり、あるいはす
          でに実行中の外部ブラウザを使用してマニュアル索引や開発者ポー
          タルを表示しなかったりすることがあります。 

          回避策:

          IDE の外で外部ブラウザを起動して、次の URL を使用してください。 
             o Solaris プラットフォーム版または Linuxプラットフォーム版
               の Sun Studio 9 製品のマニュアル索引ページの場合は、
               installation-directory/SUNWspro/docs/ja を使用します。こ
               のページに、すべてのマニュアルページと readme、マニュア
               ルへのリンクが含まれています。 
             o Sun Studio 9 の開発者ポータルの場合は、
               http://developers.sun.com/prodtech/cc/index.html を使用
               します。このポータルサイトには、コード例や専門記事、ナ
               レッジベース項目、マニュアルが掲載されています。 

       2. 外部エディタ XEmacs、GVim を使用する場合、「新規ブレークポ
          イント」ダイアログで、現在のファイルおよび行の情報が正しく表
          示されない場合がある (4981442)

          「新規ブレークポイント」ダイアログが表示されたときに、ブレー
          クポイントの種類として「ファイル名:行」が選ばれている場合には、
          エディタ内のカーソルの位置に従って、行番号が自動的に設定され
          ますが、外部エディタを使用する場合には、行番号が設定されない
          ことがあります。手動で行番号を入力してください。 

          回避策: 

          このダイアログを表示させるには 3 つの方法があります。デバッガ
          ウィンドウのブレークポイント区画から表示させた場合、ほとんど
          のケースでファイル名と行番号が表示されません。外部エディタ上
          で Shift+Ctrl+F8 を押下した場合、ファイル名と行番号は正しく設
          定されます。デバッグメニューから表示させた場合には、直前まで
          使用していた IDE のウィンドウ上での入力内容やクリックした個所
          に依存します。 

       3. スワップファイルが存在する場合、GVim が IDE に対して応答しな
          い (4801244)

          vim のスワップファイルが存在する状態で、ソースファイルを GVim
          を使ってエクスプローラから開いた場合、GVim 上で E325 エラーが
          表示されます。"Hit ENTER or type command to continue" という
          表示も行われます。 

          上記のエラーは 2 つの問題を引き起します。はじめに、GVim の
          ウィンドウを再表示させたときに、内容が再表示されないため空白
          のウィンドウになってしまいます。次に、GVim からの応答を IDE
          が受け取ることができなくなり、タイムアウトの後に接続が切れま
          す。 

          タイムアウトする前に Enter キーを押下した場合 (タイムアウトは
          約 30 秒間です)、接続は正しく確立されます。 

       4. 外部エディタ機能を使用して XEmacs および GVim を使用した場合、
          日本語や中国語等の複数バイト文字が含まれたファイルが正しく保
          存されない (4950716)

          回避策:

          複数バイト文字を使用しないでください。 

       5. 日本語環境で外部エディタを使用した場合、ブレークポイントが
          誤った位置に表示される場合がある (4948883)

          例えば 20 行目にブレークポイントを設定した場合、21 行目として
          表示されます。これは中国語環境でも発生します。 

       6. XEmacs ウィンドウで行った選択操作が解除されてしまう (4964962)

          現在のところ、有効な回避策はありません。 

       7. 実行可能ファイルのデバッグを開始したときに、
          FileStateInvalidException が発生する場合がある (4960929)

          デバッガを開始したときにこの例外がスローされた場合には、
          ウィンドウ配置も崩れます。IDE を一旦終了させて、再度起動して
          ください。 

       8. 最終行を削除すると外部エディタ文書が閉じる (4985044)

          GVim に表示されているファイルの最終行を削除すると、GVim と 
          IDE の接続が停止します。接続が失われたという通知があります。

       9. ~ 文字が GVim に変更要求を送らない

          ファイル内で変更されたすべての文字は、その文字が変更されたこ
          とを伝えるメッセージを GVim に送り返す必要があります。'~' 文
          字はメッセージを送りません。 

      10. GVim での cw コマンドによりファイルが破壊される

          GVim でのファイルの編集中に cw コマンドを使用し、そのファイル
          を保存すると、ファイルが壊れることがあります。

      11. 「出力」ウィンドウを閉じたり再度開いたりするとタブが表示され
          なくなる

          単一のデバッグセッションを実行中に「出力」ウィンドウを閉じ、
          続いて再度そのウィンドウを開くと、そのウィンドウには「出力」
          タブだけが表示されます。 

          回避策: 

          そのデバッグセッションを終了して新規のセッションを開くと、す
          べてのタブを持つ「出力」ウィンドウが表示されます。 
     


     ------------------------------------------------------------------

     K. 制限事項と互換性の問題

     Sun Studio 9 IDE には次の制限があります。

        * Linux プラットフォームでは、dbx デバッガの次の機能は利用でき
          ません。 
             o ss_attach (実行開始とともにプログラムを捕捉) 
             o コアファイルのデバッグ 
             o 修正継続 
             o Java のデバッグ 
             o dbx collector コマンドまたは「コレクタ」ダイアログによる
               パフォーマンスデータの収集 (ただし、collect コマンドまた
               はパフォーマンスアナライザの「コレクタ」ウィンドウによる
               パフォーマンスデータの収集は可能です) 
             o 実行時検査 
             o 例外ブレークポイント 
             o フォルトブレークポイント 
             o システムコールブレークポイント 
             o プロセスイベントブレークポイント (「新規ブレークポイン
               ト」ダイアログボックスでプロセスイベントブレークポイント
               を設定することはできません。「出力」ウィンドウの「デバッ
               ガコンソール」タブを使い、dbx コマンド行から exit、next、
               step、stop、gone、および syncrtld イベントにブレークポ
               イントを設定できます。) 
             o デバッガイベントブレークポイント (「新規ブレークポイン
               ト」ダイアログボックスでデバッガイベントブレークポイント
               を設定することはできません。「出力」ウィンドウの「デバッ
               ガコンソール」タブを使い、dbx コマンド行から attach およ
               び detach イベントにブレークポイントを設定できます。) 
     
        * g++ コンパイラでコンパイルされているプログラムの場合、C++ 式
          に関する実行時型情報は得られません。 

        * Linux プラットフォームでのマルチスレッドプログラムのデバッグ
          に関する制限事項については、dbx の Readme ファイルを参照して
          ください。 

        * Solaris OS x86 プラットフォーム版では、実行時検査のメモリーア
          クセス検査機能は利用できません。 
     


     ------------------------------------------------------------------

     Copyright (C) 2004 Sun Microsystems, Inc. All rights reserved. Use
     is subject to license terms.
