JPH10293685A - プログラム理解支援方法 - Google Patents

Abstract

(57)【要約】 【課題】プログラム中の各記述に対して十分なコメント
付けがなされたコメント付きプログラムを自動生成す
る。 【解決手段】セミコロンなどの記号を用いてプログラム
１１を記述毎に分解することにより、プログラム中の記
述の中からそれを構成する個々の記述要素が解析部２１
１によって取り出される。そして、抽出部２１３による
パターン翻訳辞書４１の検索により、取り出された各記
述要素に対応する翻訳文が決定される。この後、決定し
た翻訳文と入力プログラム１１の記述とが合成されて、
コメント付きプログラム３１が出力される。したがっ
て、プログラム１１中の記述に対応してコメント文を自
動生成できるようになり、プログラム１１中の各記述に
対して十分なコメント付けがなされたコメント付きプロ
グラム３１を作成することができる。

Description

【発明の詳細な説明】

【０００１】

【発明の属する技術分野】この発明はコンピュータを用
いたプログラム開発支援システムに適用されるプログラ
ム理解支援方法に関する。

【０００２】

【従来の技術】従来より、プログラム開発支援の分野で
はプログラマが作成したプログラムの理解を支援するた
めの機能として、プログラムモジュール構造作成システ
ムおよびアルゴリズムチャート作成システムなどが提供
されている。

【０００３】プログラムモジュール構造作成システム
は、ソースプログラムに含まれる情報に基づいてそのプ
ログラムのモジュール構造図を生成するものであり、こ
れによりプログラム全体の構造がビジュアル化されて利
用者に提示される。しかし、このシステムはプログラム
全体の大まかな構造理解には適しているが、プログラム
中に含まれる個々の記述の意味を理解することは困難で
ある。

【０００４】プログラム中に含まれる個々の記述の意味
を理解するためには、プログラムコーディング時に予め
コメント文を付加しておくことが重要である。このよう
なコメント付きプログラムを作成しておくことにより、
プログラムの修正や改造が容易となるばかりか、他のプ
ログラムにパーツとして利用することが容易となる。

【０００５】一方、アルゴリズムチャート作成システム
は、ソースプログラムに含まれる情報に基づいてそのプ
ログラムの制御構造を示すアルゴリズムチャート（フロ
ーチャート）を生成するものであり、これによりプログ
ラムによって実行される処理の流れを利用者に提示する
ことができる。しかし、コメント付けされてないソース
プログラムからアルゴリズムチャートを生成すると、分
岐などの制御構造だけのアルゴリズムチャートしか得ら
れず、アルゴリズムチャート内の個々のステップに対応
する矩形枠にはコメント文字は表示されず空白となって
しまう。したがって、アルゴリズムチャート作成システ
ムを使用する場合においても、コメント付きプログラム
を作成しておくことが重要である。

【０００６】しかし、ほとんどのプログラミング言語に
おいては、コメント付けする場合の形式的スタイルにつ
いては規定されているものの、コメント付けするか否か
や、コメント付けの位置およびコメント文の内容などに
ついては全てプログラマに任されている。このため、実
際には、たとえコメントが付けられていても、プログラ
ム中の各記述に対して十分なコメント付けがなされてい
るというケースは比較的まれである事が多い。

【０００７】

【発明が解決しようとする課題】上述したように、従来
では、十分なコメント付けがなされたプログラムを使用
しない限り、たとえモジュール構造作成システムやアル
ゴリズムチャート作成システムを使用してもプログラム
中の各記述の意味を理解するのに十分な情報を利用者に
提供することができないと問題があった。

【０００８】この発明はこのような点に鑑みてなされた
ものであり、入力プログラムを解析することによりその
プログラム中の記述に対応してコメント文を自動生成で
きるようにし、プログラム中の各記述に対して十分なコ
メント付けがなされたコメント付きプログラムを作成す
ることが可能なプログラム理解支援方法を提供すること
を目的とする。

【０００９】

