cflogin question

I have added a comment to the bug report. It reads:

The following code works. cflogin is dumped as a structure containing the keys "name" and "password".

<cfform> 
<cfinput name="j_username" value="me"> 
<cfinput name="j_password" value="myPW"> 
<cfinput name="sbmt" value="send" type="submit" > 
</cfform> 

<cfif isDefined("form.j_username") and isDefined("form.j_password")> 
    <cflogin> 
        <cfloginuser name="#form.j_username#" Password = "#form.j_password#" roles="myRole">
        <cfdump var="#cflogin#" > 
    </cflogin> 
</cfif> 

<!---Cfscript version also works ---> 
<!--- 
<cfscript> 
if (isDefined("form.j_username") and isDefined("form.j_password")) { 
    cflogin() { 
        cfloginuser(name="#form.j_username#", password="#form.j_password#", roles="myRole");
        writedump(cflogin); 
    } 
} 
</cfscript> 
--->

 If that is indeed cflogin's intended usage, then the documentation should emphasize:

1.  the exact conditions in which the cflogin structure will be available;
2.  the fact that the cflogin structure will then be available only within the cflogin tag or function.