JPS6167131A - ドキユメント自動出力制御方式 - Google Patents

Abstract

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

Description

【発明の詳細な説明】 〔産業上の利用分野〕 プログラムデータを入力することにより、そのプログラ
ムに対するソフトウェアドキュメントを自動的に表示又
は印字出力するドキュメント自動出力制御方式に関する
ものである。

〔従来の技術〕

ソフトウェアの開発規模の増大に伴って、その可視情報
提供手段としてのソフトウェアドキュメントの役割が重
視されている。このソフトウェアドキュメントは、作成
基準を設定してソフトウェア開発者が手作業で作成する
ものであった。又大規模のソフトウェアの開発には多数
の人々が携わり、それぞれソフトウェアドキュメントを
作成するものであるから、ソフトウェアドキュメントの
量は、ソフトウェアの規模に対応して非常に多くなるも
のである。

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

大規模のソフトウェアの開発に於いては、ソフトウェア
ドキュメントの作成基準が設定されているとしても、多
数の開発者がそれぞれ手作業によりソフトウェアドキュ
メントを作成することになり、且つその作成時に個人の
主観が導入されて、機能の記述表現にばらつきが生じる
ので、作成されたソフトウェアドキュメントの統一性が
失われる欠点があった。又前述のように、ソフトウェア
開発者が手作業により作成するものであるから、ドキュ
メントの生産性が低い欠点があった。

本発明は、従来の欠点を改善し、統一性を有するソフト
ウェアドキュメントを自動的に作成することを目的とす
るものである。

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

本発明のドキュメント自動出力制御方式は、プログラム
言語等に対応して選択された入力変換パターンに従って
入力プログラムデータを中間データに変換する第１の変
換装置と、変換された前記中間データを入力、出力、処
理の三つの属性に分割し且つ相互に関連を持たせて蓄積
する中間データ蓄積装置と、選択された出力変換パター
ンに従って前記中間データを表示又は印字可能のデータ
に変換する第２の変換装置と、この第２の変換装置によ
り変換されたデータが入力されて表示又は印字等を行う
可視装置とを備え、前記第１の変換装置にプログラムデ
ータを入力して、前記可視装置からソフトウェアドキュ
メントを自動的に出力させるものである。

〔作用〕

入力プログラムデータは、第１の変換装置により中間デ
ータに変換され、この中間データは、入力、出力、処理
の三つの属性に分割され且つ相互に関連を持たせて中間
データ蓄積装置に蓄積され、この中間データ蓄積装置か
ら読出された中間データは、第２の変換装置により表示
又は印字等を行うデータに変換されて可視装置に加えら
れ、ソフトウェアドキュメントが表示又は印字出力され
るものである。

〔実施例〕

以下図面を参照して、本発明の実施例について詳細に説
明する。

第１図は本発明の実施例のブロック図であり、ｌはソー
スプログラムを格納したプログラムデータ格納部、２は
第１の変換装置、３はプログラム言語等に対応した複数
の入力変換パターンを格納した入力変換パターン格納部
、４は中間データの分類、関連付は等の処理を行って蓄
積する蓄積装置、５は第２の変換装置、６は表示や印字
等の出力形式に対応した複数の出力変換パターンを格納
した出力変換パターン格納部、７はディスプレイ装置や
プリンタ等の可視装置である。

メモリ等からなるプログラムデータ格納部１からのプロ
グラムデータが第１の変換装置２に入力され、又入力変
換パターン格納部３からプログラム言語等に対応した入
力変換パターンが選択されて入力される。変換装置２に
於いては、入力変換パターンに従って入力プログラムデ
ータを中間データに変換するものであり、変換された中
間データは蓄積装置４に入力される。この蓄積装置４に
於いては、入力中間データを、入力、出力、処理の三つ
の属性に分類し、それらの間の関連付けの処理を行って
蓄積するものである。従って、プログラムに対するドキ
ュメントは、入力、出力、処理の属性に統一されること
になる。

第２の変換装置５は、蓄積装置４に蓄積された中間デー
タを読取って、出力変換パターン格納部６から表示、印
字等に対応した出力変換パターンを取り出し、その出力
変換パターンに従って中間データを出力データに変換し
て可視装置７に転送する。可視装置７は出力データに従
ってソフトウェアドキュメントの表示又は印字出力を行
うことになる。

