On Sun, Oct 02, 2022 at 02:52:37PM +0100, Jason McIntyre wrote: > On Sun, Oct 02, 2022 at 01:07:04PM +0000, Klemens Nanni wrote: > > rarpd(8) either "Listen[s] on all the Ethernets attached to the system" > > or requires an explicit list, not both: > > > > $ rarpd -a em0 > > usage: rarpd [-adflt] if0 [... ifN] > > $ ./obj/rarpd -a em0 > > usage: rarpd [-dflt] -a | if ... > > > > Or would this be better? > > rarpd [-dflt] if ... > > rarpd -a [-dflt] > > > > Feedback? OK? > > > > please don't!
Let's just leave it as is, then. > > - if you are specifying -a, you would hardly expect to give a list of > interfaces too. the manual documents it clearly. why single out -a? Yes, the manual makes that clear, but the usage/synopsis does not. I personally prefer such things to be visible right away, but that might just be me. > - with the newer version, it is unclear whether you can specify any > flags at all with "if ...". we could tighten that, but it's still > messy. You mean it could mean either '[-dflt] -a' or 'if ...'? Fair point, that's not better. > - and splitting such a simple SYNOPSIS in two would be nuts. Not a big deal to me; cut(1) seems a bit similar in that it is clearly split into three rather than an ambiguous one. > > - if anything, i think we could trim "if0 [... ifN]" to just "if ...". > so i agree with that part. That's a general simplification we could do in a few more manuals.
