Parser stops at the first dot

[grappler]

In the is_singular() summary the text does not end at the first dot.
Is the query for an existing single post of any post type (post, attachment, page, ... )?

https://developer.wordpress.org/reference/functions/is_singular/

I also created a core ticket as it may be quicker to correct the inline docs then the parser. https://core.trac.wordpress.org/ticket/39948

I have not checked for any other cases.

[JDGrimes]

I think this is just a result of phpDocumentor following the expected syntax for the summary, which is supposed to be a single sentence ending in a full stop. I guess it just assumes that everything after the first period (the first sentence), is a part of the long description.

So this is just the behavior of phpDocumentor, though I guess we could work around it in the parser if we wanted to.

[GaryJones]

I think this is just a result of phpDocumentor following the expected syntax for the summary, which is supposed to be a single sentence ending in a full stop.

Not quite:

The short description is started from the first character until a dot is encountered followed by a newline OR two consecutive newlines (horizontal whitespace is taken into account to consider spacing errors).
-- phpDocumentor\Reflection\DocBlockFactory

The unit tests don't appear to test the case of their being multiple dots in the summary.

Here's the regex, which at first glance, shouldn't break with multiple dots.

[GaryJones]

Saying that, it looks like it has been reported upstream anyway: phpDocumentor/ReflectionDocBlock#63