エンベデッドシステムスペシャリスト試験 令和4年度 秋期 午前II 問24

【正解】イ

ドキュメンテーションジェネレーターは、ソースコードに所定の書式で記述されたコメント、関数名、引数、戻り値、クラス構造などを解析し、API仕様書や設計資料を自動生成するツールです。例えば、関数の直前に目的や引数の説明を決められた形式で書けば、HTMLなどの読みやすい文書にまとめられます。ソースコードと文書の対応を保ちやすく、文書作成と更新の負担を軽減できるため、イが正解です。

アの説明は誤りです。これはHTMLやCSSを解釈し、画面を描画するWebブラウザ又はレンダリングエンジンの説明です。文書をソースコードから生成する機能ではありません。 ウの説明は誤りです。これはテンプレートへデータを埋め込み、動的なWebページなどを生成するテンプレートエンジンの説明です。入力データに応じた表示内容の生成が目的です。 エの説明は誤りです。これは構造をマーク付けした文書から印刷用の体裁を整える組版ソフトウェア又は文書整形システムの説明です。代表例にはTeXなどがあり、プログラムのコメントからAPI文書を抽出するものではありません。

【ポイント】 代表的なドキュメンテーションジェネレーターには、CやC++などで使われるDoxygen、Javaで使われるJavadocがあります。 決められたコメント形式を守ることで、コード変更に合わせて文書を再生成し、仕様書との不一致を減らせます。 試験では、ブラウザ、テンプレートエンジン、組版ソフトウェアとの目的の違いを整理してください。