--- a/langtools/src/jdk.compiler/share/classes/com/sun/source/util/DocTrees.java Wed Jul 05 21:13:10 2017 +0200
+++ b/langtools/src/jdk.compiler/share/classes/com/sun/source/util/DocTrees.java Fri Jan 15 15:40:24 2016 -0800
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2011, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2011, 2016, 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
@@ -126,6 +126,20 @@
public abstract DocCommentTree getDocCommentTree(Element e, String relativePath) throws IOException;
/**
+ * Returns a doc tree path containing the doc comment tree of the given file.
+ * The file must be an HTML file, in which case the doc comment tree represents the
+ * contents of the <body> tag, and any enclosing tags are ignored.
+ * Returns {@code null} if no doc comment was found.
+ * Future releases may support additional file types.
+ *
+ * @param fileObject the content container
+ * @return a doc tree path containing the doc comment read from the given file.
+ *
+ * @since 9
+ */
+ public abstract DocTreePath getDocTreePath(FileObject fileObject);
+
+ /**
* Returns the language model element referred to by the leaf node of the given
* {@link DocTreePath}, or {@code null} if unknown.
* @param path the path for the tree node
@@ -175,4 +189,12 @@
* @since 9
*/
public abstract void setBreakIterator(BreakIterator breakiterator);
+
+ /**
+ * Returns a utility object for creating {@code DocTree} objects.
+ * @return a utility object for creating {@code DocTree} objects
+ *
+ * @since 9
+ */
+ public abstract DocTreeFactory getDocTreeFactory();
}