From 262779f0bbc367b466213f8cc17509819e1f17aa Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Johan=20Andr=C3=A9n?= <johan@markatta.com>
Date: Fri, 1 Sep 2017 14:48:10 +0200
Subject: [PATCH] Mark all the around hooks as internal in the api docs
 (#23587)

---
 akka-actor/src/main/scala/akka/actor/Actor.scala | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/akka-actor/src/main/scala/akka/actor/Actor.scala b/akka-actor/src/main/scala/akka/actor/Actor.scala
index fab26a2217..7b0d8cb941 100644
--- a/akka-actor/src/main/scala/akka/actor/Actor.scala
+++ b/akka-actor/src/main/scala/akka/actor/Actor.scala
@@ -12,6 +12,8 @@ import scala.beans.BeanProperty
 import scala.util.control.NoStackTrace
 import java.util.Optional
 
+import akka.annotation.InternalApi
+
 /**
  * INTERNAL API
  *
@@ -509,6 +511,7 @@ trait Actor {
    * @param receive current behavior.
    * @param msg current message.
    */
+  @InternalApi
   protected[akka] def aroundReceive(receive: Actor.Receive, msg: Any): Unit = {
     // optimization: avoid allocation of lambda
     if (receive.applyOrElse(msg, Actor.notHandledFun).asInstanceOf[AnyRef] eq Actor.NotHandled) {
@@ -517,23 +520,35 @@ trait Actor {
   }
 
   /**
+   * INTERNAL API.
+   *
    * Can be overridden to intercept calls to `preStart`. Calls `preStart` by default.
    */
+  @InternalApi
   protected[akka] def aroundPreStart(): Unit = preStart()
 
   /**
+   * INTERNAL API.
+   *
    * Can be overridden to intercept calls to `postStop`. Calls `postStop` by default.
    */
+  @InternalApi
   protected[akka] def aroundPostStop(): Unit = postStop()
 
   /**
+   * INTERNAL API.
+   *
    * Can be overridden to intercept calls to `preRestart`. Calls `preRestart` by default.
    */
+  @InternalApi
   protected[akka] def aroundPreRestart(reason: Throwable, message: Option[Any]): Unit = preRestart(reason, message)
 
   /**
+   * INTERNAL API.
+   *
    * Can be overridden to intercept calls to `postRestart`. Calls `postRestart` by default.
    */
+  @InternalApi
   protected[akka] def aroundPostRestart(reason: Throwable): Unit = postRestart(reason)
 
   /**