第２図は、入力プログラムデータと出力ソフトウェアド
キュメントとの一例を示すものであり、構文解析論理等
を示す入力変換パターンに従ってこの入力プログラムデ
ータは中間データに変換される。この入力プログラムデ
ータの変換について説明すると、■では、Ｒ１に（Ａ＋
Ｂ）というデータを保存し、■では、ＣにＲ１を保存す
るものであるが、Ｒ１には（Ａ＋Ｂ）というデータが保
存されているので、Ｃに（Ａ＋Ｂ）を保存して、■、■
を一つの代人文として、入力、出力、処理に分解する。

即ち、入力は（Ａ＋Ｂ）、処理は代入、出力はＣとなる
。

又■では、ＤとＣとが等しいか、という条件に対して、
Ｃに保存されていたデータを取り出して入力、出力、処
理に分解するもので、入力はり。

＝、Ａ＋Ｂとなり、処理は条件分岐となる。又■では、
Ｒ１に（Ｂ＋１）というデータを保存するものであり、
■では、ＡにＲ１を保存するものであるが、Ｒ１には（
Ｂ＋１）というデータが保存しであるので、Ａに（Ｂ＋
１）を保存し、■、■を一つの代入文として入力、出力
、処理に分解する。即ち、入力は（Ｂ＋１）、処理は代
入、出力はＡとなる。

従って、中間データは、次の第１表に示すものとなる。

第１表 前述のように、入力プログラムデータは、入力出力、処
理の三つの属性に分解されて、且つ相互に関連付けられ
て蓄積装置４に蓄積される。この蓄積袋Ｗ４から第２の
変換装置へ中間データが転送され、出力変換パターン格
納部６から選択された出力変換パターンが取り出されて
、その出力変換パターンに従って中間データが出力デー
タに変換される。

例えば、前述の第１表に示す中間データは、代入として
、５ｅｔ−入力−ｔｏ−出力及びｔｈｅｓｕｍｏｆ−左
辺（Ａ）−ａｎｄ−右辺（Ｂ）の変換処理、条件分岐と
して、Ｃｈｅｃｋ−左辺（Ｄ）−ｉｆ−比較演算子−右
辺（Ａ＋Ｂ）−ｔｈｅｎの変換処理により、第２図の出
力で示す内容のソフトウェアドキュメントが可視装置７
から出力されることになる。

各種の入力プログラムデータについても、プログラム言
語の相違に拘わらず、中間データに変換して、入力、出
力、処理の三つの属性に分解して蓄積し、それらの関連
により表示又は印字可能のデータに変換して、ドキュメ
ントを出力することができるものである。

〔発明の効果〕

以上説明したように、本発明は、選択された入力変換パ
ターンに従って入力プログラムデータを中間データに変
換する第１の変換装置２と、中間データを入力、出力、
処理の三つの属性に分割し且つ相互に関連を持たせて蓄
積する中間データ蓄積装置４と、選択された出力変換パ
ターンに従って前記中間データを表示又は印字可能のデ
ータに変換する第２の変換装置５と、可視装置７とを備
えて、第１の変換装置２にプログラムデータを入力して
、可視装置からソフトウェアドキュメント、。

を自動的に出力するものであり、中間データとしては、
入力、出力、処理の三つの属性に分類して蓄積するので
、中間データの段階で統一性が与えられることになる。

又入力変換パターンをプログラム言語等に対応して選択
して、入力プログラムデータの変換を行うものであるか
ら、個人の主観が導入されることがなく、統一のとれた
ソフトウェアドキュメントを自動的に作成することがで
きる利点がある。

【図面の簡単な説明】

第１図は本発明の実施例のブロック図、第２図は入力プ
ログラムデータの一例と可視情報との説明図である。 １はプログラムデータ格納部、２は第１の変換装置、３
は入力変換パターン格納部、４は中間データ蓄積装置、
５は第２の変換装置、６は出力変換パターン格納部、７
は可視装置である。

Claims (1)

【特許請求の範囲】
1. 選択された入力変換パターンに従って入力プログラムデ
   ータを中間データに変換する第１の変換装置と、前記中
   間データを入力、出力、処理の三つの属性に分割し且つ
   相互に関連を持たせて蓄積する中間データ蓄積装置と、
   選択された出力変換パターンに従って前記中間データを
   表示又は印字可能のデータに変換する第２の変換装置と
   、該第２の変換装置により変換されたデータが入力され
   て表示又は印字等を行う可視装置とを備え、前記第１の
   変換装置にプログラムデータを入力して、前記可視装置
   からソフトウェアドキュメントを自動的に出力させるこ
   とを特徴とするドキュメント自動出力制御方式。