Half of this has already been committed. Include wblock's changes that I somehow overlooked when this was originally done.
Details
Details
- Reviewers
bcr - Group Reviewers
manpages - Commits
- rG684cedb10dfc: ddb(4): improve wording
rGdc5a0d6d6d0c: ddb(4): improve wording
Diff Detail
Diff Detail
- Repository
- rS FreeBSD src repository - subversion
- Lint
Lint Passed - Unit
No Test Coverage - Build Status
Buildable 2039 Build 2047: arc lint + arc unit
Event Timeline
| share/man/man4/ddb.4 | ||
|---|---|---|
| 1455 | I would switch word order here to smooth the sentence flow... ... can be difficult to arrange in some setups, however, so ... | |
| share/man/man4/ddb.4 | ||
|---|---|---|
| 1440 | s/IMPI/IPMI/ | |
| 1448 | Avoid "you", and try to clear up the last part of the sentence: Serial consoles can break to the debugger by sending a BREAK condition on the serial line. This requires a kernel built with .Cd options BREAK_TO_DEBUGGER . | |
| 1453 | s/or via a// | |
| 1460 | This sentence is very long and difficult to follow. Best to split it up into shorter sentences. Sending the break can be difficult or even happen spuriously in some setups. An alternate method is to build a kernel with .Cd options ALT_BREAK_TO_DEBUGGER . With that kernel, the sequence of CR TILDE CTRL-B enters the debugger, CR TILDE CTRL-P causes a panic instead of entering the debugger, and CR TILDE CTRL-R causes an immediate reboot. | |
| 1461 | In all these sequences, CR represents a Carriage Return and is usually sent by pressing the Enter or Return key. | |
| 1464 | CTRL-x is Control x, sent by pressing the Control key, then x, then releasing both. There probably should be some markup on "x" to represent the key, also on the tilde in the previous sentence. | |
| 1467 | s/may/can/, also use a compound adjective, and the final "the" is probably not needed: The break-to-debugger behavior can also be enabled by setting | |
| 1471 | As above: The alt-break-to-debugger behavior can also be enabled by setting | |
| 1475 | The debugger can be entered by setting | |