Hi Jason, Jason McIntyre wrote on Wed, May 20, 2020 at 06:38:18AM +0100:
> i'm fine with the text, but does it really warrant a CAVEATS section? it > sounds like it should just be part of "this is how it works" text. I may not be the best person to judge this, but as far as i understand, this is a manual page about a configuration file, answering the question "What is the syntax and semantics of that file?" The new paragraph looks like it warns about a trap you may end up in in some unusual situations depending on what exactly you put into the file (unusual because 16 feels like a substantial number to me, presumably it was chosen because it is sufficient for the most common purposes). So CAVEATS doesn't feel wrong to me. Now, maybe, some manual page somewhere might say something like "this program uses .Pa /dev/ldom* device nodes (or .Xr ldom 4 devices) to do foobar; make sure you have enough of those". Judging from commands like $ man -k any=dev/ldom $ man -k any~'\<ldom\>' it doesn't look like such explanations exist just yet, but if someone were to write them, they might be appropriate in a DESCRIPTION or a FILES section of some section 8 manual page, maybe. Either way, i don't feel strongly about any of that. Yours, Ingo
