Document use of capturing groups

[dsowen]

The priority-only lexer using capturing groups in its rule aggregation, which means that users can't use capturing group without interfering.