Clarification on authentication and executing a file

The documentation is misleading (or wrong) about how a file should be executed, since --password MUST be the last option if it is provided without an argument (meaning user should be prompted for password).