in reply to Documenting Thrown Exceptions

I don't have a strict policy myself. Since POD is basically a free-form text language I just do whatever reads best in context. As well as what you outlined some other structures I use are: