@@ -1489,18 +1489,18 @@ commands: Map(6) {
1489
1489
1490
1490
Each of these six commands is actually _three_ programs:
1491
1491
1492
- 1. The **effector** (` programs .effector ` ) programs is responsible for
1492
+ 1. The **effector** (` programs .effector ` ) programs are responsible for
1493
1493
second-pass arguments parsing and comprehensive validation, executing each
1494
1494
command's actual [` handler` ][8] function, generating specific help text
1495
1495
during errors, and ensuring the final parse result bubbles up to the router
1496
1496
program.
1497
1497
1498
- 2. The **helper** (` programs .helper ` ) programs is responsible for generating
1498
+ 2. The **helper** (` programs .helper ` ) programs are responsible for generating
1499
1499
generic help text as well as first-pass arguments parsing and initial
1500
1500
validation. Said parse result is used as the ` argv` third parameter passed to
1501
1501
the [` builder` ][8] functions of effectors.
1502
1502
1503
- 3. The **router** (` programs .router ` ) programs is responsible for proxying
1503
+ 3. The **router** (` programs .router ` ) programs are responsible for proxying
1504
1504
control to other routers and to helpers, and for ensuring exceptions and
1505
1505
final parse results bubble up to the root Black Flag execution context
1506
1506
([` PreExecutionContext:: execute` ][12]) for handling.
@@ -1652,7 +1652,7 @@ What follows is a flow diagram illustrating Black Flag's execution flow using
1652
1652
the ` myctl` example from the previous sections.
1653
1653
1654
1654
` ` ` text
1655
- ` myctl --version `
1655
+ ` myctl --verbose `
1656
1656
┌───────────────────────────────────┐
1657
1657
│ 2 │
1658
1658
│ ┌─────►┌───────────┐ │
@@ -1734,9 +1734,9 @@ Suppose the user executes `myctl --verbose`.<sup>🡒1</sup> Black Flag (using
1734
1734
` runProgram` ) calls your configuration hooks, discovers all available commands,
1735
1735
and creates three programs per discovered command: the "router", "helper", and
1736
1736
"effector". If there was an error during discovery/configuration or hook
1737
- execution, the error handling hook would execute before the process exited with
1738
- the appropriate code.<sup>1🡒R1</sup> This is how all errors that bubble up are
1739
- handled. Otherwise, Black Flag calls the root
1737
+ execution, an internal error handling routine would execute before the process
1738
+ exited with the appropriate code.<sup>1🡒R1</sup> This is how all errors that
1739
+ bubble up are handled. Otherwise, Black Flag calls the root
1740
1740
` RouterProgram:: parseAsync` .<sup>1🡒2</sup> The router detects that the given
1741
1741
arguments refer to the current command and so calls
1742
1742
` HelperProgram:: parseAsync` .<sup>2🡒3B</sup> If the helper throws (e.g. due to a
0 commit comments