1 files changed, 12 insertions, 10 deletions
diff --git a/lisp/erc/erc-networks.el b/lisp/erc/erc-networks.el
index eca8ad6a899..3ba5ce4e5e7 100644
--- a/lisp/erc/erc-networks.el
+++ b/lisp/erc/erc-networks.el
@@ -436,10 +436,11 @@
   ("ZiRC: Random server" ZiRC "irc.zirc.org" ((6660 6669)))
   ("ZUHnet: Random server" ZUHnet "irc.zuh.net" 6667)
   ("Zurna: Random server" Zurna "irc.zurna.net" 6667))
-  "Alist of irc servers. (NAME NET HOST PORTS) where
+  "Alist of irc servers.
+Each server is a list (NAME NET HOST PORTS) where
 NAME is a name for that server,
-NET is a symbol indicating to which network from `erc-networks-alist' this
-  server corresponds,
+NET is a symbol indicating to which network from `erc-networks-alist'
+  this server corresponds,
 HOST is the servers hostname and
 PORTS is either a number, a list of numbers, or a list of port ranges."
   :group 'erc-networks
@@ -706,12 +707,13 @@ PORTS is either a number, a list of numbers, or a list of port ranges."
     (ZiRC "zirc.org")
     (ZUHnet "zuh.net")
     (Zurna "zurna.net"))
-  "Alist of IRC networks. (NET MATCHER) where
+  "Alist of IRC networks.
+Each network is a list (NET MATCHER) where
 NET is a symbol naming that IRC network and
-MATCHER is used to find a corresponding network to a server while connected to
-  it. If it is regexp, it's used to match against `erc-server-announced-name'.
-  It can also be a function (predicate). Then it is executed with the
-  server buffer as current-buffer."
+MATCHER is used to find a corresponding network to a server while
+  connected to it.  If it is regexp, it's used to match against
+  `erc-server-announced-name'.  It can also be a function (predicate).
+  Then it is executed with the server buffer as current-buffer."
   :group 'erc-networks
   :type '(repeat
 	  (list :tag "Network"
@@ -749,8 +751,8 @@ search for a match in `erc-networks-alist'."
   (erc-with-server-buffer erc-network))
 
 (defun erc-current-network ()
-  "Deprecated.  Use `erc-network' instead.  Return the name of this server's
-network as a symbol."
+  "Deprecated.  Use `erc-network' instead.
+Return the name of this server's network as a symbol."
   (erc-with-server-buffer
     (intern (downcase (symbol-name erc-network)))))