【課題を解決するための手段】この発明は、コンピュー
タを用いてプログラム作成を支援するプログラム理解支
援方法であって、コーディングされたソースプログラム
を入力し、この入力プログラムの記述の中からそれを構
成する記述要素を取り出し、所定の記述パターンとその
内容を表す翻訳文との対応関係が定義された記述パター
ン辞書を参照して、前記入力プログラムから取り出した
記述要素に対応する翻訳文を決定し、この決定した翻訳
文と前記入力プログラムの記述とを合成して、コメント
付きプログラムを出力することを特徴とする。

【００１０】このプログラム理解支援方法においては、
例えばＣ言語でコーディングされたソースプログラムの
場合には、セミコロンなどの記号を用いてプログラムを
記述毎に分解することにより、プログラム中の記述の中
からそれを構成する個々の記述要素が取り出される。そ
して、記述パターンとその内容を表す翻訳文との対応関
係が定義された記述パターン辞書の検索により、取り出
された各記述要素に対応する翻訳文が決定される。この
後、決定した翻訳文と入力プログラムの記述とが合成さ
れて、コメント付きプログラムが出力される。したがっ
て、プログラム中の記述に対応してコメント文を自動生
成できるようになり、プログラム中の各記述に対して十
分なコメント付けがなされたコメント付きプログラムを
作成することができる。

【００１１】また、記述パターン辞書には、所定の関数
を含む記述パターンについてその関数の引数の値に応じ
て異なる複数の翻訳文を定義しておくことが好ましい。
これにより、プログラムから取り出した記述要素に含ま
れる関数の引数に合致した翻訳文を記述パターン辞書か
ら取得することが可能となり、同一の関数であっても引
数の違いにより異なるコメントを付加することができ
る。

【００１２】また、記述パターン辞書に加え、変数とし
て使用可能な所定のシンボルマークとそれに対応する変
数名などの用語との対応関係が定義されたシンボル辞書
を用意しておき、入力プログラムから取り出した記述要
素が変数宣言等であるときは、シンボル辞書を参照する
ことにより、その変数宣言で使用されるシンボルマーク
に対応した変数名を決定して、その変数名を前記変数宣
言のコメント文として前記入力プログラムの記述に合成
することが好ましい。

【００１３】また、シンボル辞書は、入力プログラムか
ら取り出した記述要素に変数が含まれるときもその変数
名を決定するために使用することができる。この場合、
記述パターン辞書から得た翻訳文とシンボル辞書から得
た変数名とを合成することにより、変数を含む記述要素
に合致したコメント文を生成することができる。

【００１４】また、入力プログラム中に含まれる変数の
変数名がコメント文によって予め記述されているとき
は、その変数を示すシンボルマークについてそのプログ
ラム中の出現位置と変数名とを示すローカルシンボル辞
書を作成し、このローカルシンボル辞書を参照して、コ
メント付けされてない記述要素に含まれるシンボルに対
応する変数名を、そのシンボルの出現位置に応じて決定
することが好ましい。これにより、プログラム中に含ま
れる複数の関数に同一の変数が使用されている場合で
も、入力プログラムに予め付加されているコメントで定
義された変数名に従って、各関数内における変数を使用
した記述に対して適切なコメント付けを行うことができ
る。

【００１５】

【発明の実施の形態】以下、図面を参照してこの発明の
実施形態を説明する。図１には、この発明の第１実施形
態に係るプログラムパターン翻訳システムの機能構成が
示されている。このプログラムパターン翻訳システム２
１は、コンピュータを利用してプログラム開発・作成を
支援するためのソフトウェアであり、Ｃ言語などでコー
ディングされたソースプログラム１１を入力し、そのソ
ースプログラム１１をパターン翻訳辞書４１およびシン
ボル翻訳辞書４２を用いて解析することによりコメント
付きプログラム２１を出力する。

