JavaDoc the formPassword mechanism

- Explain what it is for (anti-CSRF token). Thanks to nextgens!
- Link related functions/variables in each of their JavaDoc
- Stress how important it is.