Syntax documentation rewrite for N-commands.

Rewrote the syntax documentation for all commands starting with the
letter N.

1 files changed, 18 insertions, 12 deletions

diff --git a/docs/help/in/names.in b/docs/help/in/names.in
index 2d515c1c..0a122864 100644
--- a/docs/help/in/names.in
+++ b/docs/help/in/names.in
@@ -1,21 +1,27 @@
 
+%9Syntax:%9
+
 @SYNTAX:names@
 
-     -ops: show channel operators in list
-     -halfops: show half operators in list
-     -voices: show voiced people in list
-     -normal: show rest of the people in list
+%9Parameters:%9
+
+    -count:      Displays the amount of users in the channel.
+    -ops:        Displays the channel operators.
+    -halfops:    Displays the channel demi-operators.
+    -voices:     Displays the users who are voiced in a channel.
+
+    The channels to report or ** for all channels you have joined; if no
+    arguments are given, the users in the active channel will be displayed.
 
-Shows the names (nicks) in the specified channels. /NAMES ** shows all
-nicks in all channels, you probably don't want to do this.
+%9Description:%9
 
-Examples:
+    Displays the users who are in a channel; you can provide multiple channels
+    by separating them with the comma "," character.
 
-/NAMES
-     - shows nicks in the current channel.
+%9Examples:%9
 
-/NAMES -ops #c1,#c2
-     - shows operators in channels #c1 and #c2
+    /NAMES -ops
+    /NAMES -voices #irssi,#freenode
 
-See also: WHO, CHANNEL
+%9See also:%9 JOIN, PART, WHO, WHOIS