(57)【要約】【課題】ソースコードから抽出したコメント文だけでなく、図やテキスト文も含んだ保守ドキュメントを、ユーザに負担をかけずに作成する。【解決手段】管理情報記憶部27には、ソースコードから抽出したコメント文(保守ドキュメントの構成要素)と、コメント文の出現順を示す構成要素IDとが登録されている。ファイル格納部28には、追加構成要素（図など）を含んだファイルが登録されている。上記ファイル中の追加構成要素を保守ドキュメントに追加する場合、ユーザは、追加構成要素の挿入位置と所定の位置関係を有する保守ドキュメント中の構成要素を指定する。これにより、制御手段21は、管理情報記憶部27に、挿入元ファイルのファイル名に対応付けてユーザが指定した構成要素の構成要素IDと所定の関係を有する構成要素IDを登録すると共に、追加構成要素の挿入位置よりも後ろに存在する構成要素の構成要素IDを更新する。【選択図】図１
2007213195.tif 000002
【特許請求の範囲】
【請求項１】
管理情報記憶部と、
ソースコードから保守ドキュメントの構成要素となるコメント文を抽出し、抽出した各コメント文と、そのコメント文の前記ソースコードにおける出現順を示す構成要素ＩＤと、前記保守ドキュメントを特定するドキュメント名とを対応付けて前記管理情報記憶部に登録する抽出手段と、
保守ドキュメントに追加する追加構成要素を含んだファイルが登録されたファイル格納部と、
ユーザによって構成要素を追加する保守ドキュメント及び追加構成要素の挿入位置と所定の位置関係を有する前記保守ドキュメント中の構成要素が指定されたとき、前記追加構成要素を含んだファイルのファイル名に対応付けて、前記保守ドキュメントのドキュメント名と、前記追加構成要素に対する構成要素ＩＤであって前記ユーザによって指定された構成要素の構成要素ＩＤと所定の関係を有する構成要素ＩＤとを前記管理情報記憶部に登録すると共に、前記保守ドキュメントのドキュメント名に対応付けて前記管理情報記憶部に登録されている構成要素ＩＤの内の、前記追加構成要素の構成要素ＩＤが示している出現順と同じ出現順を示している構成要素ＩＤ及び前記追加構成要素の構成要素ＩＤが示している出現順よりも後の出現順を示している構成要素ＩＤを更新する制御手段とを備えたことを特徴とする保守ドキュメント作成管理装置。
【請求項２】
請求項１記載の保守ドキュメント作成管理装置において、
ユーザによって表示する保守ドキュメントのドキュメント名が指定されたとき、前記管理情報記憶部に前記ドキュメント名に対応付けて登録されているコメント文および前記ドキュメント名に対応付けてファイル名が登録されているファイル中の追加構成要素を、それに付されている構成要素ＩＤによって示される順番で表示する編集手段を備えたことを特徴とする保守ドキュメント作成管理装置。
【請求項３】
請求項１記載の保守ドキュメント作成管理装置において、
ドキュメント名と、該ドキュメント名の保守ドキュメントにおいて非表示にする構成要素の構成要素ＩＤとが登録された削除要素記憶部と、
ユーザによって表示する保守ドキュメントのドキュメント名が指定されたとき、前記管理情報記憶部に前記ドキュメント名に対応付けて登録されているコメント文および前記ドキュメント名に対応付けてファイル名が登録されているファイル中の追加構成要素の内の、前記削除要素記憶部に構成要素ＩＤが登録されていないものを、それに付されている構成要素ＩＤによって示される順番で表示する編集手段とを備えたことを特徴とする保守ドキュメント作成管理装置。
【請求項４】
請求項１乃至３の何れか１項に記載の保守ドキュメント作成管理装置において、
前記追加構成要素が図面あるいは説明文であることを特徴とする保守ドキュメント作成管理装置。
【請求項５】
管理情報記憶部と、保守ドキュメントに追加する追加構成要素を含んだファイルが登録されたファイル格納部とを備えた保守ドキュメント作成管理装置における保守ドキュメント作成管理方法であって、
ソースコードから保守ドキュメントの構成要素となるコメント文を抽出し、抽出した各コメント文と、そのコメント文の前記ソースコードにおける出現順を示す構成要素ＩＤと、前記保守ドキュメントを特定するドキュメント名とを対応付けて前記管理情報記憶部に登録する抽出ステップと、
ユーザによって構成要素を追加する保守ドキュメント及び追加構成要素の挿入位置と所定の位置関係を有する前記保守ドキュメント中の構成要素が指定されたとき、前記追加構成要素を含んだファイルのファイル名に対応付けて、前記保守ドキュメントのドキュメント名と、前記追加構成要素に対する構成要素ＩＤであって前記ユーザによって指定された構成要素の構成要素ＩＤと所定の関係を有する構成要素ＩＤとを前記管理情報記憶部に登録すると共に、前記保守ドキュメントのドキュメント名に対応付けて前記管理情報記憶部に登録されている構成要素ＩＤの内の、前記追加構成要素の構成要素ＩＤが示している出現順と同じ出現順を示している構成要素ＩＤ及び前記追加構成要素の構成要素ＩＤが示している出現順よりも後の出現順を示している構成要素ＩＤを更新する制御ステップとを含むことを特徴とする保守ドキュメント作成管理方法。
【請求項６】
請求項５記載の保守ドキュメント作成管理方法において、
ユーザによって表示する保守ドキュメントのドキュメント名が指定されたとき、前記管理情報記憶部に前記ドキュメント名に対応付けて登録されているコメント文および前記ドキュメント名に対応付けてファイル名が登録されているファイル中の追加構成要素を、それに付されている構成要素ＩＤによって示される順番で表示する編集ステップを含むことを特徴とする保守ドキュメント作成管理方法。
【請求項７】
請求項５記載の保守ドキュメント作成管理方法において、
ドキュメント名と、該ドキュメント名の保守ドキュメントにおいて非表示にする構成要素の構成要素ＩＤとが登録された削除要素記憶部を備え、且つ、
ユーザによって表示する保守ドキュメントのドキュメント名が指定されたとき、前記管理情報記憶部に前記ドキュメント名に対応付けて登録されているコメント文および前記ドキュメント名に対応付けてファイル名が登録されているファイル中の追加構成要素の内の、前記削除要素記憶部に構成要素ＩＤが登録されていないものを、それに付されている構成要素ＩＤによって示される順番で表示する編集ステップを含むことを特徴とする保守ドキュメント作成管理方法。
【請求項８】
請求項５乃至７の何れか１項に記載の保守ドキュメント作成管理方法において、
前記追加構成要素が図面あるいは説明文であることを特徴とする保守ドキュメント作成管理方法。
【請求項９】
管理情報記憶部および保守ドキュメントに追加する追加構成要素を含んだファイルが登録されたファイル格納部とを備えたコンピュータを、
ソースコードから保守ドキュメントの構成要素となるコメント文を抽出し、抽出した各コメント文と、そのコメント文の前記ソースコードにおける出現順を示す構成要素ＩＤと、前記保守ドキュメントを特定するドキュメント名とを対応付けて前記管理情報記憶部に登録する抽出手段、
ユーザによって構成要素を追加する保守ドキュメント及び追加構成要素の挿入位置と所定の位置関係を有する前記保守ドキュメント中の構成要素が指定されたとき、前記追加構成要素を含んだファイルのファイル名に対応付けて、前記保守ドキュメントのドキュメント名と、前記追加構成要素に対する構成要素ＩＤであって前記ユーザによって指定された構成要素の構成要素ＩＤと所定の関係を有する構成要素ＩＤとを前記管理情報記憶部に登録すると共に、前記保守ドキュメントのドキュメント名に対応付けて前記管理情報記憶部に登録されている構成要素ＩＤの内の、前記追加構成要素の構成要素ＩＤが示している出現順と同じ出現順を示している構成要素ＩＤ及び前記追加構成要素の構成要素ＩＤが示している出現順よりも後の出現順を示している構成要素ＩＤを更新する制御手段として機能させるためのプログラム。
【請求項１０】
請求項９記載のプログラムにおいて、
前記コンピュータを、
ユーザによって表示する保守ドキュメントのドキュメント名が指定されたとき、前記管理情報記憶部に前記ドキュメント名に対応付けて登録されているコメント文および前記ドキュメント名に対応付けてファイル名が登録されているファイル中の追加構成要素を、それに付されている構成要素ＩＤによって示される順番で表示する編集手段として機能させるためのプログラム。
【請求項１１】
請求項９記載のプログラムにおいて、
前記コンピュータが、ドキュメント名と、該ドキュメント名の保守ドキュメントにおいて非表示にする構成要素の構成要素ＩＤとが登録された削除要素記憶部を備え、且つ、
前記コンピュータを、ユーザによって表示する保守ドキュメントのドキュメント名が指定されたとき、前記管理情報記憶部に前記ドキュメント名に対応付けて登録されているコメント文および前記ドキュメント名に対応付けてファイル名が登録されているファイル中の追加構成要素の内の、前記削除要素記憶部に構成要素ＩＤが登録されていないものを、それに付されている構成要素ＩＤによって示される順番で表示する編集手段として機能させるためのプログラム。
【請求項１２】
請求項９乃至１１の何れか１項に記載のプログラムにおいて、
前記追加構成要素が図面あるいは説明文であることを特徴とするプログラム。
【発明の詳細な説明】
【技術分野】
【０００１】
本発明は、プログラムのソースコードから抽出したコメント文を利用して保守ドキュメントを作成する保守ドキュメント作成管理技術に関し、特に、ソースコードから抽出したコメント文だけでなく、図やテキスト文も含んだ保守ドキュメントを作成する保守ドキュメント作成管理技術に関する。
【背景技術】
【０００２】
プログラムのソースコードには、その保守や機能拡張等を容易にするためにコメント文が挿入されているのが一般的であり、このコメント文を利用して保守用の保守ドキュメントを作成するということは従来から行われている（例えば、特許文献１参照）。特許文献１においては、ソースコードに挿入されているコメント文を抽出し、抽出したコメント文を出現順に並べることにより、保守用ドキュメントを作成するようにしている。更に、特許文献１においては、保守ドキュメントに対して変更を行った場合、その変更内容をソースコードに反映させるようにしている。
【０００３】
一方、文書中に図表を挿入するということも従来から行われている（例えば、特許文献２参照）。特許文献２においては、図表の挿入位置を、ユーザが、キーボード上の文字キーを用いて数値により入力するようにしている。
【０００４】
【特許文献１】特開２０００−１６３２６０号公報
【特許文献２】特開平６−２６６７１２号公報
【発明の開示】
【発明が解決しようとする課題】
【０００５】
特許文献１に記載されている従来の技術によれば、保守ドキュメントを容易に作成することが可能になるが、単に、ソースコードに挿入されているコメント文を出現順に並べるだけであるので、保守ドキュメント中のコメント文をより分かりやすくするための説明文や、フローチャート等の図面を挿入することができないという問題がある。
【０００６】
このような問題を解決するため、特許文献１によって作成された保守ドキュメントに、特許文献２に記載されている技術を利用して図面などを挿入するということも考えられる。しかし、特許文献２においては、図表の挿入位置を、ユーザがキーボードの文字キーを用いて数値により入力しなければならないため、ユーザに負担がかかるという問題がある。即ち、挿入位置を示す数値をキーボードから入力したり、挿入位置を数値で表すとどうなるかを考えたりしなければならないため、ユーザに負担がかかるという問題がある。
【０００７】
そこで、本発明の目的は、ユーザに負担をかけることなく、ソースコードから抽出したコメント文だけでなく、図やテキスト文も含んだ保守ドキュメントを作成できるようにすることにある。
【課題を解決するための手段】
【０００８】
本発明にかかる第１の保守ドキュメント作成管理装置は、
管理情報記憶部と、
ソースコードから保守ドキュメントの構成要素となるコメント文を抽出し、抽出した各コメント文と、そのコメント文の前記ソースコードにおける出現順を示す構成要素ＩＤと、前記保守ドキュメントを特定するドキュメント名とを対応付けて前記管理情報記憶部に登録する抽出手段と、
保守ドキュメントに追加する追加構成要素を含んだファイルが登録されたファイル格納部と、
ユーザによって構成要素を追加する保守ドキュメント及び追加構成要素の挿入位置と所定の位置関係を有する前記保守ドキュメント中の構成要素が指定されたとき、前記追加構成要素を含んだファイルのファイル名に対応付けて、前記保守ドキュメントのドキュメント名と、前記追加構成要素に対する構成要素ＩＤであって前記ユーザによって指定された構成要素の構成要素ＩＤと所定の関係を有する構成要素ＩＤとを前記管理情報記憶部に登録すると共に、前記保守ドキュメントのドキュメント名に対応付けて前記管理情報記憶部に登録されている構成要素ＩＤの内の、前記追加構成要素の構成要素ＩＤが示している出現順と同じ出現順を示している構成要素ＩＤ及び前記追加構成要素の構成要素ＩＤが示している出現順よりも後の出現順を示している構成要素ＩＤを更新する制御手段とを備えたことを特徴とする。
【０００９】
本発明にかかる第２の保守ドキュメント作成管理装置は、第１の保守ドキュメント作成管理装置において、
ユーザによって表示する保守ドキュメントのドキュメント名が指定されたとき、前記管理情報記憶部に前記ドキュメント名に対応付けて登録されているコメント文および前記ドキュメント名に対応付けてファイル名が登録されているファイル中の追加構成要素を、それに付されている構成要素ＩＤによって示される順番で表示する編集手段とを備えたことを特徴とする。
【００１０】
本発明にかかる第３の保守ドキュメント作成管理装置は、第１の保守ドキュメント作成管理装置において、
ドキュメント名と、該ドキュメント名の保守ドキュメントにおいて非表示にする構成要素の構成要素ＩＤとが登録された削除要素記憶部と、
ユーザによって表示する保守ドキュメントのドキュメント名が指定されたとき、前記管理情報記憶部に前記ドキュメント名に対応付けて登録されているコメント文および前記ドキュメント名に対応付けてファイル名が登録されているファイル中の追加構成要素の内の、前記削除要素記憶部に構成要素ＩＤが登録されていないものを、それに付されている構成要素ＩＤによって示される順番で表示する編集手段とを備えたことを特徴とする。
【００１１】
本発明にかかる第４の保守ドキュメント作成管理装置は、第１〜第３の何れかの保守ドキュメント作成管理装置において、
前記追加構成要素が図面あるいは説明文であることを特徴とする。
【００１２】
本発明にかかる第１の保守ドキュメント作成管理方法は、
管理情報記憶部と、保守ドキュメントに追加する追加構成要素を含んだファイルが登録されたファイル格納部とを備えた保守ドキュメント作成管理装置における保守ドキュメント作成管理方法であって、
ソースコードから保守ドキュメントの構成要素となるコメント文を抽出し、抽出した各コメント文と、そのコメント文の前記ソースコードにおける出現順を示す構成要素ＩＤと、前記保守ドキュメントを特定するドキュメント名とを対応付けて前記管理情報記憶部に登録する抽出ステップと、
ユーザによって構成要素を追加する保守ドキュメント及び追加構成要素の挿入位置と所定の位置関係を有する前記保守ドキュメント中の構成要素が指定されたとき、前記追加構成要素を含んだファイルのファイル名に対応付けて、前記保守ドキュメントのドキュメント名と、前記追加構成要素に対する構成要素ＩＤであって前記ユーザによって指定された構成要素の構成要素ＩＤと所定の関係を有する構成要素ＩＤとを前記管理情報記憶部に登録すると共に、前記保守ドキュメントのドキュメント名に対応付けて前記管理情報記憶部に登録されている構成要素ＩＤの内の、前記追加構成要素の構成要素ＩＤが示している出現順と同じ出現順を示している構成要素ＩＤ及び前記追加構成要素の構成要素ＩＤが示している出現順よりも後の出現順を示している構成要素ＩＤを更新する制御ステップとを含むことを特徴とする。
【００１３】
本発明にかかる第２の保守ドキュメント作成管理方法は、第１の保守ドキュメント作成管理方法において、
ユーザによって表示する保守ドキュメントのドキュメント名が指定されたとき、前記管理情報記憶部に前記ドキュメント名に対応付けて登録されているコメント文および前記ドキュメント名に対応付けてファイル名が登録されているファイル中の追加構成要素を、それに付されている構成要素ＩＤによって示される順番で表示する編集ステップを含むことを特徴とする。
【００１４】
本発明にかかる第３の保守ドキュメント作成管理方法は、第１の保守ドキュメント作成管理方法において、
ドキュメント名と、該ドキュメント名の保守ドキュメントにおいて非表示にする構成要素の構成要素ＩＤとが登録された削除要素記憶部を備え、且つ、
ユーザによって表示する保守ドキュメントのドキュメント名が指定されたとき、前記管理情報記憶部に前記ドキュメント名に対応付けて登録されているコメント文および前記ドキュメント名に対応付けてファイル名が登録されているファイル中の追加構成要素の内の、前記削除要素記憶部に構成要素ＩＤが登録されていないものを、それに付されている構成要素ＩＤによって示される順番で表示する編集ステップを含むことを特徴とする。
【００１５】
本発明にかかる第４の保守ドキュメント作成管理方法は、第１〜第３の何れかの保守ドキュメント作成管理方法において、
前記追加構成要素が図面あるいは説明文であることを特徴とする。
【００１６】
本発明にかかる第１のプログラムは、
管理情報記憶部および保守ドキュメントに追加する追加構成要素を含んだファイルが登録されたファイル格納部とを備えたコンピュータを、
ソースコードから保守ドキュメントの構成要素となるコメント文を抽出し、抽出した各コメント文と、そのコメント文の前記ソースコードにおける出現順を示す構成要素ＩＤと、前記保守ドキュメントを特定するドキュメント名とを対応付けて前記管理情報記憶部に登録する抽出手段、
ユーザによって構成要素を追加する保守ドキュメント及び追加構成要素の挿入位置と所定の位置関係を有する前記保守ドキュメント中の構成要素が指定されたとき、前記追加構成要素を含んだファイルのファイル名に対応付けて、前記保守ドキュメントのドキュメント名と、前記追加構成要素に対する構成要素ＩＤであって前記ユーザによって指定された構成要素の構成要素ＩＤと所定の関係を有する構成要素ＩＤとを前記管理情報記憶部に登録すると共に、前記保守ドキュメントのドキュメント名に対応付けて前記管理情報記憶部に登録されている構成要素ＩＤの内の、前記追加構成要素の構成要素ＩＤが示している出現順と同じ出現順を示している構成要素ＩＤ及び前記追加構成要素の構成要素ＩＤが示している出現順よりも後の出現順を示している構成要素ＩＤを更新する制御手段として機能させる。
【００１７】
本発明にかかる第２のプログラムは、第１のプログラムにおいて、
前記コンピュータを、
ユーザによって表示する保守ドキュメントのドキュメント名が指定されたとき、前記管理情報記憶部に前記ドキュメント名に対応付けて登録されているコメント文および前記ドキュメント名に対応付けてファイル名が登録されているファイル中の追加構成要素を、それに付されている構成要素ＩＤによって示される順番で表示する編集手段として機能させる。
【００１８】
本発明にかかる第３のプログラムは、第１のプログラムにおいて、
前記コンピュータが、ドキュメント名と、該ドキュメント名の保守ドキュメントにおいて非表示にする構成要素の構成要素ＩＤとが登録された削除要素記憶部を備え、且つ、
前記コンピュータを、ユーザによって表示する保守ドキュメントのドキュメント名が指定されたとき、前記管理情報記憶部に前記ドキュメント名に対応付けて登録されているコメント文および前記ドキュメント名に対応付けてファイル名が登録されているファイル中の追加構成要素の内の、前記削除要素記憶部に構成要素ＩＤが登録されていないものを、それに付されている構成要素ＩＤによって示される順番で表示する編集手段として機能させる。
【００１９】
本発明にかかる第４のプログラムは、第１〜第３の何れかのプログラムにおいて、
前記追加構成要素が図面あるいは説明文であることを特徴とする。
【００２０】
〔作用〕
ユーザは、ソースコードの保守ドキュメントを作成する際、保守ドキュメントの作成対象にするソースコードを保守ドキュメント作成管理装置に入力する。保守ドキュメント作成管理装置内の抽出手段は、ユーザによって入力されたソースコードから保守ドキュメントの構成要素となるコメント文を抽出し、抽出した各コメント文と、そのコメント文の上記ソースコードにおける出現順を示す構成要素ＩＤと、上記保守ドキュメントを特定するドキュメント名とを対応付けて管理情報記憶部に登録する。また、ユーザは、保守ドキュメントに追加する追加構成要素（図やテキスト文等）を含んだファイルをファイル格納部に登録しておく。
【００２１】
その後、ユーザは、保守ドキュメント作成管理装置に対して、構成要素を追加する保守ドキュメント及び追加構成要素の挿入位置と所定の位置関係を有する上記保守ドキュメント中の構成要素を指定する。これにより、保守ドキュメント作成管理装置内の制御手段は、追加構成要素を含んだファイルのファイル名に対応付けて、上記保守ドキュメントのドキュメント名と、上記追加構成要素に対する構成要素ＩＤであってユーザによって指定された構成要素の構成要素ＩＤと所定の関係を有する構成要素ＩＤとを管理情報記憶部に登録する。更に、制御手段は、上記保守ドキュメントのドキュメント名に対応付けて管理情報記憶部に登録されている構成要素ＩＤの内の、追加構成要素の構成要素ＩＤが示している出現順と同じ出現順を示している構成要素ＩＤ及び追加構成要素の構成要素ＩＤが示している出現順よりも後の出現順を示している構成要素ＩＤを更新する。
【００２２】
また、ユーザは、保守ドキュメントを表示する際、保守ドキュメント作成管理装置に対して保守ドキュメントのドキュメント名を入力する。これにより、保守ドキュメント作成管理装置内の編集手段は、管理情報記憶部に上記ドキュメント名に対応付けて登録されているコメント文および上記ドキュメント名に対応付けてファイル名が登録されているファイル中の追加構成要素を、それに付されている構成要素ＩＤによって示される順番で表示する。
【発明の効果】
【００２３】
本発明によれば、ユーザに負担をかけることなく、ソースコードから抽出したコメント文だけでなく、図やテキスト文も含んだ保守ドキュメントを作成することができるという効果を得ることができる。その理由は、ユーザによって構成要素を追加する保守ドキュメント及び追加構成要素（図やテキスト文など）の挿入位置と所定の位置関係を有する保守ドキュメント中の構成要素が指定されたとき、上記追加構成要素を含んだファイルのファイル名に対応付けて、上記保守ドキュメントのドキュメント名と、追加構成要素に対する構成要素ＩＤであってユーザによって指定された構成要素の構成要素ＩＤと所定の関係を有する構成要素ＩＤとを管理情報記憶部に登録すると共に、上記保守ドキュメントのドキュメント名に対応付けて管理情報記憶部に登録されている構成要素ＩＤの内の、追加構成要素の構成要素ＩＤが示している出現順と同じ出現順を示している構成要素ＩＤ及び追加構成要素の構成要素ＩＤが示している出現順よりも後の出現順を示している構成要素ＩＤを更新する制御手段を備えているからである。即ち、ユーザは、構成要素を追加する保守ドキュメント及び追加構成要素の挿入位置と所定の位置関係を有する保守ドキュメント中の構成要素を指定するだけで良く、従来の技術のように、挿入位置を示す数値をキーボードから入力したり、挿入位置を数値で表すとどうなるかを考えたりする必要がないので、ユーザの負担が軽減する。
【発明を実施するための最良の形態】
【００２４】
次に、発明を実施するための最良の形態について図面を参照して詳細に説明する。
【００２５】
〔第１の実施の形態の構成の説明〕
図１を参照すると、本発明にかかる保守ドキュメント作成管理装置の第１の実施の形態は、キーボード・ディスプレイ等の入出力装置１と、プログラム制御により動作するコンピュータによって実現される保守ドキュメント作成管理装置２とを含む。
【００２６】
保守ドキュメント作成管理装置２は、制御手段２１と、検索手段２２と、登録手段２３と、抽出手段２４と、ＩＤ付与手段２５と、編集手段２６と、管理情報記憶部２７と、ファイル格納部２８とを備えている。
【００２７】
制御手段２１は、入出力装置１からの要求に応じた処理を行うために保守ドキュメント作成管理装置２内の各手段２２〜２６を制御する機能を有する。より具体的には、制御手段２１は、次のような機能を有する。
【００２８】
・入出力装置１からファイル登録要求が入力されたとき、ファイル名およびファイル種類の入力欄を有するファイル情報入力画面を入出力装置１に表示する機能。
・ファイル情報入力画面を用いて入出力装置１からファイル名が入力されたとき、上記ファイル名を含む検索要求を検索手段２２に供給する機能。
・検索手段２２からの検索結果が上記ファイル名のファイルが格納されていないことを示すものであった場合、入出力装置１から入力されたファイルを登録手段２３に渡すと共に、管理情報記憶部２７に上記ファイルのファイル名とファイル種類とを格納する機能。
・入出力装置１から入力されたファイル種類が、ソースコードが格納されたソースコードファイルである場合は、ＩＤ付与手段２５に対してドキュメントＩＤ付与要求を渡し、これに応答してＩＤ付与手段２５から返却されたドキュメントＩＤを上記ファイルのファイル名、ファイル種類と対応付けて管理情報記憶部２７に登録する機能。
・入出力装置１から入力されたファイル種類がソースコードファイルである場合、抽出手段２４に上記ファイルのファイル名を含む抽出要求を渡す機能。
・抽出手段２４が構成要素（コメント文）、その開始位置、終了位置、および構成要素名を抽出する毎に、ＩＤ付与手段２５に構成要素ＩＤ付与要求を渡し、この構成要素ＩＤ付与要求に応答してＩＤ付与手段２５から返却された構成要素ＩＤと、上記した構成要素、開始位置、終了位置、構成要素名とを、既に管理情報記憶部２７に登録してある該当するファイル名に対応付けて登録する機能。
・抽出手段２４がソースコードに含まれている全ての構成要素を抽出したとき、上記ソースコードに対応する保守ドキュメントのドキュメント名を生成し、生成したドキュメント名を、既に管理情報記憶部２７に登録されている該当するファイル名に対応付けて登録する機能。
・入出力装置１からドキュメント名を含むドキュメント表示要求が入力されたとき、上記ドキュメント表示要求を編集手段２６に渡し、このドキュメント表示要求に応答して編集手段２６が作成した保守ドキュメントを入出力装置１に表示する機能。
・ユーザによって構成要素を追加する保守ドキュメント及び追加する構成要素（追加構成要素）の挿入位置と所定の位置関係を有する上記保守ドキュメント中の構成要素が指定されたとき、上記追加構成要素を含んだファイルのファイル名に対応付けて、上記保守ドキュメントのドキュメント名と、上記追加構成要素に対する構成要素ＩＤであってユーザによって指定された構成要素の構成要素ＩＤと所定の関係を有する構成要素ＩＤとを管理情報記憶部２７に登録すると共に、上記保守ドキュメントのドキュメント名に対応付けて管理情報記憶部２７に登録されている構成要素ＩＤの内の、上記追加構成要素の構成要素ＩＤが示している出現順と同じ出現順を示している構成要素ＩＤ及び上記追加構成要素の構成要素ＩＤが示している出現順よりも後の出現順を示している構成要素ＩＤを更新する機能。
【００２９】
検索手段２２は、制御手段２１からファイル名を含む検索要求が入力されたとき、ファイル格納部２８に上記ファイル名のファイルが格納されているか否かを検索し、検索結果を制御手段２１に返却する機能を有する。
【００３０】
登録手段２３は、制御手段２１から渡されたファイルをファイル格納部２８に登録する機能を有する。
【００３１】
抽出手段２４は、制御手段２１からファイル名を含む抽出要求が入力されたとき、上記ファイル名のファイルに格納されているソースコードを処理対象にして、それに含まれているコメント文を抽出したり、抽出した各コメント文の開始位置，終了位置を抽出したり、コメント文の直後に存在する関数の関数名を構成要素名として抽出する機能を有する。コメント文の抽出は、既知の技術であるコンパイラの字句解析や構文解析の手法を用いる。
【００３２】
ＩＤ付与手段２５は、制御手段２１からドキュメントＩＤ付与要求が渡されたとき、ユニークなドキュメントＩＤを生成して制御手段２１に返却する機能や、制御手段２１から構成要素ＩＤ付与要求が渡されたとき、ユニークな構成要素ＩＤを生成して制御手段２１に返却する機能を有する。なお、構成要素ＩＤを生成する際には、第ｊ番目の構成要素ＩＤ付与要求に従って生成する構成要素ＩＤよりも、次の第（ｊ＋１）番目の構成要素ＩＤ付与要求に従って生成する構成要素ＩＤの方が値が大きくなるようにする。なお、本実施の形態では、第（ｊ＋１）番目の構成要素ＩＤ付与要求に従って生成する構成要素ＩＤは、第ｊ番目の構成要素ＩＤ付与要求に従って生成した構成要素ＩＤを所定値だけインクリメントしたものとする。
【００３３】
編集手段２６は、制御手段２１からドキュメント名を含むドキュメント表示要求が入力されたとき、管理情報記憶部２７から上記ドキュメント名に対応付けて登録されている構成要素ＩＤを全て取得して昇順にソートし、ソート後の構成要素ＩＤ群の先頭の構成要素ＩＤから順番に、その構成要素ＩＤに対応するコメント文或いはファイルの内容を順番につなぎ合わせる機能を有する。
【００３４】
ファイル格納部２８には、ソースコードを含んだファイル（ソースコードファイル）や、保守ドキュメントに追加する構成要素（追加構成要素）として図面を含んだファイル（図面ファイル）や、保守ドキュメントに追加する構成要素としてテキストを含んだファイル（テキストファイル）が登録される。なお、以下の説明では、ソースコードファイル、図面ファイル、テキストファイルの種類をそれぞれＳＲＣ、ＰＩＣ、ＴＸＴで表すものとする。
【００３５】
管理情報記憶部２７には、図２に示すように、ファイル格納部２８に登録されている各ファイルのファイル名、ファイル種類が登録されている。更に、ファイル種類がＳＲＣのファイルについては、構成要素名、構成要素（コメント文）、開始位置、終了位置、ドキュメントＩＤ及びドキュメント名が登録されている。また、ファイル種類がＰＩＣ、ＴＸＴのファイルについては、構成要素ＩＤ、ドキュメントＩＤ及びドキュメント名が登録されている。
【００３６】
上記した機能を有する保守ドキュメント作成管理装置２はコンピュータによって実現可能なものであり、コンピュータによって実現する場合は、例えば次のようにする。コンピュータを保守ドキュメント作成管理装置２として機能させるためのプログラムを記録したディスク、半導体メモリ、その他の記録媒体を用意し、コンピュータに上記プログラムを読み取らせる。コンピュータは、読み取ったプログラムに従って自身の動作を制御することにより、自コンピュータ上に、制御手段２１、検索手段２２、登録手段２３、抽出手段２４、ＩＤ付与手段２５、編集手段２６を実現する。
【００３７】
〔第１の実施の形態の動作の説明〕
次に、図面を参照して本実施の形態の動作について詳細に説明する。
【００３８】
〔ファイル登録時の動作〕
先ず、ユーザが保守ドキュメントを作成するために、図３に示すようなソースコードを含んだ、ファイル名Ｆ１のファイルを保守ドキュメント作成管理装置２に登録する場合の動作について説明する。
【００３９】
ユーザは、ファイルを登録する場合、入出力装置１から保守ドキュメント作成管理装置２に対してファイル登録要求を発行する。これにより、保守ドキュメント作成管理装置２内の制御手段２１は、入出力装置１の表示部（図示せず）にファイル名及びファイル種類の入力欄を有するファイル情報入力画面を表示する。
【００４０】
ユーザは、ファイル情報入力画面が表示されると、登録しようとしているファイルのファイル名及びファイル種類を該当する入力欄に入力する（図４のステップＡ１）。この場合、ユーザは、ファイル名，ファイル種類の入力欄にそれぞれ「Ｆ１」、「ＳＲＣ」を入力することになる。
【００４１】
保守ドキュメント作成管理装置２内の制御手段２１は、ファイル名Ｆ１及びファイル種類ＳＲＣが入力されると（ステップＡ２がイエス）と、検索手段２２に上記ファイル名Ｆ１を含んだ検索要求を渡す（ステップＡ３）。
【００４２】
これにより、検索手段２２は、ファイル格納部２８を検索し、上記ファイル名Ｆ１と同一ファイル名のファイルが既にファイル格納部２８に格納されているか否かを調べる。その後、検索手段２２は、ファイル名Ｆ１のファイルが格納済みか否かを示す検索結果を制御手段２１に返却する。
【００４３】
制御手段２１は、検索手段２２から返却された検索結果が、格納済みを示している場合（ステップＡ４がノー）は、その処理を終了する。これに対して、未格納を示している場合（ステップＡ４がイエス）は、入出力装置１の表示部にファイルの入力指示を表示する（ステップＡ５）。
【００４４】
この表示を見たユーザは、入出力装置１から保守ドキュメント作成管理装置２に対して、登録しようとしているファイルを入力する（ステップＡ６）。
【００４５】
制御手段２１は、ユーザによって入力されたファイルのサイズを調べ、ファイルサイズが０の場合（ステップＡ７がノー）は、その処理を終了する。これに対して、ファイルサイズが０でない場合（ステップＡ７がイエス）は、上記ファイルを登録手段２３に渡す（ステップＡ８）。これにより、登録手段２３は、制御手段２１から渡されたファイルをファイル格納部２８に格納する。
【００４６】
その後、制御手段２１は、図２に示すように、上記ファイルのファイル名Ｆ１とファイル種類ＳＣＲとを対応付けて管理情報記憶部２７に登録する（ステップＡ９）。
【００４７】
更に、制御手段２１は、処理対象にしているファイルの種類が「ＳＲＣ」であるか否かを調べる（ステップＡ１０）。この例の場合、処理対象にしているファイルの種類が「ＳＲＣ」であるので（ステップＡ１０がイエス）、制御手段２１は、ＩＤ付与手段２５に対してドキュメントＩＤ付与要求を渡す（図５のステップＢ１）。これにより、ＩＤ付与手段２５は、ユニークなドキュメントＩＤ（例えば、Ｘ１とする）を生成して制御手段２に返却する。
【００４８】
制御手段２１は、ＩＤ付与手段２５からドキュメントＩＤ「Ｘ１」が返却されると、図２に示すように、ファイル名Ｆ１、ファイル種類ＳＣＲに対応付けてドキュメントＩＤ「Ｘ１」を登録し、その後、ファイル名Ｆ１を含む抽出要求を抽出手段２４に渡す（ステップＢ２）。
【００４９】
抽出手段２４は、ファイル名Ｆ１のファイルに格納されているソースコードを解析し、ソースコード上で最初に現れる構成要素（コメント文）の開始位置、終了位置を抽出し、抽出した開始位置、終了位置を制御手段２１に返却する（ステップＢ３）。今回処理対象にしているファイル名Ｆ１のファイルには、図３に示すソースコードが格納されているので、制御手段２１は、開始位置、終了位置としてそれぞれ「第２行」「第２行」を抽出することになる。なお、抽出手段２４は、開始位置、終了位置を検出できなかった場合は、そのことを制御手段２１に通知する。
【００５０】
制御手段２１は、開始位置、終了位置が返却された場合（ステップＢ４がイエス）は、構成要素が返却するのを待つ。これに対して、開始位置、終了位置を検出できなかったことが通知された場合（ステップＢ４がノー）は、その処理を終了する。
【００５１】
開始位置、終了位置を抽出後、抽出手段２４は、構成要素を抽出し、抽出した構成要素を制御手段２１に返却する（ステップＢ５）。図３のソースコードにおいては、構成要素として「／＊関数のプロトタイプ宣言＊／」を抽出することになる。なお、構成要素を抽出できなかった場合は、そのことを制御手段２１に通知する。
【００５２】
制御手段２１は、構成要素が返却された場合（ステップ６がイエス）は、構成要素名が返却されるのを待つ。これに対して、構成要素を抽出できなかったことが通知された場合（ステップＢ６がノー）は、その処理を終了する。
【００５３】
構成要素を抽出後、抽出手段２４は、ステップＢ５で抽出した構成要素の次の行に存在する関数名を構成要素名として抽出する（ステップ７）。図３のソースコードにおいては、関数名「ａｄｄｕｐ（  ）」が構成要素名として抽出されることになる。なお、構成要素名を抽出できなかった場合は、そのことを制御手段２１に通知する。
【００５４】
制御手段２１は、構成要素名を抽出できなかったことが通知された場合（ステップＢ８がノー）は、その処理を終了する。これに対して、構成要素名が返却された場合（ステップＢ８がＹＥＳ）は、ＩＤ付与手段２５に対して構成要素ＩＤ付与要求を渡す（ステップＢ９）。
【００５５】
ＩＤ付与手段２５は、構成要素ＩＤ付与要求が入力されると、ユニークな構成要素ＩＤ（例えば、Ｙ１）を生成して制御手段２１に返却する。
【００５６】
制御手段２１は、構成要素ＩＤ「Ｙ１」がＩＤ付与手段２５から返却されると、図２に示すように、ファイル名「Ｆ１」に対応付けて、構成要素名「ａｄｄｕｐ（  ）」、構成要素「／＊関数のプロトタイプ宣言＊／」、開始位置「２」、終了位置「２」、構成要素ＩＤ「Ｙ１」を登録する（ステップＢ１０）。
【００５７】
以下、ソースコードの最後の部分に到達するまで（ステップＢ１１がイエスとなるまで）、前述したステップＢ３〜Ｂ１０の処理を繰り返し行う。そして、ソースコードの最後の部分に到達すると（ステップＢ１１がイエス）、制御手段２１は、ユニークなドキュメント名（例えば、「Ｆ１の保守ドキュメント」）を生成し、図２に示すように、ファイル名Ｆ１と対応付け管理情報記憶部２７に登録する（ステップＢ１２、Ｂ１３）。
【００５８】
次に、ユーザが、保守ドキュメントに追加するフローチャート等の図面を含んだファイルを登録する場合の動作について説明する。
【００５９】
今、例えば、図６に示すフローチャートを含んだファイル（ファイル名をＦ２とする）を登録する場合、ユーザは、ファイル登録要求を保守ドキュメント作成管理装置２に対して発行する。なお、この図６のフローチャートは、図３のソースコードの「第１６行〜第１８行」に存在するコメント文「／＊＊＊加算結果が５以下であれば、ｉに１を加える。最後にｉを２乗する＊／」に対応するフローチャートである。
【００６０】
制御手段２１は、ファイル登録要求が入力されると、入出力装置１の表示部にファイル情報入力画面を表示し、ユーザは、ファイル名、ファイル種類の入力欄にそれぞれ「Ｆ２」「ＰＩＣ」を入力する（図４のステップＡ１）。その後、前述したステップＡ２〜Ａ９と同様の処理が行われ、図２に示すように、管理情報記憶部２７にファイル名Ｆ２とファイル種類ＰＩＣとが対応付けて登録される。その後、制御手段２１は、処理対象にしているファイルのファイル種類が「ＰＩＣ」であるので（ステップＡ１０がノー）、その処理を終了する。なお、ファイル種類が「ＴＸＴ」のファイルの登録時にも同様の処理が行われる。
【００６１】
〔保守ドキュメント表示時の動作〕
次に、保守ドキュメントを入出力装置１の表示部（図示せず）に表示するときの動作を説明する。
【００６２】
ユーザは、保守ドキュメントを表示させる場合は、まず入出力装置１から保守ドキュメント名の一覧表示要求を入力する。これにより、制御手段２１は、管理情報記憶部２７で管理されている全てのドキュメント名を取得し、それらを入出力装置１の表示部に一覧表示する（図７のステップＣ１、Ｃ２）。
【００６３】
その後、ユーザは表示されたドキュメント名一覧の中から参照したい保守ドキュメントのドキュメント名を選択し、更に、入出力装置１から保守ドキュメント作成管理装置２に対してドキュメント表示要求を発行する。これにより、制御手段２１は、ユーザによって選択されたドキュメント名を含むドキュメント表示要求を編集手段２６に対して発行する。
【００６４】
これにより、編集手段２６は、管理情報記憶部２７から上記ドキュメント名に対応付けて登録されている構成要素ＩＤを全て取得する（ステップＣ３）。例えば、ユーザがドキュメント名として「Ｆ１の保守ドキュメント」を選択し、管理情報記憶部２７の内容が図２に示すものであったとすると、構成要素ＩＤ「Ｙ１」「Ｙ２」「Ｙ３」…及び構成要素「／＊関数のプロトタイプ宣言＊／」「／＊＊＊加算を実行し最後の結果を２乗する」「／＊＊＊加算結果が５以下であれば、ｉに１を加える。最後にｉを２乗する＊／」…を取得することになる。
【００６５】
次いで、編集手段２６は、ステップＣ３で取得した構成要素ＩＤを昇順にソートする（ステップＣ４）。その後、編集手段２６は、ソート後の構成要素ＩＤ群の先頭の構成要素ＩＤから順番に、その構成要素ＩＤに対応する構成要素（コメント文或いはファイルの内容）を順番につなぎ合わせることにより、保守ドキュメントを作成し、作成した保守ドキュメントを制御手段２１に渡す。制御手段２１は、編集手段２６から渡された保守ドキュメントを入出力装置１の表示部に表示する（ステップＣ５）。なお、上記した保守ドキュメントには、構成要素（コメント文及びファイルの内容）しか含まれないが、各コメント文に対応付けて構成要素ＩＤ、構成要素名、開始位置、終了位置を表示するようにしても良い。
【００６６】
〔保守ドキュメントへの構成要素追加時の動作〕
次に、保守ドキュメントに図面や説明文などの構成要素を追加する場合の動作について説明する。
【００６７】
ユーザは、まず、入出力装置１から構成要素挿入要求を入力する。構成要素挿入要求が入力されると、制御手段２１は、まず、管理情報記憶部２７からファイル種別がＰＩＣ、ＴＸＴとなっているファイルのファイル名を全て取得する（ステップＤ１）。即ち、保守ドキュメントへの挿入候補となるファイルのファイル名を全て取得する。
【００６８】
その後、制御手段２１は、ステップＤ１で取得したファイル名とそのファイル種類との一覧（挿入候補ファイル一覧）を入出力装置１の表示部に表示する（ステップＤ２）。
【００６９】
更に、制御手段２１は、管理情報記憶部２７から全てのドキュメント名を取得し（ステップＤ３）、取得したドキュメント名毎に、対応する構成要素及び構成要素ＩＤを全て取得する（ステップＤ４）。例えば、管理情報記憶部２７の内容が図２に示すものであり、処理対象にしているドキュメント名が「Ｆ１の保守ドキュメント」であるとすると、構成要素「／＊関数のプロトタイプ宣言＊／」「／＊＊＊加算を実行し最後の結果を２乗する」「／＊＊＊加算結果が５以下であれば、ｉに１を加える。最後にｉを２乗する＊／」…と、構成要素ＩＤ「Ｙ１」「Ｙ２」「Ｙ３」…とを取得することになる。
【００７０】
その後、制御手段２１は、各ドキュメント名毎の構成要素、構成要素ＩＤの一覧（挿入先要素一覧）を表示する（ステップＤ５）。この時点においては、入出力装置１の表示部には、挿入候補ファイル一覧と、挿入先要素一覧とが表示されている。
【００７１】
ユーザは、入出力装置１の表示部に、挿入候補ファイル一覧および挿入先要素一覧が表示されると、挿入候補ファイル一覧の中から挿入元にするファイルのファイル名を選択し、挿入先要素一覧の中から挿入先にする保守ドキュメントのドキュメント名と、追加構成要素の挿入位置と所定の位置関係を有する構成要素の構成要素ＩＤを選択する。なお、本実施の形態では、追加構成要素の挿入位置の直前に存在する構成要素の構成要素ＩＤを選択するものとする。
【００７２】
制御手段２１は、ユーザによって挿入先のドキュメント名及び構成要素ＩＤが選択されると、先ず、ＩＤ付与手段２５を利用してユーザによって選択された構成要素ＩＤの値をインクリメントした値を求める（図９のステップＥ１）。
【００７３】
その後、制御手段２１は、管理情報記憶部２７を検索し、ユーザが選択した挿入元ファイルのファイル名が登録されているエントリを探し出す。そして、探し出したエントリの項目「構成要素ＩＤ」に、ステップＥ１で求めた、インクリメントした構成要素ＩＤの値を設定する。更に、上記エントリの項目「ドキュメント名」にユーザが挿入先構成要素一覧を用いて選択したドキュメント名を設定する。その後、上記ドキュメント名に対応するドキュメントＩＤを管理情報記憶部２７から検索し、検索したドキュメントＩＤを上記エントリの項目「ドキュメントＩＤ」に設定する（ステップＥ２）。例えば、ユーザが、挿入候補ファイル一覧からファイル名Ｆ２を選択し、挿入先構成要素一覧からドキュメント名「Ｆ１の保守ドキュメント」、構成要素ＩＤ「Ｙ３」を選択したとすると、図２に示すように、管理情報記憶部２７のファイル名Ｆ２に対応するエントリに、構成要素ＩＤ「Ｙ４」、ドキュメントＩＤ「Ｘ１」、ドキュメント名「Ｆ１の保守ドキュメント」が設定される。なお、構成要素ＩＤ「Ｙ４」は、構成要素ＩＤ「Ｙ３」を所定値だけインクリメントすることにより生成されたものである。
【００７４】
その後、制御手段２１は、インクリメントした構成要素ＩＤの値「Ｙ４」と同じ値を持つ構成要素ＩＤが、ユーザが挿入先構成要素一覧を用いて選択したドキュメント名に対応付けて登録されているか否かを調べる（ステップＥ３）。
【００７５】
そして、そのような構成要素ＩＤが存在する場合（ステップＥ３がイエス）は、ＩＤ付与手段２５を利用して上記構成要素ＩＤの値「４」をインクリメントした値「５」を求め、求めた値「５」で置き換える（ステップＥ４）。
【００７６】
その後、ステップＥ３の判断結果がノーとなるまで、制御手段２１は、ステップＥ３、Ｅ４の処理を繰り返し行う。そして、ステップＥ３の判断結果がノーとなると、編集手段２６に対して、ユーザが挿入先構成要素一覧を用いて選択したドキュメント名を含むドキュメント表示要求を発行する。これにより、前述したステップＣ３〜Ｃ５と同様の処理が行われ、構成要素を追加した保守ドキュメントが表示される。
【００７７】
〔第１の実施の形態の効果〕
本実施の形態によれば、ユーザに負担をかけることなく、ソースコードから抽出したコメント文だけでなく、図やテキスト文も含んだ保守ドキュメントを作成することができるという効果を得ることができる。その理由は、ユーザによって構成要素を追加する保守ドキュメント及び追加構成要素（図やテキスト文など）の挿入位置と所定の位置関係を有する保守ドキュメント中の構成要素が指定されたとき、上記追加構成要素を含んだファイルのファイル名に対応付けて、上記保守ドキュメントのドキュメント名と、追加構成要素に対する構成要素ＩＤであってユーザによって指定された構成要素の構成要素ＩＤと所定の関係を有する構成要素ＩＤとを管理情報記憶部２７に登録すると共に、上記保守ドキュメントのドキュメント名に対応付けて管理情報記憶部２７に登録されている構成要素ＩＤの内の、追加構成要素の構成要素ＩＤが示している出現順と同じ出現順を示している構成要素ＩＤ及び追加構成要素の構成要素ＩＤが示している出現順よりも後の出現順を示している構成要素ＩＤを更新する制御手段２１を備えているからである。即ち、ユーザは、構成要素を追加する保守ドキュメント及び追加構成要素の挿入位置と所定の位置関係を有する保守ドキュメント中の構成要素を指定するだけで良く、従来の技術のように、挿入位置を示す数値をキーボードから入力したり、挿入位置を数値で表すとどうなるかを考えたりする必要がないので、ユーザの負担が軽減する。
【００７８】
〔第２の実施の形態〕
次に、本発明にかかる保守ドキュメント作成管理装置の第２の実施の形態について説明する。本実施の形態は、ユーザが、保守ドキュメントに含めたくない構成要素を容易に削除（非表示）できるようにしたことを特徴とする。
【００７９】
〔第２の実施の形態の構成の説明〕
図１０を参照すると、本実施の形態にかかる保守ドキュメント作成管理装置２ａは、制御手段２１の代わりに制御手段２１ａを備えている点、編集手段２６の代わりに編集手段２６ａを備えている点、および削除要素記憶部２９が追加されている点が図１に示した保守ドキュメント作成管理装置２と相違している。
【００８０】
削除要素記憶部２９には、構成要素を削除する保守ドキュメントのドキュメント名と、その保守ドキュメントにおいて削除する構成要素の構成要素ＩＤが対応付けて登録されている。図１１に削除要素記憶部２９の内容例を示す。同図に示す例は、ドキュメント名が「Ｆ１の保守ドキュメント」の保守ドキュメントから構成要素ＩＤが「Ｙ２」の構成要素を削除することを示している。
【００８１】
制御手段２１ａは、制御手段２１が備えている機能に加え、ユーザの指示に従って削除要素記憶部２９に、構成要素を削除する保守ドキュメントのドキュメント名と、削除する構成要素の構成要素ＩＤとを対応付けて登録する機能を有する。
【００８２】
編集手段２６ａは、制御手段２１ａからドキュメント名を含むドキュメント表示要求が入力されたとき、管理情報記憶部２７で上記ドキュメント名に対応付けて管理されている構成要素ＩＤから、削除要素記憶部２９で上記ドキュメント名に対応付けて管理されている構成要素ＩＤを除いたものを処理対象にして昇順にソートし、ソート後の構成要素ＩＤ群の先頭の構成要素ＩＤから順番に、その構成要素ＩＤに対応するコメント文或いはファイルの内容を順番につなぎ合わせる機能を有する。
【００８３】
本実施の形態の保守ドキュメント作成管理装置２ａもコンピュータによって実現可能なものであり、コンピュータによって実現する場合は、例えば次のようにする。コンピュータを保守ドキュメント作成管理装置２ａとして機能させるためのプログラムを記録したディスク、半導体メモリ、その他の記録媒体を用意し、コンピュータに上記プログラムを読み取らせる。コンピュータは、読み取ったプログラムに従って自身の動作を制御することにより、自コンピュータ上に、制御手段２１ａ、検索手段２２、登録手段２３、抽出手段２４、ＩＤ付与手段２５、編集手段２６ａを実現する。
【００８４】
〔第２の実施の形態の動作の説明〕
次に本実施の形態の動作について詳細に説明する。なお、削除要素記憶部２９へドキュメント名および構成要素ＩＤを登録する際の動作、および保守ドキュメントを表示する際の動作以外は、第１の実施の形態と同様であるので、ここでは説明を省略する。
【００８５】
〔削除要素記憶部への登録時の動作〕
先ず、削除要素記憶部２９にドキュメント名および構成要素ＩＤを登録する場合の動作について説明する。
【００８６】
ユーザは、削除要素記憶部２９へドキュメント名および構成要素ＩＤを登録する際、先ず、入出力装置１から削除構成要素登録要求を入力する。
【００８７】
保守ドキュメント作成管理装置２ａ内の制御手段２１ａは、削除構成要素登録要求が入力されると、図１２のフローチャートに示すように、管理情報記憶部２７に登録されているドキュメント名を全て取得し、その一覧を入出力装置１の表示部に表示する（ステップＦ１）。
【００８８】
ユーザは、ドキュメント名の一覧が表示されると、構成要素を削除する保守ドキュメントのドキュメント名を選択する。
【００８９】
制御手段２１は、ユーザによってドキュメント名が選択されると（ステップＦ２がイエス）、選択されたドキュメント名に対応付けて管理情報記憶部２７に登録されている全ての構成要素および構成要素ＩＤを取得し、その一覧を入出力装置１の表示部に表示する（ステップＦ３）。例えば、ユーザがドキュメント名「Ｆ１の保守ドキュメント」を選択し、管理情報記憶部２７の内容が図２に示すものであったとすると、制御手段２１ａは、構成要素「／＊関数のプロトタイプ宣言＊／」「／＊＊＊加算を実行し最後の結果を２乗する」「／＊＊＊加算結果が５以下であれば、ｉに１を加える。最後にｉを２乗する＊／」…、構成要素ＩＤ「Ｙ１」「Ｙ２」「Ｙ３」…を取得し、それらを一覧表示することになる。
【００９０】
ユーザは、構成要素および構成要素ＩＤの一覧が表示されると、削除する構成要素の構成要素ＩＤを選択する。
【００９１】
制御手段２１ａは、ユーザによって構成要素ＩＤが選択されると（ステップＦ４がイエス）、上記構成要素ＩＤと、ドキュメント名の一覧を用いてユーザが選択したドキュメント名とを対応付けて削除要素記憶部２９に登録する（ステップＦ６）。制御手段２１ａは、ユーザによって削除する構成要素の構成要素ＩＤが選択される毎に、上述した処理を行う。
【００９２】
ユーザは、削除する構成要素の構成要素ＩＤを全て削除要素記憶部２９に登録すると、入出力装置１から終了指示を入力する。制御手段２１ａは、終了指示が入力されると（ステップＦ５がイエス）、その処理を終了する。
【００９３】
〔保守ドキュメント表示時の動作〕
次に、保守ドキュメント表示時の動作を図１３のフローチャートを参照して説明する。
【００９４】
ユーザは、保守ドキュメントを表示させる場合は、まず入出力装置１から保守ドキュメント名の一覧表示要求を入力する。これにより、制御手段２１ａは、管理情報記憶部２７で管理されている全てのドキュメント名を取得し、それらを入出力装置１の表示部に一覧表示する（図１３のステップＧ１、Ｇ２）。
【００９５】
その後、ユーザは表示されたドキュメント名一覧の中から参照したい保守ドキュメントのドキュメント名を選択し、更に、入出力装置１から保守ドキュメント作成管理装置２ａに対してドキュメント表示要求を入力する。これにより、制御手段２１は、ユーザによって選択されたドキュメント名を含むドキュメント表示要求を編集手段２６ａに対して発行する。
【００９６】
これにより、編集手段２６ａは、管理情報記憶部２７から上記ドキュメント名に対応付けて登録されている構成要素ＩＤを全て取得する（ステップＧ３）。
【００９７】
その後、削除要素記憶部２９から上記ドキュメント名に対応付けて登録されている構成要素ＩＤを全て取得し（ステップＧ４）、ステップＧ３で取得した構成要素ＩＤからステップＧ４で取得した構成要素ＩＤを削除する（ステップＧ５）。次いで、編集手段２６ａは、残っている構成要素ＩＤを処理対象にして、構成要素ＩＤを昇順にソートする（ステップＧ６）。そして、最後に、編集手段２６は、ソート後の構成要素ＩＤ群の先頭の構成要素ＩＤから順番に、その構成要素ＩＤに対応する構成要素（コメント文或いはファイルの内容）を順番につなぎ合わせることにより、保守ドキュメントを作成し、作成した保守ドキュメントを制御手段２１ａに渡す。制御手段２１ａは、編集手段２６ａから渡された保守ドキュメントを入出力装置１の表示部に表示する（ステップＧ７）。
【００９８】
〔第２の実施の形態の効果〕
本実施の形態によれば、第１の実施の形態で得られる効果に加え、保守ドキュメントに含めたくない構成要素が存在した場合に、その構成要素を保守ドキュメントから削除することが可能となり、より自由な保守ドキュメントの構成が可能になるという効果を得ることができる。その理由は、ドキュメント名と、そのドキュメント名の保守ドキュメントにおいて非表示にする構成要素の構成要素ＩＤとが登録された削除要素記憶部２９と、ユーザによって表示する保守ドキュメントのドキュメント名が指定されたとき、管理情報記憶部２７に上記ドキュメント名に対応付けて登録されているコメント文および上記ドキュメント名に対応付けてファイル名が登録されているファイル中の追加構成要素の内の、削除要素記憶部２９に構成要素ＩＤが登録されていないものを、それに付されている構成要素ＩＤによって示される順番で表示する編集手段２６ａを備えているからである。
【産業上の利用可能性】
【００９９】
本発明は、ソースコードから保守ドキュメントを作成すると共に、保守ドキュメントに対して図やテキスト文を追加することができる保守ドキュメント作成管理装置に適用できる。
【図面の簡単な説明】
【０１００】
【図１】本発明にかかる保守ドキュメント作成管理装置の第１の実施の形態の構成例を示すブロック図である。
【図２】管理情報記憶部２７の内容例を示す図である。
【図３】ソースコードの一例を示す図である。
【図４】ファイル登録時の処理例を示すフローチャートである。
【図５】ファイル登録時の処理例を示すフローチャートである。
【図６】追加構成要素の一例を示す図である。
【図７】保守ドキュメント表示時の処理例を示すフローチャートである。
【図８】追加構成要素追加時の処理例を示すフローチャートである。
【図９】追加構成要素追加時の処理例を示すフローチャートである。
【図１０】本発明にかかる保守ドキュメント作成管理装置の第２の実施の形態の構成例を示すフローチャートである。
【図１１】削除要素記憶部２９の内容例を示す図である。
【図１２】削除要素記憶部２９への登録時の処理例を示すフローチャートである。
【図１３】保守ドキュメント表示時の処理例を示すフローチャートである。
【符号の説明】
【０１０１】
１…入出力装置
２、２ａ…保守ドキュメント作成管理装置
２１、２１ａ…制御手段
２２…検索手段
２３…登録手段
２４…抽出手段
２５…ＩＤ付与手段
２６、２６ａ…編集手段
２７…管理情報記憶部
２８…ファイル格納部
２９…削除要素記憶部
【図１】
2007213195.tif 000003
【図２】
2007213195.tif 000004
【図３】
2007213195.tif 000005
【図４】
2007213195.tif 000006
【図５】
2007213195.tif 000007
【図６】
2007213195.tif 000008
【図７】
2007213195.tif 000009
【図８】
2007213195.tif 000010
【図９】
2007213195.tif 000011
【図１０】
2007213195.tif 000012
【図１１】
2007213195.tif 000013
【図１２】
2007213195.tif 000014
【図１３】
2007213195.tif 000015