Fix #5960: Update kdoc for LintTimeoutWrapper (#5966)

<!-- READ ME FIRST: Please fill in the explanation section below and
check off every point from the Essential Checklist! -->
## Explanation
<!--
- Explain what your PR does. If this PR fixes an existing bug, please
include
- "Fixes #bugnum:" in the explanation so that GitHub can auto-close the
issue
  - when this PR is merged.
  -->
  Fix #5960 
  - Remove TODO related to the LintTimeoutWrapper 
- It was decided that it might be fine to leave a comment around the
wrapper explaining why it's there, and we could close issue #5960 since
the wrapper doesn't do any harm and there's proper context there for
future developers who are wondering why we have it.
## Essential Checklist
<!-- Please tick the relevant boxes by putting an "x" in them. -->
- [x] The PR title and explanation each start with "Fix #bugnum: " (If
this PR fixes part of an issue, prefix the title with "Fix part of
#bugnum: ...".)
- [x] Any changes to
[scripts/assets](https://github.com/oppia/oppia-android/tree/develop/scripts/assets)
files have their rationale included in the PR explanation.
- [x] The PR follows the [style
guide](https://github.com/oppia/oppia-android/wiki/Coding-style-guide).
- [x] The PR does not contain any unnecessary code changes from Android
Studio
([reference](https://github.com/oppia/oppia-android/wiki/Guidance-on-submitting-a-PR#undo-unnecessary-changes)).
- [x] The PR is made from a branch that's **not** called "develop" and
is up-to-date with "develop".
- [x] The PR is **assigned** to the appropriate reviewers
([reference](https://github.com/oppia/oppia-android/wiki/Guidance-on-submitting-a-PR#clarification-regarding-assignees-and-reviewers-section)).

Author: manas-yu

scripts/src/java/org/oppia/android/scripts/lint/AndroidLintRunner.kt

@@ -297,8 +297,18 @@ class AndroidLintAnalyzer(
   }
 }
 
-// TODO(#5960): Remove LintTimeoutWrapper once Lint supports dispatcher timeouts.
-/** Wrapper class to run lint with timeout protection. */
+/**
+ * Wrapper class to run lint with timeout protection.
+ *
+ * The lint tool sometimes hangs on certain systems after writing the report
+ * (likely due to lingering non-daemon threads in the native Java process).
+ * Since lint runs natively inside this script as a Java application,
+ * it may continue running indefinitely unless explicitly stopped.
+ *
+ * This utility ensures that lint execution terminates within a bounded time,
+ * preventing hangs by enforcing a timeout and interrupting the process if
+ * it fails to complete.
+ */
 class LintTimeoutWrapper(
   private val cliArgs: Array<String>,
   private val timeoutMinutes: Long

scripts/src/java/org/oppia/android/scripts/lint/LintAnalysisReporter.kt

@@ -544,7 +544,7 @@ class LintAnalysisReporter(private val repoRoot: File) {
           wrapText(
             "In $filePath the ${toUpperSnakeCase(issueId)} exemption is redundant" +
               " and can be removed since there are no corresponding lint issues." +
-              "Refer Android Lint Check Wiki for more information:" +
+              "\nRefer to the Android Lint Check Wiki for more information:" +
               " https://github.com/oppia/oppia-android/wiki/" +
               "Android-Lint-Check#exemption-file-maintenance-prompts"
           )
@@ -750,7 +750,8 @@ class LintAnalysisReporter(private val repoRoot: File) {
       println("${YELLOW}UNUSED ENUM MAPPINGS DETECTED:$RESET")
       println(
         "The following issue IDs are defined in issueIdMapping " +
-          "but no corresponding lint issues were found. Refer Android Lint Check Wiki for more" +
+          "but no corresponding lint issues were found." +
+          "\nRefer to the Android Lint Check Wiki for more" +
           " information: https://github.com/oppia/oppia-android/wiki/" +
           "Android-Lint-Check#unused-enum-mappings-detection"
       )