Re: args vs arg ... in manuals

2022-12-22 Thread Klemens Nanni
12/21/22 11:58, Jason McIntyre пишет: > On Wed, Dec 21, 2022 at 07:40:01AM +, Klemens Nanni wrote: >> On Tue, Dec 20, 2022 at 08:24:29PM +, Jason McIntyre wrote: >>> On Tue, Dec 20, 2022 at 06:24:45PM +, Klemens Nanni wrote: Feedback? OK? >>> >>> ok, in general i'm fine w

Re: args vs arg ... in manuals

2022-12-20 Thread Jason McIntyre
On Wed, Dec 21, 2022 at 07:40:01AM +, Klemens Nanni wrote: > On Tue, Dec 20, 2022 at 08:24:29PM +, Jason McIntyre wrote: > > On Tue, Dec 20, 2022 at 06:24:45PM +, Klemens Nanni wrote: > > > > > > Feedback? OK? > > > > > > > ok, in general i'm fine with this. i do have some concerns t

Re: args vs arg ... in manuals

2022-12-20 Thread Klemens Nanni
On Tue, Dec 20, 2022 at 08:24:29PM +, Jason McIntyre wrote: > On Tue, Dec 20, 2022 at 06:24:45PM +, Klemens Nanni wrote: > > > > Feedback? OK? > > > > ok, in general i'm fine with this. i do have some concerns though: New diff with all points addressed, see inline for explanations. Jus

Re: args vs arg ... in manuals

2022-12-20 Thread Klemens Nanni
12/21/22 00:53, Theo de Raadt пишет: > This went from solving one thing, which was largely agreed. > > Now it is trying to introduce other changes as well. Almost always that > process stinks, unless it goes over the top at saying it is trying to solve > other problems when the diff is re-introdu

Re: args vs arg ... in manuals

2022-12-20 Thread Theo de Raadt
Jason McIntyre wrote: > On Tue, Dec 20, 2022 at 01:53:18PM -0700, Theo de Raadt wrote: > > This went from solving one thing, which was largely agreed. > > > > Now it is trying to introduce other changes as well. Almost always that > > process stinks, unless it goes over the top at saying it is

Re: args vs arg ... in manuals

2022-12-20 Thread Jason McIntyre
On Tue, Dec 20, 2022 at 01:53:18PM -0700, Theo de Raadt wrote: > This went from solving one thing, which was largely agreed. > > Now it is trying to introduce other changes as well. Almost always that > process stinks, unless it goes over the top at saying it is trying to solve > other problems w

Re: args vs arg ... in manuals

2022-12-20 Thread Klemens Nanni
12/21/22 00:24, Jason McIntyre пишет: > On Tue, Dec 20, 2022 at 06:24:45PM +, Klemens Nanni wrote: > expr(1) is a good example. i think it doesn;t matter that expr can take > one arg or many. But it does, which is why the expr(1) could be considered a bug fix: $ expr '1 + 2' 1

Re: args vs arg ... in manuals

2022-12-20 Thread Theo de Raadt
This went from solving one thing, which was largely agreed. Now it is trying to introduce other changes as well. Almost always that process stinks, unless it goes over the top at saying it is trying to solve other problems when the diff is re-introduced. It is sneaky, and usually seems to be a w

Re: args vs arg ... in manuals

2022-12-20 Thread Jason McIntyre
On Tue, Dec 20, 2022 at 06:24:45PM +, Klemens Nanni wrote: > > Feedback? OK? > ok, in general i'm fine with this. i do have some concerns though: > > Index: share/man/man4/ddb.4 > === > RCS file: /cvs/src/share/man/man4/ddb.4,

Re: args vs arg ... in manuals

2022-12-20 Thread Klemens Nanni
12/20/22 20:16, Ingo Schwarze пишет: > Hi Klemens, > > Jason McIntyre wrote on Tue, Dec 20, 2022 at 10:35:19AM +: >> On Tue, Dec 20, 2022 at 09:36:39AM +, Klemens Nanni wrote: > >>> Both styles are used, but I argue that the former fails to distinguish >>> between >>> $ program 'args

Re: args vs arg ... in manuals

2022-12-20 Thread Theo de Raadt
Todd C. Miller wrote: > On Tue, 20 Dec 2022 10:35:19 +, Jason McIntyre wrote: > > > also some things will use argument vs arg. for example ssh(1). do you > > propose to change those? > > I have no strong opinion on "arg" vs. "argument". It probably makes > sense to standardize on whichever

Re: args vs arg ... in manuals

2022-12-20 Thread Todd C . Miller
On Tue, 20 Dec 2022 10:35:19 +, Jason McIntyre wrote: > also some things will use argument vs arg. for example ssh(1). do you > propose to change those? I have no strong opinion on "arg" vs. "argument". It probably makes sense to standardize on whichever is most prevalent in our documentatio

Re: args vs arg ... in manuals

2022-12-20 Thread Ingo Schwarze
Hi Klemens, Jason McIntyre wrote on Tue, Dec 20, 2022 at 10:35:19AM +: > On Tue, Dec 20, 2022 at 09:36:39AM +, Klemens Nanni wrote: >> Both styles are used, but I argue that the former fails to distinguish >> between >> $ program 'args in one shell word' >> and >> $ program one

Re: args vs arg ... in manuals

2022-12-20 Thread Klemens Nanni
12/20/22 19:26, Todd C. Miller пишет: > On Tue, 20 Dec 2022 09:36:39 +, Klemens Nanni wrote: > >> Both styles are used, but I argue that the former fails to distinguish >> between >> $ program 'args in one shell word' >> and >> $ program one arg per shell word >> >> It's a minor thin

Re: args vs arg ... in manuals

2022-12-20 Thread Todd C . Miller
On Tue, 20 Dec 2022 09:36:39 +, Klemens Nanni wrote: > Both styles are used, but I argue that the former fails to distinguish > between > $ program 'args in one shell word' > and > $ program one arg per shell word > > It's a minor thing, imho, but perhaps we can decide for one and

Re: args vs arg ... in manuals

2022-12-20 Thread Jason McIntyre
On Tue, Dec 20, 2022 at 09:36:39AM +, Klemens Nanni wrote: > Both styles are used, but I argue that the former fails to distinguish > between > $ program 'args in one shell word' > and > $ program one arg per shell word > > It's a minor thing, imho, but perhaps we can decide for on

args vs arg ... in manuals

2022-12-20 Thread Klemens Nanni
Both styles are used, but I argue that the former fails to distinguish between $ program 'args in one shell word' and $ program one arg per shell word It's a minor thing, imho, but perhaps we can decide for one and stick to it throughout the tree? Triple dots also make it immediat