JPH0217538A - ドキュメント作成装置 - Google Patents

Abstract

(57)【要約】本公報は電子出願前の出願データであるた
め要約のデータは記録されません。

Description

【発明の詳細な説明】 〔産業上の利用分野〕 本発明はソフトウェアの開発、保守および管理に利用す
る。特に、ソースプログラムの更新日、内容、その他の
情報を書類として出力するドキュメント作成装置に関す
る。

〔概　要〕

本発明は、ソフトウェアに関する情報を書類として出力
するドキュメント作成装置において、ソースプログラム
を解析する毎にその時点におけるソースプログラムの更
新日と解析データとを記憶し、その次の解析時には、更
新日が一致しないものだけを解析することにより、 自動的に効率よく正確なドキュメントを作成するように
したものである。

〔従来の技術〕

ソフトウェアの開発、保守および管理のために、ソース
プログラムだけでなく、作成日、更新日、更新内容、フ
ローチャートその他の図表、使用方法、その他そのソフ
トウェアに関する情報を書類として保存する必要がある
。これらの書類を本明細書では「ドキュメント」という
。

ドキュメントの作成は非常に手間のかかる仕事であり、
これを自動的に実行する装置が従来から考えられている
。例えば、コメント文のうち所定の書式で記述された内
容を出力するもの、プログラムのステップ数を数えて出
力するもの、さらには、プログラムの内容を解析して出
力するものが考えられている。

〔発明が解決しようとする問題点〕

しかし、従来のドキュメント作成装置では、最新のドキ
ュメントを得る場合に、すべてのソースプログラムにつ
いて解析を行うか、解析しようとする個々のソースプロ
グラムを手動により選択する必要があった。前者の場合
には、以前に解析したものについても同一のドキュメン
トを再び作成するため、効率が悪い欠点があった。後者
の場合には、前回の解析を行った時点以降に更新された
ソースプログラム、および追加されたソースプログラム
についてのみドキュメントを作成することができる。し
かし、どのソースプログラムについてドキュメントを作
成するかについては、人間の判断により指定する必要が
あり、作業盪が多く、手作業による誤りが発生しやすい
欠点があった。

本発明は、以上の問題点を解決し、効率よく正確なドキ
ュメントを作成するドキュメント作成装置を提供するこ
とを目的とする。

〔問題点を解決するための手段〕

本発明のドキュメント作成装置は、すでに解析したソー
スプログラムの識別名、更新日および解析データを格納
する解析データ記憶装置と、個々のソースプログラムの
識別名および更新日をそれぞれ解析データ記憶装置に記
憶された識別名および更新日と比較する手段と、識別名
が一致していて更新日が一致していないときに、そのソ
ースプログラムを解析して解析データ記憶装置の記憶内
容を更新する手段さ、一致する識別名がないときに、そ
のソースプログラムを解析して解析データ記憶装置に新
しく識別名、更新日および解析データを登録する手段と
を備えたことを特徴とする。

〔作　用〕

ソースプログラムと以前の解析により得られた解析デー
タとについて、その識別名と更新日とを比較することに
より、以前にドキュメントを作成した後に変更があった
ソースプログラム、および新しく付は加えられたソース
プログラムを自動的に判別し、そのソースプログラムだ
１すを解析してドキュメントを作成する。

また、解析データについては、すべてのソースプログラ
ムについて最新のものが蓄えられるので、新しくすべて
のドキュメントが必要なときには、あらためて解析を行
うことなく速やかに出力できる。

〔実施例〕

第１図は本発明実施例ドキュメント作成装置のブロック
構成図である。

この実施例装置は、識別名および更新日が記載されたソ
ースプログラムを格納するソースプログラム記憶装置１
０と、このソースプログラムを読み出してその内容を解
析する解析手段と、解析データ記憶装置４０からの解析
データを出力するドキュメント出力装置５０とを備える
。

解析手段は、すでに解析したソースプログラムの識別名
、更新日および解析データを格納する解析データ記憶装
置４０と、個々のソースプログラムの識別名および更新
日をそれぞれ解析データ記憶装置４０に記憶された識別
名および更新日と比較する解析対象ソースプログラム判
別装置２０と、この解析対象ソースプログラム判別装置
２０の出力によリソースプログラムを解析するプログラ
ム解析装置３０とを含む。

プログラム解析装置３０は、識別名が一致していて更新
日が一致していないときに、そのソースプログラムを解
析して解析データ記憶装置４０の記憶内容を更新する手
段と、一致する識別名がないときに、そのソースプログ
ラムを解析して解析データ記憶装置４０に新しく識別名
、更新日および解析データを登録する手段を含む。

第２図はソースプログラム記憶装置１０の記憶フォーマ
ットを示す。

ソースプログラム記憶装置ｌＯは、ソースプログラム記
憶単位毎に、複数のソースプログラムを蓄えている。そ
れぞれのソースプログラム記憶単位には、ソースプログ
ラム識別名、最終更新日およびソーステキストが格納さ
れる。これらの記憶内容は、常に最新のものに更新され
る。

