Changeset 1914

Show
Ignore:
Timestamp:
05/08/07 15:42:53
Author:
murrayc
Message:

2007-05-08 Murray Cumming <murrayc@murrayc.com

        • docs/devel/reference/tmpl/tny-shared.sgml:

TnyGetPassFunc?:

        • libtinymail/tny-password-getter.c:

tny_password_getter_get_password():

        • camel/camel-session.c:

camel_session_get_password():
Document the prompt parameter as best ignored, because there is nothing
sensible that a real-world application can do with it.

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved
  • trunk/ChangeLog

    r1912 r1914  
     12007-05-08  Murray Cumming  <murrayc@murrayc.com 
     2 
     3        * docs/devel/reference/tmpl/tny-shared.sgml: 
     4        TnyGetPassFunc: 
     5        * libtinymail/tny-password-getter.c:  
     6        tny_password_getter_get_password(): 
     7        * camel/camel-session.c: 
     8        camel_session_get_password(): 
     9        Document the prompt parameter as best ignored, because there is nothing  
     10        sensible that a real-world application can do with it. 
     11 
    1122007-05-08  Dirk-Jan C. Binnema <dirk-jan.binnema@nokia.com> 
    213 
  • trunk/docs/devel/reference/tmpl/tny-shared.sgml

    r1878 r1914  
    373373<!-- ##### USER_FUNCTION TnyGetPassFunc ##### --> 
    374374<para> 
    375 This method happens whenever the password is needed. You must return the password for #TnyAccount self. 
     375This method happens whenever the password must be requested from the user. You must return the password for #TnyAccount self. 
    376376</para> 
    377377 
    378378@self: The #TnyAccount instance for which the password is needed 
    379 @prompt: A promp that you can display to your user 
     379@prompt: A prompt that you can display to the user. This is a human-readable password question, possibly  
     380containing an untranslated error message directly from the server. This should be ignored by most  
     381implementations, so NULL is an acceptable value. 
    380382@cancel: A by-ref boolean for if the user wants to cancel the connection request 
    381 @Returns: Return the password for #TnyAccount self 
     383@Returns: Return the password for #TnyAccount self entered by the user. 
    382384 
    383385 
  • trunk/libtinymail-camel/camel-lite/ChangeLog

    r1014 r1914  
     12007-05-08  set REAL_NAME environment variable  <murrayc@murrayc-desktop> 
     2 
     3        reviewed by: <delete if not using a buddy> 
     4 
     5        * camel/camel-session.c: 
     6 
    172006-10-17  Philip Van Hoof  <pvanhoof@gnome.org> 
    28 
  • trunk/libtinymail-camel/camel-lite/camel/camel-session.c

    r1415 r1914  
    335335 * @service: the #CamelService this query is being made by 
    336336 * @domain: domain of password request.  May be null to use the default. 
    337  * @prompt: prompt to provide to user 
     337 * @prompt: prompt to provide to user. May be null. 
    338338 * @item: an identifier, unique within this service, for the information 
    339339 * @flags: #CAMEL_SESSION_PASSWORD_REPROMPT, the prompt should force a reprompt 
     
    351351 * already have the answer cached). If #CAMEL_SESSION_PASSWORD_SECRET 
    352352 * is set, the user's input will not be echoed back. 
     353 * This is a human-readable password question, possibly containing an untranslated error  
     354 * message directly from the server. This should be ignored by most implementations,  
     355 * so NULL is an acceptable value. 
    353356 * 
    354357 * If #CAMEL_SESSION_PASSWORD_STATIC is set, it means the password returned 
  • trunk/libtinymail/tny-password-getter.c

    r1855 r1914  
    3030 * @self: a #TnyPasswordGetter object 
    3131 * @aid: a unique string identifying the requested password 
    32  * @prompt: the password question 
     32 * @prompt: A human-readable password question, possibly containing an untranslated error  
     33 * message directly from the server. This should be ignored by most implementations, 
     34 * so NULL is an acceptable value. 
    3335 * @cancel: whether or not the user cancelled 
    3436 *