Doc: clarify priority of lint level sources

This updates the rustc book to clearly document how conflicting lint configurations are resolved across different sources, including command-line flags, crate-level attributes, in-line attributes, and `--cap-lints`.

It also explains the special behavior of `forbid` and `force_warn`.

Author: HamidrezaSK

src/doc/rustc/src/lints/levels.md

@@ -330,4 +330,56 @@ $
 
 This feature is used heavily by Cargo; it will pass `--cap-lints allow` when
 compiling your dependencies, so that if they have any warnings, they do not
-pollute the output of your build.
+pollute the output of your build. However, note that `--cap-lints allow` does **not** override lints marked as `force-warn`.
+
+## Priority of Lint Level Sources
+
+Rust allows setting lint levels (`allow`, `warn`, `deny`, etc.) through various sources:
+
+- Attributes (`#[allow(...)]`, `#![deny(...)]`, etc.)
+- Command-line options (e.g., `--cap-lints`, `-A unused_variables`)
+
+These mechanisms can interact in subtle ways, the compiler resolves conflicts based on the **source’s scope and strength**.
+
+### Priority of sources (`allow`, `warn`, and `deny`)
+
+For standard lint levels, **the most specific scope** takes precedence.
+
+For example, the following allows the `unused-variables` lint, because it has a more specific scope:
+
+```rust
+#![deny(unused_variables)]
+
+#[allow(unused_variables)]
+fn main() {
+    let x = 42; // Allow wins
+}
+```
+
+### Priority of sources (`force-warn`and `forbid`)
+
+Special lint levels take precedence over standard levels. When multiple special levels are in effect, **the least specific (outermost) scope** takes precedence.
+
+For example, consider the following:
+
+```rust
+#[forbid(unused_variables)]
+fn main() {
+    let x = 42; // Allow wins
+}
+```
+
+If we compile it with `--force-warn unused_variables`:
+
+```bash
+$ rustc --force-warn unused_variables lib.rs 
+warning: unused variable: `x`
+  --> lib.rs:3:9
+   |
+40 |     let x = 42;
+   |         ^ help: if this is intentional, prefix it with an underscore: `_x`
+   |
+   = note: requested on the command line with `--force-warn unused-variables`
+
+warning: 1 warning emitted
+```