[#1803] DOC: show @Command-annotated method with int return value in user manual

Author: remkop

RELEASE-NOTES.md

@@ -125,6 +125,7 @@ Picocli 4.7.0 introduced a `sortSynopsis = false` attribute to let the synopsis
 * [#1788] DOC: add link to `picocli-examples` in the user manual. Thanks to [Markus Elfring](https://github.com/Markus-Elfring) for raising this.
 * [#1796] DOC: Fixing broken links and typos. Thanks to [Andreas Deininger](https://github.com/deining) for the pull request.
 * [#1798] DOC: update examples for jakarta.validation-api. Thanks to [Roy](https://github.com/ashr123) for raising this.
+* [#1803] DOC: show `@Command`-annotated method with `int` return value in user manual. Thanks to [SinaMobasheri](https://github.com/SinaMobasheri) for raising this.
 * [#1581] BUILD: Fix dependabot config.
 * [#1613] DEP: The `picocli-groovy` module now declares `groovy-all` as dependency.
 * [#1604] DEP: Remove dependency on `slf4j` from `picocli-spring-boot-starter`.

docs/index.adoc

@@ -10594,12 +10594,13 @@ class Cat {
 
     @Command(description = "Concatenate FILE(s) to standard output.",
              mixinStandardHelpOptions = true, version = "4.1.3")
-    void cat(@Option(names = {"-E", "--show-ends"}) boolean showEnds,
+    int cat(@Option(names = {"-E", "--show-ends"}) boolean showEnds,
              @Option(names = {"-n", "--number"}) boolean number,
              @Option(names = {"-T", "--show-tabs"}) boolean showTabs,
              @Option(names = {"-v", "--show-nonprinting"}) boolean showNonPrinting,
              @Parameters(paramLabel = "FILE") File[] files) {
         // process files
+        return CommandLine.ExitCode.OK;
     }
 }
 ----
@@ -10614,8 +10615,9 @@ class Cat {
             @Option(names = ["-n", "--number"]) number: Boolean,
             @Option(names = ["-T", "--show-tabs"]) showTabs: Boolean,
             @Option(names = ["-v", "--show-nonprinting"]) showNonPrinting: Boolean,
-            @Parameters(paramLabel = "FILE") files: Array<File>?) {
+            @Parameters(paramLabel = "FILE") files: Array<File>?): Int {
         // process files
+        return CommandLine.ExitCode.OK
     }
 }