第３図は解析データ記憶装置４０の記憶フォーマットを
示す。

解析データ記憶装置４０は、ソースプログラム記憶装置
１０のソースプログラム記憶単位に対応して、解析デー
タ記憶単位毎に、解析データ識別名、解析時におけるソ
ースプログラムの更新日（解析時更新日）およびプログ
ラム解析装置３０の出力した解析データを格納する。

第４図は解析対象ソースプログラム判別装置２０の詳細
を示すブロック構成図である。この装置は、ソースプロ
グラム記憶装置１０から読み出した識別名を蓄えるソー
スプログラム識別名レジスタ２１と、そのソースプログ
ラムの最終更新日を蓄える最終更新日レジスタ２２と、
比較回路２３とを備える。

第５図は実施例装置の動作の流れを示す。

解析対象ソースプログラム判別装置２０は、ソースプロ
グラム記憶装置１０に格納されたひとつのソースプログ
ラムを選択し、そのソースプログラム識別名および最終
更新日を取り込んで、それぞれソースプログラム識別名
レジスタ２１および最終更新日レジスタ２２に格納する
。

次に、解析対象ソースプログラム判別装置２０は、解析
データ記憶装置４０に格納されたすべての解析データに
ついて、解析データ識別名および解析時更新日を参照し
、比較回路２３により、それぞれソースプログラム識別
名レジスタ２１および最終更新日レジスタ２２の内容と
比較する。

ソースプログラム識別名と解析データ識別名とが一致し
た場合には、さらに最終更新日と解析時更新日とを比較
する。更新日が一致しない場合には、ソースプログラム
識別名をプログラム解析装置３０に通知する。また、ソ
ースプログラム識別名が解析データ記憶装置４０内のど
の解析データ識別名とも一致しない場合には、ソースプ
ログラム識別名をプログラム解析装置３０に通知する。

プログラム解析装置３０は、通知されたソースプログラ
ム識別名にしたがってソースプロゲラ１１記憶装置１０
からソースプログラム記憶単位を読み出し、そのソース
テキストを解析し、その結果を解析データ記憶装置４０
に格納する。このとき、識別名が一致するものがある場
合には、解析時更新日および解析データを更新し、識別
名が一致するものがない場合には、あらたに解析データ
識別名を登録し、解析時更新日および解析データを格納
する。

以上の処理をソースプログラム記憶装置１０に格納され
たすべてのソースプログラム記憶単位について繰り返す
。

ドキュメント出力装置５０は、解析データ記憶装置４０
から解析データを読み取り、書類として出力する。

〔発明の効果〕

以上説明したように、本発明のドキュメント作成装置は
、開発または保守作業中に更新されるソースプログラム
について、前回までの解析データから、新たに更新され
たソースプログラムを自動的に判断する。したがって、
短時間に正確な最新ドキュメントが得られる。本発明は
、ドキュメントの保守作業を効率化し、正確なドキュメ
ントを作成できる。したがって、ソフトウェア開発およ
び保守作業の品質および生産性を高めることができる効
果がある。

【図面の簡単な説明】

第１図は本発明実施例ドキュメント作成装置のブロック
構成図。 第２図はソースプログラム記憶装置の記憶フォーマット
を示す図。 第３図は解析データ記憶装置の記憶フォーマットを示す
図。 第４図は解析対象ソースプログラム判別装置の詳細を示
すブロック構成図。 第５図は実施例装置の動作の流れ図。 １０・・・ソースプログラム記憶装置、２０・・・解析
対象ソースプログラム判別装置、２１・・・ソースプロ
グラム識別名レジスタ、２２・・・最終更新日レジスタ
、２３・・・比較回路、３０・・・プログラム解析装置
、４０・・・解析データ記憶装置、５０・・・ドキュメ
ント出力装置。

Claims (1)

1. 【特許請求の範囲】 １、識別名および更新日が記載されたソースプログラム
   を格納するソースプログラム記憶装置と、このソースプ
   ログラムを読み出してその内容を解析する解析手段と、 この解析手段からの解析データを出力するドキュメント
   出力装置と を備えたドキュメント作成装置において、 上記解析手段は、 すでに解析したソースプログラムの識別名、更新日およ
   び解析データを格納する解析データ記憶装置と、 個々のソースプログラムの識別名および更新日をそれぞ
   れ上記解析データ記憶装置に記憶された識別名および更
   新日と比較する手段と、 識別名が一致していて更新日が一致していないときに、
   そのソースプログラムを解析して上記解析データ記憶装
   置の記憶内容を更新する手段と、一致する識別名がない
   ときに、そのソースプログラムを解析して上記解析デー
   タ記憶装置に新しく識別名、更新日および解析データを
   登録する手段と を含む ことを特徴とするドキュメント作成装置。