What's the best way to document intentional switch fall-through?

Question

I have found myself in a situation where a switch case fall-through is the best option. By this I mean:

switch($bar)
{
    case 0:
        // do something
    case 1:
        // do more
        break;
    //more cases
}

Currently my IDE (phpStorm) is throwing a warning about the fall-through.

Is there an accepted way in phpDoc to document such intended fall-through?

n.b. I'm aware that some of you will undoubtedly say not to do this but I subscribe to this definition of evil and this is certainly the 'the least bad of the alternatives'.

Answer 1

Although the question explicitly asks about phpDoc, here's an IDE-specific solution for PHPStorm.

For Javascript, comment

//noinspection FallthroughInSwitchStatementJS

above the switch statement.

For PHP, comment

/** @noinspection PhpMissingBreakStatementInspection */

above the offending case statement.