Hi, Anton Lindqvist wrote on Fri, Dec 02, 2016 at 10:40:16AM +0100:
> Make it clear that args is a keyword followed by zero or more arguments. Your argument makes sense to me, we generally don't use "..." to imply a preceding .Ar, but we use it to indicate that the preceding .Ar can be repeated. So yes, this may be confusing. > Unfortunately, the grammar format no longer fits on a single line even > with the offset removed. That is ugly indeed and makes the overview line harder to read. I think we can avoid the confusion by being more explicit in the description, but keep the overview concise. Any OKs for the following version? Yours, Ingo Index: doas.conf.5 =================================================================== RCS file: /cvs/src/usr.bin/doas/doas.conf.5,v retrieving revision 1.30 diff -u -r1.30 doas.conf.5 --- doas.conf.5 2 Sep 2016 18:12:30 -0000 1.30 +++ doas.conf.5 2 Dec 2016 22:37:40 -0000 @@ -35,7 +35,7 @@ .Op Ar options .Ar identity .Op Ic as Ar target -.Op Ic cmd Ar command Op Ic args ... +.Op Ic cmd Ar command Op Ic args No ... .Ed .Pp Rules consist of the following parts: @@ -90,7 +90,7 @@ If a relative path is specified, only a restricted .Ev PATH will be searched. -.It Ic args ... +.It Ic args Op Ar argument ... Arguments to command. The command arguments provided by the user need to match those specified. The keyword
