JPH05282138A - ドキュメンタの文書生成方法 - Google Patents

Abstract

(57)【要約】 【目的】 ドキュメンタの文書生成方法に関し、ドキュ
メンタプログラムの性能向上とオブジェクトサイズの減
少を図ることを目的としている。 【構成】 ドキュメンタプログラムの起動によりコンパ
イラを起動し（ａ）、次にコンパイラがソースプログラ
ムを参照して構文チェックと中間テキストの生成を行う
ときソースプログラム中の式文字列を式文字列編集領域
に抽出して式文字列編集領域の式文字列データを中間テ
キストに出力し（ｂ）、次にドキュメンタプログラムが
中間テキストを参照して文書を生成する（ｃ）ようにし
た。

Description

【発明の詳細な説明】

【０００１】

【産業上の利用分野】本発明は、ドキュメンタの文書生
成方法に関する。ドキュメンタプログラムは、ソースプ
ログラムに記述された処理の流れを図化した文書を出力
するものである。コンパイラは、ドキュメンタプログラ
ムが参照する中間テキストをソースプログラムの構文チ
ェックを行いながら生成する。

【０００２】ドキュメンタプログラムによる文書生成を
効率良く行うためには、ドキュメンタプログラムの性能
を向上させ、オブジェクトサイズを減少させることが必
要である。

【０００３】

【従来の技術】従来のドキュメンタプログラムの文書生
成方法を図１２に示す。図１２において、１はドキュメ
ンタプログラム、２はドキュメンタプログラム１により
起動されるコンパイラ、３はコンパイラ２およびドキュ
メンタプログラム１が参照するソースプログラム、４は
コンパイラ２が生成し、ドキュメンタプログラム１が参
照する中間テキスト、５はドキュメンタプログラム１が
生成する文書である。

【０００４】以下、文書生成の概要を図中の番号を参照
して説明する。 (1) ドキュメンタプログラム１を起動する。 (2) ソースプログラム３の構文チェックと中間テキス
ト４を生成するために、ドキュメンタプログラム１がコ
ンパイラ２を起動する。 (3) コンパイラ２がソースプログラム３を参照して、
構文チェックと中間テキスト４の生成を行う。 (4) ドキュメンタプログラム１が中間テキスト４とソ
ースプログラム３を参照して文書５を生成する。 (5) ドキュメンタプログラム１を終了する。

【０００５】中間テキスト４には、ソースプログラム３
に記述された命令語やデータ名の情報が設定されてい
る。ソースプログラム３に記述した式についての情報
は、従来の中間テキスト４では一般に四つ組と呼ばれる
形式となっている。その例を図１３に示す。ソースプロ
グラム３と中間テキスト４の説明を図１３中の番号を参
照して説明する。 (1) ？Ａ，？Ｂ，？Ｃ，？Ｄ，？Ｅは変数名を意味す
る。：＝は代入演算子を意味する。図１３のソースプロ
グラム３は右辺の演算結果を左辺の？Ａに代入する処理
である。 (2) ？Ｂと？Ｃの値を加算して、演算結果を作業域Ｗ
に設定する処理を意味する中間テキスト４である。 (3) 作業域Ｗの値から？Ｄの値を減算して、演算結果
を作業域Ｗに設定する処理を意味する中間テキスト４で
ある。 (4) 作業域Ｗの値に？Ｅの値を加算して、演算結果を
？Ａに設定する処理を意味する中間テキスト４である。
なお、＊印は次の中間コードへのポインタを意味する。
最終中間コードの場合は１６進のＸ´ＦＦＦＦが設定さ
れる。

【０００６】この中間テキスト４は、実行形式のオブジ
ェクトプログラムを生成する場合に都合のよい形式とな
っている。これらの情報だけでは、ドキュメンタプログ
ラム１はソースプログラム３の文字列を復元して編集す
ることができない、そこでドキュメンタプログラム１
は、中間テキスト４だけでなくソースプログラム３も参
照している。

【０００７】

【発明が解決しようとする課題】このような従来のドキ
ュメンタの文書生成方法にあっては、文書を生成する際
に、中間テキストだけでなく、ソースプログラムも参照
しているため、文書が出力されるまでにコンパイラとド
キュメンタプログラムでソースプログラムの２度読みが
発生する。その結果、ドキュメンタプログラムの処理が
複雑化し、ドキュメンタプログラムの性能低下とオブジ
ェクトサイズの増大の原因となっている。本発明は、こ
のような従来の問題点に鑑みてなされたものであって、
ドキュメンタプログラムの性能向上とオプジェクトサイ
ズの減少を図ることを目的としている。

【０００８】

