Page MenuHomeFreeBSD
Differential D56475

tests.7: Provide better examples
ClosedPublic
Actions

Authored by des on Apr 17 2026, 6:11 PM.
Tags
None
Referenced Files
Unknown Object (File)
Mon, May 18, 10:44 PM
Unknown Object (File)
Mon, May 18, 9:28 PM
Unknown Object (File)
Mon, May 18, 2:24 AM
Unknown Object (File)
Mon, May 18, 1:33 AM
Unknown Object (File)
Sun, May 17, 11:27 PM
Unknown Object (File)
Sun, May 17, 11:22 PM
Unknown Object (File)
Sun, May 17, 3:26 PM
Unknown Object (File)
Sun, May 17, 3:17 PM
View All 37 Files
Subscribers
imp
ngie
ziaee

Details

Reviewers
ziaee
ngie
Group Reviewers
srcmgr
manpages
tests
Commits
rG3e08beca5acb: tests.7: Provide better examples
rG3d00db6b8b73: tests.7: Provide better examples
Summary

Previous authors appear to have prioritized brevity over clarity. This
unfortunately resulted in a manual page that left its reader with the
false impression that Kyua is difficult to use. Attempt to correct
this by providing more and simpler examples with longer explanations.

While here, correct outdated information about where Kyua stores its
logs and results.

MFC after: 1 week

Diff Detail

Repository
rG FreeBSD src repository
Lint
Lint Skipped
Unit
Tests Skipped
Build Status
Buildable 72323
Build 69206: arc lint + arc unit

Event Timeline

des created this revision.Apr 17 2026, 6:11 PM
Herald added subscribers: ziaee, imp. · View Herald TranscriptApr 17 2026, 6:11 PM
des requested review of this revision.Apr 17 2026, 6:11 PM
Harbormaster completed remote builds in B72294: Diff 175773.Apr 17 2026, 6:11 PM
des added a reviewer: tests.Apr 17 2026, 6:55 PM
ziaee accepted this revision.Apr 17 2026, 7:18 PM

LGTM from manpages. If you have a moment the https://reviews.freebsd.org/D56153 you requested is awaiting your review.

This revision is now accepted and ready to land.Apr 17 2026, 7:18 PM
ngie accepted this revision.Apr 18 2026, 1:50 AM
ngie added a subscriber: ngie.
ngie added inline comments.
share/man/man7/tests.7
149–153

I would note that kyua debug doesn't automatically clean up the sandbox kyua makes at test completion (or just point someone to man 1 kyua).

des added inline comments.Apr 18 2026, 8:19 AM
share/man/man7/tests.7
149–153

Yes it does. I can add a mention of -p though, if that's what you're thinking of.

des updated this revision to Diff 175836.Apr 18 2026, 12:52 PM

kyua debug -p

This revision now requires review to proceed.Apr 18 2026, 12:52 PM
Harbormaster completed remote builds in B72323: Diff 175836.Apr 18 2026, 12:52 PM
des marked an inline comment as done.Apr 18 2026, 12:52 PM
This revision was not accepted when it landed; it landed in state Needs Review.Wed, Apr 22, 8:20 AM
Closed by commit rG3d00db6b8b73: tests.7: Provide better examples (authored by des). · Explain Why
This revision was automatically updated to reflect the committed changes.
des added a commit: rG3d00db6b8b73: tests.7: Provide better examples.
des added a commit: rG3e08beca5acb: tests.7: Provide better examples.Sat, Apr 25, 5:12 PM

Revision Contents
Changeset List

PathSize
share/
man/
man7/
102 lines

Diff 175836

View Options

share/man/man7/tests.7

Loading...