Обсуждение: A propose to revise \watch help message

Поиск
Список
Период
Сортировка

A propose to revise \watch help message

От
Kyotaro Horiguchi
Дата:
Recently \watch got the following help message.

>   \watch [[i=]SEC] [c=N] [m=MIN]
>                           execute query every SEC seconds, up to N times
>                           stop if less than MIN rows are returned

The "m=MIN" can be a bit misleading. It may look like it's about
interval or counts, but it actually refers to the row number, which is
not spelled out in the line.

Would it make sense to change it to MINROWS?  There's enough room in
the line for that change and the doc already uses min_rows.

regards.

-- 
Kyotaro Horiguchi
NTT Open Source Software Center

Вложения

Re: A propose to revise \watch help message

От
Kyotaro Horiguchi
Дата:
At Wed, 30 Aug 2023 10:21:26 +0900 (JST), Kyotaro Horiguchi <horikyota.ntt@gmail.com> wrote in 
> Recently \watch got the following help message.
> 
> >   \watch [[i=]SEC] [c=N] [m=MIN]
> >                           execute query every SEC seconds, up to N times
> >                           stop if less than MIN rows are returned
> 
> The "m=MIN" can be a bit misleading. It may look like it's about
> interval or counts, but it actually refers to the row number, which is
> not spelled out in the line.
> 
> Would it make sense to change it to MINROWS?  There's enough room in
> the line for that change and the doc already uses min_rows.

Mmm. I noticed the continuation lines are indented too much, probably
because of the backslash escape in the main line.  The attached
includes the fix for that.

regards.

-- 
Kyotaro Horiguchi
NTT Open Source Software Center

Вложения