fixing up doc comment for the validator

heckj · rauhul · commit d79d7c5e7c54 · 2025-08-19T09:48:17.000-07:00
diff --git a/Tools/generate-docc-reference/Extensions/ArgumentParser+Markdown.swift b/Tools/generate-docc-reference/Extensions/ArgumentParser+Markdown.swift
@@ -113,6 +113,7 @@ extension CommandInfoV0 {
   /// - Parameters:
   ///   - startlength: The starting width of the line this multi-line string appends onto.
   ///   - wraplength: The maximum width  of the multi-linecode block.
+  /// - Returns: A wrapped, multi-line string that wraps the commands arguments into a text block.
   public func usage(startlength: Int, wraplength: Int) -> String {
     guard let args = self.arguments else {
       return ""
@@ -136,7 +137,6 @@ extension CommandInfoV0 {
       }
     }
     return multilineString
-    //return args.map { $0.usage() }.joined(separator: " ")
   }
 }
 

Original file line number	Diff line number	Diff line change
`@@ -113,6 +113,7 @@ extension CommandInfoV0 {`
`113`	`113`	`/// - Parameters:`
`114`	`114`	`/// - startlength: The starting width of the line this multi-line string appends onto.`
`115`	`115`	`/// - wraplength: The maximum width of the multi-linecode block.`
	`116`	`+ /// - Returns: A wrapped, multi-line string that wraps the commands arguments into a text block.`
`116`	`117`	`public func usage(startlength: Int, wraplength: Int) -> String {`
`117`	`118`	`guard let args = self.arguments else {`
`118`	`119`	`return ""`
`@@ -136,7 +137,6 @@ extension CommandInfoV0 {`
`136`	`137`	`}`
`137`	`138`	`}`
`138`	`139`	`return multilineString`
`139`		`- //return args.map { $0.usage() }.joined(separator: " ")`
`140`	`140`	`}`
`141`	`141`	`}`
`142`	`142`