Subject: | problematic use of [] in documentation |
You use [] in the documentation to indicate optional elements. This is a
bad idea because they are mistaken for literal syntax (arrayref).
I'm filing this bug on behalf of a newcomer who was confused by this and
produced broken code.