View Javadoc
1   /*xml
2   <module name="Checker">
3     <module name="TreeWalker">
4       <module name="JavadocStyle"/>
5     </module>
6   </module>
7   */
8   package com.puppycrawl.tools.checkstyle.checks.javadoc.javadocstyle;
9   
10  // xdoc section -- start
11  /**
12   * Some description here
13   */
14  public class Example1 {
15    Example1() {
16      // violation 5 lines above 'First sentence should end with a period'
17    }
18    /**
19     * Some description here.
20     */
21    private void testMethod1() {}
22    // ok below, @return tag automatically inserts a period after the text
23    /**
24     * {@return {@code true} if this object
25     * has been initialized, {@code false} otherwise}
26     */
27    private boolean testMethod2() {
28      return true;
29    }
30    /**
31     * Some description here
32     */
33    private void testMethod3() {
34      // violation 4 lines above 'First sentence should end with a period'
35    }
36    /**
37     * Some description here
38     */
39    public void testMethod4() {
40      // violation 4 lines above 'First sentence should end with a period'
41    }
42    /**
43     * Some description here
44     * Second line of description
45     */
46    private void testMethod5() {
47      // violation 5 lines above 'First sentence should end with a period'
48    }
49    /**
50     * Some description here
51     * <p
52     */
53    private void testMethod6() { // violation 4 lines above 'should end with a period'
54      // violation 3 lines above 'Incomplete HTML tag found'
55    }
56  }
57  // xdoc section -- end