--- a/include/freeDiameter/freeDiameter.h	Mon Jan 25 19:07:29 2010 +0900
+++ b/include/freeDiameter/freeDiameter.h	Tue Jan 26 13:23:03 2010 +0900
@@ -302,7 +302,7 @@
 int fd_peer_getbyid( char * diamid, struct peer_hdr ** peer );
 
 /*
- * FUNCTION:	peer_validate_register
+ * FUNCTION:	fd_peer_validate_register
  *
  * PARAMETERS:
  *  peer_validate 	: Callback as defined bellow.
@@ -341,6 +341,8 @@
  * structure as parameter (with pir_cert_list set) and returns 0 if the credentials are correct,
  * or an error code otherwise. If the error code is received, the connection is closed and the 
  * peer is destroyed.
+ * Note that freeDiameter already achieves some usual checks. The callback may be used to enforce
+ * additional restrictions.
  *
  * RETURN VALUE:
  *  0      	: The authorization decision has been written in the location pointed by auth.