Potential fix for pull request finding

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Author: tballison

tika-core/src/main/java/org/apache/tika/detect/MetadataCharsetDetector.java

@@ -40,7 +40,9 @@
  *       HTTP/MIME Content-Type header (e.g. {@code text/html; charset=UTF-8}).</li>
  *   <li>{@link TikaCoreProperties#CONTENT_TYPE_HINT} — the {@code charset} parameter
  *       of a content-type a source <em>claimed</em> for the bytes (e.g. an HTML
- *       {@code <meta>} tag, or a zip entry's UTF-8 (EFS) flag). A hint, not a verdict.</li>
+ *       {@code <meta>} tag, or a zip entry's UTF-8 (EFS) flag). A hint, not a verdict.
+ *       This key is only consulted when {@link MetadataCharsetDetector} is included in
+ *       the active {@link org.apache.tika.detect.EncodingDetector} chain.</li>
  *   <li>{@link Metadata#CONTENT_ENCODING} — a bare charset label set by parsers
  *       such as {@code RFC822Parser}, which splits Content-Type into a bare
  *       media-type key and a separate charset key.</li>