diff --git a/samples/bip.conf b/samples/bip.conf
index afc1633..b698569 100644
--- a/samples/bip.conf
+++ b/samples/bip.conf
@@ -4,7 +4,7 @@
 ip = "0.0.0.0";
 
 # To connect a client to bip, try the port below, and
-# be sure to set the username and password to the values
+# be sure to set the password to the value
 # specified in the network you want to connect to. 
 port = 7778;
 
@@ -63,20 +63,17 @@ network {
 #  - chose and setup a different login for each connection
 # on your irc client:
 #  - Use the multi server feature of your client, the server beeing each time
-#    the server where bip is running. In your client setup realname or username
-#    to the value of login in the corresponding connection.
+#    the server where bip is running. In your client setup server password to:
+#      username:password:connectionname
+#  - do not store the password in clear here, use the bipmkpass util to generate
+# a hash
 
 # User structure is grouping information for a given user
-
-# XXX You sure as hell want to read this:
-# To log on this connection configure you client to connect with server
-# password username:password:connectionname
-
 user {
 	# The name in bip of the user
 	# This is used by bip only
 	name = "nohar";
-	# this user's password (md5(md5("tata"))) plus seed
+	# this user's password (md5(md5("tata"))) with seed - generated by bipmkpass
 	password = "3880f2b39b3b9cb507b052b695d2680859bfc327";
 
 	# SSL certificates checking mode for user:
@@ -104,9 +101,9 @@ user {
 		network = "iiens";	# which ircnet to connect to
 
 
-		# user = "otheruser";
-		# realname = "otheruser";
-
+		# these will be sent to the real server
+		#user = "otheruser";
+		#realname = "otheruser";
 		#password = "serverpassword";
 
 		# Some options:
@@ -118,13 +115,12 @@ user {
 		# Autojoined channels:
 		channel { name = "#bip"; };
 	};
+
+	# another connection (optionnal)
 	connection {
 		name = "freenode";		# used by bip only
 		network = "freenode";	# which ircnet to connect to
 
-		# Information sent to the irc server:
-		#password = "serverpassword";
-
 		# Some options:
 		#away_nick = "bip`away";
 		#follow_nick = true;