【課題を解決するための手段】図１は本発明の原理説明
図である。図１において、（ａ）はドキュメンタプログ
ラムの起動によりコンパイラを起動するステップ、
（ｂ）はコンパイラがソースプログラムを参照して構文
チェックと中間テキストの生成を行うときソースプログ
ラム中の式文字列を式文字列編集領域に抽出して式文字
列の編集領域の式文字列データを中間テキストに出力す
るステップ、（ｃ）はドキュメンタプログラムが中間テ
キストを参照して文書を生成するステップである。

【０００９】

【作用】本発明においては、コンパイラがソースプログ
ラムを参照して構文チェックと中間テキストの生成を行
うとき、ソースプログラム中の式文字列を式文字列編集
領域に抽出し、式文字列編集領域の式文字列データを中
間テキストに出力するようにしたため、ドキュメンタプ
ログラムは中間テキストだけを参照して文書を生成する
ことができる。

【００１０】すなわち、ソースプログラムの２度読みが
発生せず、ディスクからの入力回数が減少する。また、
中間テキスト中には式文字列データが格納されているた
め、ドキュメンタプログラムで式情報を編集する必要が
なくなる。その結果、ドキュメンタプログラムの性能向
上とオブジェクトサイズの減少を図ることができる。

【００１１】

【実施例】以下、本発明の実施例を図面に基づいて説明
する。図２〜図１１は本発明の一実施例を示す図であ
る。図２において、１１はドキュメンタプログラムであ
り、ドキュメンタプログラム１１はコンパイラ１２を起
動し、また、中間テキスト１３のみを参照して、文書１
４で生成する。

【００１２】コンパイラ１２は、ソースプログラム１５
を参照して構文チェックと中間テキスト１３の生成を行
う。この場合、ソースプログラム１３中の式文字列を式
文字列編集領域に抽出し、式文字列編集領域のデータを
中間テキスト１３に出力する。中間テキスト１３には式
文字列データ１６が格納される。次に、式文字列の抽出
について説明する。

【００１３】ソースプログラム１５に記述される式に
は、ＩＦ文などの条件判断の条件式や代入式がある。ソ
ースプログラム１５中の条件式や代入式の文字列を抽出
すれば式文字列の情報を得ることができる。ＩＦ文に書
かれた条件判断文の抽出方法を図３に示す。図３中の式
文字列編集領域１７とは、式解析中に式を構成する字句
を読み込み順に格納する作業領域である。図３のＩＦ文
は、データ名？Ａの領域に設定されているデータが１０
００と等しいか否かを判定して、等しければ処理Ａを実
行する処理である。解析手順としては、ＩＦからＴＨＥ
Ｎの文字列を命令語・データ名・演算子などの字句に分
解する。そして、左から右方向に字句を読み込んで、字
句の前後関係から記述が構文規則に沿ったものであるか
を判別する。ここで、ＩＦ文の条件判断の式文字列は、
ＩＦとＴＨＥＮの中でのみ出現することが予測できる。
つまり、ＩＦが出現した時点で式文字列の開始が判定で
きる。そして、ＴＨＥＮが読み込まれた時に式文字列の
終了位置と判定できる。この抽出手順についての説明を
図３の番号を参照して以下に行う。 (1) ＩＦの出現により、式文字列の式文字列編集
領域１７への設定処理を開始する。 (2) 〜(4) 読み込んだ字句を式文字列編集領域１７に順
に設定する。 (5) ＴＨＥＮの出現により、式文字列編集領域１
７への字句設定処理を終了する。そして、式文字列の情
報として式文字列編集領域１７のデータを中間テキスト
１３に出力する。

【００１４】前記抽出手順をフローチャートで示すと図
４のようになる。図４において、ステップＳ１で１字句
を読み込み、ステップＳ２でＩＦの出現を判別する。Ｉ
Ｆが出現しないときは、終了となり、ＩＦが出現したと
きはステップＳ３で１字句（例えば、？Ａ、＝、１００
０）を読み込み、ステップＳ５で式文字列編集領域１７
に順次設定する。

【００１５】ステップＳ４でＴＨＥＮが出現したら、ス
テップＳ６で中間テキスト１３へ式文字列のデータを出
力する。以上の処理は、ＩＦ文に限らずＷＨＩＬＥ文や
ＦＯＲ文などのループ制御文の条件式でも同様である。
次に、代入文の式文字列の抽出方法を図５に示す。

【００１６】これは、データ名？Ａの領域に１０００＋
２０００−３０００の演算結果を設定する処理であ
る。：＝が代入演算記号である。この場合、式文字列の
先頭は、：＝の前に存在するデータ名？Ａとなる。：＝
が出現した時点で式文字列の開始が判断できる。そし
て、式文字列の終端は、データ名・定数値、演算子以外
のものが出現した位置である。この抽出手順についての
説明を図５の番号を参照して以下に行う。 (1) ？Ａの読込みを行う。 (2) ：＝の出現により、式文字列の式文字列編集
領域１７への設定処理を開始する。 (3) ：＝の直前に読み込まれた？Ａを式文字列編
集領域１７に設定する。 (4) ：＝の文字列を式文字列編集領域１７に設定
する。 (5) 〜(9) 読み込んだ字句を式文字列編集領域１７に設
定する。 (10) ＩＦの出現により、式文字列編集領域１７へ
の字句設定処理を終了する。そして、式文字列の情報と
して式文字列編集領域１７のデータを中間テキスト１３
に出力する。

