docs: update help text for readability in Repeat example and README (#787)

* docs: update help text for readability in Repeat example and README

* Update help text snapshots for repeat command to fix test failures

Author: Konstantin-Krokhin

Examples/repeat/Repeat.swift

@@ -13,7 +13,7 @@ import ArgumentParser
 
 @main
 struct Repeat: ParsableCommand {
-  @Option(help: "The number of times to repeat 'phrase'.")
+  @Option(help: "How many times to repeat 'phrase'.")
   var count: Int? = nil
 
   @Flag(help: "Include a counter with each repetition.")

README.md

@@ -18,7 +18,7 @@ struct Repeat: ParsableCommand {
     @Flag(help: "Include a counter with each repetition.")
     var includeCounter = false
 
-    @Option(name: .shortAndLong, help: "The number of times to repeat 'phrase'.")
+    @Option(name: .shortAndLong, help: "How many times to repeat 'phrase'.")
     var count: Int? = nil
 
     @Argument(help: "The phrase to repeat.")

Tests/ArgumentParserExampleTests/RepeatExampleTests.swift

@@ -61,7 +61,7 @@ final class RepeatExampleTests: XCTestCase {
         <phrase>                The phrase to repeat.
 
       OPTIONS:
-        --count <count>         The number of times to repeat 'phrase'.
+        --count <count>         How many times to repeat 'phrase'.
         --include-counter       Include a counter with each repetition.
         -h, --help              Show help information.
 
@@ -84,7 +84,7 @@ final class RepeatExampleTests: XCTestCase {
           <phrase>                The phrase to repeat.
 
         OPTIONS:
-          --count <count>         The number of times to repeat 'phrase'.
+          --count <count>         How many times to repeat 'phrase'.
           --include-counter       Include a counter with each repetition.
           -h, --help              Show help information.
 
@@ -96,7 +96,7 @@ final class RepeatExampleTests: XCTestCase {
       command: "repeat hello --count",
       expected: """
         Error: Missing value for '--count <count>'
-        Help:  --count <count>  The number of times to repeat 'phrase'.
+        Help:  --count <count>  How many times to repeat 'phrase'.
         Usage: repeat [--count <count>] [--include-counter] <phrase>
           See 'repeat --help' for more information.
 
@@ -107,7 +107,7 @@ final class RepeatExampleTests: XCTestCase {
       command: "repeat hello --count ZZZ",
       expected: """
         Error: The value 'ZZZ' is invalid for '--count <count>'
-        Help:  --count <count>  The number of times to repeat 'phrase'.
+        Help:  --count <count>  How many times to repeat 'phrase'.
         Usage: repeat [--count <count>] [--include-counter] <phrase>
           See 'repeat --help' for more information.
 

Tests/ArgumentParserGenerateDoccReferenceTests/Snapshots/testRepeatDoccReference().md

@@ -8,7 +8,7 @@ repeat [--count=<count>] [--include-counter] <phrase> [--help]
 
 - term **--count=\<count\>**:
 
-*The number of times to repeat 'phrase'.*
+*How many times to repeat 'phrase'.*
 
 
 - term **--include-counter**:

Tests/ArgumentParserGenerateDoccReferenceTests/Snapshots/testRepeatMarkdownReference().md

@@ -8,7 +8,7 @@ repeat [--count=<count>] [--include-counter] <phrase> [--help]
 
 **--count=\<count\>:**
 
-*The number of times to repeat 'phrase'.*
+*How many times to repeat 'phrase'.*
 
 
 **--include-counter:**

Tests/ArgumentParserGenerateManualTests/Snapshots/testRepeatMultiPageManual().mdoc

@@ -14,7 +14,7 @@
 .Sh DESCRIPTION
 .Bl -tag -width 6n
 .It Fl -count Ar count
-The number of times to repeat 'phrase'.
+How many times to repeat 'phrase'.
 .It Fl -include-counter
 Include a counter with each repetition.
 .It Ar phrase

Tests/ArgumentParserGenerateManualTests/Snapshots/testRepeatSinglePageManual().mdoc

@@ -14,7 +14,7 @@
 .Sh DESCRIPTION
 .Bl -tag -width 6n
 .It Fl -count Ar count
-The number of times to repeat 'phrase'.
+How many times to repeat 'phrase'.
 .It Fl -include-counter
 Include a counter with each repetition.
 .It Ar phrase

Tests/ArgumentParserUnitTests/ParsableArgumentsValidationTests.swift

@@ -16,7 +16,7 @@ import XCTest
 
 final class ParsableArgumentsValidationTests: XCTestCase {
   private struct A: ParsableCommand {
-    @Option(help: "The number of times to repeat 'phrase'.")
+    @Option(help: "How many times to repeat 'phrase'.")
     var count: Int?
 
     @Argument(help: "The phrase to repeat.")
@@ -31,7 +31,7 @@ final class ParsableArgumentsValidationTests: XCTestCase {
   }
 
   private struct B: ParsableCommand {
-    @Option(help: "The number of times to repeat 'phrase'.")
+    @Option(help: "How many times to repeat 'phrase'.")
     var count: Int?
 
     @Argument(help: "The phrase to repeat.")
@@ -41,7 +41,7 @@ final class ParsableArgumentsValidationTests: XCTestCase {
   }
 
   private struct C: ParsableCommand {
-    @Option(help: "The number of times to repeat 'phrase'.")
+    @Option(help: "How many times to repeat 'phrase'.")
     var count: Int?
 
     @Argument(help: "The phrase to repeat.")
@@ -58,7 +58,7 @@ final class ParsableArgumentsValidationTests: XCTestCase {
     @Argument(help: "The phrase to repeat.")
     var phrase: String
 
-    @Option(help: "The number of times to repeat 'phrase'.")
+    @Option(help: "How many times to repeat 'phrase'.")
     var count: Int?
 
     enum CodingKeys: String, CodingKey {
@@ -70,7 +70,7 @@ final class ParsableArgumentsValidationTests: XCTestCase {
     @Argument(help: "The phrase to repeat.")
     var phrase: String
 
-    @Option(help: "The number of times to repeat 'phrase'.")
+    @Option(help: "How many times to repeat 'phrase'.")
     var count: Int?
 
     @Flag(help: "Include a counter with each repetition.")
@@ -128,7 +128,7 @@ final class ParsableArgumentsValidationTests: XCTestCase {
     @Argument(help: "The phrase to repeat.")
     var phrase: String = ""
 
-    @Option(help: "The number of times to repeat 'phrase'.")
+    @Option(help: "How many times to repeat 'phrase'.")
     var count: Int = 0
 
     init() {}