JPH11161398A

JPH11161398A - コンピュータを利用したドキュメンテーション及びインストラクション

Info

Publication number: JPH11161398A
Application number: JP22748798A
Authority: JP
Inventors: Erik Hennum; ヘーナムエリック; Landon L Ott; エルオットランドン
Original assignee: Informix Software Inc
Current assignee: Informix Software Inc
Priority date: 1997-07-07
Filing date: 1998-07-07
Publication date: 1999-06-18
Also published as: AU761413B2; EP0890900A3; US6259445B1; CA2242408A1; BR9802350A; AU7415898A; EP0890900A2; US6724401B1

Abstract

(57)【要約】【課題】コンピュータを利用したドキュメンテーショ
ン及びインストラクションの方法及び装置を提供する。【解決手段】コンピュータシステムのユーザインスト
ラクションは、対話例を実行すること、及び用例に対応
している説明情報を、対話例と同期で、供給することを
含む。提示された説明情報は、対話例で最近何が生じた
のかを説明すると共に対話例の現行状態に対応すべく自
動的に更新される。

Description

【発明の詳細な説明】

【０００１】

【発明の属する技術分野】本発明は、コンピュータを利
用したドキュメンテーション及びインストラクションに
関する。

【０００２】

【従来の技術】図１に示すような一般的なコンピュータ
システムは、中央処理装置１２、入力／出力装置１３及
び、オペレーティングシステム１５及び一つ以上のアプ
リケーションプログラム１６のようなコンピュータ１１
によって用いられる種々のプログラムを含んでいるメモ
リ１４を有しているコンピュータ１１を含む。コンピュ
ータシステムのエンド−ユーザは、入力／出力装置１３
を介して情報をコンピュータ１１に転送する種々の入力
装置（キーボード１７、マウス１８）によりコンピュー
タ１１と通信する。コンピュータ１１は、かずある中で
も、例えば、適当なテキスト及びイメージをディスプレ
イモニタ１９の画面上に表示することにより、エンド−
ユーザに応答出力を供給することによって、この入力デ
ータに応答する。

【０００３】オペレーティングシステム１５は、オペレ
ーティングシステム及び（それが）実行しているあらゆ
るアプリケーション（例えば、ワードプロセッシングプ
ログラム）が（それによって）コンピュータシステムの
ユーザと通信することができるグラフィックユーザイン
タフェース（“ＧＵＩ”）を含みうる。一般的に用いら
れるＧＵＩインプリメンテーションは、モニタの画面が
仮想デスクトップと見なされるようなデスクトップメタ
ファーを採用する。デスクトップは、一つ以上のディス
プレイ領域を含んでいる、種々のグラフィックオブジェ
クトを支援している本質的に二次元ワーキングテンプレ
ートエリアである。図２に示すように、アプリケーショ
ンプログラム又はオペレーティングシステムによって生
成される情報は、ディスプレイ領域２３内のデスクトッ
プ２１（例えば、ウィンドウズ、ダイアログボックス、
ポップアップメニュー、プルダウンメニュー、ドロップ
ダウンリスト、アイコン）に表示することができる。ユ
ーザは、ディスプレイ領域内のカーソル２４を適当に操
作することにより、かつキーボード又は他の入力装置で
情報を入力することにより、オペレーティングシステ
ム、及びそれが実行しうるあらゆるアプリケーションと
対話することができる。

【０００４】有効にアプリケーションプログラムを使用
するために、ユーザは、アプリケーションそれ自体と対
話する方法を知らなければならないだけでなく、アプリ
ケーションの特質により、ユーザは、アプリケーション
が関係する対象事項に関する本質的な知識の本体も有さ
なければならない。例えば、アプリケーションがソフト
ウェア開発環境であれば、ユーザは、有効的にアプリケ
ーションを使用するためにコンピュータプログラミング
内容及びプログラミング言語に精通していなければなら
ない。

【０００５】ほとんどのコンピュータアプリケーション
は、アプリケーションの使用を補助するオンラインヘル
プ／ドキュメンテーションファシリティを供給する。図
３Ａに示すような一般的なオンラインヘルプシステム
は、テキスト及びグラフィック情報の画面がヘルプウィ
ンドウ３０のユーザに対して表示されるようなＧＵＩを
介してアクセスされる。次いで、ユーザは、アプリケー
ション及びその種々の特徴の更なる理解を得るためにヘ
ルプテキストの画面を読取ることができる。ユーザは、
キーシーケンス（例えば、キーボードのＦ１キーを押す
こと）で、又は適当なグラフィックアイコン又はメニュ
ー項目上でマウスをクリックすることによって、ヘルプ
システムを呼出す。それに応答して、ヘルプシステム
は、要望によりユーザによってアクセスしかつビューす
ることができる利用可能なヘルプトピックス及びサブト
ピックスをリストしている目録３１を表示しうる。ユー
ザは、目録３１全体をブラウザ（走査、検索）しかつそ
の情報の対応する本体をヘルプウィンドウに表示させる
べく興味があるヘルプトピックをクリックすることがで
きる。図３Ａに示したヘルプウィンドウ３０では、ユー
ザは、図３Ｂに示すように、ウィンドウ３０に対応ヘル
プ画面３２を表示させるべく“マイクロソフトワードに
よるプログラミング”トピック３１をクリックした。

【０００６】図３Ｂに示した“マイクロソフトワードに
よるプログラミング”トピック３１は、それぞれが個別
の“リンク”によって表される、複数のサブトピックス
３３を含む。ユーザがこれらリンクの一つ−−例えば、
“エラーメッセージ”リンク３４−−でマウスをクリッ
クした場合、図３Ｃに示すように対応ヘルプトピックに
対するルーチンテキストがヘルプウィンドウ３０に自動
的に表示される。この例では、“エラーメッセージ”リ
ンク３５は、特定の型のエラーメッセージに関係してい
る更なるサブトピックスに対する複数のリンクを含む。
図３Ｄに示すように、ユーザがこれらのリンクの一つ、
例えば、“Ｏｕｔｏｆｍｅｍｏｒｙ（アウトオブメモ
リ）（スタック空間）”リンク２５をクリックした場
合、選択したトピックに対する対応ヘルプ情報（“Ｆｒ
ｅｅｉｎｇｕｐｍｅｍｏｒｙ（メモリを自由に使えるよ
うにする）”）を表示すべく新しいヘルプウィンドウ３
６が生起される。ウィンドウ３６に表示されるヘルプ情
報は、ユーザによってクリックされた場合に対応ヘルプ
テキストをポップ−アップダイアログボックス３８に表
わす、別のサブトピック、“ａｃｔｉｖｅｗｉｎｄｏｗ
（アクティブウィンドウ）”、に対する更に別のリンク
３７を含む。実質的にそのようなネストされたへルプデ
ィスプレイのあらゆるレベルが可能である。ヘルプ情報
を表示するために用いられるディスプレイ領域（ウィン
ドウズ、ダイアログボックス、等）の量及び型は、ほと
んど、ヘルプシステム開発者の好みに基づく設計選択事
項である。全ての利用可能なヘルプトピックスを単に表
示しかつユーザに適当なヘルプトピックを識別しかつ手
動で呼出させるよりも、ヘルプシステムがアプリケーシ
ョンの現行タスクに特に関連するヘルプ情報を自動的に
表示するということを意味する、“コンテキスト−セン
シティブ”ヘルプ情報を供給しうる。コンテキスト−セ
ンシティブヘルプシステムは、アプリケーションの現行
状態（例えば、ユーザによって呼出される特定の機能）
及び現行カーソル位置のようなファクター（要因）に基
づきどのヘルプ情報を表示するかを決定する。

【０００７】ほとんどのオンラインヘルプシステムによ
って供給される情報は、アプリケーションの特徴を使用
する機構に関する。図４では、例えば、選択されたヘル
プトピック４１、“印刷中止（Ｃａｎｃｅｌｐｒｉｎｔ
ｉｎｇ）”に対応しているテキスト４２は、アプリケー
ション４０（マイクロソフトワード）によって供給され
る印刷特性を制御する方法を記述する。また、ヘルプシ
ステムは、所望の目的を達成するためのアプリケーショ
ンの利用方法に関する実質的な情報も供給しうる。図５
Ａでは、例えば、オンラインヘルプシステムは、二つの
型の実質的な情報を供給する：ＷｏｒｄＢａｓｉｃ（ワ
ードベーシック）ばプログラミング言語に対するリファ
レンス材料５１及び有用なプログラムを書込むためのＷ
ｏｒｄＢａｓｉｃの使用方法の実用的説明５２．リファ
レンス材料５１は、ＡｄｄＡｄｄｌｎステートメントの
ような、種々のＷｏｒｄＢａｓｉｃステートメントの構
文及び意味を記述しているテキスト注釈、図５Ｂに示さ
れる、ヘルプテキストを含む。実用的説明５２は、ユー
ザがＷｏｒｄＢａｓｉｃプログラミング言語の更なる
理解を得るために勉強することができるプログラムコー
ドの静的な例を含むことができる。図５Ｃは、ＧｅｔＣ
ｕｒＶａｌｕｅｓＷｏｒｄＢａｓｉｃステートメントを
利用するプログラムコードの例を示す。

【０００８】オンラインヘルプシステムは、一般的に、
テクニカルライターによって書かれたヘルプ情報を含ん
でいる多数の異なるヘルプソースファイルをコンパイル
することによって“構築（ｂｕｉｌｔ）”（即ち、ラン
タイム動作を容易にするフォームにプロセスされる）さ
れる。一般に、これらのヘルプソースファイルは、ヘル
プシステムが対応するアプリケーションとは異なる情報
の個別の本体として維持される。その結果、アプリケー
ション開発者がアプリケーションの機能性（相関性）を
変更又は更新する場合、テクニカルライターは、オンラ
インヘルプシステムがアプリケーションの動作を正確に
記述するということを保障するためにヘルプソースファ
イルに対して対応する変更を行わなければならない。