【００１７】図５は、代入文の次にＩＦ文が存在する例
であり、ＩＦが出現した時点で式文字列の抽出処理を終
了する。また、代入文が続いている場合は、データ名が
２つ続いた時点で抽出処理を終了する。この例を図６に
示す。この抽出手順についての説明を図６の番号を参照
して以下に行う。 (1) ？Ａの読込みを行う。 (2) ：＝の出現により、式文字列の式文字列編集
領域１７への設定処理を開始する。 (3) ：＝の直前に読み込まれた？Ａを式文字列編
集領域１７に設定する。 (4) ：＝の文字列を式文字列編集領域１７に設定
する。 (5) 〜(7) 読み込んだ字句を式文字列編集領域１７に設
定する。 (8) 読み込んだ字句が？Ｃであり、直前に読み込
んだ字句が１００なのでデータ名が２つ続いたため代入
式の終端となる。そして、式文字列の情報として式文字
列編集領域１７のデータを中間テキスト１３に出力す
る。

【００１８】ここで、図５の代入式の抽出手順と図６の
式文字列の抽出手順をまとめて図７のフローチャートに
示す。図７において、ステップＳ１１で１字句の読み込
みを行い、ステップＳ１２で読み込んだ１字句の退避を
行う。そして、ステップＳ１３で再び１字句の読み込み
を行い、ステップＳ１４で：＝の出現を判別する。出現
しないときは、終了とし、出現したときは、ステップＳ
１５で退避させた文字列と：＝を式文字列編集領域１７
に設定する。

【００１９】そして、ステップＳ１６で１字句を順次読
み込み、ステップＳ１９で式文字列編集領域１７に順次
設定する。ステップＳ１７でＩＦなどが出現したとき
は、ステップＳ２０で式文字列編集領域１７に設定した
式文字列データを中間テキスト１３に出力する。また、
ステップＳ１８で数値などデータ名が２つ続いたとき
は、同様にステップＳ２０で式文字列編集領域１７に設
定した式文字列データを中間テキスト１３に出力する。

【００２０】このように本実施例においては、ソースプ
ログラム１５の２度読みが発生せずディスクからの入力
回数が減少する。また、中間テキスト１３中には、文書
１４に出力する形式で式文字列データ１６が格納されて
いるため、ドキュメンタプログラム１１での式情報を編
集する必要がなくなる。こうして生成された中間テキス
ト１３の例を、図８に、文書１４の例を図９および図１
０に、それぞれ示す。なお、図１１はソースプログラム
１５の例を示す。

【００２１】したがって、本実施例においては、ドキュ
メンタプログラム１１の性能向上およびオブジェクトサ
イズの減少を図ることができる。

【００２２】

【発明の効果】以上説明してきたように、本発明によれ
ば、コンパイラが出力する中間テキストにソースプログ
ラムに記述された式文字列を持たせるようにしたため、
文書の生成において、ドキュメンタプログラムの性能向
上およびオブジェクトサイズの減少を図ることができ
る。

【図面の簡単な説明】

【図１】本発明の原理説明図

【図２】本発明の一実施例を示す図

【図３】条件式の抽出手順の説明図

【図４】条件式の抽出手順のフローチャート

【図５】代入式の抽出手順の説明図

【図６】式文字列の抽出手順の説明図

【図７】代入式および式文字列の抽出手順のフローチャ
ート

【図８】中間テキストの例を示す図

【図９】文書の例を示す図

【図１０】文書の例を示す図

【図１１】ソースプログラムの例を示す図

【図１２】従来例を示す図

【図１３】中間テキスト生成の説明図

【符号の説明】

１１：ドキュメンタプログラム １２：コンパイラ １３：中間テキスト １４：文書 １５：ソースプログラム １６：式文字列データ １７：式文字列編集領域

Claims (1)

【特許請求の範囲】
1. 【請求項１】ドキュメンタプログラムの起動によりコン
   パイラを起動し（ａ）、次に、コンパイラがソースプロ
   グラムを参照して構文チェックと中間テキストの生成を
   行うときソースプログラム中の式文字列を式文字列編集
   領域に抽出して式文字列編集領域の式文字列データを中
   間テキストに出力し（ｂ）、次にドキュメンタプログラ
   ムが中間テキストを参照して文書を生成する（ｃ）こと
   を特徴とするドキュメンタの文書生成方法。