add docs in main header block-comment re: 'login-option' properties