I'm against it, because it has a completely different connotation for me: I would have assumed any code documented with it would _trigger an event_ using some sort of event dispatcher.
In terms of using it to document trigger_error calls, I'm in agreement with Chuck: in most modern PHP I see, you raise exceptions instead. I only see `trigger_error` used for deprecation notices generally, and those can be documented with @deprecated instead. On Wed, Dec 5, 2018 at 4:17 PM Chuck Burgess <[email protected]> wrote: > I'm accustomed to seeing such old-style error behavior wrapped by > exceptions as much as possible, so I'm -1 on the idea. > > Working Group / others, thoughts? > CRB > *about.me/ashnazg <http://about.me/ashnazg>* > > > On Mon, Nov 26, 2018 at 5:00 AM Magnar Ovedal Myrtveit < > [email protected]> wrote: > >> Would it be interesting to include a @triggers tag in PSR-19? This would >> be used with code that may call trigger_error() or other code that may >> trigger errors, such as filesize(), mime_content_type(), filemtime(), >> md5_file(), pspell_new(), etc. (There are really many!) >> >> Examples would be: >> >> @triggers E_ERROR Some text explaining what might trigger the error. >> >> @triggers E_WARNING Some text explaining what might trigger the warning. >> >> -- >> You received this message because you are subscribed to the Google Groups >> "PHP Framework Interoperability Group" group. >> To unsubscribe from this group and stop receiving emails from it, send an >> email to [email protected]. >> To post to this group, send email to [email protected]. >> To view this discussion on the web visit >> https://groups.google.com/d/msgid/php-fig/a044b2ab-a22a-4385-9a26-95c2fc1ac121%40googlegroups.com >> <https://groups.google.com/d/msgid/php-fig/a044b2ab-a22a-4385-9a26-95c2fc1ac121%40googlegroups.com?utm_medium=email&utm_source=footer> >> . >> For more options, visit https://groups.google.com/d/optout. >> > -- > You received this message because you are subscribed to the Google Groups > "PHP Framework Interoperability Group" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to [email protected]. > To post to this group, send email to [email protected]. > To view this discussion on the web visit > https://groups.google.com/d/msgid/php-fig/CANsgjnujHCAJd7rSvMYXX7az-8zM-%3DFJONz3JMJW44P3G5D0Pw%40mail.gmail.com > <https://groups.google.com/d/msgid/php-fig/CANsgjnujHCAJd7rSvMYXX7az-8zM-%3DFJONz3JMJW44P3G5D0Pw%40mail.gmail.com?utm_medium=email&utm_source=footer> > . > For more options, visit https://groups.google.com/d/optout. > -- Matthew Weier O'Phinney [email protected] https://mwop.net/ -- You received this message because you are subscribed to the Google Groups "PHP Framework Interoperability Group" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/php-fig/CAJp_myXK1W%3Dc4VteP4_KPUqOqGFdOs4pkZs%3DsyXt4mb3srjcqg%40mail.gmail.com. For more options, visit https://groups.google.com/d/optout.
