JavaプログラミングでのJavaDocと同等なC++における機能としてDoxygen がある。
Doxygenをeclipse開発環境から使うためのプラグインがeclox

以下のページを参考にした。
(1)Monoistの 生産性向上への道 Eclipseで行うC/C++開発(4) ページ
(2)Kitsugi's Blog のページ
(3)株式会社ライトライト のページ

1. doxygenのインストール
 (1)ubuntuソフトウェアセンターを使ってもインストール出来るけど、以下のコマンドラインで。
  $ sudo apt-get install doxygen

2. ecloxのインストール
 (1)eclipseを起動し、「ヘルプ」→「新規ソフトウェアのインストー\\
ル...」
 (2)「追加」をクリックすると、「リポジトリーの追加」ダイアログ
 (3) このダイアログで以下を入力(名前は何でも良い)
   名前    eclox 
   ロケーション http://download.gna.org/eclox/update
  「OK」をクリック
 (4)名前欄にecloxと表示されので、チェックボックスをチェックし、「次に」
 (5)インストール詳細にEcloxとEclox Hotが表示されいるので、「次に」
 (6)ライセンスのレビュー画面で「使用条件の条項に同意します」をチェック、「完了」
 (7)セキリティー警告が表示されるが、「OK」で続行。
 (8)Eclipseを再起動。
  「ファイル」→「新規」→「その他...」で新規ウィザード上で「その他」を展開し、Doxyfile があればインストール成功。

3. 使い方
 ・上記URLの(1)を参考に、サンプルプログラムを作りながらコメントを入れて勉強中。
 ・使い方のポイント等がまとまれば、またここに書こう。