Details

Reviewers

wulf
val_packett.cool

Group Reviewers

manpages

Commits

rG893e5b702077: hgame.4: Polish
rG31e7ee6bd524: hgame.4: Polish
rGc0c8d812b560: hgame.4: Polish

Summary

hgame.4: Smooth criminal edition

+ updated document description to answer all your questions
+ updated synopsis section to answer all your questions
+ updated description section to answer all your questions
+ add something to supported hardware to answer all your questions
+ adjust files section to answer all your questions

MFC after:      3 days

Diff Detail

Repository

rG FreeBSD src repository

Lint

Lint Not Applicable

Unit

Tests Not Applicable

Event Timeline

ziaee created this revision.Oct 23 2025, 2:35 AM

Herald added a subscriber: imp. · View Herald TranscriptOct 23 2025, 2:35 AM

ziaee requested review of this revision.Oct 23 2025, 2:35 AM

Harbormaster completed remote builds in B68032: Diff 164838.Oct 23 2025, 2:35 AM

ziaee added a reviewer: wulf.Oct 23 2025, 2:57 AM

ziaee retitled this revision from hgame.4: Add HARDWARE for HW Relnotes to hgame.4: Smooth criminal edition.Nov 6 2025, 2:02 AM

ziaee edited the summary of this revision. (Show Details)

ziaee added a reviewer: val_packett.cool.

/smooth/

Harbormaster completed remote builds in B68447: Diff 165931.Nov 6 2025, 2:02 AM

Add something about devfs.rules. I don't actually know if any of this
is accurate because I don't have this working. So far, 0660ing
/dev/input/event* lets the applications I've tried see something is
plugged in, but the buttons don't work yet.

Harbormaster completed remote builds in B68579: Diff 166326.Nov 12 2025, 8:29 PM

I suppose hgame_load is a variable, not a command.

Harbormaster completed remote builds in B68581: Diff 166329.Nov 12 2025, 9:02 PM

wulf accepted this revision.Nov 12 2025, 9:13 PM

This revision is now accepted and ready to land.Nov 12 2025, 9:13 PM

I'm not sure what you mean by "Smooth criminal edition". Can you explain?

share/man/man4/hgame.4
97	While here or in another change.

I'm not sure what you mean by "Smooth criminal edition". Can you explain?

I (think I'm) making the manual page smooth. It's criminal because I can't get this to work. I can't keep track of notes, so I fix manpages as I'm bringing stuff up. I get stuck, I post the manpage with that notice ("I don't actually know if any of this is accurate because I don't have this working."), and someone comes and helps me.

A huge motivator is I ask how to use controllers, and people point me to this:

https://alfaexploit.com/en/posts/gamepads_and_emulators_on_freebsd/

I can use Google, I obviously saw that; however chmoding the /dev/usb is obviously wrong and not what anyone should do.

How to get the driver working, for real with no extra stuff, needs to be in the reference manual for the driver.

Perhaps something less judgemental than "criminal", like "misleading" or "incomplete"?

In D53290#1226634, @pauamma_gundo.com wrote:

Perhaps something less judgemental than "criminal", like "misleading" or "incomplete"?

Smooth criminal is an iconic American pop song from 40 years ago -- but that is completely reasonable.

Honestly, I am not ready to commit this yet because I don't have the driver working, so I figured I'd fix it before then. I try to make good commit messages, that say why instead of what, and this draft message is supposed to just be something lighthearted that makes people smile a bit.

Thanks for the clarification.

You are very welcome and I appreciate your attention to this matter.

Closed by commit rGc0c8d812b560: hgame.4: Polish (authored by ziaee). · Explain WhyThu, Nov 13, 11:58 PM

This revision was automatically updated to reflect the committed changes.

ziaee added a commit: rGc0c8d812b560: hgame.4: Polish.

ziaee added a commit: rG31e7ee6bd524: hgame.4: Polish.Fri, Nov 14, 12:16 AM

cperciva added a commit: rG893e5b702077: hgame.4: Polish.Fri, Nov 14, 2:35 AM