【００１６】このプログラムパターン翻訳システム２１
は、図示のように、入力部２１、解析部２１２、抽出部
２１３、および出力部２１４から構成されている。入力
部２１は、コメント付けの対象となるソースプログラム
１１を入力し、解析部２１２に渡す。解析部２１２は、
入力されたソースプログラム１１中の記述を解析してそ
の記述を記述要素毎に分解する。この分解は、たとえば
セミコロンなどの記号で区切られたステートメント文毎
に行われ、これによって得られた各記述要素（変数宣
言、関数宣言、関数内における内部変数宣言、関数内で
使用する関数の宣言、実行文など）は、パターン翻訳辞
書４１およびシンボル翻訳辞書４２を検索可能な記述形
式（記述パターン）に変換されて抽出部２１３に渡され
る。

【００１７】抽出部２１３は、解析部２１２により変換
された記述形式を用いてパターン翻訳辞書４１およびシ
ンボル翻訳辞書４２の検索を行い、各記述要素の意味を
表す翻訳文をそれら辞書から取り出す。出力部２１４
は、抽出部２１３によって抽出された翻訳文とソースプ
ログラム１１の記述とを合成して、コメント付きプログ
ラム３１を出力する。

【００１８】パターン翻訳辞書４１には、例えばＣ言語
などのプログラム言語で用いられる各関数やＩＦ文、Ｗ
ＨＩＬＥ文などで用いられる制御構造毎にそれを使用し
た所定の記述パターンとその内容を表す翻訳文との対応
関係が定義されている。このパターン翻訳辞書４１の内
容の一例を図２に示す。

【００１９】図２においては、記述パターンの一例とし
て、“ｏｐｅｎ（ ，０＿ＲＤＯＮＬＹ）”、“ｅｘ
ｉｔ（０）”、“ｓｔａｔ”，“ｃｌｏｓｅ”が定義さ
れており、それに対応する翻訳文としては、「読み込み
モードでファイルをオープンする」、「正常終了す
る」、「ステータスを取得」、「クローズする」が定義
されている場合が示されている。

【００２０】シンボル翻訳辞書４２には、例えばＣ言語
で記述されたプログラム中に変数名や関数名として使用
可能な所定のシンボルマークとそれに対応する翻訳用語
との対応関係が定義されている。このシンボル翻訳辞書
４２の内容の一例を図３に示す。

【００２１】図３においては、シンボルマークの一例と
して、変数“ｆｄ”，“ｓｔｒｕｃｔ ｓｔａｔ”，
“ｓｔ−ｔｉｍｅ”が定義されており、それに対応する
翻訳用語としては、「ファイルディスクプリタ」、「フ
ァイルステータス構造体」、「ファイル修正時刻」が定
義されている場合が示されている。

【００２２】このシンボル翻訳辞書４２は、例えば、ソ
ースプログラム１１中の変数宣言で使用されるシンボル
マークからそれに対応する変数名を決定したり、記述パ
ターンの翻訳文中で使用される変数名を決定するためな
どに用いられる。

【００２３】次に、図４のフローチャートを参照して、
図１のプログラムパターン翻訳システムによって実行さ
れるコメント付け処理の手順を説明する。まず、入力部
２１１によってコメント付け対象のソースプログラム１
１が入力され（ステップＳ１１１）、その入力プログラ
ムが解析部２１２により各記述毎に分解される（ステッ
プＳ１１２）。そして、以下のステップＳ１１３〜Ｓ１
２３までの処理が全ての記述パターンに対して順番に実
行される。

【００２４】すなわち、まず、翻訳対象の記述パターン
に対してパターン翻訳辞書４１の検索が行われ、その記
述パターンに対応する翻訳文の定義が存在するか否かが
調べられる（ステップＳ１１４，Ｓ１１５）。翻訳文の
定義が存在しないならば、その記述パターンは翻訳され
ずにそのまま出力部２１４から出力される（ステップＳ
１１６）。

