Page MenuHomeFreeBSD

bhyve.8: Update and rearrange to improve readability
ClosedPublic

Authored by jrm on Apr 26 2024, 6:43 PM.
Tags
None
Referenced Files
Unknown Object (File)
Thu, Nov 28, 4:20 PM
Unknown Object (File)
Thu, Nov 28, 4:19 PM
Unknown Object (File)
Thu, Nov 28, 3:56 PM
Unknown Object (File)
Nov 6 2024, 12:28 PM
Unknown Object (File)
Nov 6 2024, 10:31 AM
Unknown Object (File)
Nov 6 2024, 3:37 AM
Unknown Object (File)
Oct 20 2024, 1:23 PM
Unknown Object (File)
Sep 25 2024, 11:00 AM
Subscribers

Details

Reviewers
freebsd_ny-central.org
Group Reviewers
bhyve
Summary

bhyve's man page is a very long block of text that has grown to
proportions that make it hard to read. In particular, the level of
nesting of various content means man can no longer render the text in a
user-friendly way.

To remedy this:

  • move the -s argument documentation into a separate section and reformat the various arguments so they are consistent
  • add documentation on how to use the -o config.dump feature
  • make the listing of the various arguments more consistent
  • consolidated duplicate listing of TPM backends
  • add an example for the config.dump feature
  • fix various formatting inconsistencies.

Diff Detail

Repository
rG FreeBSD src repository
Lint
Lint Passed
Unit
No Test Coverage
Build Status
Buildable 57401
Build 54289: arc lint + arc unit

Event Timeline

jrm requested review of this revision.Apr 26 2024, 6:43 PM
jrm retitled this revision from bhyve.8: Update an rearrange to improve readability to bhyve.8: Update and rearrange to improve readability.Apr 26 2024, 6:44 PM

Chris, rather than overwrite your review, I rebased your work on top of the latest of the main branch. The commit message is based on your summary in D43940. If everything looks good to you, I'll commit.

Looks good to me! Thanks for helping with the rebase. Need to keep in mind to keep those patches up-to-date in the future.

This revision is now accepted and ready to land.Apr 27 2024, 1:11 PM