Wed, 17 Apr 2013 15:54:24 +0200
8008174: DocTree API should provide start and end positions for tree nodes
Summary: Adding DocSourcePositions to allow access to DocTree starting/ending position
Reviewed-by: jjg, darcy
Contributed-by: Ralph Benjamin Ruijs <ralphbenjamin@netbeans.org>, Jan Lahoda <jlahoda@netbeans.org>
aoqi@0 | 1 | valid: |
aoqi@0 | 2 | DOC_COMMENT:First sentence. |
aoqi@0 | 3 | * |
aoqi@0 | 4 | * <p>Description with {@link java.io.InputStream link} |
aoqi@0 | 5 | * |
aoqi@0 | 6 | * @param first description |
aoqi@0 | 7 | * @param second description |
aoqi@0 | 8 | * @return whatever |
aoqi@0 | 9 | * @throws IllegalStateException why? |
aoqi@0 | 10 | * @since 1.15 |
aoqi@0 | 11 | * @see java.util.List |
aoqi@0 | 12 | TEXT:First sentence. |
aoqi@0 | 13 | START_ELEMENT:<p> |
aoqi@0 | 14 | TEXT:Description with!trailing-whitespace! |
aoqi@0 | 15 | LINK:{@link java.io.InputStream link} |
aoqi@0 | 16 | REFERENCE:java.io.InputStream |
aoqi@0 | 17 | TEXT:link |
aoqi@0 | 18 | PARAM:@param first description |
aoqi@0 | 19 | IDENTIFIER:first |
aoqi@0 | 20 | TEXT:description |
aoqi@0 | 21 | PARAM:@param second description |
aoqi@0 | 22 | IDENTIFIER:second |
aoqi@0 | 23 | TEXT:description |
aoqi@0 | 24 | RETURN:@return whatever |
aoqi@0 | 25 | TEXT:whatever |
aoqi@0 | 26 | THROWS:@throws IllegalStateException why? |
aoqi@0 | 27 | REFERENCE:IllegalStateException |
aoqi@0 | 28 | TEXT:why? |
aoqi@0 | 29 | SINCE:@since 1.15 |
aoqi@0 | 30 | TEXT:1.15 |
aoqi@0 | 31 | SEE:@see java.util.List |
aoqi@0 | 32 | REFERENCE:java.util.List |
aoqi@0 | 33 | erroneous: |
aoqi@0 | 34 | DOC_COMMENT:First sentence. |
aoqi@0 | 35 | * |
aoqi@0 | 36 | * <p>Description with {@link}, {@link java.util.List}, {@link |
aoqi@0 | 37 | * |
aoqi@0 | 38 | * @param |
aoqi@0 | 39 | * @param second |
aoqi@0 | 40 | * @return |
aoqi@0 | 41 | * @throws |
aoqi@0 | 42 | * @throws IllegalStateException |
aoqi@0 | 43 | * @since |
aoqi@0 | 44 | * @see |
aoqi@0 | 45 | TEXT:First sentence. |
aoqi@0 | 46 | START_ELEMENT:<p> |
aoqi@0 | 47 | TEXT:Description with!trailing-whitespace! |
aoqi@0 | 48 | LINK:{@link} |
aoqi@0 | 49 | TEXT:,!trailing-whitespace! |
aoqi@0 | 50 | LINK:{@link java.util.List} |
aoqi@0 | 51 | REFERENCE:java.util.List |
aoqi@0 | 52 | TEXT:,!trailing-whitespace! |
aoqi@0 | 53 | ERRONEOUS:{@link |
aoqi@0 | 54 | ERRONEOUS:@param |
aoqi@0 | 55 | PARAM:@param second |
aoqi@0 | 56 | IDENTIFIER:second |
aoqi@0 | 57 | RETURN:@return |
aoqi@0 | 58 | ERRONEOUS:@throws |
aoqi@0 | 59 | THROWS:@throws IllegalStateException |
aoqi@0 | 60 | REFERENCE:IllegalStateException |
aoqi@0 | 61 | SINCE:@since |
aoqi@0 | 62 | ERRONEOUS:@see |
aoqi@0 | 63 | withWhiteSpaces: |
aoqi@0 | 64 | DOC_COMMENT:First sentence. |
aoqi@0 | 65 | * |
aoqi@0 | 66 | * <p>Description with {@link }, {@link java.util.List#add( int )}, |
aoqi@0 | 67 | * {@link java.util.List#add( int ) some text with whitespaces}, {@link |
aoqi@0 | 68 | * |
aoqi@0 | 69 | * @param first |
aoqi@0 | 70 | * @param second some text with trailing whitespace |
aoqi@0 | 71 | * @return some return |
aoqi@0 | 72 | * @throws java.lang.IllegalStateException |
aoqi@0 | 73 | * @throws java.lang.IllegalStateException some text |
aoqi@0 | 74 | TEXT:First sentence. |
aoqi@0 | 75 | START_ELEMENT:<p> |
aoqi@0 | 76 | TEXT:Description with!trailing-whitespace! |
aoqi@0 | 77 | LINK:{@link } |
aoqi@0 | 78 | TEXT:,!trailing-whitespace! |
aoqi@0 | 79 | LINK:{@link java.util.List#add( int )} |
aoqi@0 | 80 | REFERENCE:java.util.List#add( int ) |
aoqi@0 | 81 | TEXT:, |
aoqi@0 | 82 | *!trailing-whitespace! |
aoqi@0 | 83 | LINK:{@link java.util.List#add( int ) some text with whitespaces} |
aoqi@0 | 84 | REFERENCE:java.util.List#add( int ) |
aoqi@0 | 85 | TEXT:some text with whitespaces |
aoqi@0 | 86 | TEXT:,!trailing-whitespace! |
aoqi@0 | 87 | ERRONEOUS:{@link |
aoqi@0 | 88 | PARAM:@param first |
aoqi@0 | 89 | IDENTIFIER:first |
aoqi@0 | 90 | PARAM:@param second some text with trailing whitespace |
aoqi@0 | 91 | IDENTIFIER:second |
aoqi@0 | 92 | TEXT:some text with trailing whitespace |
aoqi@0 | 93 | RETURN:@return some return |
aoqi@0 | 94 | TEXT:some return |
aoqi@0 | 95 | THROWS:@throws java.lang.IllegalStateException |
aoqi@0 | 96 | REFERENCE:java.lang.IllegalStateException |
aoqi@0 | 97 | THROWS:@throws java.lang.IllegalStateException some text |
aoqi@0 | 98 | REFERENCE:java.lang.IllegalStateException |
aoqi@0 | 99 | TEXT:some text |