On Tue, Jul 15, 2025 at 02:56:01PM +0900, Masami Hiramatsu wrote:
On Fri, 11 Jul 2025 13:20:43 +0200
Nam Cao [off-list ref] wrote:
quoted
/**
- * panic - halt the system
+ * vpanic - halt the system
Shouldn't we make a copy the doc for the panic() (keep the text as it is)
and change the short explanation?
panic - halt the system
@fmt: ...
vpanic - halt the system with va_list
@fmt: ...
@args: ...
From the newbie's viewpoint, as far as we keep providing the same
function, it is better to keep the same document to avoid confusion.
That would be nice for sure. But I think the counter arguments are
stronger:
- Two copies need to be maintained
- panic() is only a few lines, and it is obvious at first glance that it
is simply a thin wrapper around vpanic()
So I think it is better to leave it as is.
Best regards,
Nam