要約Javadocがありませんというエラーについて

Question

最近javaを学び始めたものです。
CheckStyle(Google Checks)を用いながらソースコードを書いているのですが、Javadocに関する以下の2つのエラーを解決出来なくて悩んでます。
調べても解決方法が分かりませんでした。

①要約javadocがありません。

getterメソッドを記述し、Javadocを挿入したのですが、
「要約javadocがありません。」
というCheckStyleのエラーが出ます。
以下がソースコードになります。

該当のソースコード

    /**
     * 名前を返します。
     * @return name 名前.
     * 
     */
    public String getName() {
        return this.name;
    }

試したこと

「名前を返します。」という要約文を入れたつもりなのですが、このようなエラーが出ます。
要約javadocとは一体何なのでしょうか。調べても出てこず、手詰まり状態になっています。

②javadocの最初の文には終了時がありません。

以下のソースコードを書きましたが、「javadocの最初の文には終了時がありません。」　というCheckStyleエラー文が出ます。　

該当のソースコード

    /**
     *名前をセットする。
     *@param newName セットする名前
     **/
    public void setName(String newName) {
        if (newName.length() < 3) {
            throw new IllegalArgumentException("名前が不正です");
        }
        this.name = newName;
    }

試したこと

「名前をセットする。」の「。」によって、最初の文を終了させたつもりです。
他には「名前をセットする.」という記載も行いましたが、同様のエラーが出ます。
私は見当違いな対処を行っているのでしょうか。

Comments

[y_waiwai]

エラーメッセージは勝手な要約、翻訳せず、そのままの形で提示しましょう

[yajata]

すいません。一応このメッセージが原文ママになっております。

[退会済みユーザー]

CheckStyle の日本語対応がされてないだけかと

（プレアデスで表示を日本語にしてるってことじゃないよ）

1行目が . で終わる文であること（タグ除く）だとおもったが

Answer 1

要約javadocとは一体何なのでしょうか

Summary Javadoc の和訳かと思います。

対応としては、

「名前を返します。」という要約文を入れたつもり

上記で、「javadocの最初の文には終了時がありません。」が出る以外は問題ないと思います。

私は見当違いな対処を行っているのでしょうか。

合っていると思います。あわてず確認してみてください。
原文は

period symbol at the end of first javadoc sentence

だと思いますが、eclipseのデフォルト設定だと「javadocの最初の文には終了時がありません。」となってますね。

periodの設定を変更していなければ、半角の.なので、

/**
  * 名前をセットする.
  * @param newName セットする名前
  **/

であれば、警告でないと思います。（少なくとも私の環境ではでない）

Comments

[yajata]

なんとか解決しました。本当にありがとうございました。