【００２５】翻訳文の定義が存在する場合には、その記
述パターンに対応する翻訳文がパターン翻訳辞書４１か
ら取り出され（ステップＳ１１７）、翻訳文の定義中
（または、それに対応する記述パターン中）に変数が含
まれるか否かが調べられる（ステップＳ１１８）。変数
が含まれているならば、その変数に対応するシンボルマ
ークを用いたシンボル翻訳辞書４２の検索が行われ、そ
のシンボルマークに対応する翻訳用語の定義が存在する
か否かが調べられる（ステップＳ１１９，Ｓ１２０）。
翻訳用語の定義が存在する場合には、その翻訳用語がシ
ンボル翻訳辞書４２から取り出され（ステップＳ１２
１）、その翻訳用語はパターン翻訳辞書４１から取り出
された翻訳文と合成される（ステップＳ１２２）。そし
て、その合成結果は現在対象となっている記述パターン
に対するコメント文としてその記述パターンに合成され
て、出力部２１４から出力される（ステップＳ１２
３）。

【００２６】この図４のフローチャートの処理で得られ
るコメント付きプログラムの一例を図５に示す。図５
（ａ）はコメント付け対象の入力プログラム１１であ
り、図５（ｂ）はそのプログラムを解析することによっ
て得られたコメント付きプログラム３１である。

【００２７】 ここでは、変数宣言の記述パターン ｓｔｒｕｃｔ ｓｔａｔ ｓｔｓ に対するコメント文として ／＊ファイルステータス構造体を定義＊／ が付加され、実行文の記述パターン ｉｆ（！（ｆｄ＝（ｉｎｔ ＊）ｏｐｅｎ（ｆｉｌｅ，０＿ＲＤＯＮＬＹ） ））ｒｅｔｕｒｎ ＮＵＬＬ に対するコメント文として ／＊読み込みモードでファイルをオープンする＊／ が付加されている。

【００２８】 また、同じく実行文の記述パターン ｓｔａｔ（ｆｉｌｅ，＆ｓｔｓ） に対するコメント文として、 ／＊パスで指定されたファイルのステータス取得＊／ が付加され、 ｃｏｎｔｅｎｔｓ＝（ｃｈａｒ ＊）ｍａｌｌｏｃ（ｓｔｓ．ｓｔ＿ｓｉｚ ｅ） に対するコメント文として ／＊指定されたサイズの領域をメモリ上に確保する＊／ が付加され、 ｃｌｏｓｅ（ｆｄ） に対するコメント文として ＊／ファイルをクローズする＊／ が付加されている。

【００２９】ここで、＊／はコメント分の開始を示し、
＊／は終了を示している。以上のように、第１実施形態
に係るプログラム翻訳システム２１においては、セミコ
ロンなどの記号を用いてプログラム１１を記述毎に分解
することにより、プログラム中の記述の中からそれを構
成する個々の記述要素が取り出される。そして、パター
ン翻訳辞書４１の検索により、取り出された各記述要素
に対応する翻訳文が決定される。この後、決定した翻訳
文と入力プログラム１１の記述とが合成されて、コメン
ト付きプログラム３１が出力される。したがって、プロ
グラム１１中の記述に対応してコメント文を自動生成で
きるようになり、プログラム１１中の各記述に対して十
分なコメント付けがなされたコメント付きプログラム３
１を作成することができる。

【００３０】また、パターン翻訳辞書４１に加え、変数
や関数として使用可能な所定のシンボルマークとそれに
対応する変数名などの用語との対応関係が定義されたシ
ンボル翻訳辞書４２を使用する事により、入力プログラ
ム１１から取り出した記述要素が変数宣言等であるとき
は、シンボル翻訳辞書４２を参照することにより、その
変数宣言で使用されるシンボルマークに対応した変数名
を決定して、その変数名を変数宣言のコメント文として
入力プログラム１１の記述に合成することができる。ま
た、シンボル翻訳辞書４２は、入力プログラム１１から
取り出した記述要素に変数が含まれるときにその変数名
を決定するためにも使用され、パターン翻訳辞書４１か
ら得た翻訳文とシンボル翻訳辞書４２から得た変数名と
を合成することにより、変数を含む記述要素に合致した
コメント文を生成することができる。

