Merge
This commit is contained in:
commit
c4cbd8f70c
@ -60,7 +60,7 @@ import com.sun.tools.javac.comp.Env;
|
||||
import com.sun.tools.javac.comp.MemberEnter;
|
||||
import com.sun.tools.javac.comp.Resolve;
|
||||
import com.sun.tools.javac.model.JavacElements;
|
||||
import com.sun.tools.javac.parser.EndPosTable;
|
||||
import com.sun.tools.javac.tree.EndPosTable;
|
||||
import com.sun.tools.javac.processing.JavacProcessingEnvironment;
|
||||
import com.sun.tools.javac.tree.JCTree;
|
||||
import com.sun.tools.javac.tree.JCTree.*;
|
||||
@ -240,10 +240,11 @@ public class JavacTrees extends Trees {
|
||||
|
||||
public String getDocComment(TreePath path) {
|
||||
CompilationUnitTree t = path.getCompilationUnit();
|
||||
if (t instanceof JCTree.JCCompilationUnit) {
|
||||
Tree leaf = path.getLeaf();
|
||||
if (t instanceof JCTree.JCCompilationUnit && leaf instanceof JCTree) {
|
||||
JCCompilationUnit cu = (JCCompilationUnit) t;
|
||||
if (cu.docComments != null) {
|
||||
return cu.docComments.get(path.getLeaf());
|
||||
return cu.docComments.getCommentText((JCTree) leaf);
|
||||
}
|
||||
}
|
||||
return null;
|
||||
|
@ -1,5 +1,5 @@
|
||||
/*
|
||||
* Copyright (c) 1999, 2011, Oracle and/or its affiliates. All rights reserved.
|
||||
* Copyright (c) 1999, 2012, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
@ -312,7 +312,7 @@ public class Enter extends JCTree.Visitor {
|
||||
tree.packge);
|
||||
if (addEnv || (tree0.packageAnnotations.isEmpty() &&
|
||||
tree.docComments != null &&
|
||||
tree.docComments.get(tree) != null)) {
|
||||
tree.docComments.hasComment(tree))) {
|
||||
typeEnvs.put(tree.packge, topEnv);
|
||||
}
|
||||
}
|
||||
|
@ -1,5 +1,5 @@
|
||||
/*
|
||||
* Copyright (c) 1999, 2011, Oracle and/or its affiliates. All rights reserved.
|
||||
* Copyright (c) 1999, 2012, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
@ -40,7 +40,7 @@ import com.sun.tools.javac.tree.JCTree.*;
|
||||
import com.sun.tools.javac.code.Type.*;
|
||||
|
||||
import com.sun.tools.javac.jvm.Target;
|
||||
import com.sun.tools.javac.parser.EndPosTable;
|
||||
import com.sun.tools.javac.tree.EndPosTable;
|
||||
|
||||
import static com.sun.tools.javac.code.Flags.*;
|
||||
import static com.sun.tools.javac.code.Flags.BLOCK;
|
||||
|
@ -36,6 +36,7 @@ import java.util.ArrayList;
|
||||
import java.util.Arrays;
|
||||
import java.util.Calendar;
|
||||
import java.util.Collections;
|
||||
import java.util.LinkedHashMap;
|
||||
import java.util.HashMap;
|
||||
import java.util.HashSet;
|
||||
import java.util.List;
|
||||
@ -284,7 +285,7 @@ public class ZipFileIndex {
|
||||
try {
|
||||
checkIndex();
|
||||
if (allDirs == Collections.EMPTY_SET) {
|
||||
allDirs = new HashSet<RelativeDirectory>(directories.keySet());
|
||||
allDirs = new java.util.LinkedHashSet<RelativeDirectory>(directories.keySet());
|
||||
}
|
||||
|
||||
return allDirs;
|
||||
@ -572,7 +573,7 @@ public class ZipFileIndex {
|
||||
|
||||
// Add each of the files
|
||||
if (entryCount > 0) {
|
||||
directories = new HashMap<RelativeDirectory, DirectoryEntry>();
|
||||
directories = new LinkedHashMap<RelativeDirectory, DirectoryEntry>();
|
||||
ArrayList<Entry> entryList = new ArrayList<Entry>();
|
||||
int pos = 2;
|
||||
for (int i = 0; i < entryCount; i++) {
|
||||
@ -867,7 +868,7 @@ public class ZipFileIndex {
|
||||
if (zipFile.lastModified() != fileStamp) {
|
||||
ret = false;
|
||||
} else {
|
||||
directories = new HashMap<RelativeDirectory, DirectoryEntry>();
|
||||
directories = new LinkedHashMap<RelativeDirectory, DirectoryEntry>();
|
||||
int numDirs = raf.readInt();
|
||||
for (int nDirs = 0; nDirs < numDirs; nDirs++) {
|
||||
int dirNameBytesLen = raf.readInt();
|
||||
|
@ -1,5 +1,5 @@
|
||||
/*
|
||||
* Copyright (c) 2001, 2011, Oracle and/or its affiliates. All rights reserved.
|
||||
* Copyright (c) 2001, 2012, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
@ -31,7 +31,7 @@ import com.sun.tools.javac.tree.*;
|
||||
import com.sun.tools.javac.util.*;
|
||||
import com.sun.tools.javac.util.List;
|
||||
import com.sun.tools.javac.tree.JCTree.*;
|
||||
import com.sun.tools.javac.parser.EndPosTable;
|
||||
import com.sun.tools.javac.tree.EndPosTable;
|
||||
|
||||
/** This class contains the CharacterRangeTable for some method
|
||||
* and the hashtable for mapping trees or lists of trees to their
|
||||
|
@ -1,5 +1,5 @@
|
||||
/*
|
||||
* Copyright (c) 1999, 2011, Oracle and/or its affiliates. All rights reserved.
|
||||
* Copyright (c) 1999, 2012, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
@ -37,7 +37,7 @@ import com.sun.tools.javac.code.Symbol.*;
|
||||
import com.sun.tools.javac.code.Type.*;
|
||||
import com.sun.tools.javac.jvm.Code.*;
|
||||
import com.sun.tools.javac.jvm.Items.*;
|
||||
import com.sun.tools.javac.parser.EndPosTable;
|
||||
import com.sun.tools.javac.tree.EndPosTable;
|
||||
import com.sun.tools.javac.tree.JCTree.*;
|
||||
|
||||
import static com.sun.tools.javac.code.Flags.*;
|
||||
|
@ -1,5 +1,5 @@
|
||||
/*
|
||||
* Copyright (c) 2005, 2011, Oracle and/or its affiliates. All rights reserved.
|
||||
* Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
@ -28,11 +28,14 @@ package com.sun.tools.javac.model;
|
||||
import java.lang.annotation.Annotation;
|
||||
import java.lang.annotation.Inherited;
|
||||
import java.util.Map;
|
||||
|
||||
import javax.lang.model.SourceVersion;
|
||||
import javax.lang.model.element.*;
|
||||
import javax.lang.model.type.DeclaredType;
|
||||
import javax.lang.model.util.Elements;
|
||||
import javax.tools.JavaFileObject;
|
||||
import static javax.lang.model.util.ElementFilter.methodsIn;
|
||||
|
||||
import com.sun.tools.javac.code.*;
|
||||
import com.sun.tools.javac.code.Symbol.*;
|
||||
import com.sun.tools.javac.code.TypeTags;
|
||||
@ -47,9 +50,7 @@ import com.sun.tools.javac.tree.TreeInfo;
|
||||
import com.sun.tools.javac.tree.TreeScanner;
|
||||
import com.sun.tools.javac.util.*;
|
||||
import com.sun.tools.javac.util.Name;
|
||||
|
||||
import static com.sun.tools.javac.tree.JCTree.Tag.*;
|
||||
import static javax.lang.model.util.ElementFilter.methodsIn;
|
||||
|
||||
/**
|
||||
* Utility methods for operating on program elements.
|
||||
@ -361,7 +362,7 @@ public class JavacElements implements Elements {
|
||||
JCCompilationUnit toplevel = treeTop.snd;
|
||||
if (toplevel.docComments == null)
|
||||
return null;
|
||||
return toplevel.docComments.get(tree);
|
||||
return toplevel.docComments.getCommentText(tree);
|
||||
}
|
||||
|
||||
public PackageElement getPackageOf(Element e) {
|
||||
|
@ -1,5 +1,5 @@
|
||||
/*
|
||||
* Copyright (c) 1999, 2011, Oracle and/or its affiliates. All rights reserved.
|
||||
* Copyright (c) 1999, 2012, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
@ -571,7 +571,7 @@ public class JavaTokenizer {
|
||||
reader.scanCommentChar();
|
||||
} while (reader.ch != CR && reader.ch != LF && reader.bp < reader.buflen);
|
||||
if (reader.bp < reader.buflen) {
|
||||
comments = addDocReader(comments, processComment(pos, reader.bp, CommentStyle.LINE));
|
||||
comments = addComment(comments, processComment(pos, reader.bp, CommentStyle.LINE));
|
||||
}
|
||||
break;
|
||||
} else if (reader.ch == '*') {
|
||||
@ -597,7 +597,7 @@ public class JavaTokenizer {
|
||||
}
|
||||
if (reader.ch == '/') {
|
||||
reader.scanChar();
|
||||
comments = addDocReader(comments, processComment(pos, reader.bp, style));
|
||||
comments = addComment(comments, processComment(pos, reader.bp, style));
|
||||
break;
|
||||
} else {
|
||||
lexError(pos, "unclosed.comment");
|
||||
@ -693,10 +693,10 @@ public class JavaTokenizer {
|
||||
}
|
||||
}
|
||||
//where
|
||||
List<Comment> addDocReader(List<Comment> docReaders, Comment docReader) {
|
||||
return docReaders == null ?
|
||||
List.of(docReader) :
|
||||
docReaders.prepend(docReader);
|
||||
List<Comment> addComment(List<Comment> comments, Comment comment) {
|
||||
return comments == null ?
|
||||
List.of(comment) :
|
||||
comments.prepend(comment);
|
||||
}
|
||||
|
||||
/** Return the position where a lexical error occurred;
|
||||
@ -780,6 +780,10 @@ public class JavaTokenizer {
|
||||
return null;
|
||||
}
|
||||
|
||||
public int getSourcePos(int pos) {
|
||||
return -1;
|
||||
}
|
||||
|
||||
public CommentStyle getStyle() {
|
||||
return cs;
|
||||
}
|
||||
|
@ -117,7 +117,7 @@ public class JavacParser implements Parser {
|
||||
this.allowMethodReferences = source.allowMethodReferences() &&
|
||||
fac.options.isSet("allowMethodReferences");
|
||||
this.keepDocComments = keepDocComments;
|
||||
docComments = keepDocComments ? new HashMap<JCTree,String>() : null;
|
||||
docComments = newDocCommentTable(keepDocComments);
|
||||
this.keepLineMap = keepLineMap;
|
||||
this.errorTree = F.Erroneous();
|
||||
endPosTable = newEndPosTable(keepEndPositions);
|
||||
@ -128,6 +128,11 @@ public class JavacParser implements Parser {
|
||||
? new SimpleEndPosTable()
|
||||
: new EmptyEndPosTable();
|
||||
}
|
||||
|
||||
protected DocCommentTable newDocCommentTable(boolean keepDocComments) {
|
||||
return keepDocComments ? new SimpleDocCommentTable() : null;
|
||||
}
|
||||
|
||||
/** Switch: Should generics be recognized?
|
||||
*/
|
||||
boolean allowGenerics;
|
||||
@ -417,21 +422,21 @@ public class JavacParser implements Parser {
|
||||
|
||||
/* ---------- doc comments --------- */
|
||||
|
||||
/** A hashtable to store all documentation comments
|
||||
/** A table to store all documentation comments
|
||||
* indexed by the tree nodes they refer to.
|
||||
* defined only if option flag keepDocComment is set.
|
||||
*/
|
||||
private final Map<JCTree, String> docComments;
|
||||
private final DocCommentTable docComments;
|
||||
|
||||
/** Make an entry into docComments hashtable,
|
||||
* provided flag keepDocComments is set and given doc comment is non-null.
|
||||
* @param tree The tree to be used as index in the hashtable
|
||||
* @param dc The doc comment to associate with the tree, or null.
|
||||
*/
|
||||
void attach(JCTree tree, String dc) {
|
||||
void attach(JCTree tree, Comment dc) {
|
||||
if (keepDocComments && dc != null) {
|
||||
// System.out.println("doc comment = ");System.out.println(dc);//DEBUG
|
||||
docComments.put(tree, dc);
|
||||
docComments.putComment(tree, dc);
|
||||
}
|
||||
}
|
||||
|
||||
@ -1858,7 +1863,7 @@ public class JavacParser implements Parser {
|
||||
return List.of(parseStatement());
|
||||
case MONKEYS_AT:
|
||||
case FINAL: {
|
||||
String dc = token.comment(CommentStyle.JAVADOC);
|
||||
Comment dc = token.comment(CommentStyle.JAVADOC);
|
||||
JCModifiers mods = modifiersOpt();
|
||||
if (token.kind == INTERFACE ||
|
||||
token.kind == CLASS ||
|
||||
@ -1875,13 +1880,13 @@ public class JavacParser implements Parser {
|
||||
}
|
||||
}
|
||||
case ABSTRACT: case STRICTFP: {
|
||||
String dc = token.comment(CommentStyle.JAVADOC);
|
||||
Comment dc = token.comment(CommentStyle.JAVADOC);
|
||||
JCModifiers mods = modifiersOpt();
|
||||
return List.of(classOrInterfaceOrEnumDeclaration(mods, dc));
|
||||
}
|
||||
case INTERFACE:
|
||||
case CLASS:
|
||||
String dc = token.comment(CommentStyle.JAVADOC);
|
||||
Comment dc = token.comment(CommentStyle.JAVADOC);
|
||||
return List.of(classOrInterfaceOrEnumDeclaration(modifiersOpt(), dc));
|
||||
case ENUM:
|
||||
case ASSERT:
|
||||
@ -2418,7 +2423,7 @@ public class JavacParser implements Parser {
|
||||
JCExpression type,
|
||||
Name name,
|
||||
boolean reqInit,
|
||||
String dc,
|
||||
Comment dc,
|
||||
T vdefs)
|
||||
{
|
||||
vdefs.append(variableDeclaratorRest(pos, mods, type, name, reqInit, dc));
|
||||
@ -2434,7 +2439,7 @@ public class JavacParser implements Parser {
|
||||
/** VariableDeclarator = Ident VariableDeclaratorRest
|
||||
* ConstantDeclarator = Ident ConstantDeclaratorRest
|
||||
*/
|
||||
JCVariableDecl variableDeclarator(JCModifiers mods, JCExpression type, boolean reqInit, String dc) {
|
||||
JCVariableDecl variableDeclarator(JCModifiers mods, JCExpression type, boolean reqInit, Comment dc) {
|
||||
return variableDeclaratorRest(token.pos, mods, type, ident(), reqInit, dc);
|
||||
}
|
||||
|
||||
@ -2445,7 +2450,7 @@ public class JavacParser implements Parser {
|
||||
* @param dc The documentation comment for the variable declarations, or null.
|
||||
*/
|
||||
JCVariableDecl variableDeclaratorRest(int pos, JCModifiers mods, JCExpression type, Name name,
|
||||
boolean reqInit, String dc) {
|
||||
boolean reqInit, Comment dc) {
|
||||
type = bracketsOpt(type);
|
||||
JCExpression init = null;
|
||||
if (token.kind == EQ) {
|
||||
@ -2539,7 +2544,7 @@ public class JavacParser implements Parser {
|
||||
seenImport = true;
|
||||
defs.append(importDeclaration());
|
||||
} else {
|
||||
String docComment = token.comment(CommentStyle.JAVADOC);
|
||||
Comment docComment = token.comment(CommentStyle.JAVADOC);
|
||||
if (firstTypeDecl && !seenImport && !seenPackage) {
|
||||
docComment = firstToken.comment(CommentStyle.JAVADOC);
|
||||
consumedToplevelDoc = true;
|
||||
@ -2597,7 +2602,7 @@ public class JavacParser implements Parser {
|
||||
/** TypeDeclaration = ClassOrInterfaceOrEnumDeclaration
|
||||
* | ";"
|
||||
*/
|
||||
JCTree typeDeclaration(JCModifiers mods, String docComment) {
|
||||
JCTree typeDeclaration(JCModifiers mods, Comment docComment) {
|
||||
int pos = token.pos;
|
||||
if (mods == null && token.kind == SEMI) {
|
||||
nextToken();
|
||||
@ -2612,7 +2617,7 @@ public class JavacParser implements Parser {
|
||||
* @param mods Any modifiers starting the class or interface declaration
|
||||
* @param dc The documentation comment for the class, or null.
|
||||
*/
|
||||
JCStatement classOrInterfaceOrEnumDeclaration(JCModifiers mods, String dc) {
|
||||
JCStatement classOrInterfaceOrEnumDeclaration(JCModifiers mods, Comment dc) {
|
||||
if (token.kind == CLASS) {
|
||||
return classDeclaration(mods, dc);
|
||||
} else if (token.kind == INTERFACE) {
|
||||
@ -2656,7 +2661,7 @@ public class JavacParser implements Parser {
|
||||
* @param mods The modifiers starting the class declaration
|
||||
* @param dc The documentation comment for the class, or null.
|
||||
*/
|
||||
protected JCClassDecl classDeclaration(JCModifiers mods, String dc) {
|
||||
protected JCClassDecl classDeclaration(JCModifiers mods, Comment dc) {
|
||||
int pos = token.pos;
|
||||
accept(CLASS);
|
||||
Name name = ident();
|
||||
@ -2685,7 +2690,7 @@ public class JavacParser implements Parser {
|
||||
* @param mods The modifiers starting the interface declaration
|
||||
* @param dc The documentation comment for the interface, or null.
|
||||
*/
|
||||
protected JCClassDecl interfaceDeclaration(JCModifiers mods, String dc) {
|
||||
protected JCClassDecl interfaceDeclaration(JCModifiers mods, Comment dc) {
|
||||
int pos = token.pos;
|
||||
accept(INTERFACE);
|
||||
Name name = ident();
|
||||
@ -2708,7 +2713,7 @@ public class JavacParser implements Parser {
|
||||
* @param mods The modifiers starting the enum declaration
|
||||
* @param dc The documentation comment for the enum, or null.
|
||||
*/
|
||||
protected JCClassDecl enumDeclaration(JCModifiers mods, String dc) {
|
||||
protected JCClassDecl enumDeclaration(JCModifiers mods, Comment dc) {
|
||||
int pos = token.pos;
|
||||
accept(ENUM);
|
||||
Name name = ident();
|
||||
@ -2767,7 +2772,7 @@ public class JavacParser implements Parser {
|
||||
/** EnumeratorDeclaration = AnnotationsOpt [TypeArguments] IDENTIFIER [ Arguments ] [ "{" ClassBody "}" ]
|
||||
*/
|
||||
JCTree enumeratorDeclaration(Name enumName) {
|
||||
String dc = token.comment(CommentStyle.JAVADOC);
|
||||
Comment dc = token.comment(CommentStyle.JAVADOC);
|
||||
int flags = Flags.PUBLIC|Flags.STATIC|Flags.FINAL|Flags.ENUM;
|
||||
if (token.deprecatedFlag()) {
|
||||
flags |= Flags.DEPRECATED;
|
||||
@ -2856,7 +2861,7 @@ public class JavacParser implements Parser {
|
||||
nextToken();
|
||||
return List.<JCTree>nil();
|
||||
} else {
|
||||
String dc = token.comment(CommentStyle.JAVADOC);
|
||||
Comment dc = token.comment(CommentStyle.JAVADOC);
|
||||
int pos = token.pos;
|
||||
JCModifiers mods = modifiersOpt();
|
||||
if (token.kind == CLASS ||
|
||||
@ -2936,7 +2941,7 @@ public class JavacParser implements Parser {
|
||||
Name name,
|
||||
List<JCTypeParameter> typarams,
|
||||
boolean isInterface, boolean isVoid,
|
||||
String dc) {
|
||||
Comment dc) {
|
||||
List<JCVariableDecl> params = formalParameters();
|
||||
if (!isVoid) type = bracketsOpt(type);
|
||||
List<JCExpression> thrown = List.nil();
|
||||
|
@ -1,5 +1,5 @@
|
||||
/*
|
||||
* Copyright (c) 2004, 2011, Oracle and/or its affiliates. All rights reserved.
|
||||
* Copyright (c) 2004, 2012, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
@ -62,19 +62,54 @@ public class JavadocTokenizer extends JavaTokenizer {
|
||||
@Override
|
||||
protected Comment processComment(int pos, int endPos, CommentStyle style) {
|
||||
char[] buf = reader.getRawCharacters(pos, endPos);
|
||||
return new JavadocComment(new ColReader(fac, buf, buf.length), style);
|
||||
return new JavadocComment(new DocReader(fac, buf, buf.length, pos), style);
|
||||
}
|
||||
|
||||
/**
|
||||
* This is a specialized version of UnicodeReader that keeps track of the
|
||||
* column position within a given character stream (used for Javadoc processing).
|
||||
* column position within a given character stream (used for Javadoc processing),
|
||||
* and which builds a table for mapping positions in the comment string to
|
||||
* positions in the source file.
|
||||
*/
|
||||
static class ColReader extends UnicodeReader {
|
||||
static class DocReader extends UnicodeReader {
|
||||
|
||||
int col;
|
||||
int startPos;
|
||||
|
||||
ColReader(ScannerFactory fac, char[] input, int inputLength) {
|
||||
/**
|
||||
* A buffer for building a table for mapping positions in {@link #sbuf}
|
||||
* to positions in the source buffer.
|
||||
*
|
||||
* The array is organized as a series of pairs of integers: the first
|
||||
* number in each pair specifies a position in the comment text,
|
||||
* the second number in each pair specifies the corresponding position
|
||||
* in the source buffer. The pairs are sorted in ascending order.
|
||||
*
|
||||
* Since the mapping function is generally continuous, with successive
|
||||
* positions in the string corresponding to successive positions in the
|
||||
* source buffer, the table only needs to record discontinuities in
|
||||
* the mapping. The values of intermediate positions can be inferred.
|
||||
*
|
||||
* Discontinuities may occur in a number of places: when a newline
|
||||
* is followed by whitespace and asterisks (which are ignored),
|
||||
* when a tab is expanded into spaces, and when unicode escapes
|
||||
* are used in the source buffer.
|
||||
*
|
||||
* Thus, to find the source position of any position, p, in the comment
|
||||
* string, find the index, i, of the pair whose string offset
|
||||
* ({@code pbuf[i] }) is closest to but not greater than p. Then,
|
||||
* {@code sourcePos(p) = pbuf[i+1] + (p - pbuf[i]) }.
|
||||
*/
|
||||
int[] pbuf = new int[128];
|
||||
|
||||
/**
|
||||
* The index of the next empty slot in the pbuf buffer.
|
||||
*/
|
||||
int pp = 0;
|
||||
|
||||
DocReader(ScannerFactory fac, char[] input, int inputLength, int startPos) {
|
||||
super(fac, input, inputLength);
|
||||
this.startPos = startPos;
|
||||
}
|
||||
|
||||
@Override
|
||||
@ -147,19 +182,43 @@ public class JavadocTokenizer extends JavaTokenizer {
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
@Override
|
||||
public void putChar(char ch, boolean scan) {
|
||||
// At this point, bp is the position of the current character in buf,
|
||||
// and sp is the position in sbuf where this character will be put.
|
||||
// Record a new entry in pbuf if pbuf is empty or if sp and its
|
||||
// corresponding source position are not equidistant from the
|
||||
// corresponding values in the latest entry in the pbuf array.
|
||||
// (i.e. there is a discontinuity in the map function.)
|
||||
if ((pp == 0)
|
||||
|| (sp - pbuf[pp - 2] != (startPos + bp) - pbuf[pp - 1])) {
|
||||
if (pp + 1 >= pbuf.length) {
|
||||
int[] new_pbuf = new int[pbuf.length * 2];
|
||||
System.arraycopy(pbuf, 0, new_pbuf, 0, pbuf.length);
|
||||
pbuf = new_pbuf;
|
||||
}
|
||||
pbuf[pp] = sp;
|
||||
pbuf[pp + 1] = startPos + bp;
|
||||
pp += 2;
|
||||
}
|
||||
super.putChar(ch, scan);
|
||||
}
|
||||
}
|
||||
|
||||
protected class JavadocComment extends JavaTokenizer.BasicComment<ColReader> {
|
||||
protected class JavadocComment extends JavaTokenizer.BasicComment<DocReader> {
|
||||
|
||||
/**
|
||||
* Translated and stripped contents of doc comment
|
||||
*/
|
||||
private String docComment = null;
|
||||
private int[] docPosns = null;
|
||||
|
||||
JavadocComment(ColReader comment_reader, CommentStyle cs) {
|
||||
super(comment_reader, cs);
|
||||
JavadocComment(DocReader reader, CommentStyle cs) {
|
||||
super(reader, cs);
|
||||
}
|
||||
|
||||
@Override
|
||||
public String getText() {
|
||||
if (!scanned && cs == CommentStyle.JAVADOC) {
|
||||
scanDocComment();
|
||||
@ -167,6 +226,33 @@ public class JavadocTokenizer extends JavaTokenizer {
|
||||
return docComment;
|
||||
}
|
||||
|
||||
@Override
|
||||
public int getSourcePos(int pos) {
|
||||
// Binary search to find the entry for which the string index is
|
||||
// less than pos. Since docPosns is a list of pairs of integers
|
||||
// we must make sure the index is always even.
|
||||
// If we find an exact match for pos, the other item in the pair
|
||||
// gives the source pos; otherwise, compute the source position
|
||||
// relative to the best match found in the array.
|
||||
if (pos < 0 || pos >= docComment.length())
|
||||
throw new StringIndexOutOfBoundsException();
|
||||
if (docPosns == null)
|
||||
return -1;
|
||||
int start = 0;
|
||||
int end = docPosns.length;
|
||||
while (start < end - 2) {
|
||||
// find an even index midway between start and end
|
||||
int index = ((start + end) / 4) * 2;
|
||||
if (docPosns[index] < pos)
|
||||
start = index;
|
||||
else if (docPosns[index] == pos)
|
||||
return docPosns[index + 1];
|
||||
else
|
||||
end = index;
|
||||
}
|
||||
return docPosns[start + 1] + (pos - docPosns[start]);
|
||||
}
|
||||
|
||||
@Override
|
||||
@SuppressWarnings("fallthrough")
|
||||
protected void scanDocComment() {
|
||||
@ -209,7 +295,8 @@ public class JavadocTokenizer extends JavaTokenizer {
|
||||
// whitespace, then it consumes any stars, then it
|
||||
// puts the rest of the line into our buffer.
|
||||
while (comment_reader.bp < comment_reader.buflen) {
|
||||
|
||||
int begin_bp = comment_reader.bp;
|
||||
char begin_ch = comment_reader.ch;
|
||||
// The wsLoop consumes whitespace from the beginning
|
||||
// of each line.
|
||||
wsLoop:
|
||||
@ -263,10 +350,10 @@ public class JavadocTokenizer extends JavaTokenizer {
|
||||
break outerLoop;
|
||||
}
|
||||
} else if (! firstLine) {
|
||||
//The current line does not begin with a '*' so we will indent it.
|
||||
for (int i = 1; i < comment_reader.col; i++) {
|
||||
comment_reader.putChar(' ', false);
|
||||
}
|
||||
// The current line does not begin with a '*' so we will
|
||||
// treat it as comment
|
||||
comment_reader.bp = begin_bp;
|
||||
comment_reader.ch = begin_ch;
|
||||
}
|
||||
// The textLoop processes the rest of the characters
|
||||
// on the line, adding them to our buffer.
|
||||
@ -334,11 +421,14 @@ public class JavadocTokenizer extends JavaTokenizer {
|
||||
|
||||
// Store the text of the doc comment
|
||||
docComment = comment_reader.chars();
|
||||
docPosns = new int[comment_reader.pp];
|
||||
System.arraycopy(comment_reader.pbuf, 0, docPosns, 0, docPosns.length);
|
||||
} else {
|
||||
docComment = "";
|
||||
}
|
||||
} finally {
|
||||
scanned = true;
|
||||
comment_reader = null;
|
||||
if (docComment != null &&
|
||||
docComment.matches("(?sm).*^\\s*@deprecated( |$).*")) {
|
||||
deprecatedFlag = true;
|
||||
|
@ -0,0 +1,67 @@
|
||||
/*
|
||||
* Copyright (c) 1999, 2012, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
* under the terms of the GNU General Public License version 2 only, as
|
||||
* published by the Free Software Foundation. Oracle designates this
|
||||
* particular file as subject to the "Classpath" exception as provided
|
||||
* by Oracle in the LICENSE file that accompanied this code.
|
||||
*
|
||||
* This code is distributed in the hope that it will be useful, but WITHOUT
|
||||
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
||||
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
||||
* version 2 for more details (a copy is included in the LICENSE file that
|
||||
* accompanied this code).
|
||||
*
|
||||
* You should have received a copy of the GNU General Public License version
|
||||
* 2 along with this work; if not, write to the Free Software Foundation,
|
||||
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
|
||||
*
|
||||
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
|
||||
* or visit www.oracle.com if you need additional information or have any
|
||||
* questions.
|
||||
*/
|
||||
|
||||
package com.sun.tools.javac.parser;
|
||||
|
||||
import java.util.HashMap;
|
||||
import java.util.Map;
|
||||
|
||||
import com.sun.tools.javac.parser.Tokens.Comment;
|
||||
import com.sun.tools.javac.tree.DocCommentTable;
|
||||
import com.sun.tools.javac.tree.JCTree;
|
||||
|
||||
|
||||
/**
|
||||
*
|
||||
* <p><b>This is NOT part of any supported API.
|
||||
* If you write code that depends on this, you do so at your own risk.
|
||||
* This code and its internal interfaces are subject to change or
|
||||
* deletion without notice.</b>
|
||||
*/
|
||||
public class SimpleDocCommentTable implements DocCommentTable {
|
||||
Map<JCTree, Comment> table;
|
||||
|
||||
SimpleDocCommentTable() {
|
||||
table = new HashMap<JCTree, Comment>();
|
||||
}
|
||||
|
||||
public boolean hasComment(JCTree tree) {
|
||||
return table.containsKey(tree);
|
||||
}
|
||||
|
||||
public Comment getComment(JCTree tree) {
|
||||
return table.get(tree);
|
||||
}
|
||||
|
||||
public String getCommentText(JCTree tree) {
|
||||
Comment c = getComment(tree);
|
||||
return (c == null) ? null : c.getText();
|
||||
}
|
||||
|
||||
public void putComment(JCTree tree, Comment c) {
|
||||
table.put(tree, c);
|
||||
}
|
||||
|
||||
}
|
@ -1,5 +1,5 @@
|
||||
/*
|
||||
* Copyright (c) 1999, 2011, Oracle and/or its affiliates. All rights reserved.
|
||||
* Copyright (c) 1999, 2012, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
@ -294,6 +294,7 @@ public class Tokens {
|
||||
}
|
||||
|
||||
String getText();
|
||||
int getSourcePos(int index);
|
||||
CommentStyle getStyle();
|
||||
boolean isDeprecated();
|
||||
}
|
||||
@ -371,11 +372,11 @@ public class Tokens {
|
||||
* Preserve classic semantics - if multiple javadocs are found on the token
|
||||
* the last one is returned
|
||||
*/
|
||||
public String comment(Comment.CommentStyle style) {
|
||||
List<Comment> readers = getReaders(Comment.CommentStyle.JAVADOC);
|
||||
return readers.isEmpty() ?
|
||||
public Comment comment(Comment.CommentStyle style) {
|
||||
List<Comment> comments = getComments(Comment.CommentStyle.JAVADOC);
|
||||
return comments.isEmpty() ?
|
||||
null :
|
||||
readers.head.getText();
|
||||
comments.head;
|
||||
}
|
||||
|
||||
/**
|
||||
@ -383,22 +384,22 @@ public class Tokens {
|
||||
* javadoc comment attached to this token contains the '@deprecated' string
|
||||
*/
|
||||
public boolean deprecatedFlag() {
|
||||
for (Comment r : getReaders(Comment.CommentStyle.JAVADOC)) {
|
||||
if (r.isDeprecated()) {
|
||||
for (Comment c : getComments(Comment.CommentStyle.JAVADOC)) {
|
||||
if (c.isDeprecated()) {
|
||||
return true;
|
||||
}
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
private List<Comment> getReaders(Comment.CommentStyle style) {
|
||||
private List<Comment> getComments(Comment.CommentStyle style) {
|
||||
if (comments == null) {
|
||||
return List.nil();
|
||||
} else {
|
||||
ListBuffer<Comment> buf = ListBuffer.lb();
|
||||
for (Comment r : comments) {
|
||||
if (r.getStyle() == style) {
|
||||
buf.add(r);
|
||||
for (Comment c : comments) {
|
||||
if (c.getStyle() == style) {
|
||||
buf.add(c);
|
||||
}
|
||||
}
|
||||
return buf.toList();
|
||||
|
@ -0,0 +1,57 @@
|
||||
/*
|
||||
* Copyright (c) 2012, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
* under the terms of the GNU General Public License version 2 only, as
|
||||
* published by the Free Software Foundation. Oracle designates this
|
||||
* particular file as subject to the "Classpath" exception as provided
|
||||
* by Oracle in the LICENSE file that accompanied this code.
|
||||
*
|
||||
* This code is distributed in the hope that it will be useful, but WITHOUT
|
||||
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
||||
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
||||
* version 2 for more details (a copy is included in the LICENSE file that
|
||||
* accompanied this code).
|
||||
*
|
||||
* You should have received a copy of the GNU General Public License version
|
||||
* 2 along with this work; if not, write to the Free Software Foundation,
|
||||
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
|
||||
*
|
||||
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
|
||||
* or visit www.oracle.com if you need additional information or have any
|
||||
* questions.
|
||||
*/
|
||||
package com.sun.tools.javac.tree;
|
||||
|
||||
import com.sun.tools.javac.parser.Tokens.Comment;
|
||||
|
||||
/**
|
||||
* A table giving the doc comment, if any, for any tree node.
|
||||
*
|
||||
* <p><b>This is NOT part of any supported API.
|
||||
* If you write code that depends on this, you do so at your own
|
||||
* risk. This code and its internal interfaces are subject to change
|
||||
* or deletion without notice.</b>
|
||||
*/
|
||||
public interface DocCommentTable {
|
||||
/**
|
||||
* Check if a tree node has a corresponding doc comment.
|
||||
*/
|
||||
public boolean hasComment(JCTree tree);
|
||||
|
||||
/**
|
||||
* Get the Comment token containing the doc comment, if any, for a tree node.
|
||||
*/
|
||||
public Comment getComment(JCTree tree);
|
||||
|
||||
/**
|
||||
* Get the plain text of the doc comment, if any, for a tree node.
|
||||
*/
|
||||
public String getCommentText(JCTree tree);
|
||||
|
||||
/**
|
||||
* Set the Comment to be associated with a tree node.
|
||||
*/
|
||||
public void putComment(JCTree tree, Comment c);
|
||||
}
|
@ -1,5 +1,5 @@
|
||||
/*
|
||||
* Copyright (c) 2011, Oracle and/or its affiliates. All rights reserved.
|
||||
* Copyright (c) 2011, 2012, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
@ -22,9 +22,8 @@
|
||||
* or visit www.oracle.com if you need additional information or have any
|
||||
* questions.
|
||||
*/
|
||||
package com.sun.tools.javac.parser;
|
||||
|
||||
import com.sun.tools.javac.tree.JCTree;
|
||||
package com.sun.tools.javac.tree;
|
||||
|
||||
/**
|
||||
* Specifies the methods to access a mappings of syntax trees to end positions.
|
@ -1,5 +1,5 @@
|
||||
/*
|
||||
* Copyright (c) 1999, 2011, Oracle and/or its affiliates. All rights reserved.
|
||||
* Copyright (c) 1999, 2012, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
@ -25,25 +25,23 @@
|
||||
|
||||
package com.sun.tools.javac.tree;
|
||||
|
||||
import java.util.*;
|
||||
|
||||
import java.io.IOException;
|
||||
import java.io.StringWriter;
|
||||
import java.util.*;
|
||||
|
||||
import javax.lang.model.element.Modifier;
|
||||
import javax.lang.model.type.TypeKind;
|
||||
import javax.tools.JavaFileObject;
|
||||
|
||||
import com.sun.tools.javac.util.*;
|
||||
import com.sun.tools.javac.util.JCDiagnostic.DiagnosticPosition;
|
||||
import com.sun.tools.javac.util.List;
|
||||
import com.sun.tools.javac.code.*;
|
||||
import com.sun.tools.javac.code.Scope.*;
|
||||
import com.sun.tools.javac.code.Symbol.*;
|
||||
import com.sun.tools.javac.parser.EndPosTable;
|
||||
import com.sun.source.tree.*;
|
||||
import com.sun.source.tree.LambdaExpressionTree.BodyKind;
|
||||
import com.sun.source.tree.MemberReferenceTree.ReferenceMode;
|
||||
|
||||
import com.sun.tools.javac.code.*;
|
||||
import com.sun.tools.javac.code.Scope.*;
|
||||
import com.sun.tools.javac.code.Symbol.*;
|
||||
import com.sun.tools.javac.util.*;
|
||||
import com.sun.tools.javac.util.JCDiagnostic.DiagnosticPosition;
|
||||
import com.sun.tools.javac.util.List;
|
||||
import static com.sun.tools.javac.code.BoundKind.*;
|
||||
import static com.sun.tools.javac.tree.JCTree.Tag.*;
|
||||
|
||||
@ -491,7 +489,7 @@ public abstract class JCTree implements Tree, Cloneable, DiagnosticPosition {
|
||||
public ImportScope namedImportScope;
|
||||
public StarImportScope starImportScope;
|
||||
public Position.LineMap lineMap = null;
|
||||
public Map<JCTree, String> docComments = null;
|
||||
public DocCommentTable docComments = null;
|
||||
public EndPosTable endPositions = null;
|
||||
protected JCCompilationUnit(List<JCAnnotation> packageAnnotations,
|
||||
JCExpression pid,
|
||||
|
@ -1,5 +1,5 @@
|
||||
/*
|
||||
* Copyright (c) 1999, 2011, Oracle and/or its affiliates. All rights reserved.
|
||||
* Copyright (c) 1999, 2012, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
@ -29,14 +29,12 @@ import java.io.*;
|
||||
import java.util.*;
|
||||
|
||||
import com.sun.source.tree.MemberReferenceTree.ReferenceMode;
|
||||
|
||||
import com.sun.tools.javac.code.*;
|
||||
import com.sun.tools.javac.code.Symbol.*;
|
||||
import com.sun.tools.javac.parser.Tokens.Comment;
|
||||
import com.sun.tools.javac.tree.JCTree.*;
|
||||
import com.sun.tools.javac.util.*;
|
||||
import com.sun.tools.javac.util.List;
|
||||
import com.sun.tools.javac.code.*;
|
||||
|
||||
import com.sun.tools.javac.code.Symbol.*;
|
||||
import com.sun.tools.javac.tree.JCTree.*;
|
||||
|
||||
import static com.sun.tools.javac.code.Flags.*;
|
||||
import static com.sun.tools.javac.code.Flags.ANNOTATION;
|
||||
import static com.sun.tools.javac.tree.JCTree.Tag.*;
|
||||
@ -78,10 +76,10 @@ public class Pretty extends JCTree.Visitor {
|
||||
*/
|
||||
Name enclClassName;
|
||||
|
||||
/** A hashtable mapping trees to their documentation comments
|
||||
/** A table mapping trees to their documentation comments
|
||||
* (can be null)
|
||||
*/
|
||||
Map<JCTree, String> docComments = null;
|
||||
DocCommentTable docComments = null;
|
||||
|
||||
/** Align code to be indented to left margin.
|
||||
*/
|
||||
@ -233,7 +231,7 @@ public class Pretty extends JCTree.Visitor {
|
||||
*/
|
||||
public void printDocComment(JCTree tree) throws IOException {
|
||||
if (docComments != null) {
|
||||
String dc = docComments.get(tree);
|
||||
String dc = docComments.getCommentText(tree);
|
||||
if (dc != null) {
|
||||
print("/**"); println();
|
||||
int pos = 0;
|
||||
@ -480,7 +478,7 @@ public class Pretty extends JCTree.Visitor {
|
||||
|
||||
public void visitVarDef(JCVariableDecl tree) {
|
||||
try {
|
||||
if (docComments != null && docComments.get(tree) != null) {
|
||||
if (docComments != null && docComments.hasComment(tree)) {
|
||||
println(); align();
|
||||
}
|
||||
printDocComment(tree);
|
||||
|
@ -25,15 +25,14 @@
|
||||
|
||||
package com.sun.tools.javac.tree;
|
||||
|
||||
|
||||
import com.sun.source.tree.Tree;
|
||||
import com.sun.tools.javac.code.*;
|
||||
import com.sun.tools.javac.comp.AttrContext;
|
||||
import com.sun.tools.javac.comp.Env;
|
||||
import com.sun.tools.javac.tree.JCTree.*;
|
||||
import com.sun.tools.javac.util.*;
|
||||
import com.sun.tools.javac.util.JCDiagnostic.DiagnosticPosition;
|
||||
import com.sun.tools.javac.code.*;
|
||||
import com.sun.tools.javac.parser.EndPosTable;
|
||||
import com.sun.tools.javac.tree.JCTree.*;
|
||||
|
||||
import static com.sun.tools.javac.code.Flags.*;
|
||||
import static com.sun.tools.javac.tree.JCTree.Tag.*;
|
||||
import static com.sun.tools.javac.tree.JCTree.Tag.BLOCK;
|
||||
@ -282,6 +281,13 @@ public class TreeInfo {
|
||||
return (lit.typetag == TypeTags.BOT);
|
||||
}
|
||||
|
||||
public static String getCommentText(Env<?> env, JCTree tree) {
|
||||
DocCommentTable docComments = (tree.hasTag(JCTree.Tag.TOPLEVEL))
|
||||
? ((JCCompilationUnit) tree).docComments
|
||||
: env.toplevel.docComments;
|
||||
return (docComments == null) ? null : docComments.getCommentText(tree);
|
||||
}
|
||||
|
||||
/** The position of the first statement in a block, or the position of
|
||||
* the block itself if it is empty.
|
||||
*/
|
||||
|
@ -1,5 +1,5 @@
|
||||
/*
|
||||
* Copyright (c) 1999, 2011, Oracle and/or its affiliates. All rights reserved.
|
||||
* Copyright (c) 1999, 2012, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
@ -32,7 +32,7 @@ import java.util.Map;
|
||||
import javax.tools.JavaFileObject;
|
||||
|
||||
import com.sun.tools.javac.file.JavacFileManager;
|
||||
import com.sun.tools.javac.parser.EndPosTable;
|
||||
import com.sun.tools.javac.tree.EndPosTable;
|
||||
import com.sun.tools.javac.tree.JCTree;
|
||||
|
||||
import static com.sun.tools.javac.util.LayoutCharacters.*;
|
||||
|
@ -1,5 +1,5 @@
|
||||
/*
|
||||
* Copyright (c) 2003, 2011, Oracle and/or its affiliates. All rights reserved.
|
||||
* Copyright (c) 2003, 2012, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
@ -35,7 +35,7 @@ import javax.tools.JavaFileObject;
|
||||
|
||||
import com.sun.tools.javac.api.DiagnosticFormatter;
|
||||
import com.sun.tools.javac.code.Lint.LintCategory;
|
||||
import com.sun.tools.javac.parser.EndPosTable;
|
||||
import com.sun.tools.javac.tree.EndPosTable;
|
||||
import com.sun.tools.javac.tree.JCTree;
|
||||
|
||||
import static com.sun.tools.javac.util.JCDiagnostic.DiagnosticType.*;
|
||||
|
@ -1,5 +1,5 @@
|
||||
/*
|
||||
* Copyright (c) 1999, 2011, Oracle and/or its affiliates. All rights reserved.
|
||||
* Copyright (c) 1999, 2012, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
@ -37,7 +37,7 @@ import javax.tools.JavaFileObject;
|
||||
import com.sun.tools.javac.api.DiagnosticFormatter;
|
||||
import com.sun.tools.javac.main.Main;
|
||||
import com.sun.tools.javac.main.Option;
|
||||
import com.sun.tools.javac.parser.EndPosTable;
|
||||
import com.sun.tools.javac.tree.EndPosTable;
|
||||
import com.sun.tools.javac.util.JCDiagnostic.DiagnosticPosition;
|
||||
import com.sun.tools.javac.util.JCDiagnostic.DiagnosticType;
|
||||
|
||||
|
@ -1,5 +1,5 @@
|
||||
/*
|
||||
* Copyright (c) 2001, 2011, Oracle and/or its affiliates. All rights reserved.
|
||||
* Copyright (c) 2001, 2012, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
@ -25,14 +25,17 @@
|
||||
|
||||
package com.sun.tools.javadoc;
|
||||
|
||||
import com.sun.tools.javac.util.Context;
|
||||
import com.sun.tools.javac.util.JCDiagnostic.DiagnosticPosition;
|
||||
import com.sun.tools.javac.util.List;
|
||||
|
||||
import javax.tools.JavaFileObject;
|
||||
|
||||
import com.sun.tools.javac.code.Kinds;
|
||||
import com.sun.tools.javac.code.Symbol.*;
|
||||
import com.sun.tools.javac.comp.Enter;
|
||||
import com.sun.tools.javac.tree.JCTree.*;
|
||||
import javax.tools.JavaFileObject;
|
||||
import com.sun.tools.javac.tree.TreeInfo;
|
||||
import com.sun.tools.javac.util.Context;
|
||||
import com.sun.tools.javac.util.JCDiagnostic.DiagnosticPosition;
|
||||
import com.sun.tools.javac.util.List;
|
||||
|
||||
/**
|
||||
* Javadoc's own enter phase does a few things above and beyond that
|
||||
@ -77,7 +80,7 @@ public class JavadocEnter extends Enter {
|
||||
public void visitTopLevel(JCCompilationUnit tree) {
|
||||
super.visitTopLevel(tree);
|
||||
if (tree.sourcefile.isNameCompatible("package-info", JavaFileObject.Kind.SOURCE)) {
|
||||
String comment = tree.docComments.get(tree);
|
||||
String comment = TreeInfo.getCommentText(env, tree);
|
||||
docenv.makePackageDoc(tree.packge, comment, tree);
|
||||
}
|
||||
}
|
||||
@ -87,7 +90,7 @@ public class JavadocEnter extends Enter {
|
||||
super.visitClassDef(tree);
|
||||
if (tree.sym == null) return;
|
||||
if (tree.sym.kind == Kinds.TYP || tree.sym.kind == Kinds.ERR) {
|
||||
String comment = env.toplevel.docComments.get(tree);
|
||||
String comment = TreeInfo.getCommentText(env, tree);
|
||||
ClassSymbol c = tree.sym;
|
||||
docenv.makeClassDoc(c, comment, tree, env.toplevel.lineMap);
|
||||
}
|
||||
|
@ -1,5 +1,5 @@
|
||||
/*
|
||||
* Copyright (c) 2003, 2011, Oracle and/or its affiliates. All rights reserved.
|
||||
* Copyright (c) 2003, 2012, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
@ -25,13 +25,14 @@
|
||||
|
||||
package com.sun.tools.javadoc;
|
||||
|
||||
import com.sun.tools.javac.util.Context;
|
||||
import com.sun.tools.javac.util.Position;
|
||||
import com.sun.tools.javac.code.Flags;
|
||||
import com.sun.tools.javac.code.Kinds;
|
||||
import com.sun.tools.javac.code.Symbol.*;
|
||||
import com.sun.tools.javac.comp.MemberEnter;
|
||||
import com.sun.tools.javac.tree.JCTree.*;
|
||||
import com.sun.tools.javac.tree.TreeInfo;
|
||||
import com.sun.tools.javac.util.Context;
|
||||
import com.sun.tools.javac.util.Position;
|
||||
|
||||
/**
|
||||
* Javadoc's own memberEnter phase does a few things above and beyond that
|
||||
@ -61,11 +62,12 @@ public class JavadocMemberEnter extends MemberEnter {
|
||||
docenv = DocEnv.instance(context);
|
||||
}
|
||||
|
||||
@Override
|
||||
public void visitMethodDef(JCMethodDecl tree) {
|
||||
super.visitMethodDef(tree);
|
||||
MethodSymbol meth = tree.sym;
|
||||
if (meth == null || meth.kind != Kinds.MTH) return;
|
||||
String docComment = env.toplevel.docComments.get(tree);
|
||||
String docComment = TreeInfo.getCommentText(env, tree);
|
||||
Position.LineMap lineMap = env.toplevel.lineMap;
|
||||
if (meth.isConstructor())
|
||||
docenv.makeConstructorDoc(meth, docComment, tree, lineMap);
|
||||
@ -75,12 +77,13 @@ public class JavadocMemberEnter extends MemberEnter {
|
||||
docenv.makeMethodDoc(meth, docComment, tree, lineMap);
|
||||
}
|
||||
|
||||
@Override
|
||||
public void visitVarDef(JCVariableDecl tree) {
|
||||
super.visitVarDef(tree);
|
||||
if (tree.sym != null &&
|
||||
tree.sym.kind == Kinds.VAR &&
|
||||
!isParameter(tree.sym)) {
|
||||
String docComment = env.toplevel.docComments.get(tree);
|
||||
String docComment = TreeInfo.getCommentText(env, tree);
|
||||
Position.LineMap lineMap = env.toplevel.lineMap;
|
||||
docenv.makeFieldDoc(tree.sym, docComment, tree, lineMap);
|
||||
}
|
||||
|
@ -1,5 +1,5 @@
|
||||
/*
|
||||
* Copyright (c) 2005, 2011, Oracle and/or its affiliates. All rights reserved.
|
||||
* Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
@ -33,9 +33,9 @@ import java.net.URI;
|
||||
import javax.tools.JavaFileObject;
|
||||
import javax.tools.SimpleJavaFileObject;
|
||||
import com.sun.tools.javac.file.JavacFileManager;
|
||||
import com.sun.tools.javac.parser.EndPosTable;
|
||||
import com.sun.tools.javac.parser.Parser;
|
||||
import com.sun.tools.javac.parser.ParserFactory;
|
||||
import com.sun.tools.javac.tree.EndPosTable;
|
||||
import com.sun.tools.javac.tree.JCTree;
|
||||
import com.sun.tools.javac.tree.TreeScanner;
|
||||
import com.sun.tools.javac.util.Context;
|
||||
|
@ -1,5 +1,5 @@
|
||||
/*
|
||||
* Copyright (c) 2010, 2011, Oracle and/or its affiliates. All rights reserved.
|
||||
* Copyright (c) 2010, 2012, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
@ -68,7 +68,7 @@ import com.sun.source.util.TaskListener;
|
||||
import com.sun.tools.javac.api.JavacTool;
|
||||
import com.sun.tools.javac.code.Symbol;
|
||||
import com.sun.tools.javac.code.Type;
|
||||
import com.sun.tools.javac.parser.EndPosTable;
|
||||
import com.sun.tools.javac.tree.EndPosTable;
|
||||
import com.sun.tools.javac.tree.JCTree;
|
||||
import com.sun.tools.javac.tree.JCTree.JCCompilationUnit;
|
||||
import com.sun.tools.javac.tree.JCTree.JCImport;
|
||||
|
File diff suppressed because it is too large
Load Diff
@ -1,5 +1,5 @@
|
||||
/*
|
||||
* Copyright (c) 2011, Oracle and/or its affiliates. All rights reserved.
|
||||
* Copyright (c) 2011, 2012, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
@ -29,6 +29,7 @@
|
||||
|
||||
import com.sun.source.tree.*;
|
||||
import com.sun.source.util.*;
|
||||
import com.sun.tools.javac.tree.DocCommentTable;
|
||||
import com.sun.tools.javac.tree.JCTree;
|
||||
|
||||
import java.net.URI;
|
||||
@ -137,16 +138,16 @@ public class DocCommentToplevelTest {
|
||||
|
||||
new TreeScanner<ClassTree,Void>() {
|
||||
|
||||
Map<JCTree, String> docComments;
|
||||
DocCommentTable docComments;
|
||||
|
||||
@Override
|
||||
public ClassTree visitCompilationUnit(CompilationUnitTree node, Void unused) {
|
||||
docComments = ((JCTree.JCCompilationUnit)node).docComments;
|
||||
boolean expectedComment = tdk == ToplevelDocKind.HAS_DOC &&
|
||||
(pk != PackageKind.NO_PKG || ik != ImportKind.ZERO);
|
||||
boolean foundComment = docComments.get(node) != null;
|
||||
boolean foundComment = docComments.hasComment((JCTree) node);
|
||||
if (expectedComment != foundComment) {
|
||||
error("Unexpected comment " + docComments.get(node) + " on toplevel");
|
||||
error("Unexpected comment " + docComments.getComment((JCTree) node) + " on toplevel");
|
||||
}
|
||||
return super.visitCompilationUnit(node, null);
|
||||
}
|
||||
@ -156,9 +157,9 @@ public class DocCommentToplevelTest {
|
||||
boolean expectedComment = tdk == ToplevelDocKind.HAS_DOC &&
|
||||
pk == PackageKind.NO_PKG && ik == ImportKind.ZERO &&
|
||||
node.getSimpleName().toString().equals("First");
|
||||
boolean foundComment = docComments.get(node) != null;
|
||||
boolean foundComment = docComments.hasComment((JCTree) node);
|
||||
if (expectedComment != foundComment) {
|
||||
error("Unexpected comment " + docComments.get(node) + " on class " + node.getSimpleName());
|
||||
error("Unexpected comment " + docComments.getComment((JCTree) node) + " on class " + node.getSimpleName());
|
||||
}
|
||||
return super.visitClass(node, unused);
|
||||
}
|
||||
|
@ -1,5 +1,5 @@
|
||||
/*
|
||||
* Copyright (c) 2010, 2011, Oracle and/or its affiliates. All rights reserved.
|
||||
* Copyright (c) 2010, 2012, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
@ -73,7 +73,7 @@ import com.sun.source.tree.CompilationUnitTree;
|
||||
import com.sun.source.util.JavacTask;
|
||||
import com.sun.tools.javac.api.JavacTool;
|
||||
import com.sun.tools.javac.code.Flags;
|
||||
import com.sun.tools.javac.parser.EndPosTable;
|
||||
import com.sun.tools.javac.tree.EndPosTable;
|
||||
import com.sun.tools.javac.tree.JCTree;
|
||||
import com.sun.tools.javac.tree.JCTree.JCCompilationUnit;
|
||||
import com.sun.tools.javac.tree.JCTree.JCNewClass;
|
||||
|
Loading…
x
Reference in New Issue
Block a user