Я нашел себя в ситуации, когда переход от случая к случаю - лучший вариант. Под этим я подразумеваю:
switch($bar)
{
case 0:
// do something
case 1:
// do more
break;
//more cases
}
В настоящее время моя IDE (phpStorm) выдает предупреждение о провале.
Есть ли принятый способ в phpDoc документировать такой предполагаемый провал?
n.b. Я знаю, что некоторые из вас, несомненно, скажут, что не делают этого, но я соглашаюсь на это определение зла, и это, безусловно, является "наименее плохим из альтернатив",.
Хотя вопрос явно спрашивает о phpDoc, вот конкретное решение IDE для PHPStorm.
Для Javascript, комментарий
//noinspection FallthroughInSwitchStatementJS
над оператором switch.
Для PHP, комментарий
/** @noinspection PhpMissingBreakStatementInspection */
над выражением о нарушении.