[Issue 18124] std.regex.RegexMatch's front property is under-documented

[d-bugmail at puremagic.com]

https://issues.dlang.org/show_bug.cgi?id=18124

--- Comment #6 from Steven Schveighoffer <schveiguy at yahoo.com> ---
(In reply to Neia Neutuladh from comment #5)
> If you merely think
> you might get a better name for it in the near future, you can change it
> then and add a deprecated alias for the existing name.

I think we can keep things as is, but just document that RegexMatch.front
returns a Captures struct. After all, Captures is already documented.

> A slightly more salient change is that you might move a type so it's more
> widely accessible. Perhaps a year from now we'll want to use a Captures
> object for a std.string.find function. A public import if the name is kept
> the same, or an alias if it is not, functions just as well as using an auto
> return type.

I don't think we need to move types around yet. When I look at std.regex docs,
Captures has a lot of documentation, we just don't have the link between
RegexMatch.front and the struct it returns (a downside of auto here). We just
need to make that link.

> > Just another tip: you may want to avoid taking unnecessary offense at
> > innocuous things for no reason. Most people in our organization are friendly
> > and cheerful people, including Seb. Thanks! ;)
> 
> In point of fact, what I experienced was _anger_, not offense. Detached
> professionalism doesn't give anger a target.
> 
> By reiterating a behavior I just complained about in response to me
> complaining about it, it looks like you are trying to deliberately
> antagonize me. This is a concept that most of my cohort had grasped by
> second grade. I believe you've been in the D community as long as me, which
> means you should be an adult, or near enough.

Wow! It's a smiley, it literally is just a way to put a happy, friendly face on
a comment. You were angry because someone typed a smiley and you grossly
misinterpreted it? Have you used the Internet before?

> Do you have some sort of social disability that makes it difficult for you
> to learn things like this? If so, I'll try to take that into account in our
> future interactions.

Yes, I learned to get over trivialities that are obviously not meant for
offense before they made me angry. Pretty much around the same time (2nd grade
you say?) you were learning... whatever it is you are calling tantruming here.

By all means, we can stop this OT conversation, but let's get some good work
done and move on.

--