Guard against broken intra-doc links in CI (#2616)

.github/workflows/clippy-fmt.yml

@@ -5,6 +5,24 @@ on:
     types: [opened, synchronize, reopened]
 
 jobs:
+  lint-docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Install Rust
+        uses: actions-rs/toolchain@v1
+        with:
+          toolchain: stable
+          profile: minimal
+          components: rust-docs
+      - name: Check for broken intra-doc links
+        uses: actions-rs/cargo@v1
+        env:
+          RUSTDOCFLAGS: "-D warnings"
+        with:
+          command: doc
+          args: --no-deps --all-features --workspace
+
   fmt:
     runs-on: ubuntu-latest
     steps:

actix-files/src/named.rs

@@ -209,6 +209,7 @@ impl NamedFile {
         Self::from_file(file, path)
     }
 
+    #[allow(rustdoc::broken_intra_doc_links)]
     /// Attempts to open a file asynchronously in read-only mode.
     ///
     /// When the `experimental-io-uring` crate feature is enabled, this will be async.
@@ -300,7 +301,7 @@ impl NamedFile {
 
     /// Set content encoding for serving this file
     ///
-    /// Must be used with [`actix_web::middleware::Compress`] to take effect.
+    /// Must be used with `actix_web::middleware::Compress` to take effect.
     #[inline]
     pub fn set_content_encoding(mut self, enc: ContentEncoding) -> Self {
         self.encoding = Some(enc);