flua: Expand man page coverage a bit
Needs ReviewPublic
Actions

Authored by markj on Sep 5 2024, 10:42 PM.

Details

Reviewers

kevans
imp
bapt

Summary

Reference intro.3lua from intro.1.
Try to make intro.3lua a bit more informative, though it's still quite lacking.
Add an incomplete posix.3lua man page.

I'm not quite sure how best to handle posix.3lua: should we split it up
per header file, i.e., posix.unistd.3lua, etc.? I'm not sure yet.

Diff Detail

Repository

rG FreeBSD src repository

Lint

Lint Skipped

Unit

Tests Skipped

Build Status

Buildable 59332
Build 56219: arc lint + arc unit

Event Timeline

markj requested review of this revision.Sep 5 2024, 10:42 PM

markj created this revision.

Harbormaster completed remote builds in B59332: Diff 142998.Sep 5 2024, 10:42 PM

markj added a parent revision: D46555: lposix: Use reentrant passwd and group lookup functions.Sep 5 2024, 10:42 PM

I think we should keep posix.3lua for now, if it starts becoming too bug we can start spliting it into sub manpages posix.unistd.3lua & friends like you suggest

imp added inline comments.Sep 6 2024, 2:09 PM

share/man/man3lua/Makefile
3	I don't see freebsd.3lua in this review or in the latest tree I just pulled.
share/man/man3lua/intro.3lua
54	Would this be the right place to document our current policy of "If there's substantial overlap with a standard Lua thing, then we try to be compatible with that thing."? There was a question about that earlier.
share/man/man3lua/posix.3lua
66	Are they GC'd at exit? Though I guess it doesn't much matter on the way out.... Also, does this differ from luaposix?