PHPDoc on CarbonImmutable::createFromFormat incompatible with actual return type

[BusterNeece]

Carbon 3.0.2

The phpdoc annotation here:

Carbon/src/Carbon/CarbonImmutable.php

Line 819 in cc73388

* @method static static createFromFormat(string $format, string $time, DateTimeZone|string|false|null $timezone = null) Parse a string into a new CarbonImmutable object according to the specified format.

is incompatible with the actual return type from the Creator trait:

Carbon/src/Carbon/Traits/Creator.php

Lines 630 to 642 in cc73388

	/**
	* Create a Carbon instance from a specific format.
	*
	* @param string $format Datetime format
	* @param string $time
	* @param DateTimeZone|string|int|null $timezone
	*
	* @throws InvalidFormatException
	*
	* @return static|null
	*/
	#[ReturnTypeWillChange]
	public static function createFromFormat($format, $time, $timezone = null): ?self

If you have static analysis tools that trust the phpdoc annotations (i.e. phpstan), it'll throw that a comparison against null is invalid, even though the actual returned value can be null.

[kylekatarnls]

Thanks for report. Actually method that are declared in traits shouldn't be at all in the list of @method only methods that exist via __call should be there, it's a exclusion mistake from the doc generator.

[BusterNeece]

Thank you!