validate and repair Unidoc’s own documentation

Author: tayloraswift

Sources/GitHubAPI/GitHub.OAuth.swift

@@ -6,7 +6,7 @@ extension GitHub
     ///
     /// >   Note:
     /// This type would be named `GitHub.OAuthApp`, but then ``GitHub.App`` would have to be
-    /// named ``GitHub.AppApp``, and that would just be stupid.
+    /// named `GitHub.AppApp`, and that would just be stupid.
     @frozen public
     struct OAuth:GitHubApplication
     {

Sources/HTTP/HTTP.Resource.Content.Body.swift

@@ -33,8 +33,7 @@ extension HTTP.Resource.Content.Body:CustomStringConvertible
 }
 extension HTTP.Resource.Content.Body
 {
-    /// The size of the content to be transferred, in bytes. Unlike ``length``, this property
-    /// is zero if the content is a ``length(_:)`` cache result.
+    /// The size of the content to be transferred, in bytes.
     @inlinable public
     var size:Int
     {
@@ -45,16 +44,4 @@ extension HTTP.Resource.Content.Body
         case .string(let string):   string.utf8.count
         }
     }
-    /// The logical length of the content, in bytes, which may not reflect the actual ``size``
-    /// of the data to be transferred.
-    @inlinable public
-    var length:Int
-    {
-        switch self
-        {
-        case .binary(let buffer):   buffer.count
-        case .buffer(let buffer):   buffer.readableBytes
-        case .string(let string):   string.utf8.count
-        }
-    }
 }

Sources/HTTP/HTTP.Resource.swift

@@ -37,7 +37,7 @@ extension HTTP.Resource:ExpressibleByStringLiteral, ExpressibleByStringInterpola
 extension HTTP.Resource
 {
     /// Computes and populates the resource ``hash`` if it has not already been computed, and
-    /// drops the payload if it matches the given ``tag``.
+    /// drops the payload if it matches the given `tag`.
     public mutating
     func optimize(tag:MD5?)
     {

Sources/HTTPServer/HTTP.ServerIntegralRequest.swift

@@ -20,7 +20,7 @@ extension HTTP
 extension HTTP.ServerIntegralRequest
 {
     /// Inefficiently converts the headers to equivalent HPACK headers, and calls the witness
-    /// for ``init?(get:headers:origin:)``.
+    /// for ``init(get:headers:origin:) [37U4H]``.
     ///
     /// Servers that expect to handle a lot of HTTP/1.1 GET requests should override this with
     /// a more efficient implementation.
@@ -33,7 +33,7 @@ extension HTTP.ServerIntegralRequest
     }
 
     /// Inefficiently converts the headers to equivalent HPACK headers, and calls the witness
-    /// for ``init?(post:headers:origin:body:)``.
+    /// for ``init(post:headers:origin:body:) [XBU7]``.
     ///
     /// Servers that expect to handle a lot of HTTP/1.1 POST requests should override this with
     /// a more efficient implementation.

Sources/IP/IP.V4.swift

@@ -1,6 +1,6 @@
 extension IP
 {
-    /// A native SwiftNIO ``IPv4Address`` is reference counted and resilient, and we
+    /// A native SwiftNIO `IPv4Address` is reference counted and resilient, and we
     /// would rather pass around an inline value type.
     @frozen public
     struct V4:Equatable, Hashable, Sendable

Sources/IP/IP.V6.swift

@@ -1,6 +1,6 @@
 extension IP
 {
-    /// A native SwiftNIO ``IPv6Address`` is reference counted and resilient, and we
+    /// A native SwiftNIO `IPv6Address` is reference counted and resilient, and we
     /// would rather pass around an inline value type.
     @frozen public
     struct V6:Equatable, Hashable, Sendable

Sources/MarkdownABI/README.md

@@ -57,4 +57,4 @@ Codewords and references can contain valid UTF-8 sequences. Therefore, they are
 -   ``Markdown.CodeLanguageType``
 -   ``Markdown.DiffType``
 -   ``Markdown.PlainText``
--   ``Markdown.PlainText.Highligher``
+-   ``Markdown.PlainText.Highlighter``

Sources/MarkdownAST/BlockElements/Markdown.BlockProse.swift

@@ -24,8 +24,9 @@ extension Markdown
             }
         }
 
-        /// Calls the superclass method, and then calls ``Markdown.TreeElement/outline(by:)``
-        /// on each of the inline elements in this container.
+        /// Calls the superclass method, and then calls
+        /// ``Markdown.InlineElement/outline(by:) [6AL0]`` on each of the inline elements in
+        /// this container.
         @inlinable public final override
         func outline(by register:(Markdown.AnyReference) throws -> Int?) rethrows
         {

Sources/MarkdownAST/Markdown.Source.swift

@@ -15,7 +15,7 @@ extension Markdown
     {
         /// The absolute location of the markdown source within a larger source file,
         /// if known. If the markdown source was a standalone markdown file, this is
-        /// ``SourceLocation/zero``.
+        /// ``SourcePosition/zero``.
         public
         let origin:SourceLocation<Int32>?
         /// The unparsed markdown source text.

Sources/MarkdownAST/TableElements/Markdown.Table.AnyCell.swift

@@ -12,7 +12,7 @@ extension Markdown.Table
         /// without any alignment attributes.
         ///
         /// This method will never actually be called, because ``Markdown.Table`` bypasses it
-        /// in favor of the ``emit(into:alignment:)`` method.
+        /// in favor of the (internal) `emit(into:alignment:)` method.
         public final override
         func emit(into binary:inout Markdown.BinaryEncoder)
         {