-------------------------------------------------------------------------------- Fedora Update Notification FEDORA-2024-95c8e1ba66 2025-01-01 01:22:48.465283+00:00 -------------------------------------------------------------------------------- Name : php-phpdocumentor-reflection-docblock5 Product : Fedora 41 Version : 5.6.1 Release : 2.fc41 URL : https://github.com/phpDocumentor/ReflectionDocBlock Summary : DocBlock parser Description : The ReflectionDocBlock component of phpDocumentor provides a DocBlock parser that is fully compatible with the PHPDoc standard. With this component, a library can provide support for annotations via DocBlocks or otherwise retrieve information that is embedded in a DocBlock. Autoloader: /usr/share/php/phpDocumentor/Reflection/DocBlock5/autoload.php -------------------------------------------------------------------------------- Update Information: Version 5.6.1 Fix compatibility issue with phpstan 2.0 parser by @jaapio in #394 Version 5.6.0 add support for phpstan/phpdoc-parser 2 by @xabbuh in #386 Version 5.5.1 Fixes regression introduced in 5.5.0 that triggered notices during parsing of docblocks. When the docblock contained indented lines. Version 5.5.0 Improved method tag parameter rendering, by now the method tag parameters are correctly rendered when transforming a docblock back to string. New supported tags: template template-covariant mixin implements & @template-implements extends & @template-extends The template tags do not support all functionality needed to have full generic support as this requires some extra work. But for many situations this will already add value. Version 5.4.1 In the previous release a regression was introduced regarding multiline tag descriptions. Part of the description was lost and the indenting wasn't reduced as we did before 5.4. If your application relies on docblock tags and uses the descriptions it is highly recommended to update immediately. And block version 5.4.0 from the allowed versions in your composer.json Version 5.4.0 More type support Since the beginning of this package we have been working on our own parser. Mostly regular expressions spitting each part of a docblock and processing them separately in each tag. But since static analyzers became more popular it became a lot harder to cover all the new formats of types. In type-resolver 1.7 we already started using phpstan's parser to process types. And now in this release we also cover parts of the docblock parsing process with their parser. This will make it easier to keep up with all the new changes and allows us to support more complex type formats. We do not support all types covered by phpstan. Generics are not fully supported on all notations, we will return an InvalidTag in those cases. Deprecations Param tag We spend a lot of time to cover all the edge cases that we supported in docblocks for many years. However we also noticed that some notations do not really make sense. First notation added to the list is a @param tag without a variable. param MyType Here starts the description but $var is ommited This notation is now deprecated, and support will be removed in the first release of v6. Static factory interface We introduced a new factory strategy to make it possible to have more complex factories for tags and keep the implementation simple. Due to this new system of creating tags we can now support external parser to cover the body of a tag to be handled. With this new system the older system of StaticFactories has become deprecated. And will be removed in v6. Backward compatibility We introduced all new functionality with backward compatibility in mind. There are no interface changes being made so consumers of the library will not notice anything from the internal changes. However since we introduced a large amount of new types you might notice issues depending on your implementation. Especially when your project reads the types provided by this library. Other notable changes Fix PhpDoc in class Description by @WinterSilence in #317 Optimize Description::render() by @WinterSilence in #318 Test with multiple versions of the dependencies by @villfa in #319 GH Actions: version update for ramsey/composer-install by @jrfnl in #321 Send code coverage to Scrutinizer by @villfa in #320 GH Actions: version update for various predefined actions by @jrfnl in #329 Support reference in method tag by @villfa in #332 Upgrade ci to standardized pipeline by @jaapio in #340 PhpStan based tag parsing by @jaapio in #343 Update .gitattributes by @williamdes in #344 Test against php 8.3 by @sergiy-petrov in #356 Fix rendering a description when it contains escaped chars and no tags by @AydinHassan in #357 Add typeless parameter support. by @jaapio in #360 Be more strict about type definitions on param by @jaapio in #363 Added test for regression on invalid types by @jaapio in #364 -------------------------------------------------------------------------------- ChangeLog: * Mon Dec 23 2024 Remi Collet <remi@xxxxxxxxxxxx> - 5.6.1-2 - allow phpstan/phpdoc-parser v2 * Mon Dec 9 2024 Remi Collet <remi@xxxxxxxxxxxx> - 5.6.1-1 - update to 5.6.1 - re-license spec file to CECILL-2.1 - raise dependency on PHP 7.4 - raise dependency on phpdocumentor/type-resolver 1.7 - add dependency on phpstan/phpdoc-parser - add dependency on doctrine/deprecations -------------------------------------------------------------------------------- This update can be installed with the "dnf" update program. Use su -c 'dnf upgrade --advisory FEDORA-2024-95c8e1ba66' at the command line. For more information, refer to the dnf documentation available at http://dnf.readthedocs.io/en/latest/command_ref.html#upgrade-command-label All packages are signed with the Fedora Project GPG key. More details on the GPG keys used by the Fedora Project can be found at https://fedoraproject.org/keys -------------------------------------------------------------------------------- -- _______________________________________________ package-announce mailing list -- package-announce@xxxxxxxxxxxxxxxxxxxxxxx To unsubscribe send an email to package-announce-leave@xxxxxxxxxxxxxxxxxxxxxxx Fedora Code of Conduct: https://docs.fedoraproject.org/en-US/project/code-of-conduct/ List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines List Archives: https://lists.fedoraproject.org/archives/list/package-announce@xxxxxxxxxxxxxxxxxxxxxxx Do not reply to spam, report it: https://pagure.io/fedora-infrastructure/new_issue
