[openrtm-staff:786] Re: OpenRTM-aist-Javaのドキュメントビルドエラーについて

2017年 7月 26日 (水) 17:29:15 JST

河内様

片見です。

> ドキュメントのトップページでは　OpenRTM-aist-Java 1.2.0と表示されます。
> バージョン番号はbuild.xmlで管理しているものと思い、ここだけを修正して
> おりましたが、下記ファイルもあるのですね。

build.xmlのバージョンが
Version.javaに反映されるようにしました。
ビルド時に
build.xmlの
version と target.name を
Version.javaに反映させます。
実際には
Version.java.inファイルを追加して
idlコンパイルの前で
sedで文字列を置き換えています。

よろしくお願いいたします。

________________________________________
差出人: openrtm-staff <openrtm-staff-bounces ＠ openrtm.org> が 河内 のぶ <n-kawauchi ＠ openrtm.org> の代理で送信
送信日時: 2017年7月26日 11:04
宛先: openrtm-staff
件名: [openrtm-staff:783] Re:     OpenRTM-aist-Javaのドキュメントビルドエラーについて

片見様

河内です

実はまた発生したので調べていたところでした。

JenkinsのVM環境はUbuntu16.04で新しくする予定で、このバージョンでは
発生しないのですが、Fedora25では発生します。

この２つの環境のantとJavaは同じバージョンです。
ant    1.9.6
OpenJDK  1.8.0_131

buildRTC.shの実行結果は異なります。

●Ubuntu16.04
-----
  [javadoc] Registered Taglet EnOnTaglet ...
  [javadoc] Registered Taglet JaOffTaglet ...
  [javadoc] Standard Doclet version 1.8.0_131
  [javadoc] Building tree for all the packages and classes...
  [javadoc] Building index for all the packages and classes...
  [javadoc] Building index for all classes...

BUILD SUCCESSFUL
-----

●Fedora25
-----
  [javadoc] Registered Taglet EnOnTaglet ...
  [javadoc] Registered Taglet JaOffTaglet ...
  [javadoc] Standard Doclet version 1.8.0_131
  [javadoc] Building tree for all the packages and classes...
  [javadoc] /home/openrtm/src/OpenRTM-aist-Java/jp.go.aist.rtm.RTC/src/jp/go/aist/rtm/Constants.java:4:
エラー: @の後にタグ名がありません
  [javadoc]  * {@.ja sun-orb 用の定数}
        :
  [javadoc] 100 errors
  [javadoc] 100 warnings

BUILD SUCCESSFUL
-----

Fedoraはエラーとなっていますが、ドキュメントは生成されており、
ブラウザでも確認できます。
OpenRTM-aist-Java/jp.go.aist.rtm.RTC/docs/JavaDoc/index.html

ドキュメントページの左下段がすべてのクラスの一覧になっています。
ここから上のエラーの「Constants」を開き、UbuntuとFedoraを
見比べても違いがありません。エラーがどこに影響しているのかが
一見して分かっておりません。

また、この「Constants」クラスのページに「定数フィールド値」の
リンクがあるので、これをクリックしてみたら、バージョン番号が
1.1.0の古いままで表示されました。画像を添付します。

ドキュメントのトップページでは　OpenRTM-aist-Java 1.2.0と表示されます。
バージョン番号はbuild.xmlで管理しているものと思い、ここだけを修正して
おりましたが、下記ファイルもあるのですね。
バージョン番号は一元管理したいところですが、下記は直書きするしかない
でしょうか。
http://svn.openrtm.org/OpenRTM-aist-Java/trunk/OpenRTM-aist-Java/jp.go.aist.rtm.RTC/src/jp/go/aist/rtm/Version.java
http://svn.openrtm.org/OpenRTM-aist-Java/trunk/OpenRTM-aist-Java/jp.go.aist.rtm.RTC/tests/src/jp/go/aist/rtm/RTC/ConfigAdminTest.java

下記ファイルは1.1.0のテスト用ということで修正しなくてもよいのでしょうか？
http://svn.openrtm.org/OpenRTM-aist-Java/trunk/OpenRTM-aist-Java/jp.go.aist.rtm.RTC/tests/src/jp/go/aist/rtm/AllTest110.java

以上、よろしくお願いいたします。


