--- a/src/jdk.javadoc/share/classes/com/sun/javadoc/PackageDoc.java	Fri Feb 09 13:58:40 2018 -0800
+++ b/src/jdk.javadoc/share/classes/com/sun/javadoc/PackageDoc.java	Fri Feb 09 13:58:17 2018 -0800
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1998, 2014, Oracle and/or its affiliates. All rights reserved.
+ * 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
@@ -42,7 +42,8 @@
  *   in the package {@code jdk.javadoc.doclet}.
  *   For more information, see the <i>Migration Guide</i> in the documentation for that package.
  */
-@Deprecated
+@Deprecated(since="9", forRemoval=true)
+@SuppressWarnings("removal")
 public interface PackageDoc extends Doc {
 
     /**