Update docs

Author: Dr-TSNG

api/src/main/java/io/github/libxposed/api/XposedInterface.java

@@ -41,13 +41,17 @@ public interface XposedInterface {
      * <p>API additions:</p>
      * <ul>
      * <li>Hot reloading callbacks are available for modules that declare exactly one Java entry class.</li>
+     * <li>Hot reload is disabled for modules that do not declare exactly one Java entry class,
+     * modules that declare native entries, and targets where module code has successfully loaded
+     * a native library.</li>
      * <li>Module entries can stop receiving subsequent lifecycle callbacks through
      * {@link XposedInterfaceWrapper#detach()}.</li>
      * <li>Hooks can be assigned an id through {@link HookBuilder#setId(String)}. Hook ids are
      * scoped to the current module and executable, and can be queried through
      * {@link HookHandle#getId()}.</li>
      * <li>Hooks can be atomically replaced through {@link HookHandle#replaceHook(Hooker)}.</li>
-     * <li>{@link #PROP_RT_HOT_RELOAD} indicates whether hot reload is currently permitted.</li>
+     * <li>{@link #PROP_RT_HOT_RELOAD} indicates whether framework policy allows this module to
+     * request hot reload.</li>
      * </ul>
      * <p>Behavior changes: Modules targeting 102 or higher</p>
      * <ul>
@@ -76,7 +80,11 @@ public interface XposedInterface {
     long PROP_RT_API_PROTECTION = 1L << 2;
 
     /**
-     * The framework currently permits hot reload through the service.
+     * Framework policy allows this module to request hot reload through the service.
+     * <p>
+     * This property only describes framework policy, such as a safety option. It does not
+     * guarantee that any target is hot-reloadable or that a hot reload request can complete.
+     * </p>
      */
     long PROP_RT_HOT_RELOAD = 1L << 3;
 

api/src/main/java/io/github/libxposed/api/XposedModuleInterface.java

@@ -114,7 +114,10 @@ interface SystemServerStartingParam {
      * Wraps information about the hot reloading event.
      * <p>
      * Hot reloading is supported only for modules that declare exactly one Java entry class.
-     * Modules with multiple Java entry classes are rejected before hot reload callbacks are invoked.
+     * Modules with zero or multiple Java entry classes are rejected before hot reload callbacks
+     * are invoked. Modules that declare native entries are not hot-reloadable. If module code
+     * successfully loads a native library in a target process, that target is no longer
+     * hot-reloadable until it restarts.
      * </p>
      */
     @SinceApi(XposedInterface.API_102)
@@ -240,13 +243,21 @@ default void onSystemServerStarting(@NonNull SystemServerStartingParam param) {
      * <p>This callback runs in <b>old</b> code.</p>
      * <p>
      * Hot reloading is supported only for modules that declare exactly one Java entry class.
-     * Modules with multiple Java entry classes are rejected before this callback is invoked.
+     * Modules with zero or multiple Java entry classes and modules that declare native entries
+     * are rejected before this callback is invoked. If module code successfully loads a native
+     * library in a target process, that target is no longer hot-reloadable until it restarts.
      * </p>
      * <p>
      * Hot reloads are serialized per target. Before the old hook handle list is captured, the
      * framework freezes old code so further hook registrations from old code fail. In-flight hook
      * calls keep using the hook chain snapshot that was active when they started.
      * </p>
+     * <p>
+     * Returning {@code false} rejects the hot reload request. For service-triggered requests, this
+     * is reported as {@code HotReloadResult.Status.FAILED} with a null message. If this callback
+     * or the subsequent reload operation throws, the request is reported as failed with a
+     * framework-provided diagnostic message.
+     * </p>
      *
      * @param param Information about the hot reloading event
      * @return {@code true} to allow hot reloading to proceed, {@code false} to cancel hot reloading
@@ -261,7 +272,9 @@ default boolean onHotReloading(@NonNull HotReloadingParam param) {
      * <p>This callback runs in <b>new</b> code.</p>
      * <p>
      * Hot reloading is supported only for modules that declare exactly one Java entry class.
-     * Modules with multiple Java entry classes are rejected before hot reload callbacks are invoked.
+     * Modules with zero or multiple Java entry classes are rejected before hot reload callbacks
+     * are invoked. Modules that declare native entries are not hot-reloadable. Hot reload also
+     * does not unload, reload, or replace native libraries loaded by module code.
      * </p>
      * <p>
      * Package lifecycle callbacks are not automatically replayed after hot reload. Override this

api/src/main/java/io/github/libxposed/api/package-info.java

@@ -135,6 +135,15 @@
  * needs lifecycle callbacks. This stops subsequent lifecycle callbacks only for the current entry;
  * hooks and other {@link io.github.libxposed.api.XposedInterface} APIs remain available.</p>
  *
+ * <p>Hot reload is supported only for modules that declare exactly one Java entry class. Modules
+ * with zero or multiple Java entry classes are not hot-reloadable.</p>
+ *
+ * <p>Hot reload is not supported for modules that declare native entries. If module code
+ * successfully loads a native library in a hooked target process through
+ * {@link java.lang.System#load(String)} or {@link java.lang.System#loadLibrary(String)}, that
+ * target is no longer hot-reloadable until it restarts. Hot reload never unloads, reloads, or
+ * replaces native libraries loaded by a previous module generation.</p>
+ *
  * <h2>Error Handling</h2>
  *
  * <p>Framework-level errors are reported via subclasses of