【００３１】図６には、この発明の第２実施形態に係る
プログラムパターン翻訳システム２１の構成が示されて
いる。このプログラムパターン翻訳システム２１におい
ては、図１のパターン翻訳辞書４１の代わりに、順序付
きパターン翻訳辞書４３が使用されており、他の構成は
図１と同じである。

【００３２】順序付きパターン翻訳辞書４３には、図１
のパターン翻訳辞書４１のようにある特定の限定的な記
述パターンについての翻訳文が定義されているだけでな
く、所定の関数を含む一般的な記述パターンについては
その関数の引数の値に応じて異なる複数の翻訳文が順序
づけされて定義されている。例えば、図７に示されてい
るように、オープン関数を用いた記述パターンに対して
は、図２で説明した限定的な記述パターン“ｏｐｅｎ
（ ，０＿ＲＤＯＮＬＹ）”に加え、引数の違うオー
プン関数の記述パターンとして、“ｏｐｅｎ（ ，
ｎ），０＜ｎ＜１６”と、“ｏｐｅｎ（ ，ｎ），ｎ
＞１５”が登録されている。ここで、ｎはオープン関数
のモード番号を示す引数であり、書き込み用ファイルと
してオープンするなどといった他のファイルオープンモ
ードの種類を表している。

【００３３】引数ｎが１から１５までの範囲であるとき
は「モードｎでファイルをオープンする」という翻訳文
が用いられ、引数ｎがオープン関数に未定義のモードを
示すときは「エラー；存在しないモードｎでオープンし
ている」という翻訳文が用いられる。

【００３４】次に、図８のフローチャートを参照して、
図６のプログラムパターン翻訳システムによって実行さ
れるコメント付け処理の手順を説明する。まず、入力部
２１１によってコメント付け対象のソースプログラム１
１が入力され（ステップＳ２１１）、その入力プログラ
ムが解析部２１２により各記述毎に分解される（ステッ
プＳ２１２）。そして、以下のステップＳ２１３〜Ｓ２
２５までの処理が全ての記述パターンに対して順番に実
行される。

【００３５】すなわち、まず、翻訳対象の記述パターン
に対して順序付きパターン翻訳辞書４３の検索が行わ
れ、その記述パターンに対応する翻訳文の定義が存在す
るか否かが調べられる（ステップＳ２１４，Ｓ２１
５）。そして、その記述パターンに対応する翻訳文が複
数順序づけされて定義されている場合には、それら翻訳
文が順に参照されることにより記述パターンに最もマッ
チした翻訳文が決定される（ステップＳ２１６）。これ
により、例えば、引数が異なる同一関数についての翻訳
文が複数定義されている場合には、記述パターンに含ま
れる引数に合致した翻訳文が選択されることになる。

【００３６】該当する翻訳文の定義が存在しないなら
ば、その記述パターンは翻訳されずにそのまま出力部２
１４から出力される（ステップＳ２１７，Ｓ２１８）。
該当する翻訳文の定義が存在する場合には、その記述パ
ターンに対応する翻訳文が順序付きパターン翻訳辞書４
３から取り出され（ステップＳ２１９）、翻訳文の定義
中（または、それに対応する記述パターン中）に変数が
含まれるか否かが調べられる（ステップＳ２２０）。変
数が含まれているならば、その変数に対応するシンボル
マークを用いたシンボル翻訳辞書４２の検索が行われ、
そのシンボルマークに対応する翻訳用語の定義が存在す
るか否かが調べられる（ステップＳ２２１，Ｓ２２
２）。翻訳用語の定義が存在する場合には、その翻訳用
語がシンボル翻訳辞書４２から取り出され（ステップＳ
２２３）、その翻訳用語は順序付きパターン翻訳辞書４
３から取り出された翻訳文と合成される（ステップＳ２
２４）。そして、その合成結果は現在対象となっている
記述パターンに対するコメント文としてその記述パター
ンに合成されて、出力部２１４から出力される（ステッ
プＳ２２５）。

