Re: [Bug] S-flag imposes non-greedy match where it shouldn't

[Sebastian Gniazdowski <sgniazdowski@xxxxxxxxx>]

On Sun, 29 Dec 2019 at 03:06, Daniel Shahaf <d.s@xxxxxxxxxxxxxxxxxx> wrote:
>
> Sebastian Gniazdowski wrote on Sun, Dec 29, 2019 at 01:56:12 +0100:
> > I think that the style of the docs has a value. At first one can get little
> > angry "why the example just doesn't confirm what I already suspect",
> > however, after untangling it one most probably will feel satisfaction and
> > gratefulness. It's a way to share advanced, expert knowledge.
>
> There should be no untangling.  Documentation is about conveying knowledge, not
> about presenting riddles.

I'm just noticing that the riddle-style is a way to convey peculiar
things about the described features and it does work, although it
requires involving more resources during reading. Otherwise, there
must be basically a long paragraph of text that openly - although with
difficulty of stating the subtleties clearly – describes the things. I
can opt for the riddle style because it has its advantages – reading
such long delicate text requires resources too and is open for
misreading, while the riddle condensates the knowledge in a form
that's not open for that.

> > As I said I see much value in the current style of the docs and I've
> > learned much from it, so I don't think it should be changed.
>
> Well, I'm sorry, but I expect consensus will not side with you on this.
>
> Do you intend to send another revision of the (S) docs patch upthread?

Rather not, I've couldn't replace the example with anything simpler
and the patch that would describe the issue with (S) would be either
superficial (for a short version) or too long and convoluted.

-- 
Sebastian Gniazdowski
News: https://twitter.com/ZdharmaI
IRC: https://kiwiirc.com/client/chat.freenode.net:+6697/#zplugin
Blog: http://zdharma.org