--- a/src/jdk.javadoc/share/classes/com/sun/javadoc/ProgramElementDoc.java Fri Feb 22 17:03:09 2019 +0000
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,148 +0,0 @@
-/*
- * Copyright (c) 1998, 2018, 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.javadoc;
-
-/**
- * Represents a java program element: class, interface, field,
- * constructor, or method.
- * This is an abstract class dealing with information common to
- * these elements.
- *
- * @see MemberDoc
- * @see ClassDoc
- *
- * @author Robert Field
- *
- * @deprecated
- * The declarations in this package have been superseded by those
- * in the package {@code jdk.javadoc.doclet}.
- * For more information, see the <i>Migration Guide</i> in the documentation for that package.
- */
-@Deprecated(since="9", forRemoval=true)
-@SuppressWarnings("removal")
-public interface ProgramElementDoc extends Doc {
-
- /**
- * Get the containing class or interface of this program element.
- *
- * @return a ClassDoc for this element's containing class or interface.
- * If this is a top-level class or interface, return null.
- */
- ClassDoc containingClass();
-
- /**
- * Get the package that this program element is contained in.
- *
- * @return a PackageDoc for this element containing package.
- * If in the unnamed package, this PackageDoc will have the
- * name "".
- */
- PackageDoc containingPackage();
-
- /**
- * Get the fully qualified name of this program element.
- * For example, for the class {@code java.util.Hashtable},
- * return "java.util.Hashtable".
- * <p>
- * For the method {@code bar()} in class {@code Foo}
- * in the unnamed package, return "Foo.bar".
- *
- * @return the qualified name of the program element as a String.
- */
- String qualifiedName();
-
- /**
- * Get the modifier specifier integer.
- *
- * @see java.lang.reflect.Modifier
- *
- * @return Get the modifier specifier integer.
- */
- int modifierSpecifier();
-
- /**
- * Get modifiers string.
- * For example, for:
- * <pre>
- * public abstract int foo() { ... }
- * </pre>
- * return "public abstract".
- * Annotations are not included.
- *
- * @return "public abstract".
- */
- String modifiers();
-
- /**
- * Get the annotations of this program element.
- * Return an empty array if there are none.
- *
- * @return the annotations of this program element.
- * @since 1.5
- */
- AnnotationDesc[] annotations();
-
- /**
- * Return true if this program element is public.
- *
- * @return true if this program element is public.
- */
- boolean isPublic();
-
- /**
- * Return true if this program element is protected.
- *
- * @return true if this program element is protected.
- */
- boolean isProtected();
-
- /**
- * Return true if this program element is private.
- *
- * @return true if this program element is private.
- */
- boolean isPrivate();
-
- /**
- * Return true if this program element is package private.
- *
- * @return true if this program element is package private.
- */
- boolean isPackagePrivate();
- /**
- * Return true if this program element is static.
- *
- * @return true if this program element is static.
- */
- boolean isStatic();
-
- /**
- * Return true if this program element is final.
- *
- * @return true if this program element is final.
- */
- boolean isFinal();
-}