【００３７】以上のように、第２実施形態においては、
所定の関数を含む記述パターンについてその関数の引数
の値に応じて異なる複数の翻訳文を定義しておくことに
より、プログラム１１から取り出した記述パターンに含
まれる関数の引数に合致した翻訳文を順序付きパターン
翻訳辞書４３から取得することが可能となり、同一の関
数であっても引数の違いにより異なるコメントを付加す
ることができるようになる。

【００３８】図９には、この発明の第３実施形態に係る
プログラムパターン翻訳システム２１の構成が示されて
いる。このプログラムパターン翻訳システム２１におい
ては、図１のパターン翻訳辞書４１およびシンボル翻訳
辞書４２に加え、ローカルシンボル翻訳辞書４４が設け
られており、他の構成は図１と同じである。

【００３９】ローカルシンボル翻訳辞書４４は、コメン
ト付け対象のプログラム１１毎にその記述に基づいて生
成されるシンボル翻訳辞書であり、プログラム１１に予
め付加されているコメント文に基づいてプログラム１１
中に出現する変数名の定義をその変数の出現場所毎に管
理するために用いられる。すなわち、Ｃ言語等において
は、変数は宣言した位置や記憶クラスによってスコープ
と称される変数の有効範囲が異なり、ある関数内でのみ
有効な変数を用いたり、また、関数外で宣言された変数
についてはプログラムファイルの全ての範囲において使
用できるといった規定がある。

【００４０】このため、第３実施形態においては、プロ
グラム１１中に含まれる変数の変数名がコメント文によ
って予め記述されているときは、その変数を示すシンボ
ルマークについてそのプログラム中の出現位置と変数名
とを示すローカルシンボル翻訳辞書４４を作成し、この
ローカルシンボル翻訳辞書４４を参照することによっ
て、コメント付けされてない記述パターンに含まれるシ
ンボルに対応する的確な変数名をそのシンボルの出現位
置に応じて決定するようにしている。

【００４１】例えば、図１０のソースプログラム１１の
ように、関数外にある整数型変数宣言“ｉｎｔ ｆｄ”
に対して「ユーザファイル１」というコメント付けがな
されており、またメイン関数“ｍａｉｎ（ ）”の記述
内部にある整数型変数宣言“ｉｎｔ ｆｄ”に対して
「ユーザファイル２」というコメント付けがなされてい
るプログラムの場合には、図１１に示されているよう
に、ローカルシンボル翻訳辞書４４には、シンボルマー
クｆｄについて、関数外（−）とメイン関数（ｍａｉ
ｎ）の２つの出現エリアと、それらに対応する翻訳文
「ユーザファイル１」、「ユーザファイル２」が登録さ
れる。

【００４２】この場合、メイン関数“ｍａｉｎ（ ）”
の記述内部にある記述パターン“ｆｄ＝ｏｐｅｎ（
， ）”に対しては、「ユーザファイル２をオー
プンする」といったコメント付けがなされることにな
る。

【００４３】次に、図１２のフローチャートを参照し
て、図９のプログラムパターン翻訳システムによって実
行されるコメント付け処理の手順を説明する。まず、入
力部２１１によってコメント付け対象のソースプログラ
ム１１が入力され（ステップＳ３１１）、その入力プロ
グラムが解析部２１２により各記述毎に分解されるとと
もに、各記述内に付加されているコメント文に従ってロ
ーカルシンボル翻訳辞書４４の作成が行われる（ステッ
プＳ３１２）。そして、以下のステップＳ３１３〜Ｓ３
２６までの処理が全ての記述パターンに対して順番に実
行される。

【００４４】すなわち、まず、翻訳対象の記述パターン
に対してパターン翻訳辞書４１の検索が行われ、その記
述パターンに対応する翻訳文の定義が存在するか否かが
調べられる（ステップＳ３１４，Ｓ３１５）。翻訳文の
定義が存在しないならば、その記述パターンは翻訳され
ずにそのまま出力部２１４から出力される（ステップＳ
３１６）。