2017年7月26日 9:58 片見剛人 <t-katami ＠ aist.go.jp>:
> 河内様
>
> 片見です。
>
> お疲れ様です。
> とりあえず、解決ということで、
> よろしいでしょうか？
> また、発生しましたら、
> ご連絡をお願いします。
>
> 参考までに、、、
> 関数ヘッダコメントやクラスヘッダコメントでは
> 「@.ja」「@.ne」という独自タグを使用しています。
> それをjavadocに解釈させるために
> Taglet  を使ってを「@.ja」「@.ne」を登録しています。
> 以下の行がそれです。
>   [javadoc] Registered Taglet EnOnTaglet ...
>   [javadoc] Registered Taglet JaOffTaglet ...
> これで、javadocが「@.ja」「@.ne」タグを解釈できるようになります。
> これがうまくいっていないと、
> javadocが「@.ja」「@.ne」を解釈できず、
> 「エラー: @の後にタグ名がありません」という
> エラーが発生します。
>
> よろしくお願いします。
>
> ________________________________________
> 差出人: openrtm-staff <openrtm-staff-bounces ＠ openrtm.org> が 河内 のぶ <n-kawauchi ＠ openrtm.org> の代理で送信
> 送信日時: 2017年7月24日 18:11:24
> 宛先: openrtm-staff
> 件名: [openrtm-staff:771] Re:     OpenRTM-aist-Javaのドキュメントビルドエラーについて
>
> 片見様
>
> 河内です
>
> この件ですが、私の環境で、Ubuntu16.04のほとんど何もインストールして
> いないスナップショットへ戻し、一括インストールスクリプトで環境を整えた後、
> Javaのソースビルドを実行してみたところ、errorはもちろんwarningも出ない
> ことを確認しました。
> お騒がせいたしました。(^^;
>
> やはり現在のJenkins VM環境がUbuntu12.04ということが影響していると
> 思えます。
>
> 私の環境では、branches/RELENG_1_2/OpenRTM-aist-Java　の最新ソースを
> チェックアウトし、debパッケージの作成までOKを確認できました。
>
> 以上、よろしくお願いいたします。
>
> 2017年7月24日 14:58 河内 のぶ <n-kawauchi ＠ openrtm.org>:
>> 片見様
>>
>> 河内です
>>
>>  [javadoc]のビルドについて確認させて下さい。
>> branches/RELENG_1_2のソースを使ってビルドしていますが、
>> trunkのr960をマージしたところからエラーが発生するように
>> なりました。
>>
>> branchesのr958のビルドでは以下のようにwarningが１つです。
>> http://openrtm.org:8080/view/02_Java/job/01_openrtm-java-build-branches/61/consoleFull
>>　　 ↓
>>  [javadoc] 1 warning
>>
>> ところがtrunkのr960をマージしたところ、エラーもwarningも
>> 100を超えています。
>> http://openrtm.org:8080/view/02_Java/job/01_openrtm-java-build-branches/62/console
>>　　 ↓
>> [javadoc] 100 errors
>> [javadoc] 100 warnings
>>
>> エラーで指摘されているのはコメント文のようです。
>>
>> -----
>>  [javadoc] /tmp/workspace/01_openrtm-java-build-branches/jp.go.aist.rtm.RTC/src/jp/go/aist/rtm/Constants.java:4:
>> エラー: @の後にタグ名がありません
>>   [javadoc]  * {@.ja sun-orb 用の定数}
>>
>>   [javadoc] /tmp/workspace/01_openrtm-java-build-branches/jp.go.aist.rtm.RTC/src/jp/go/aist/rtm/Constants.java:5:
>> エラー: @の後にタグ名がありません
>>   [javadoc]  * {@.en Constants for sun-orb}
>> -----
>>
>> ワークスペースから生成されたdocをダウンロードしてブラウザで
>> ざっと確認してみましたが、表示がおかしい部分は見つけられませんでした。
>>
>> お手数をおかけいたしますが、よろしくお願いいたします。
>>
>> --
>> ------------------------------------------------------------------------
>> 河内 のぶ        n-kawauchi ＠ openrtm.org
>
>
>
> --
> ------------------------------------------------------------------------
> 河内 のぶ        n-kawauchi ＠ openrtm.org
> _______________________________________________
> openrtm-staff mailing list
> openrtm-staff ＠ openrtm.org
> http://www.openrtm.org/mailman/listinfo/openrtm-staff
> _______________________________________________
> openrtm-staff mailing list
> openrtm-staff ＠ openrtm.org
> http://www.openrtm.org/mailman/listinfo/openrtm-staff


--
------------------------------------------------------------------------
河内 のぶ        n-kawauchi ＠ openrtm.org