Document IllegalArgumentExceptions thrown by various Glide.with methods.

This is to address issue #5528.

PiperOrigin-RevId: 771265021

Author: falhassen

library/src/main/java/com/bumptech/glide/Glide.java

@@ -554,6 +554,8 @@ public static RequestManager with(@NonNull Context context) {
    * @deprecated This is equivalent to calling {@link #with(Context)} using the application context.
    *     Use the androidx Activity class instead (ie {@link FragmentActivity}, or {@link
    *     androidx.appcompat.app.AppCompatActivity}).
+   * @throws IllegalArgumentException if the activity associated with the Glide request is being
+   *     destroyed.
    */
   @NonNull
   @Deprecated
@@ -566,8 +568,9 @@ public static RequestManager with(@NonNull Activity activity) {
    * androidx.fragment.app.FragmentActivity}'s lifecycle and that uses the given {@link
    * androidx.fragment.app.FragmentActivity}'s default options.
    *
-   * @param activity The activity to use.
+   * @param activity The activity to use. The activity must not be destroyed.
    * @return A RequestManager for the given FragmentActivity that can be used to start a load.
+   * @throws IllegalArgumentException if the activity is being destroyed.
    */
   @NonNull
   public static RequestManager with(@NonNull FragmentActivity activity) {
@@ -580,6 +583,7 @@ public static RequestManager with(@NonNull FragmentActivity activity) {
    *
    * @param fragment The fragment to use.
    * @return A RequestManager for the given Fragment that can be used to start a load.
+   * @throws IllegalArgumentException if the activity associated with the fragment is destroyed.
    */
   @NonNull
   public static RequestManager with(@NonNull Fragment fragment) {
@@ -595,6 +599,7 @@ public static RequestManager with(@NonNull Fragment fragment) {
    * @deprecated This method is identical to calling {@link Glide#with(Context)} using the
    *     application context. Prefer support Fragments and {@link #with(Fragment)} instead. See
    *     https://github.com/android/android-ktx/pull/161#issuecomment-363270555.
+   * @throws IllegalArgumentException if the activity associated with the fragment is destroyed.
    */
   @Deprecated
   @NonNull
@@ -628,6 +633,7 @@ public static RequestManager with(@NonNull android.app.Fragment fragment) {
    *
    * @param view The view to search for a containing Fragment or Activity from.
    * @return A RequestManager that can be used to start a load.
+   * @throws IllegalArgumentException if the activity associated with the view is destroyed.
    */
   @NonNull
   public static RequestManager with(@NonNull View view) {