【００４５】翻訳文の定義が存在する場合には、その記
述パターンに対応する翻訳文がパターン翻訳辞書４１か
ら取り出され（ステップＳ３１７）、翻訳文の定義中
（または、それに対応する記述パターン中）に変数が含
まれるか否かが調べられる（ステップＳ３１８）。変数
が含まれているならば、その変数に対応するシンボルマ
ークを用いたローカルシンボル翻訳辞書４４の検索が行
われ、そのシンボルマークに対応する翻訳用語の定義が
存在するか否かが調べられる（ステップＳ３１９，Ｓ３
２０）。翻訳用語の定義が存在する場合には、その出現
位置に対応する翻訳用語がローカルシンボル翻訳辞書４
４から取り出され（ステップＳ３２１）、その翻訳用語
はパターン翻訳辞書４１から取り出された翻訳文と合成
される（ステップＳ３２５）。そして、その合成結果は
現在対象となっている記述パターンに対するコメント文
としてその記述パターンに合成されて、出力部２１４か
ら出力される（ステップＳ３２６）。

【００４６】一方、ローカルシンボル翻訳辞書４４に対
応する翻訳用語の定義が存在しない場合には、シンボル
翻訳辞書４２の検索が行われ、該当する翻訳用語の定義
が存在するか否かが調べられる（ステップＳ３２２，Ｓ
３２３）。翻訳用語の定義が存在する場合には、その翻
訳用語がシンボル翻訳辞書４２から取り出され（ステッ
プＳ３２４）、その翻訳用語はパターン翻訳辞書４１か
ら取り出された翻訳文と合成される（ステップＳ３２
５）。そして、その合成結果は現在対象となっている記
述パターンに対するコメント文としてその記述パターン
に合成されて、出力部２１４から出力される（ステップ
Ｓ３２６）。

【００４７】なお、この第３実施形態のローカルシンボ
ル翻訳辞書４４は、第２実施形態の順序付きパターン翻
訳辞書４３と組み合わせて使用することもできる。ま
た、第１乃至第３実施形態のコメント付け処理の手順を
コンピュータに実行させるコンピュータプログラムをフ
ロッピーディスクやＣＤ−ＲＯＭなどの記録媒体に格納
して配布することにより、任意のコンピュータ上でコメ
ント付けを伴うプログラムの作成作業を支援することが
可能となる。

【００４８】

【発明の効果】以上説明したように、この発明によれ
ば、入力プログラムを解析することによりそのプログラ
ム中の記述に対応してコメント文を自動生成できるよう
になり、プログラム中の各記述に対して十分なコメント
付けがなされたコメント付きプログラムを作成すること
が可能となる。

【図面の簡単な説明】

【図１】この発明の第１実施形態に係るプログラムパタ
ーン翻訳システムの機能構成を示すブロック図。

【図２】同第１実施形態のシステムに適用されるパター
ン翻訳辞書の具体的な記述例を示す図。

【図３】同第１実施形態のシステムに適用されるシンボ
ル翻訳辞書の具体的な記述例を示す図。

【図４】同第１実施形態のシステムによって実行される
コメント付け処理の手順を示すフローチャート。

【図５】同第１実施形態のシステムでコメント付け対象
となる入力プログラムと、コメント付け処理された出力
プログラムの一例を示す図。

【図６】この発明の第２実施形態に係るプログラムパタ
ーン翻訳システムの機能構成を示すブロック図。

【図７】同第２実施形態のシステムに適用される順序付
きパターン翻訳辞書の具体的な記述例を示す図。

【図８】同第２実施形態のシステムによって実行される
コメント付け処理の手順を示すフローチャート。

【図９】この発明の第３実施形態に係るプログラムパタ
ーン翻訳システムの機能構成を示すブロック図。

【図１０】同第３実施形態のシステムにおける入力プロ
グラムの一例を示す図。

【図１１】同第３実施形態のシステムにおいて図１０の
入力プログラムから生成されるローカルシンボル翻訳辞
書の一例を示す図。