【０００９】

【発明の実施の形態】一形態では、コンピュータシステ
ムのユーザインストラクションは、対話例又はインスト
ラクショナルデモンストレーションを実行すること及
び、対話例に同期して、例に対応している説明情報を供
給することを含む。提示された説明情報は、対話例で最
近発生したことを説明しかつ対話例の現行状態に対応す
べく自動的に更新される。説明情報は、対話例からの出
力と並行して又は同時に提示されうる。コンピュータシ
ステムのユーザは、対話例の性能又は説明情報の提示を
制御することができる。説明情報の提示は、コンピュー
タシステムの画面上に複数のウィンドウズを表示するこ
とを含むことができ、対話例からの出力は、別のウィン
ドウに表示される。対話例の状態における変化に応じ
て、供給された説明情報は、それに従って変更されう
る。

【００１０】また、コンピュータシステムのユーザは、
対話例、説明情報、又はその両方に関するオンラインリ
ファレンス材料へのアクセスを供給されうる。オンライ
ンリファレンス材料は、説明情報のリンクを介してアク
セスされうる。ユーザが、例えば、マウスカーソルでリ
ンクをクリックすることによって特定のリンクを選択す
る場合、対応リファレンス情報がユーザに提示される。
説明情報のリンクは、論理的階層構造に配列することが
でき、階層構造の各連続レベルは、増大した詳細の程度
を供給する。また、コンピュータシステムのユーザは、
対話例と関連するソースコードへのアクセスを供給され
うる。対話例と関連するソースコードのフラグメント
は、例と関連する注釈に表示されうる。また、注釈は、
対話例の動作の散文記述(prosedescription）も含みう
る。ソースコードへのアクセスは、編集ユティリティに
よって供給することができ、コンピュータシステムのユ
ーザが注釈内の視覚的に示されたジャンプ（例えば、シ
ョートカット矢印）を選択する場合に始めることができ
る。次いで、ユーザは、対話例全体に対するソースコー
ドのコンテキストにおけるソースコードフラグメントを
ビューし、コピーし又は変更することができる。ユーザ
は、例のソースコードを繰返し変更しそして何が起こる
か見るために変更した例を実行することによって対話例
を経験することができる。

【００１１】対話例によって示された概念を実現するた
めのアプリケーションは、ユーザに供給されうる。コン
ピュータを利用したインストラクショナルシステムによ
って供給される対話例は、アプリケーションによって供
給される機能性のサブセットを表すことができる。例え
ば、対話例は、コンピュータプログラミング概念に対応
しうる。その場合には、ソフトウェア開発環境は、ユー
ザに対話例によって示されるプログラミング概念を実現
させるべく供給されうる。対話例及び対話例を記述して
いる対応注釈は、ソースコードの統一された本体から構
築することができる。対話例を構築するのに用いられる
ソースコードの部分及び対話例を記述している注釈を構
築するのに用いられるソースコードの別の部分を仕切
る、マークアップ記号は、ソースコードの統一された本
体端に含むことができる。対話例を構築するのに用いら
れるソースコードの部分は、対話例を記述している注釈
を構築するのに用いられるソースコードの部分を重ね合
わせることができる。

【００１２】別の形態では、コンピュータソフトウェア
は、コンピュータを利用したアプリケーション（例え
ば、インストラクショナル例）に対するソースコードの
本体を維持しかつソースコードの本体に基づいてコンピ
ュータを利用したアプリケーションを構築することによ
って開発することができる。更に、コンピュータを利用
したアプリケーションに対応している注釈は、ソースコ
ードの本体から抽出された情報に基づいて構築すること
ができる。維持されるソースコードの本体は、プログラ
ムインストラクション及び説明情報の両方を含むことが
でき、プログラマ（又はプロセッシングスクリプト）
は、ソースコードの本体を通じて表されているそれぞれ
互いのベースになる記号（例えば、マークアップ記号）
から識別することができる。記号は、エンドユーザに対
して表示される対話例又はソースコードフラグメントを
構築するために用いられるべきプログラムインストラク
ションを識別することができる。代替的に、又は更に、
記号は、説明情報がエンドユーザに提示される方法を定
義することができる。

【００１３】注釈は、注釈に対応するソースコードの部
分を識別するためにソースコードの本体をパーズするこ
とによって構築することができる。パーシング（構文解
析）は、ソースコードの本体に表されている所定のマー
クアップ記号を認識するスクリプトでソースコードの本
体をプロセスすることによって達成される。また、注釈
の構築は、パーシングの結果に基づいてドキュメンテー
ションソースファイルを生成することも含む。次いで、
ドキュメンテーションソースファイルは、オンラインヘ
ルプユティリティによって認識されるフォーマットにコ
ンパイルすることができる。また、ソースコードのパー
シングは、エンド−ユーザにより実行することができる
対話例にコンパイルすることができる、用例ソースコー
ドファイルを生成するために用いることができる。

【００１４】また、ソフトウェアの開発は、エンドユー
ザに、ジャンプに隣接して表示されるソースコードフラ
グメントに対応している位置におけるソースコードの本
体をアクセスさせるジャンプを生成することを含みう
る。更に、ソフトウェア開発は、ソースコードの本体に
表される所定のトークン（例えば、キーワード又はクラ
スネーム）のリストをアセンブリすること及びアセンブ
リされたリストにおける各トークンに対するオンライン
リファレンスへのリンクを生成することを含むことがで
きる。利点（効果）は、以下の一つ以上を含みうる。用
例概念によるドキュメンテーションに基づくインストラ
クショナルヘルプシステムは、学習環境、又はラボラト
リを供給し、ユーザは、所望の目的（例えば、新しいア
プリケーションをプログラムすること）を達成するため
にアプリケーションを成功裏に動作するための供給され
た技術の代表例を供給される。実行し、検査し、変更
し、かつ供給された例からコピーすることによって、ユ
ーザは、加速されたレートで複雑でかつ精巧な対象項目
を学習することができる。

【００１５】ここで記述された用例システムによるドキ
ュメンテーションは、向上した訓練及びインストラク
ションケーパビリティを供給する。ユーザは、多数の対
話例のいずれかを選択的に実行しかつそれらの動作を観
測することによって学習することができる。更に、ユー
ザの観測は、用例が実行されているときにユーザに表示
される注釈によって補強される。注釈は、与えられた時
間に表示される注釈テキストが用例の状態と同期される
ように用例の実行で自動的に調整される。その結果、ユ
ーザは、画面上に表されている注釈を読取ることによっ
て用例において何がちょうど生じたのかを判別すること
ができる。更に、ユーザは、関連背景情報への注釈にお
けるリンクに従うことによって詳細の所望のレベルにお
ける用例について更に学習することができる。

【００１６】用例システムによるドキュメンテーション
が構築されかつ維持される方法は、対話例及びそれらの
対応注釈が同期に保たれることを保障する。対話例及び
対応説明情報に対するソースコードがソースコードの同
じ本体から直接抽出されるので、注釈は、対話例の現行
機能性を常に反映する。更に、用例のソースコード及び
ソースコードの同じ本体内のそれらの対応注釈を含むこ
とによって、用例システムによるドキュメンテーション
の維持（保守）は、劇的に簡略化される。用例システム
によるドキュメンテーションのコンポーネントが対話例
のソースコードに統合され、かつそれと一緒に更新され
るので、ソフトウェア開発者は、用例が変更される度に
用例システムによりドキュメンテーションを個別に更新
しかつ構築する必要がない。その結果、対話例は、ドキ
ュメンテーションシステムが最近の又は正しいバージョ
ンの用例及びそれらの注釈を含むということを手動で確
保することの管理上の悩みを蒙ることなく自由にかつ頻
繁に更新することができる。

【００１７】他の利点及び特徴は、図面及び特許請求の
範囲を含む、以下の説明から明らかになるであろう。

【００１８】

【実施例】通常のオンラインヘルプシステムによって供
給されるヘルプ情報は、アプリケーションプログラムを
有効に利用するためにユーザを支援することにおいて有
用なことが示された。しかしながら、これら通常のオン
ラインヘルプシステムは、静的テキスト又は図式情報を
供給することに本質的に限定されるので、それらの効果
は、かなり縮小される。通常のオンラインヘルプシステ
ムのユーザは、ヘルプシステムによて供給されるテキス
ト及び図式情報を読取りかつ注意深く勉強しそしてその
教示を解決すべき問題に適用することによってインスト
ラクションを得る。その結果、複雑なアプリケーション
を使用することを学習することは、しばしば、骨がおれ
かつ時間を消費するプロセスである。

【００１９】例えば、ＮｅｗＥｒａ（ニューエラ）Ｂｙ
Ｅｘａｍｐｌｅとして知られる、ＩｎｆｏｒｍｉｘＳｏ
ｆｔｗａｒｅ、Ｉｎｃ．（インフォミックスソフトウェ
ア会社）によって開発されたオンラインヘルプ及びイン
ストラクションシステムは、それによりユーザが情報を
吸収しかつ新しいアプリケーションを使用することを学
ぶことができる容易性を劇的に向上する。ＮｅｗＥｒａ
ＢｙＥｘａｍｐｌｅは、Ｗｉｎｄｏｗｓ９５／ＮＴオペ
レーティングシステムの下で実行されるＩｎｆｏｒｍｉ
ｘＳｏｆｔｗａｒｅＩｎｃ．からのオブジェクト指向型
アプリケーション開発環境である、ＮｅｗＥｒａのため
のオンラインドキュメンテーションファシリティであ
る。その使用及び動作のＮｅｗＥｒａＢｙＥｘａｍ
ｐｌｅのオンライン説明のコピーは、添付資料Ａとして
添付される。

【００２０】ＮｅｗＥｒａＢｙＥｘａｍｐｌｅ（又
は、より一般的に、ＮｅｗＥｒａ、ＶｉｓｕａｌＢａｓ
ｉｃ及びＪａｖａ開発環境に対して供給される用例を利
用したインストラクションシステムを網羅する、Ｉｎｆ
ｏｒｍｉｘＢｙＥｘａｍｐｌｅ）は、ユーザが所与のタ
スクを達成するための方法をデモンストレートしている
動的な、対話用例を供給されるような「ドキュメンテー
ションバイイクザンプル」と呼ばれるより一般的な概念
の特定な実現である。用例の種々な形態を記述している
注釈は、それらが実行されるときに用例を伴う。ドキュ
メンテーションバイイクザンプルは、単にトピックを
読むこと以外に何かを行うこと（例えば、アクティビテ
ィに参加しかつその出力を観測するか又は影響を及ぼす
こと）によってユーザが最もよく学ぶプレミス（前提条
件）に部分的に基づく。

【００２１】図６のフロー図に示すように、Ｉｎｆｏｒ
ｍｉｘｂｙＥｘａｍｐｌｅユーザは、種々の異なるトピ
ックスの中から選択すること（ステップ６０）；求めら
れるヘルプに対するアプリケーションがアクティブのま
まである間に用例を実行すること（ステップ６２）；用
例を実行していると同時に又は用例と独立して用例につ
いて読むこと（ステップ６４）；異なるエディタユティ
リティにおける用例のソースコードを調査すること（ス
テップ６６）；及び、ユーザが用例を理解することを支
援するオンラインバックグラウンドリファレンス材料を
アクセスすること（ステップ６８） - -全てヘルプ環境
を離れることなく- - を含んでいる、情報を取得するた
めの多数の異なるオプションを有する。ステップ６６で
は、用例に対するソースコードは、新しいアプリケーシ
ョンを生成することにおけるＮｅｗＥｒａ開発環境のテ
ンプレートとして用いるためのカット- アンド−ペース
トすることができるサンプルプログラムコードとして用
いることができる。更に、ＩｎｆｏｒｍｉｘｂｙＥｘａ
ｍｐｌｅは、ユーザに実験を通して、例えば、用例又は
それらのパラメータを選択的に変えかつ変化が用例の出
力にどのように影響を及ぼすかを観測することによっ
て、学習させる。

【００２２】ＩｎｆｏｒｍｉｘｂｙＥｘａｍｐｌｅの特
定な特徴は、ＩｎｆｏｒｍｉｘｂｙＥｘａｍｐｌｅアプ
リケーションから取った例示的画面ショットである、図
７〜図１６Ｅを参照して詳細に説明される。ユーザがＩ
ｎｆｏｒｍｉｘｂｙＥｘａｍｐｌｅに最初に着手し
た場合、図７に示すデフォルト画面構成が表示される。
この初期画面は、現行トピック７３の下でユーザに現在
利用可能なサブトピックスを示しているリスト（又は
「目録（目次）」）ウィンドウ７０、及びリストウィン
ドウ７０から選択されたトピック又はサブトピックに対
応しているヘルプ情報を表示するテキストウィンドウ７
１の、二つの別々なディスプレイウィンドウを含む。ユ
ーザがリストウィンドウ７０に表示された８つのサブト
ピック７２の異なるものをクリックすると、テキストウ
ィンドウ７１の情報は、選択されたサブトピック７２に
対応すべく自動的に更新される。ユーザは、希望により
前進（「＞＞」）ボタン７６又は後退（「＜＜」）ボタ
ン７５をクリックすることによって現行トピック内の異
なるページに移ることができる。

【００２３】図７の例では、リストウィンドウ７１に示
したサブトピックは、トピック「ＮｅｗＥｒａｂｙＥｘ
ａｍｐｌｅＩｎｔｒｏｄｕｃｔｏｒｙＴｏｐｉｃｓ」に
関する。別のヘルプトピックに切替えるために、それゆ
えにオンラインヘルプドキュメンテーションの異なるサ
ブセットを利用可能にするために、ユーザは、図８に示
すように、９つの異なるヘルプトピックのリスト８２を
伴うＨｅｌｐＴｏｐｉｃｓメニュー８０を含んでいるウ
ィンドウを稼動するＨｅｌｐＴｏｐｉｃｓボタン７４を
クリックする。ＩｎｆｏｒｍｉｘｂｙＥｘａｍｐｌ
ｅアプリケーションにおけるあらゆる点において、ユー
ザは、ＨｅｌｐＴｏｐｉｃｓメニュー８０を稼動しかつ
所望のトピックをクリックすることによってオンライン
ヘルプシステムの他の部分へジャンプすることができ
る。ユーザは、適当な回数だけＢａｃｋボタン７７を押
し下げることによって前のトピックへ戻ることができ
る。

【００２４】図８のリスト８２のヘルプトピックスのそ
れぞれは、複数レベルのサブトピックの階層構造を明ら
かにすべく拡張することができる。ユーザが、例えば、
トピックス８３（「ＮｅｗＥｒａｂｙＥｘａｍｐｌ
ｅ」）をクリックする場合、それは、図９に示すような
サブトピックスの二つの更なるレベル−−サブトピック
「Ｉｎｔｒｏｄｕｃｔｉｏｎ」、「ＣｏｍｍｏｎＮｅｗ
ＥｒａＰｒｏｇｒａｍｍｉｎｇＴｅｃｈｎｉｑｕｅ
ｓ」、及び「ＴｈｅＥｘａｍｐｌｅｓ」を含んでいる第
１のレベル９１、及び４３の対話例を含む「「ＴｈｅＥ
ｘａｍｐｌｅｓ」サブトピック下の第２のレベル９３−
−を明らかにすべく拡張する。ユーザが用例の一つ、例
えば、「ＥｎａｂｌｉｎｇａｎｄＤｉｓａｂｌｉｎｇＢ
ｕｔｔｏｎｓ」用例９５をクリックする場合、リストウ
ィンドウ７０は、選択された用例と関連する注釈セグメ
ント１０１（「ＯｖｅｒｖｉｅｗｏｆＢｕｔｔｏｎｓ２
Ｅｘａｍｐｌｅ」、「ＧｒａｐｈｉｃａｌＯｂｊｅｃｔ
Ｓｕｍｍａｒｙ」、「ＥｖｅｎｔＨａｎｄｌｅｒＳｕｍ
ｍａｒｙ」、「ＩｍｐｏｒｔａｎｔＥｖｅｎｔＨａｎｄ
ｌｅｒｓ」、及び「ＥｎｈａｎｃｅｍｅｎｔｓａｎｄＶ
ａｒｉａｔｉｏｎｓ」）を表示するために図１０に示す
ように更新される。注釈セグメント１０１は、対応用例
を正確に記述しかつ用例のウィンドウの説明、その図式
オブジェクト、及びその事象ハンドラを含む。用例の散
文的記述に加えて、注釈セグメントは、また、考慮して
いる用例のソースコードから直接インポートされた特に
興味があるもののソースコードフラグメントも通常含
む。

【００２５】図１０に示すように、注釈セグメントの一
つ（「ＩｍｐｏｒｔａｎｔＥｖｅｎｔＨａｎｄｌｅｒ
ｓ」）は、１３のトピックス１０４−−ＢＵＴＴＯＮＳ
２用例に用いられる主事象ハンドラのリストを含む。各
事象ハンドラトピック１０４は、ソースコードフラグメ
ント及びトピックが対応している事象ハンドラを記述し
ている散文説明を含む。例えば、ユーザが事象ハンドラ
トピック１０５をクリックする場合、テキストウィンド
ウ７１は、図１１に示すように、コードの動作を記述し
ている注釈１１２と一緒に対応事象ハンドラ（ｎｅｘｔ
ＢＴ：：ａｃｔｉｖａｔｅ（））に関するソースコード
フラグメント１１１を表示する。また、テキストウィン
ドウは、関連情報、例えば、バックグラウンドリファレ
ンス材料への一つ以上のリンクも含み、それは次いで、
階層構造的に、更なるバックグラウンド情報等への更な
るリンクを含み、階層構造における各連続レベルは、よ
り詳細にかつより低いレベルのアブストラクトで用例に
ついての情報を供給する。このような方法で増大的に詳
細なドキュメンテーションへのリンクの階層構造を供給
することによって、ＩｎｆｏｒｍｉｘｂｙＥｘａｍ
ｐｌｅは、全てのユーザに、彼らの経験及び知識の様々
なレベルに係わりなく、有用かつ効率的な方法でコンテ
キスト−適格情報を供給する。ユーザは、ユーザのニー
ズ及びバックグラウンドに相応する理解のレベルに到達
するまで、選択的に説明情報の階層構造的リンクをトラ
バースダウンすることができる。この構成は、未熟なユ
ーザに詳細な説明情報への容易なアクセスを供給すると
同時に、特定な点でヘルプを求めている熟練なユーザ
は、大量な不要情報の中を進まなければならないことか
ら保護される。

【００２６】階層構造敵リンキングの例は、テキストウ
ィンドウ７１が、ＢＵＴＴＯＮＳ２用例の機能の一つで
ある、ＭＡＩＮ（）機能へのリンク１０６（緑色の、下
線付きテキストとして表示される）を含むように、図１
０に示されている。ユーザがＭＡＩＮ（）機能リンク１
０６をクリックする場合、テキストウィンドウ７１は、
図１２に示すように、その機能に対するソースコード１
２０を表示する。ソースコード１２０は、キーワード及
びオブジェクトクラスの説明を含んでいるオンライン言
語リファレンスマニュアルのような関連情報への更なる
リンクを含む。ユーザがこれらのリンクの一つ−−例え
ば、ＬＥＴステートメントに対するキーワードリンク１
２２−−をクリックする場合、テキストウィンドウ７１
は、図１３Ａに示すように対応オンライン言語リファレ
ンスエントリを表示するために変化する。同様に、ユー
ザがオブジェクトクラスリンク１２３をクリックしたな
らば、テキストウィンドウ７１は、ｉｘＳＱＬＣｏｎｎ
ｅｃｔクラスについての情報を表示するであろう。図１
３Ａでは、ユーザは、例えば、テキストウィンドウ７１
を図１３Ｂにおけるように表わすべくＯｂｊｅｃｔＥｘ
ｐｒｅｓｓｉｏｎボックス１３４をクリックすることに
よって、更なるバックグラウンド情報へのリンクをファ
ローすることができる。その後、又は代替的に、ユーザ
は、図１３Ｃに示すように一対のウィンドウのオンライ
ン用語集−−コンテンツウィンドウ１３６の用語集表及
び用語集テキストウィンドウ１３７を稼動するためにＧ
ｌｏｓｓａｒｙボタン１３３をクリックすることができ
る。コンテンツウィンドウ１３６の用語集表における用
語をクリックすることは、その定義を用語集テキストウ
ィンドウ１３７に表させる。

【００２７】用例の注釈、そのソースコードフラグメン
ト、対応言語リファレンスエントリ、用語集、又はそれ
らの組合せを学習した後、ユーザは、図８に示すＨｅｌ
ｐＴｏｐｉｃｓメニュー８０を稼動する、Ｃｏｎｔｅｎ
ｔｓボタン１３５（又は、探索可能−インデックスフォ
ームの利用可能ヘルプトピックを提示する、Ｉｎｄｅｘ
ボタン１３８）をクリックし、次いで図８及び図９に関
して説明した方法で所望のトピックを選択することによ
ってヘルプシステムにおける他の位置へ選択的にジャン
プすることができる。図１２における、ＬＥＴステート
メントリンク１２２及びｉｘＳＱＬＣｏｎｎｅｃｔクラ
スリンク１２３のような、キーワードリンク及びクラス
ネームリンクは、それぞれ、それらが互いに容易にかつ
図１０のＭＡＩＮ（）機能リンク１０６（緑色の、下線
付きテキスト）のような他の型のリンクから区別されう
るように視覚的に独自な方法（例えば、キーワードに対
して青い大文字テキスト、及びクラスネームに対して小
文字テキスト）で表される。異なる型ｋ他のリンクに対
して異なるスタイルを用いることによって、Ｉｎｆｏｒ
ｍｉｘｂｙＥｘａｍｐｌｅは、利用可能なオンライ
ン情報の特質（特性）及び用例の異なるコンポーネント
（注釈、ソースコードフラグメント、言語リファレン
ス、等）間の相互関係に関する直感的に認識されかつ有
用な情報をユーザに供給する。視覚的にあらゆる数の異
なるリンク型は、システム設計者の好みにより異なるス
タイルによって表現されうる。

【００２８】用例の注釈に含まれるソースコードフラグ
メントのそれぞれに対して、ユーザは、用例のソースコ
ードを検査し、編集し又はコピーするためにＩｎｆｏｒ
ｍｉｘｂｙＥｘａｍｐｌｅ内から適当なエディティ
ングユティリティを呼出すことができる。これは、ユー
ザにそれからそれが得られた大きなプログラムのコンテ
キストのソースコードフラグメントをビューさせる。Ｉ
ｎｆｏｒｍｉｘｂｙＥｘａｍｐｌｅは、二つの異な
る型のソースコード−−（４ＧＬ又は４ＧＨファイルサ
フィックスによって示された）ＮｅｗＥｒａプログラミ
ング言語におけるテキストプログラムコード、及びＧＵ
Ｉが表される方法を定義するウィンドウズインタフェー
ス定義ファイル（サフィックスＷＩＦを有しているファ
イル）−−からのソースコードフラグメントを含み、か
つ開発を行っているアプリケーションのエンドユーザと
対話する。いずれかの型のソースコードをビューするた
めに、ユーザは、コードフラグメントの次のショートカ
ットアロー、例えば、図１０〜１２に示すショートカッ
トアロー１０７及び１０８の一つ、をクリックし、Ｉｎ
ｆｏｒｍｉｘｂｙＥｘａｍｐｌｅは、考慮している
ソースコードの型に対応するエディタに着手することに
よって応答する。ユーザが図１０及び１２のショートカ
ットアロー１０７にような、４ＧＨ又は４ＧＬファイル
の次のショートカットアローをクリックする場合、Ｉｎ
ｆｏｒｍｉｘｂｙＥｘａｍｐｌｅは、図１４に示す
ように、それからコードフラグメントが取られたソース
コードファイルをビューするために適当なエディタ−−
ＮｅｗＥｒａＣｏｄｅｗｒｉｇｈｔ−−に自動的に着手
する。同様に、ユーザが図１０及び１１のショートカッ
トアロー１０８にような、ＷＩＦファイルの次のショー
トカットアローをクリックする場合、Ｉｎｆｏｒｍｉｘ
ｂｙＥｘａｍｐｌｅは、図１５に示すように、それ
からコードフラグメントが取られたＷＩＦファイルをビ
ューするために適当なエディタ−−ＮｅｗＥｒａＷｉｎ
ｄｏｗＰａｉｎｔｅｒ３．０−−に自動的に着手する。

【００２９】このような方法で複数の異なるエディタの
適当な一つに選択的に着手することは、ＮｅｗＥｒａ開
発環境の標準エディティング作用を反映する。ＮｅｗＥ
ｒａ開発環境及びＩｎｆｏｒｍｉｘｂｙＥｘａｍｐ
ｌｅドキュメンテーションシステムの両方は、同じ方法
で同じエディタを利用する。その結果、ユーザは、オン
ラインヘルプシステム（例えば、Ｉｎｆｏｒｍｉｘｂ
ｙＥｘａｍｐｌｅ）との通常の対話を介してヘルプが
求められるアプリケーション（例えば、ＮｅｗＥｒａ開
発環境）に精通する。一度ユーザが用例に対するソース
コードを開いたならば、ユーザは、コードを簡単に学習
することができるか又は、ＷＩＦファイルからの可視的
オブジェクト又は４ＧＨ又は４ＧＬファイルのプログラ
ムステートメントである、コードの部分を、ユーザ自身
のソースファイルに、カット−アンド−ペーストするこ
とができる。代替的、ユーザは、「としてセーブす
る」動作を実行することができそれにより新しいファイ
ル名の下で用例に対するソースコードを保守する。次い
で、ユーザは、エディットできるかさもなければ望むよ
うに新しいファイルを操作することができる。このよう
に、ＩｎｆｏｒｍｉｘｂｙＥｘａｍｐｌｅによって
供給される用例は、ＮｅｗＥｒａ開発環境において新し
いアプリケーションを開発するのに利用するテンプレー
トとしてサーブすることができる。

【００３０】また、ユーザは、それらが動作する方法を
最初に観測するためにＩｎｆｏｒｍｉｘｂｙＥｘａ
ｍｐｌｅで供給される４３の対話例のいずれか又は全て
を実行しうる。用例は、予め構築されかつそれらの対応
ＩｎｆｏｒｍｉｘｂｙＥｘａｍｐｌｅ注釈から直接
着手することができる。そのようにするために、ユーザ
は、まず、図９に示されたＨｅｌｐＴｏｐｉｃｓウィン
ドウ８０から興味がある用例を選択し、そして、対応す
る注釈がテキストウィンドウに表れるときに、テキスト
ウィンドウのトップ近くに表れるＲｕｎボタンをクリッ
クする。それに応じて、用例は、実行しかつ、ユーザか
ら受取った入力に基づき、用例がスタンドアロンアプリ
ケーションであるかのように、種々の画面をユーザに表
示する。同時に、テキストウィンドウは、ユーザによっ
てちょうど実行された用例の部分に関係がある説明情報
を表示するために自動的に更新する。ユーザが実行して
いる用例で実行する各連続動作により、テキストウィン
ドウは、用例でちょうど生起されたことをユーザに説明
する注釈の対応セクションを表示することによって対話
例の状態との同期を維持するために同時に（またはほぼ
それに近く）更新される。ヘルプディスプレイを用例の
現行状態とコーディネートすることにより、ユーザは、
興味があるユーザの現行トピックに直接関係するタイム
リでかつ有用な情報（例えば、用例によって実行される
特定のソースコード）が一貫して供給される。その結
果、情報を理解しかつ吸収するユーザの能力は、劇的に
向上される。ＩｎｆｏｒｍｉｘｂｙＥｘａｍｐｌｅ
の自動的にコーディネートされたヘルプディスプレイの
用例は、図１６Ａ〜１６Ｅに示されている。

【００３１】図１６Ａは、ユーザがＨｅｌｐＴｏｐｉｃ
ｓメニューから「ＤｉｓｐｌａｙｉｎｇａｎＥｄｉｔＭ
ｅｎｕ」用例を選択する場合に表示される初期リストウ
ィンドウ７０及びテキストウィンドウ７１を示す。この
用例を実行するために、ユーザは、図１６Ｂに示すよう
に、エディットウィンドウの基本を説明している用例ウ
ィンドウ１６１を生起する、Ｒｕｎボタン１６０をクリ
ックする。同時に、テキストウィンドウ７１は、「Ｄｉ
ｓｐｌａｙｉｎｇａｎＥｄｉｔＷｉｎｄｏｗ」用例に対
するＭＡＩＮ（）機能の情報を表示するために更新され
る。ユーザが用例ウィンドウ１６１のＧＵＩ制御を選択
的に操作するときに、テキストウィンドウ７１に表示さ
れた情報は、対応している方法で自動的に更新される。
図１６Ｃでは、ユーザは、テキストウィンドウ７１にｅ
ｄｉｔ１ＴＢ：：ｆｏｃｕｓｌｎ（）に関する情報を表
示させるテキストボックス１６２をクリックした。同様
に、、ユーザがテキストボックス１６３をクリックする
場合、テキストウィンドウ７１は、図１６Ｄに示すよう
にｅｄｉｔ２ＴＢ：：ｆｏｃｕｓｌｎ（）に関する情報
を表示する。ユーザがＣｈｅｃｋＢｏｘ１６４をクリッ
クする場合、テキストウィンドウ７１は、図１６Ｅに示
すようにｎｏｎｅｄｉｔＣＢ：：ｆｏｃｕｓｌｉｎ（）
に関する情報を表示する。

【００３２】ユーザは、そのソースコードを変えること
によって又はそのパラメータを変更しかつこれらの変化
が用例にどのように影響を及ぼすかを観測することによ
って用例を体験することができる。そのようにするため
に、ユーザは、所望のソースコードファイルをエディッ
トし、所定の用例を妨げないように個別のワーキングデ
ィレクトリにそれを保管し、次いで、ＮｅｗＥｒａ開発
環境に供給された機構を用いて用例を再構築する。生成
されかつ実行されうるそのような経験の数及び型は、ユ
ーザの想像力によってのみ制限される。用例を実行する
ことにおける他のオプションは、可能である。例えば、
ユーザは、注釈を同時にビューすることなく用例を実行
することができる。更に、ＮｅｗＥｒａに供給されたデ
バッガ（Ｄｅｂｕｇｇｅｒ）は、用例を実行する前に用
例ソースコードにおけるブレークポイントを設定するた
めに用いることができ、それゆえに用例が作動する方法
への更なる洞察をユーザに与える。

【００３３】ＩｎｆｏｒｍｉｘｂｙＥｘａｍｐｌｅ
アーキテクチャーの説明、及びＮｅｗＥｒａ開発環境及
びＩｎｆｏｒｍｉｘｂｙＥｘａｍｐｌｅアプリケー
ションが構築される方法は、図１７〜１９を参照して供
給される。ＩｎｆｏｒｍｉｘｂｙＥｘａｍｐｌｅ
は、Ｗｉｎｄｏｗｓ９５／ＮＴオペレーティングシステ
ムで供給されるオンラインヘルプ（ＯＬＨ）ファシリテ
ィで構築する。図１７に示すように、Ｉｎｆｏｒｍｉｘ
ｂｙＥｘａｍｐｌｅアプリケーション１７０は、を
ＩｎｆｏｒｍｉｘｂｙＥｘａｍｐｌｅに対して特に
生成されたリソース並びにＮｅｗＥｒａ開発環境１７９
にネーティブなリソースの両方を引出す。Ｉｎｆｏｒｍ
ｉｘｂｙＥｘａｍｐｌｅアプリケーション１７０に
特定なコンポーネントは、対話例１７１、用例に対する
ソースコード１７２、及び用例を説明している注釈ウィ
ンドウ１７３を含む。注釈１７３は、用例のソースコー
ドの代表的フラグメント１７４、用例のソースコードを
ビューするために適当なエディタ（例えば、ＮｅｗＥｒ
ａＣｏｄｅｗｒｉｇｈｔ又はＮｅｗＥｒａＷｉｎｄｏｗ
Ｐａｉｎｔｅｒ）に着手するショートカット１７５、対
話例へのジャンプ１７６、及びＮｅｗＥｒａオンライン
リファレンス１８５に含まれる特定キーワード及びクラ
スネームの説明へのリンク１７７を含んでいる多数の異
なるサブコンポーネントを含む。

【００３４】図１７に示すように、オンラインリファレ
ンス１８５、Ｃｏｄｅｗｒｉｇｈｔエディタ１８１及び
ＷｉｎｄｏｗＰａｉｎｔｅｒエディタ１８２−−Ａｐｐ
ｌｉｃａｔｉｏｎＢｕｉｌｄｅｒ１８０、Ｄｅｂｕｇｇ
ｅｒ１８３及びＩｎｔｅｒｐｒｏｃｅｓｓＣｏｍｍｕｎ
ｉｃａｔｉｏｎｓ（ＩＰＣ）ライブラリ１８４のような
他のコンポーネントと一緒に−−は、開発環境１７９の
一部として存在しそれゆえにＩｎｆｏｒｍｉｘｂｙ
Ｅｘａｍｐｌｅアプリケーション１７０から論理的に分
離される。その結果、ＩｎｆｏｒｍｉｘｂｙＥｘａ
ｍｐｌｅアプリケーション１７０のユーザが−−キーワ
ード又はクラスネームに対してリンク１７７をクリック
することによって又はソースコードをビューするために
ショートカット１７５をクリックすることによって−−
ＮｅｗＥｒａ開発環境に存在しているリソースを要求す
る場合、ＩｎｆｏｒｍｉｘｂｙＥｘａｍｐｌｅ１７
０は、要求されたリソースをアクセスするためにインタ
フェースダイナミックリンクドライブラリ（ＤＬＬ）１
７８を介してＮｅｗＥｒａ開発環境１７９とまず通信し
なけらばならない。インタフェースＤＬＬ１７８は、Ｉ
ｎｆｏｒｍｉｘｂｙＥｘａｍｐｌｅアプリケーショ
ン１７０を開発環境のコンポーネントのような他のアプ
リケーションと通信させるルーチンのコンパイルされた
ライブラリである。ＩｎｆｏｒｍｉｘｂｙＥｘａｍ
ｐｌｅ１７０は、ユーザによって成された要求の特質に
より、要求されたオンラインリファレンス情報を表示す
るために、または適当なソースコードエディタをランチ
するために適当なＤＬＬルーチンをコールする。

【００３５】より特定的には、Ｉｎｆｏｒｍｉｘｂｙ
Ｅｘａｍｐｌｅユーザが用例ソースコード１７２にお
ける位置へのショートカット１７５をクリックする場
合、ＩｎｆｏｒｍｉｘｂｙＥｘａｍｐｌｅアプリケ
ーション１７０は、ＤＬＬにおける関数をコールし、そ
れは次いで適当なエディタに着手するＩＰＣライブラリ
１８４における関数をコールする。（以下に説明する、
ＩｎｆｏｒｍｉｘｂｙＥｘａｍｐｌｅの構築中にソー
スコードフラグメントをプロセスすることによって自動
的に生成される）この関数コールの一部として、Ｉｎｆ
ｏｒｍｉｘｂｙＥｘａｍｐｌｅアプリケーション１
７０は、着手されるエディタ（Ｃｏｄｅｗｒｉｇｈｔ１
８１又はＷｉｎｄｏｗＰａｉｎｔｅｒ１８２）を指定
し、かつ用例のソースコード１７２が指定されたエディ
タによって開かれるライン番号を識別するパラメータを
パスする。ＩｎｆｏｒｍｉｘｂｙＥｘａｍｐｌｅユ
ーザがキーワード又はクラスネームに対してリンク１７
５をクリックする場合、ＩｎｆｏｒｍｉｘｂｙＥｘ
ａｍｐｌｅアプリケーション１７０は、ＤＬＬにおける
機能をコールし、それは次いでオンラインリファレンス
１８５において対応定義を表示するためにＷｉｎｄｏｗ
ｓＯＬＨファシリティを用いる。

【００３６】インタフェースＤＬＬ１７８によって供給
される他の機能は、それらが対応を維持することを保障
するために対話例１７１の実行を制御しかつリストウィ
ンドウとテキストウィンドウディスプレイをコーディネ
ートする。インタフェースＤＬＬ１７８及びＩｎｆｏｒ
ｍｉｘｂｙＥｘａｍｐｌｅアプリケーション１７０
のランタイム動作の詳細は、添付資料Ｂに示されてい
る。ＩｎｆｏｒｍｉｘｂｙＥｘａｍｐｌｅアプリケ
ーション１７０及びそのコンポーネント（例えば、用例
１７１、用例のソースコード１７２及び注釈１７３）が
生成される方法は、高い程度のコード「保守性」を認識
する−−アプリケーションを変更できる効率性及び容易
性の尺度である。高い程度のコード保守性は、対話例及
びＩｎｆｏｒｍｉｘｂｙＥｘａｍｐｌｅの対応注釈
コンポーネントの両方を生成するために用いられる情報
の全てを統一論理エンティティ−−具体的には、対話例
それ自体に対するソースコードに組込むことによって達
成される。その結果、情報の一つの中央ソースだけが維
持されることが必要である。その中央情報ソースに対し
てなされたあらゆる変更又は更新は、用例及び用例に対
するドキュメンテーション／インストラクション／ヘル
プファシリティ（ＩｎｆｏｒｍｉｘｂｙＥｘａｍｐ
ｌｅ）の両方に自動的に組込まれる。この自動化された
構築手続きは、用例及び対応Ｉｎｆｏｒｍｉｘｂｙ
Ｅｘａｍｐｌｅ注釈が基礎をなすソースコードに対して
成された変更の数及び頻度に係わらず同期に維持される
ことを保障する。

【００３７】図１８に示すように、ＮｅｗＥｒａｂｙＥ
ｘａｍｐｌｅソースコード４００は、物理的にはそれ
は、相互依存ファイルの集合により形成されるけれど
も、単一の論理エンティティと考えることができる。ソ
ースコード４００は、テキストの３つの基本型を含む−
−プログラムインストラクション４０１、プログラムコ
メント４０２及び注釈４０３−−ソースコード全体を通
して相互ミックスされる。異なるテキスト型は、をプロ
グラミングコンベンションによって及びソースコード全
体を通して種々の異なるマークアップ記号４０４を戦略
的に配置することによって、互いに区別される。ソース
コード４００のテキストのあるものは、複数の目的をサ
ーブすることができる。例えば、ソースコード４００の
プログラムインストラクション４０１は、用例のバイナ
リ実行可能ファイル４１３にコンパイルされる。これら
のプログラムインストラクションは、用例の実行中に適
切な点における対応注釈を表示するためのＯＬＨファシ
リティへのコールを含む。用例がエンドユーザによって
実行される場合、これらＯＬＨコールは、用例において
ちょうど起きたことを記述するために自動的にテキスト
ウィンドウに適当な注釈を表示させる。これらの同じプ
ログラムインストラクション４０１の部分は、また、エ
ディティング環境においてユーザに表示することができ
る、用例ソースコードのクリーンコピーとしてサーブす
るために抽出される。同様に、（Ｉｎｆｏｒｍｉｘｂ
ｙＥｘａｍｐｌｅプロジェクト開発者で指向されるプ
ロセスされていないプログラミング説明）プログラムコ
メント４０２としてサーブする記述テキストは、また、
注釈４０３（ライタイムでＩｎｆｏｒｍｉｘｂｙＥ
ｘａｍｐｌｅのエンドユーザに表示されるプログラミン
グ説明）としてもサーブすることができる。

【００３８】マークアップ記号４０４は、ソースコード
における種々の型のテキストを正確に概説しかつ対話例
とＩｎｆｏｒｍｉｘｂｙＥｘａｍｐｌｅ注釈が構築
されるときにそれらが扱われる方法を特定する。図１９
は、「．ｎｏｒｍａｌ」記号１９０及び１９１、「．
［ｅｄｉｔ」記号１９２及び「．」ｆｉｌｅ」記号１９
３の二つのインスタンスを含む複数のマークアップ記号
を含むＮｅｗＥｒａソースコードのサンプルを示す。こ
れらマークアップ記号のそれぞれは、それらの対応アー
ギュメントと共に、それらが共通フィールドに存在しか
つＮｅｗＥｒａプログラムインストラクションとして扱
われるべきでないということを示している一対のブラケ
ット（”｛．．．｝”）によってバウンドされる。Ｎｅ
ｗＥｒａ以外のプログラミング言語は、コメントフィー
ルドを正確に概説するために異なるコンベンションを用
いうる。Ｊａｖａプログラミング言語では、例えば、コ
メントフィールドの開始は、「／^*」記号によって示さ
れかつ「^*／」記号によって終了される。いずれの場
合にも、対応プログラミング言語コンパイラは、コメン
トフィールドに存在しているように指定されたあらゆる
テキストを無視する。

【００３９】「．ｎｏｒｍａｌ」マークアップ記号は、
その記号に続くテキスト（例えば、記号１９０に続く
「Ｓｉｎｃｅｏｂｊｅｃｔ、．．．、」）は、説明コメ
ントとして取り扱われるべきであり、それゆえに対応対
話例の実行中に適当な地点における注釈テキストの一部
としてテキストウィンドウでエンドユーザに表示される
べきであるということを示す。他のマークアップ記号
は、出力ファイルの名前、用例のソースコードの代表的
フラグメントとしてサーブするソースコードの一部、ホ
ットスポット及びジャンプ及びリンクに対する宛先、又
はディスプレイ特性及びオブジェクトに関するＧＵＩ−
関係情報（ウィンドウズ、ポップアップス、ボタン、
等）を特定する。マークアップ言語の詳細な説明は、添
付資料Ｃに示されている。

【００４０】一度ソースコード４００が所望のように変
更されたならば、それは、多数の異なるステップを介し
て対話例及びＩｎｆｏｒｍｉｘｂｙＥｘａｍｐｌｅ
アプリケーションの説明コンテンツを構築するために用
いられる。まず、ソースコード４００は、二つの異なる
スクリプト４０７−−ＰＥＲＬスクリプト（Ｐｒａｃｔ
ｉｃａｌＥｘｔｒａｃｔｉｏｎ＆ＲｅｐｏｒｔＬａｎｇ
ｕａｇｅ、テキストの構文解析にしばしば用いられる汎
用翻訳言語）及びＷｏｒｄＢａｓｉｃスクリプトによっ
てプロセスされる。スクリプト４０７は、二つの出力の
基本型を生成する：対話例に対するソースコードファイ
ル４１１、及びＩｎｆｏｒｍｉｘｂｙＥｘａｍｐｌｅ
アプリケーションの記述的及び視覚的コンテンツ（例え
ば、注釈、ソースコードフラグメント、ソースコードエ
ディタへのショートカット、オンラインリファレンスへ
のリンク、実行可能用例へのジャンプ）を表すＲＴＦ
（ＲｉｃｈＴｅｘｔＦｏｒｍａｔ、ＯＬＨコンパイラに
よって求められるフォーマット）ファイル４０８。

【００４１】ＰＥＲＬスクリプトは、マークアップ記号
を探索しているソースコード４００を構文解析し、か
つ、出会った特定のマークアップ記号に基づき、ソース
コード４００全体の種々のサブセットを表す、複数のＲ
ＴＦファイルフラグメント及び複数のソースコードファ
イル４１１を生成する。次いで、ＷｏｒｄＢａｓｉｃス
クリプトは、ＲＴＦファイルフラグメントを、Ｉｎｆｏ
ｒｍｉｘｂｙＥｘａｍｐｌｅアプリケーションに対
する説明的及び視覚的コンテンツを含んでいるＯＬＨフ
ァイル４１０を生成するためいＷｉｎｄｏｗｓＯＬＨコ
ンパイラ４０９によってプロセスされる完全なＲＴＦフ
ァイル４０８にマージする。同時に、用例のソースコー
ド４１１は、対話例４１３に対応しているバイナリ実行
可能を生成するためにＮｅｗＥｒａコンパイラによって
コンパイルされる。

【００４２】ＰＥＲＬスクリプトによって生成されたＲ
ＴＦファイルフラグメントは、ソースコード４００に表
される注釈４０３に加えて多数の異なるコンポーネント
を含む。ＰＥＲＬスクリプトは、用例から抽出されたソ
ースコードに表されるキーワード又はクラスネームの各
インスタンスを識別する。検出された各キーワード及び
クラスネームに対して、ＰＥＲＬスクリプトは、オンラ
インリファレンス材料における対応エントリに対するＲ
ＴＦファイルのリンクを生成する。ＰＥＲＬスクリプト
は、また、説明コメントと一緒に表されるテキストとし
てＲＴＦファイルに含まれるために代表的ソースコード
のフラグメントを抽出する。ソースコードフラグメント
は、前縁及び後縁ブランクラインによって生起されたモ
ノスペースアンラップドテキストとしてフォーマットさ
れ、説明コメントは、比例的にスペースドラップドテキ
ストとしてフォーマットされる。ＲＴＦファイルに含ま
れた各ソースコードフラグメントに対して、ＰＥＲＬス
クリプトは、また、エンドユーザにソースコードエディ
タを着手させかつフラグメントが始まるラインにおける
ソースコードをビューさせる対応ショートカットボタン
をＲＴＦファイルに挿入する。また、ＰＥＲＬスクリプ
トは、用例に対して抽出されたソースコードからマーク
アップ記号４０４の全てをストリップする。これは、関
連エディタにおけるビューのためにソースコードのクリ
ーンバージョンをエンドユーザに供給する。

【００４３】ＰＥＲＬスクリプトによって実行される他
の機能は、注釈トピックに対する識別子が、Ｗｉｎｄｏ
ｗｓＯＬＨファシリティにおけるように、対話例におい
て同じであるということを自動的に保障することを含
む。即ち、ＰＥＲＬスクリプトは、ＷｉｎｄｏｗｓＯＬ
Ｈファシリティに対するヘルプトピック識別子を読取り
かつ対応ＮｅｗＥｒａ定数を生成する。また、ＰＥＲＬ
スクリプトは、用例を構築するために用いられる変更さ
れたバージョンのＮｅｗＥｒａメークファイル（アプリ
ケーションを構築するためのコンピュータ読取り可能イ
ンストラクションを含むファイル）を生成する。ＰＥＲ
Ｌスクリプト及びその動作の更なる詳細は、添付資料Ｂ
に示される。上述したＰＥＲＬ及びＷｏｒｄＢａｓｉｃ
スクリプトは、ＮｅｗＥｒａプログラミング言語で書か
れたソースコードで動作するが、他の型のソースコー
ド、例えば、ＪａｖａやＶｉｓｕａｌＢａｓｉｃを構文
解析するために異なるスクリプトを用いることができ
る。一般的に、適当なＰＥＲＬ及びＷｏｒｄＢａｓｉｃ
スクリプトは、プログラミング言語がＡＳＣＩＩソース
コード（ＰＥＲＬによって要求される）を利用しかつあ
る種のソースコードコメント機構を供給するということ
が供給されるあらゆる型のプログラミング言語を視覚的
にプロセスするために書くことができる。Ｉｎｆｏｒｍ
ｉｘｂｙＥｘａｍｐｌｅ技術の使用を容易にする他
のプログラミング言語属性は、（用例がその注釈を表示
できるように）トピック識別子を有するＷｉｎｄｏｗｓ
ＯＬＨファシリティを呼出す機構、（考慮しているプロ
グラミング言語が開発環境を供給又は要求するというこ
とを想定して、注釈がソースコードファイルを開くこと
ができるように）開発環境のエディティング機能を呼出
す機構、及び（ソースコードのキーワードがオンライン
リファレンスへのジャンプを有することができるよう
に）ＷｉｎｄｏｗｓＯＬＨフォーマットにおけるオンラ
インリファレンスを含む。上述した多くのＩｎｆｏｒｍ
ｉｘｂｙＥｘａｍｐｌｅの特徴は、しかしながら、
基礎を成しているプログラミング言語がそれらの他の属
性の一つ以上を欠落しても実現することができる。

【００４４】ＰＥＲＬスクリプトは、ＲＴＦ以外のフォ
ーマットでファイルを出力すべく変更することができ
る。例えば、変更されたＰＥＲＬスクリプトは、あらゆ
る利用可能なウェブブラウザ（例えば、Ｎｅｔｓｃａｐ
ｅＮａｖｉｇａｔｏｒ）を用いてビューすることができ
る、ハイパーテキストマークアップ言語（ＨＴＭＬ）フ
ァイルを出力することができる。ドキュメンテーション
バイイクザンプルの他の変形も可能である。例えば、対
話例を記述している注釈は、テキスト的な方法以外で提
示することができる。サウンド、図式記号、絵、映画又
は通信の他の手段は、所望のように用いることができ
る。更に、実行すべき対話例の選択は、ユーザによって
指定されたもの以外の要因、またはそれに加えた要因に
基づきうる。例えば、対話例は、基礎を成しているアプ
リケーションの実行中にある一定の点において、又はヘ
ルプシステムにおけるある実行点において自動的に着手
されうる。ユーザがキーワード、クラスネーム又は他の
リンクをクリックする場合、用例は、リンクによってポ
イントされたテキストリファレンス情報を表示すること
の、に加えて、またはその代わりに、自動的に着手され
うる。

【００４５】上述したドキュメンテーションバイイクザ
ンプルの方法及び技術は、ソフトウェア開発システムの
ユーザを支援することに限定されるものではなく、あら
ゆるコンピュータを利用したアプリケーション又はユテ
ィリティに対する一般的な訓練及び教育ツールとしての
アプリケーションを見出しうる。更に、ここに説明され
た技術は、ハードウェア又はソフトウェア、またはそれ
ら二つの組合せとして実現されうる。技術は、それぞれ
がプロセッサ、プロセッサによって読取り可能な記憶媒
体（揮発性及び不揮発性メモリ及び／又は記憶素子を含
む）、及び適当な入力及び出力装置を含むプログラマブ
ルコンピュータ上で実行されるコンピュータプログラム
で実現されるのが好ましい。プログラムコードは、上述
した機能を実行しかつ出力情報を生成するために入力装
置を用いて入力されたデータに供給される。出力情報
は、一つ以上の出力装置に供給することができる。

【００４６】各プログラムは、コンピュータシステムと
通信するために高レベルな手続き的又はオブジェクト指
向型プログラミング言語で実現されるのが好ましい。し
かしんがら、望むならば、プログラムは、アセンブリ又
はマシン言語で実現することができる。いずれの場合に
も、言語は、コンパイルされた又は翻訳された言語であ
りうる。各そのようなコンピュータプログラムは、記憶
媒体又は装置が上述した手続きを実行するためにコンピ
ュータにより準備が整った場合にコンピュータを構成し
かつ動作する汎用又は特殊目的プログラマブルコンピュ
ータによって読取り可能である記憶媒体又は装置（例え
ば、ＣＤ−ＲＯＭ、ハードディスク又は磁気ディクケッ
ト）に記憶されるのが好ましい。システムは、また、記
憶媒体がコンピュータを特定かつ所定の方法で動作させ
るように構成された、コンピュータプログラムで構成さ
れた、コンピュータ読取り可能記憶媒体としても実現さ
れうる。

【００４７】他の実施例は、特許請求の範囲の範疇内で
ある。

【図面の簡単な説明】

【図１】従来技術のコンピュータシステムのブロック図
である。

【図２】図１のコンピュータシステムで用いられるよう
な図式ユーザインタフェースのディスプレイ領域を示す
図である。

【図３Ａ】従来技術のオンラインヘルプ及びドキュメン
テーションシステムからの画面である。

【図３Ｂ】従来技術のオンラインヘルプ及びドキュメン
テーションシステムからの画面である。

【図３Ｃ】従来技術のオンラインヘルプ及びドキュメン
テーションシステムからの画面である。

【図３Ｄ】従来技術のオンラインヘルプ及びドキュメン
テーションシステムからの画面である。

【図４】従来技術のオンラインヘルプ及びドキュメンテ
ーションシステムからの画面である。

【図５Ａ】従来技術のオンラインヘルプ及びドキュメン
テーションシステムからの画面である。

【図５Ｂ】従来技術のオンラインヘルプ及びドキュメン
テーションシステムからの画面である。

【図５Ｃ】従来技術のオンラインヘルプ及びドキュメン
テーションシステムからの画面である。

【図６】用例アプリケーションによるＩｎｆｏｒｍｉｘ
（インフォーミックス）のユーザに対して利用可能なオ
プションを示しているフロー図である。

【図４】用例アプリケーションによるＩｎｆｏｒｍｉｘ
からの及びＮｅｗＥｒａ（ニューエラ）開発環境からの
画面である。

【図８】用例アプリケーションによるＩｎｆｏｒｍｉｘ
からの及びＮｅｗＥｒａ開発環境からの画面である。

【図９】用例アプリケーションによるＩｎｆｏｒｍｉｘ
からの及びＮｅｗＥｒａ開発環境からの画面である。

【図１０】用例アプリケーションによるＩｎｆｏｒｍｉ
ｘからの及びＮｅｗＥｒａ開発環境からの画面である。

【図１１】用例アプリケーションによるＩｎｆｏｒｍｉ
ｘからの及びＮｅｗＥｒａ開発環境からの画面である。

【図１２】用例アプリケーションによるＩｎｆｏｒｍｉ
ｘからの及びＮｅｗＥｒａ開発環境からの画面である。

【図１３Ａ】用例アプリケーションによるＩｎｆｏｒｍ
ｉｘからの及びＮｅｗＥｒａ開発環境からの画面であ
る。

【図１３Ｂ】用例アプリケーションによるＩｎｆｏｒｍ
ｉｘからの及びＮｅｗＥｒａ開発環境からの画面であ
る。

【図１３Ｃ】用例アプリケーションによるＩｎｆｏｒｍ
ｉｘからの及びＮｅｗＥｒａ開発環境からの画面であ
る。

【図１４】用例アプリケーションによるＩｎｆｏｒｍｉ
ｘからの及びＮｅｗＥｒａ開発環境からの画面である。

【図１５】用例アプリケーションによるＩｎｆｏｒｍｉ
ｘからの及びＮｅｗＥｒａ開発環境からの画面である。

【図１６Ａ】用例アプリケーションによるＩｎｆｏｒｍ
ｉｘからの及びＮｅｗＥｒａ開発環境からの画面であ
る。

【図１６Ｂ】用例アプリケーションによるＩｎｆｏｒｍ
ｉｘからの及びＮｅｗＥｒａ開発環境からの画面であ
る。

【図１６Ｃ】用例アプリケーションによるＩｎｆｏｒｍ
ｉｘからの及びＮｅｗＥｒａ開発環境からの画面であ
る。

【図１６Ｄ】用例アプリケーションによるＩｎｆｏｒｍ
ｉｘからの及びＮｅｗＥｒａ開発環境からの画面であ
る。

【図１６Ｅ】用例アプリケーションによるＩｎｆｏｒｍ
ｉｘからの及びＮｅｗＥｒａ開発環境からの画面であ
る。

【図１７】ＮｅｗＥｒａアーキテクチャのブロック図で
ある。

【図１５】用例アプリケーションによるＩｎｆｏｒｍｉ
ｘが構築される方法を示すブロック図である。

【図１９】ＮｅｗＥｒａソースコードのサンプルを示す
図である。

─────────────────────────────────────────────────────

【手続補正書】

【提出日】平成１０年９月８日

【手続補正１】

【補正対象書類名】明細書

【補正対象項目名】図面の簡単な説明

【補正方法】変更

【補正内容】

【図面の簡単な説明】

【図７】用例アプリケーションによるＩｎｆｏｒｍｉｘ
からの及びＮｅｗＥｒａ（ニューエラ）開発環境からの
画面である。

【図１８】用例アプリケーションによるＩｎｆｏｒｍｉ
ｘが構築される方法を示すブロック図である。

───────────────────────────────────────────────────── フロントページの続き (72)発明者ランドンエルオットアメリカ合衆国カリフォルニア州 94539 フリーモントサンマーティンプレイス 932

Claims

【特許請求の範囲】

【請求項１】ユーザをインストラクトする、コンピュ
ータシステムで実行される、方法であって、対話例を実行し；かつ前記対話例と同期して、当該対話
例に対応する説明情報を供給する段階を具備することを
特徴とする方法。
【請求項２】前記コンピュータシステムのユーザに前
記対話例の性能を制御させる段階を更に具備することを
特徴とする請求項１に記載の方法。
【請求項３】前記コンピュータシステムのユーザに前
記説明情報の供給を制御させる段階を更に具備すること
を特徴とする請求項１に記載の方法。
【請求項４】前記供給する段階は、前記対話例におい
て何が最近生じたのかを説明する説明情報を提示するこ
とを備えていることを特徴とする請求項１に記載の方
法。
【請求項５】前記供給する段階は、前記対話例からの
出力と同時に説明情報を提示することを備えていること
を特徴とする請求項４に記載の方法。
【請求項６】前記供給する段階は、前記コンピュータ
システムの画面に複数のウィンドウズを表示すること備
えており、前記説明情報は、一つのウィンドウに表示さ
れかつ前記対話例からの出力は、別のウィンドウに表示
されることを特徴とする請求項５に記載の方法。
【請求項７】前記供給する段階は、供給された前記説
明情報を前記対話例の状態の変化に応じて変更すること
を備えていることを特徴とする請求項１に記載の方法。
【請求項８】前記対話例、前記説明情報、又はそれら
の両方に関するオンラインリファレンス材料へのアクセ
スを前記コンピュータシステムのユーザに供給すること
を更に具備することを特徴とする請求項１に記載の方
法。
【請求項９】前記オンラインリファレンス材料に前記
説明情報におけるリンクを供給することを更に具備する
ことを特徴とする請求項８に記載の方法。
【請求項１０】前記コンピュータシステムのユーザが
リンクを選択する場合に対応リファレンス情報を提示す
ることを更に具備することを特徴とする請求項９に記載
の方法。
【請求項１１】前記説明情報における前記リンクは、
論理的階層構造に配置され、当該階層構造の各連続する
レベルは、増大された詳細の程度を供給することを特徴
とする請求項９に記載の方法。
【請求項１２】前記コンピュータシステムのユーザに
対話例と関連したソースコードへのアクセスを供給する
ことを更に具備することを特徴とする請求項１に記載の
方法。
【請求項１３】前記コンピュータシステムのユーザに
対話例と関連するソースコードをビューさせ、コピーさ
せ又は変更させることを更に具備することを特徴とする
請求項１２に記載の方法。
【請求項１４】前記コンピュータシステムのユーザに
対話例を変更させることを更に具備することを特徴とす
る請求項１２に記載の方法。
【請求項１５】前記ユーザに対話例を繰返し変更させ
かつ実行させることを更に具備することを特徴とする請
求項１４に記載の方法。
【請求項１６】対話例と関連するソースコードをアク
セスするためのユティリティへのジャンプを前記説明情
報に供給することを更に具備することを特徴とする請求
項１に記載の方法。
【請求項１７】前記コンピュータシステムのユーザが
前記ジャンプを選択した場合に前記ソースコードをアク
セスするための前記ユティリティを着手することを更に
具備することを特徴とする請求項１６に記載の方法。
【請求項１８】前記供給する段階は、前記対話例の動
作の散文的記述を提示することを具備することを特徴と
する請求項１に記載の方法。
【請求項１９】前記供給する段階は、前記対話例と関
連するソースコードのフラグメントを提示することを具
備することを特徴とする請求項１に記載の方法。
【請求項２０】前記コンピュータシステムのユーザに
前記対話例全体に対するソースコードのコンテキストに
おける前記ソースコードフラグメントをビューさせるこ
とを更に具備することを特徴とする請求項１９に記載の
方法。
【請求項２１】コンピュータシステムのユーザを教育
する、コンピュータを利用した方法であって、選択したトピックに関する対話デモンストレーションを
実行し；前記対話デモンストレーションの性能と連携し
て当該対話デモンストレーションの注釈記述を前記ユー
ザに提示し；かつ前記ユーザ、前記対話デモンストレー
ション、の前記注釈、又はその両方の異なる形態を選択
的に探求させる段階を具備することを特徴とする方法。
【請求項２２】コンピュータを利用したインストラク
ショナルシステムであって、コンピュータシステムのユーザにより選択的に実行可能
な対話例；及び前記対話例を記述している注釈を備え、異なる注釈は、前記対話例の選択的実行に応じて自動的
に供給されることを特徴とするインストラクショナルシ
ステム。
【請求項２３】前記ユーザがそれを介して前記対話例
と関連したソースコードをアクセスすることができるユ
ティリティを更に備えていることを特徴とする請求項２
２に記載のシステム。
【請求項２４】前記ユティリティは、前記ユーザに前
記対話例のソースコードをビューさせ、コピーさせ又は
変更させることを特徴とする請求項２３に記載のシステ
ム。
【請求項２５】前記ユーザに対して選択的にアクセス
可能なリファレンス情報の本体を更に備えていることを
特徴とする請求項２２に記載のシステム。
【請求項２６】前記リファレンス情報の本体内の情報
の項目への直接アクセスを前記ユーザに供給するリンク
を更に備えていることを特徴とする請求項２５に記載の
システム。
【請求項２７】前記リンクは、その上で前記ユーザが
カーソルをクリックすることができる視覚的に表示され
るマーカーであることを特徴とする請求項２６に記載の
システム。
【請求項２８】前記注釈は、前記対話例のテキスト記
述を備えていることを特徴とする請求２２に記載のシス
テム。
【請求項２９】前記注釈は、前記対話例と関連するソ
ースコードのフラグメントを備えていることを特徴とす
る請求項２８に記載のシステム。
【請求項３０】前記注釈は、前記対話例と関連する完
全なソースコードをそれを介してアクセスすることがで
きるユティリティへのジャンプを備えていることを特徴
とする請求項２９に記載のシステム。
【請求項３１】前記ジャンプは、ショートカットアロ
ーとして前記ユーザに視覚的に表されることを特徴とす
る請求項３０に記載のシステム。
【請求項３２】前記注釈は、リファレンス情報の本体
への視覚的に表示されるリンクを備えていることを特徴
とする請求項２２に記載のシステム。
【請求項３３】前記対話例は、コンピュータプログラ
ミング概念を説明することを特徴とする請求項２２に記
載のシステム。
【請求項３４】前記対話例によって説明される前記プ
ログラミング概念を実現するためのソフトウェア開発環
境を更に備えていることを特徴とする請求項３３に記載
のシステム。
【請求項３５】前記対話例及び当該対話例を記述して
いる前記注釈を構築するためにソースコードの統一本体
が用いられることを特徴とする請求２２に記載のシステ
ム。
【請求項３６】前記ソースコードの統一本体は、前記
対話例を構築することに用いられる前記ソースコードの
一部分及び該対話例を記述している前記注釈を構築する
ことに用いられる前記ソースコードの別の部分を仕切る
マークアップ記号を含むことを特徴とする請求項３５に
記載のシステム。
【請求項３７】前記対話例を構築することに用いられ
る前記ソースコードの部分は、該対話例を記述している
前記注釈を構築することに用いられる前記ソースコード
の部分にオーバーラップすることを特徴とする請求項３
６に記載のシステム。
【請求項３８】前記対話例によって説明された概念を
実現するためのアプリケーションを更に備えていること
を特徴とする請求項２２に記載のシステム。
【請求項３９】前記コンピュータを利用したインスト
ラクショナルシステムによって供給される前記対話例
は、前記アプリケーションによって供給される機能性の
サブセットを表すことを特徴とする請求項３８に記載の
システム。
【請求項４０】コンピュータソフトウェアを開発する
方法であって、コンピュータを利用したアプリケーションに対するソー
スコードの本体を維持し；前記ソースコードの本体に基
づいて前記コンピュータを利用したアプリケーションを
構築し；かつ前記ソースコードから抽出した情報に基づ
いて前記コンピュータを利用したアプリケーションに対
応している注釈を構築する段階を具備することを特徴と
する方法。
【請求項４１】前記コンピュータを利用したアプリケ
ーションは、インストラクショナル用例を備えているこ
とを特徴とする請求項４０に記載の方法。
【請求項４２】前記維持する段階は、前記ソースコー
ドの本体にプログラムインストラクション及び説明情報
を含むことを具備することを特徴とする請求項４０に記
載の方法。
【請求項４３】前記ソースコードの本体にプログラム
インストラクション及び説明情報を区別するための記号
を含むことを更に具備することを特徴とする請求項４２
に記載の方法。
【請求項４４】前記ソースコードの本体に対話例を構
築するために用いられるプログラムインストラクション
を識別するための記号を含むことを更に具備することを
特徴とする請求項４２に記載の方法。
【請求項４５】前記ソースコードの本体に前記説明情
報がエンドユーザに提示されるような方法を画定する記
号を含むことを更に具備することを特徴とする請求項４
２に記載の方法。
【請求項４６】前記ソースコードの本体に表される所
定のトークンのリストをアセンブリすることを更に具備
することを特徴とする請求項４２に記載の方法。
【請求項４７】前記アセンブリされたリストの各トー
クンに対するオンラインリファレンスへのリンクを生成
することを更に具備することを特徴とする請求項４２に
記載の方法。
【請求項４８】前記トークンは、キーワードを備えて
いることを特徴とする請求項４６に記載の方法。
【請求項４９】前記トークンは、クラスネームを備え
ていることを特徴とする請求項４６に記載の方法。
【請求項５０】エンドユーザに提示されるソースコー
ドフラグメントを識別するための記号を前記ソースコー
ドの本体に含むことを更に具備することを特徴とする請
求項４０に記載の方法。
【請求項５１】エンドユーザに、前記ソースコードフ
ラグメントに対応している位置におけるソースコードの
本体をアクセスさせるジャンプを生成することを更に具
備することを特徴とする請求項５０に記載の方法。
【請求項５２】前記注釈を構築することは、前記注釈
に対応する前記ソースコードの部分を識別するために前
記ソースコードの本体を構文解析することを具備するこ
とを特徴とする請求項４０に記載の方法。
【請求項５３】前記構文解析することは、前記ソース
コードの本体に表される所定のマークアップ記号を認識
するスクリプトで該ソースコードの本体をプロセスする
ことを具備することを特徴とする請求項５２に記載の方
法。
【請求項５４】前記注釈を構築することは、前記構文
解析の結果に基づきドキュメンテーションソースファイ
ルを生成することを具備することを特徴とする請求項５
２に記載の方法。
【請求項５５】オンラインヘルプユティリティによっ
て認識されたフォーマットに前記ドキュメンテーション
ソースファイルをコンパイルすることを更に具備するこ
とを特徴とする請求項５４に記載の方法。
【請求項５６】前記注釈を構築することは、前記構文
解析の結果に基づき用例ソースコードファイルを生成す
ることを更に具備することを特徴とする請求項５２に記
載の方法。
【請求項５７】エンドユーザによって実行されること
ができる対話例に前記用例ソースコードファイルをコン
パイルすることを更に具備することを特徴とする請求項
５６に記載の方法。
【請求項５８】コンピュータ読取り可能媒体に存在し
ている、コンピュータソフトウェアであって、コンピュータを利用したアプリケーションをそれから構
築することができるソースコード；及び前記コンピュー
タを利用したアプリケーションを用いるためのインスト
ラクションを供給するための記述的内容をそれから構築
することができる前記ソースコードの部分を指定してい
る該ソースコード内の記号を備えていることを特徴とす
るコンピュータソフトウェア。
【請求項５９】コンピュータシステムで実行される、
ユーザをインストラクトする方法であって、インストラクショナル用例を実行し；前記用例と関連す
る説明情報を同時に供給し；前記用例及び前記説明情報
の少なくとも一つとのユーザ対話を許可し；かつ前記ユ
ーザ対話に応じて前記用例と前記説明情報との間の同期
を維持する段階を具備することを特徴とする方法。
【請求項６０】コンピュータシステムで実行され、コ
ンピュータプログラミング概念についてユーザを教育す
る方法であって、前記ユーザに興味があるプログラミングトピックを指定
させ；前記指定されたプログラミングトピックの注釈説
明を前記ユーザに供給し；前記ユーザに、前記指定され
た概念のインストラクト的な対話例を選択的に実行さ
せ；前記選択的クッキー的に実行された対話例の結果を
表示し；かつ前記対話例の前記実行と同時に、前記対話
例の表示された結果を説明する情報を表示するために前
記注釈を自動的に更新する段階を具備することを特徴と
する方法。