mavenでxxx-source.jarを生成する方法。
試験管の中のコードさんの記事参照。

ここで書かれているpom.xmlは若干間違っているので注意。
実際にpom.xmlに追加するのは

  <build>
    <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-source-plugin</artifactId>
      <executions>
        <execution>
        <phase>package</phase>
          <goals>
            <goal>jar</goal>
          </goals>
        </execution>
      </executions>
    </plugin>
    </plugins>
  </build>

となる。
こうしておくと、

> mvn install

でxxx-source.jarもローカルリポジトリに登録される。

mavenでxxx-source.jarをリポジトリに登録しておくと、maven eclipse pluginを利用し、

> mvn -DdownloadSources eclipse:eclipse

としてEclipseの.projectファイルを生成した際に、ライブラリに対してソースファイルを紐付けてくれるのが非常に便利だ。

今回この方法を調べたのも、Apache CocoonのVlocityGeneratorをEclipseのデバッガで追いかける際にソースの紐付けが必要となったからなのだ。手動でやってもよかったのだが、mavenベースでビルド環境ができているので、できるだけmavenでやってみたかった。
なお、Apache Cocoonのpom.xmlには上記のmaven-source-pluginの設定はされていないので、各自で設定する必要があるので注意。すでにmavenのセントラルリポジトリにあがっているものに関してはsourceもあがっているはずなので、pom.xmlを修正する必要があるのは私のようにSubversionにのみ上がっているソースを触る場合だ。