【図１２】同第３実施形態のシステムによって実行され
るコメント付け処理の手順を示すフローチャート。

【符号の説明】

１１…ソースプログラム、２１…プログラムパターン翻
訳システム、３１…コメント付きプログラム、４１…パ
ターン翻訳辞書、４２…シンボル翻訳辞書、４３…順序
付きパターン翻訳辞書、４４…ローカルシンボル翻訳辞
書、２１１…入力部、２１２…解析部、２１３…抽出
部、２１４…出力部。

Claims (7)

【特許請求の範囲】
1. 【請求項１】 コンピュータを用いてプログラム作成を
   支援するプログラム理解支援方法であって、 コーディングされたソースプログラムを入力し、 この入力プログラムの記述の中からそれを構成する記述
   要素を取り出し、 所定の記述パターンとその内容を表す翻訳文との対応関
   係が定義された記述パターン辞書を参照して、前記入力
   プログラムから取り出した記述要素に対応する翻訳文を
   決定し、 この決定した翻訳文と前記入力プログラムの記述とを合
   成して、コメント付きプログラムを出力することを特徴
   とするプログラム理解支援方法。
2. 【請求項２】 前記記述パターン辞書には、各関数およ
   び制御構造毎にそれを使用した記述パターンとそれに対
   応する翻訳文との対応関係が定義されていることを特徴
   とする請求項１記載のプログラム理解支援方法。
3. 【請求項３】 前記記述パターン辞書には、所定の関数
   を含む記述パターンについてその関数の引数の値に応じ
   て異なる複数の翻訳文が定義されており、 前記入力プログラムから取り出した記述要素に含まれる
   関数の引数に合致した翻訳文が前記記述パターン辞書か
   ら取得されることを特徴とする請求項１記載のプログラ
   ム理解支援方法。
4. 【請求項４】 前記入力プログラムから取り出した記述
   要素が変数宣言であるとき、変数として使用可能な所定
   のシンボルマークとそれに対応する変数名との対応関係
   が定義されたシンボル辞書を参照して、前記変数宣言で
   使用されるシンボルマークに対応した変数名を決定し、 この決定した変数名を、前記変数宣言のコメント文とし
   て前記入力プログラムの記述に合成することを特徴とす
   る請求項１記載のプログラム理解支援方法。
5. 【請求項５】 前記入力プログラムから取り出した記述
   要素に変数が含まれるとき、変数として使用可能な所定
   のシンボルマークとそれに対応する変数名との対応関係
   が定義されたシンボル辞書を参照して、前記記述要素に
   含まれる変数に対応した変数名を決定し、 この決定した変数名と前記記述要素に対応する翻訳文と
   を合成して、変数を含む記述要素に対応したコメント文
   を生成することを特徴とする請求項１記載のプログラム
   理解支援方法。
6. 【請求項６】 前記入力プログラム中に含まれる変数の
   変数名がコメント文によって予め記述されているとき、
   その変数を示すシンボルマークについてそのプログラム
   中の出現位置と変数名とを示すローカルシンボル辞書を
   作成し、 このローカルシンボル辞書を参照して、コメント付けさ
   れてない記述要素に含まれるシンボルに対応する変数名
   を、そのシンボルの出現位置に応じて決定することを特
   徴とする請求項１記載のプログラム理解支援方法。
7. 【請求項７】 コンピュータプログラムを記録した記録
   媒体であって、前記プログラムには、 コーディングされたソースプログラムを入力し、 この入力プログラムの記述の中からそれを構成する記述
   要素を取り出し、 所定の記述パターンとその内容を表す翻訳文との対応関
   係が定義された記述パターン辞書を参照して、前記入力
   プログラムから取り出した記述要素に対応する翻訳文を
   決定し、 この決定した翻訳文と前記入力プログラムの記述とを合
   成して、コメント付きプログラムを出力する手続きが記
   述されていることを特徴とするプログラム記録媒体。