I'm just suggesting that if you are going to use @ comments to inject metadata about the source code, it makes sense to do so in a way compatible with document generation tools. That way the generator can re-use the metadata without need to repeat it in your POD markup.

BTW, my filter supports =for for @ notations while passing other POD markup through, unmodified.