diff --git a/doc/reference.conf b/doc/reference.conf
index 768ce0bb..e0277583 100755
--- a/doc/reference.conf
+++ b/doc/reference.conf
@@ -658,8 +658,9 @@ channel {
 
 /* The serverhide block contains the options regarding serverhiding */
 serverhide {
-	/* flatten links: this option will show all servers in /links appear
-	 * that they are linked to this current server
+	/* flatten links: this option will hide various routing information
+	 * and make all servers in /links appear that they are linked to
+	 * this server.
 	 */
 	flatten_links = no;
 
@@ -668,8 +669,8 @@ serverhide {
 	 */
 	links_delay = 5 minutes;
 
-	/* hidden: hide this server from a /links output on servers that
-	 * support it.  this allows hub servers to be hidden etc.
+	/* hidden: hide this server from a /links output on servers with
+	 * flatten_links enabled.  this allows hub servers to be hidden etc.
 	 */
         hidden = no;