From 161f040940ad8422dfc03fadcb3a07ccd60201df Mon Sep 17 00:00:00 2001
From: Jilles Tjoelker <jilles@stack.nl>
Date: Sun, 18 Jan 2009 18:22:43 +0100
Subject: [PATCH] Update comments for parv[0] removal.

---
 extensions/example_module.c | 5 -----
 extensions/m_findforwards.c | 1 -
 extensions/m_mkpasswd.c     | 1 -
 extensions/m_ojoin.c        | 1 -
 extensions/m_okick.c        | 1 -
 extensions/m_olist.c        | 1 -
 extensions/m_omode.c        | 1 -
 extensions/m_opme.c         | 1 -
 extensions/m_webirc.c       | 1 -
 include/msg.h               | 6 +++---
 modules/core/m_error.c      | 1 -
 modules/core/m_join.c       | 2 --
 modules/core/m_kick.c       | 1 -
 modules/core/m_kill.c       | 2 --
 modules/core/m_mode.c       | 1 -
 modules/core/m_nick.c       | 3 ---
 modules/core/m_part.c       | 1 -
 modules/core/m_quit.c       | 2 --
 modules/core/m_server.c     | 2 --
 modules/core/m_squit.c      | 2 --
 modules/m_accept.c          | 1 -
 modules/m_admin.c           | 3 ---
 modules/m_away.c            | 1 -
 modules/m_capab.c           | 1 -
 modules/m_challenge.c       | 1 -
 modules/m_chghost.c         | 4 ----
 modules/m_connect.c         | 2 --
 modules/m_etrace.c          | 1 -
 modules/m_help.c            | 3 ---
 modules/m_info.c            | 2 --
 modules/m_invite.c          | 1 -
 modules/m_knock.c           | 1 -
 modules/m_links.c           | 2 --
 modules/m_list.c            | 2 --
 modules/m_locops.c          | 1 -
 modules/m_lusers.c          | 2 --
 modules/m_map.c             | 2 --
 modules/m_motd.c            | 2 --
 modules/m_names.c           | 1 -
 modules/m_oper.c            | 1 -
 modules/m_pass.c            | 1 -
 modules/m_ping.c            | 1 -
 modules/m_post.c            | 1 -
 modules/m_resv.c            | 4 ----
 modules/m_scan.c            | 1 -
 modules/m_services.c        | 1 -
 modules/m_snote.c           | 1 -
 modules/m_stats.c           | 1 -
 modules/m_svinfo.c          | 1 -
 modules/m_time.c            | 1 -
 modules/m_topic.c           | 2 --
 modules/m_trace.c           | 1 -
 modules/m_users.c           | 1 -
 modules/m_version.c         | 2 --
 modules/m_wallops.c         | 1 -
 modules/m_who.c             | 1 -
 modules/m_whois.c           | 2 --
 modules/m_whowas.c          | 1 -
 src/parse.c                 | 5 ++---
 src/s_user.c                | 1 -
 unsupported/m_clearchan.c   | 1 -
 unsupported/m_force.c       | 1 -
 62 files changed, 5 insertions(+), 97 deletions(-)

diff --git a/extensions/example_module.c b/extensions/example_module.c
index 526fba3ce..86623296d 100644
--- a/extensions/example_module.c
+++ b/extensions/example_module.c
@@ -151,7 +151,6 @@ DECLARE_MODULE_AV1(
 
 /*
  * mr_test
- *      parv[0] = sender prefix
  *      parv[1] = parameter
  */
 
@@ -178,7 +177,6 @@ munreg_test(struct Client *client_p, struct Client *source_p, int parc, const ch
 
 /*
  * mclient_test
- *      parv[0] = sender prefix
  *      parv[1] = parameter
  */
 static int
@@ -201,7 +199,6 @@ mclient_test(struct Client *client_p, struct Client *source_p, int parc, const c
 
 /*
  * mrclient_test
- *      parv[0] = sender prefix
  *      parv[1] = parameter
  */
 static int
@@ -220,7 +217,6 @@ mrclient_test(struct Client *client_p, struct Client *source_p, int parc, const
 
 /*
  * mserver_test
- *      parv[0] = sender prefix
  *      parv[1] = parameter
  */
 static int
@@ -239,7 +235,6 @@ mserver_test(struct Client *client_p, struct Client *source_p, int parc, const c
 
 /*
  * moper_test
- *      parv[0] = sender prefix
  *      parv[1] = parameter
  */
 static int
diff --git a/extensions/m_findforwards.c b/extensions/m_findforwards.c
index e33ea1786..f681234e1 100644
--- a/extensions/m_findforwards.c
+++ b/extensions/m_findforwards.c
@@ -49,7 +49,6 @@ DECLARE_MODULE_AV1(findforwards, NULL, NULL, findforwards_clist, NULL, NULL, "$R
 
 /*
 ** mo_findforwards
-**      parv[0] = sender prefix
 **      parv[1] = channel
 */
 static int
diff --git a/extensions/m_mkpasswd.c b/extensions/m_mkpasswd.c
index d0e9d6ef9..bf5f038f2 100644
--- a/extensions/m_mkpasswd.c
+++ b/extensions/m_mkpasswd.c
@@ -97,7 +97,6 @@ m_mkpasswd(struct Client *client_p, struct Client *source_p, int parc, const cha
 
 /*
 ** mo_test
-**      parv[0] = sender prefix
 **      parv[1] = parameter
 */
 static int
diff --git a/extensions/m_ojoin.c b/extensions/m_ojoin.c
index 66e12deec..239cd447c 100644
--- a/extensions/m_ojoin.c
+++ b/extensions/m_ojoin.c
@@ -50,7 +50,6 @@ DECLARE_MODULE_AV1(ojoin, NULL, NULL, ojoin_clist, NULL, NULL, "$Revision: 3554
 
 /*
 ** mo_ojoin
-**      parv[0] = sender prefix
 **      parv[1] = channel
 */
 static int
diff --git a/extensions/m_okick.c b/extensions/m_okick.c
index 3c532945b..29e8b6424 100644
--- a/extensions/m_okick.c
+++ b/extensions/m_okick.c
@@ -52,7 +52,6 @@ DECLARE_MODULE_AV1(okick, NULL, NULL, okick_clist, NULL, NULL, "$Revision: 3554
 
 /*
 ** m_okick
-**      parv[0] = sender prefix
 **      parv[1] = channel
 **      parv[2] = client to kick
 **      parv[3] = kick comment
diff --git a/extensions/m_olist.c b/extensions/m_olist.c
index 737e1ac99..7588d5113 100644
--- a/extensions/m_olist.c
+++ b/extensions/m_olist.c
@@ -62,7 +62,6 @@ static void list_named_channel(struct Client *source_p, const char *name);
 
 /*
 ** mo_olist
-**      parv[0] = sender prefix
 **      parv[1] = channel
 */
 static int
diff --git a/extensions/m_omode.c b/extensions/m_omode.c
index c00974e03..03c9d3289 100644
--- a/extensions/m_omode.c
+++ b/extensions/m_omode.c
@@ -55,7 +55,6 @@ DECLARE_MODULE_AV1(omode, NULL, NULL, omode_clist, NULL, NULL, "$Revision: 3121
 
 /*
  * mo_omode - MODE command handler
- * parv[0] - sender
  * parv[1] - channel
  */
 static int
diff --git a/extensions/m_opme.c b/extensions/m_opme.c
index bd74eba3e..31ee67f8d 100644
--- a/extensions/m_opme.c
+++ b/extensions/m_opme.c
@@ -49,7 +49,6 @@ DECLARE_MODULE_AV1(opme, NULL, NULL, opme_clist, NULL, NULL, "$Revision: 3554 $"
 
 /*
 ** mo_opme
-**      parv[0] = sender prefix
 **      parv[1] = channel
 */
 static int
diff --git a/extensions/m_webirc.c b/extensions/m_webirc.c
index 1b5748e56..1b92ff018 100644
--- a/extensions/m_webirc.c
+++ b/extensions/m_webirc.c
@@ -67,7 +67,6 @@ DECLARE_MODULE_AV1(webirc, NULL, NULL, webirc_clist, NULL, NULL, "$Revision: 207
 
 /*
  * mr_webirc - webirc message handler
- *      parv[0] = sender prefix
  *      parv[1] = password
  *      parv[2] = fake username (we ignore this)
  *	parv[3] = fake hostname 
diff --git a/include/msg.h b/include/msg.h
index 283eb9b2d..1d04c0be1 100644
--- a/include/msg.h
+++ b/include/msg.h
@@ -139,13 +139,13 @@ extern int m_unregistered(struct Client *, struct Client *, int, const char **);
  *
  *    parv    a NULL terminated list of parameter pointers,
  *
- *                    parv[0], sender (prefix string), if not present
- *                            this points to an empty string.
+ *                    parv[0], unused for historical reasons (formerly
+ *                            sender name)
  *                    parv[1]...parv[parc-1]
  *                            pointers to additional parameters
  *                    parv[parc] == NULL, *always*
  *
- *            note:   it is guaranteed that parv[0]..parv[parc-1] are all
+ *            note:   it is guaranteed that parv[1]..parv[parc-1] are all
  *                    non-NULL pointers.
  */
 
diff --git a/modules/core/m_error.c b/modules/core/m_error.c
index 108b38bf0..df19a14b7 100644
--- a/modules/core/m_error.c
+++ b/modules/core/m_error.c
@@ -85,7 +85,6 @@ is_safe_error(const char *message)
  * although this is called internally from other functions
  * --msa
  *
- *      parv[0] = sender prefix
  *      parv[*] = parameters
  */
 int
diff --git a/modules/core/m_join.c b/modules/core/m_join.c
index 6f28e1396..e9f092d2c 100644
--- a/modules/core/m_join.c
+++ b/modules/core/m_join.c
@@ -125,7 +125,6 @@ check_forward(struct Client *source_p, struct Channel *chptr,
 
 /*
  * m_join
- *      parv[0] = sender prefix
  *      parv[1] = channel
  *      parv[2] = channel password (key)
  */
@@ -388,7 +387,6 @@ m_join(struct Client *client_p, struct Client *source_p, int parc, const char *p
 
 /*
  * ms_join
- *      parv[0] = sender prefix
  *      parv[1] = channel TS
  *      parv[2] = channel
  *      parv[3] = "+", formerly channel modes but now unused
diff --git a/modules/core/m_kick.c b/modules/core/m_kick.c
index ecf1d218f..c87a1a50a 100644
--- a/modules/core/m_kick.c
+++ b/modules/core/m_kick.c
@@ -52,7 +52,6 @@ DECLARE_MODULE_AV1(kick, NULL, NULL, kick_clist, NULL, NULL, "$Revision: 3317 $"
 
 /*
 ** m_kick
-**      parv[0] = sender prefix
 **      parv[1] = channel
 **      parv[2] = client to kick
 **      parv[3] = kick comment
diff --git a/modules/core/m_kill.c b/modules/core/m_kill.c
index c26518783..c78baf588 100644
--- a/modules/core/m_kill.c
+++ b/modules/core/m_kill.c
@@ -58,7 +58,6 @@ DECLARE_MODULE_AV1(kill, NULL, NULL, kill_clist, NULL, NULL, "$Revision: 3408 $"
 
 /*
 ** mo_kill
-**      parv[0] = sender prefix
 **      parv[1] = kill victim
 **      parv[2] = kill path
 */
@@ -158,7 +157,6 @@ mo_kill(struct Client *client_p, struct Client *source_p, int parc, const char *
 
 /*
  * ms_kill
- *      parv[0] = sender prefix
  *      parv[1] = kill victim
  *      parv[2] = kill path and reason
  */
diff --git a/modules/core/m_mode.c b/modules/core/m_mode.c
index 1653b09b6..42df7ed2b 100644
--- a/modules/core/m_mode.c
+++ b/modules/core/m_mode.c
@@ -66,7 +66,6 @@ DECLARE_MODULE_AV1(mode, NULL, NULL, mode_clist, NULL, NULL, "$Revision: 1006 $"
 
 /*
  * m_mode - MODE command handler
- * parv[0] - sender
  * parv[1] - channel
  */
 static int
diff --git a/modules/core/m_nick.c b/modules/core/m_nick.c
index 7335399b4..4deeed605 100644
--- a/modules/core/m_nick.c
+++ b/modules/core/m_nick.c
@@ -108,7 +108,6 @@ static int perform_nickchange_collides(struct Client *, struct Client *,
 				       struct Client *, int, const char **, time_t, const char *);
 
 /* mr_nick()
- *       parv[0] = sender prefix
  *       parv[1] = nickname
  */
 static int
@@ -175,7 +174,6 @@ mr_nick(struct Client *client_p, struct Client *source_p, int parc, const char *
 }
 
 /* m_nick()
- *     parv[0] = sender prefix
  *     parv[1] = nickname
  */
 static int
@@ -258,7 +256,6 @@ m_nick(struct Client *client_p, struct Client *source_p, int parc, const char *p
 /* mc_nick()
  *      
  * server -> server nick change
- *    parv[0] = sender prefix
  *    parv[1] = nickname
  *    parv[2] = TS when nick change
  */
diff --git a/modules/core/m_part.c b/modules/core/m_part.c
index b0cd6b08b..5e38047aa 100644
--- a/modules/core/m_part.c
+++ b/modules/core/m_part.c
@@ -58,7 +58,6 @@ static void part_one_client(struct Client *client_p,
 
 /*
 ** m_part
-**      parv[0] = sender prefix
 **      parv[1] = channel
 **      parv[2] = reason
 */
diff --git a/modules/core/m_quit.c b/modules/core/m_quit.c
index 3ad321b8c..bc77f0951 100644
--- a/modules/core/m_quit.c
+++ b/modules/core/m_quit.c
@@ -50,7 +50,6 @@ DECLARE_MODULE_AV1(quit, NULL, NULL, quit_clist, NULL, NULL, "$Revision: 1333 $"
 
 /*
 ** m_quit
-**      parv[0] = sender prefix
 **      parv[1] = comment
 */
 static int
@@ -87,7 +86,6 @@ m_quit(struct Client *client_p, struct Client *source_p, int parc, const char *p
 
 /*
 ** ms_quit
-**      parv[0] = sender prefix
 **      parv[1] = comment
 */
 static int
diff --git a/modules/core/m_server.c b/modules/core/m_server.c
index 86ff95c4d..9007fd8b4 100644
--- a/modules/core/m_server.c
+++ b/modules/core/m_server.c
@@ -64,7 +64,6 @@ static int set_server_gecos(struct Client *, const char *);
 
 /*
  * mr_server - SERVER message handler
- *      parv[0] = sender prefix
  *      parv[1] = servername
  *      parv[2] = serverinfo/hopcount
  *      parv[3] = serverinfo
@@ -261,7 +260,6 @@ mr_server(struct Client *client_p, struct Client *source_p, int parc, const char
 
 /*
  * ms_server - SERVER message handler
- *      parv[0] = sender prefix
  *      parv[1] = servername
  *      parv[2] = serverinfo/hopcount
  *      parv[3] = serverinfo
diff --git a/modules/core/m_squit.c b/modules/core/m_squit.c
index e53e29100..587b851bb 100644
--- a/modules/core/m_squit.c
+++ b/modules/core/m_squit.c
@@ -64,7 +64,6 @@ static struct squit_parms *find_squit(struct Client *client_p,
 
 /*
  * mo_squit - SQUIT message handler
- *      parv[0] = sender prefix
  *      parv[1] = server name
  *      parv[2] = comment
  */
@@ -106,7 +105,6 @@ mo_squit(struct Client *client_p, struct Client *source_p, int parc, const char
 
 /*
  * ms_squit - SQUIT message handler
- *      parv[0] = sender prefix
  *      parv[1] = server name
  *      parv[2] = comment
  */
diff --git a/modules/m_accept.c b/modules/m_accept.c
index 3af9c9eb9..06a341b4a 100644
--- a/modules/m_accept.c
+++ b/modules/m_accept.c
@@ -54,7 +54,6 @@ DECLARE_MODULE_AV1(accept, NULL, NULL, accept_clist, NULL, NULL, "$Revision: 254
 
 /*
  * m_accept - ACCEPT command handler
- *      parv[0] = sender prefix
  *      parv[1] = servername
  */
 static int
diff --git a/modules/m_admin.c b/modules/m_admin.c
index 5e051a4da..9b0bf8d7d 100644
--- a/modules/m_admin.c
+++ b/modules/m_admin.c
@@ -60,7 +60,6 @@ DECLARE_MODULE_AV1(admin, NULL, NULL, admin_clist, admin_hlist, NULL, "$Revision
 
 /*
  * mr_admin - ADMIN command handler
- *      parv[0] = sender prefix   
  *      parv[1] = servername   
  */
 static int
@@ -86,7 +85,6 @@ mr_admin(struct Client *client_p, struct Client *source_p, int parc, const char
 
 /*
  * m_admin - ADMIN command handler
- *      parv[0] = sender prefix
  *      parv[1] = servername
  */
 static int
@@ -117,7 +115,6 @@ m_admin(struct Client *client_p, struct Client *source_p, int parc, const char *
 
 /*
  * ms_admin - ADMIN command handler, used for OPERS as well
- *      parv[0] = sender prefix
  *      parv[1] = servername
  */
 static int
diff --git a/modules/m_away.c b/modules/m_away.c
index d52c66f42..02b510d8e 100644
--- a/modules/m_away.c
+++ b/modules/m_away.c
@@ -64,7 +64,6 @@ DECLARE_MODULE_AV1(away, NULL, NULL, away_clist, NULL, NULL, "$Revision: 3370 $"
 
 /*
 ** m_away
-**      parv[0] = sender prefix
 **      parv[1] = away message
 */
 static int
diff --git a/modules/m_capab.c b/modules/m_capab.c
index 3bc93724a..3e7de45d7 100644
--- a/modules/m_capab.c
+++ b/modules/m_capab.c
@@ -50,7 +50,6 @@ DECLARE_MODULE_AV1(capab, NULL, NULL, capab_clist, NULL, NULL, "$Revision: 1295
 
 /*
  * mr_capab - CAPAB message handler
- *      parv[0] = sender prefix
  *      parv[1] = space-separated list of capabilities
  *
  */
diff --git a/modules/m_challenge.c b/modules/m_challenge.c
index e0b9dbe05..19729e3cb 100644
--- a/modules/m_challenge.c
+++ b/modules/m_challenge.c
@@ -100,7 +100,6 @@ cleanup_challenge(struct Client *target_p)
 
 /*
  * m_challenge - generate RSA challenge for wouldbe oper
- * parv[0] = sender prefix
  * parv[1] = operator to challenge for, or +response
  *
  */
diff --git a/modules/m_chghost.c b/modules/m_chghost.c
index a4b4ce3e6..57bffa977 100644
--- a/modules/m_chghost.c
+++ b/modules/m_chghost.c
@@ -77,7 +77,6 @@ clean_host(const char *host)
 
 /*
  * me_realhost
- * parv[0] = origin
  * parv[1] = real host
  *
  * Yes this contains a little race condition if someone does a whois
@@ -140,7 +139,6 @@ do_chghost(struct Client *source_p, struct Client *target_p,
 
 /*
  * ms_chghost
- * parv[0] = origin
  * parv[1] = target
  * parv[2] = host
  */
@@ -168,7 +166,6 @@ ms_chghost(struct Client *client_p, struct Client *source_p,
 
 /*
  * me_chghost
- * parv[0] = origin
  * parv[1] = target
  * parv[2] = host
  */
@@ -188,7 +185,6 @@ me_chghost(struct Client *client_p, struct Client *source_p,
 
 /*
  * mo_chghost
- * parv[0] = origin
  * parv[1] = target
  * parv[2] = host
  */
diff --git a/modules/m_connect.c b/modules/m_connect.c
index 809783a2b..cf8975603 100644
--- a/modules/m_connect.c
+++ b/modules/m_connect.c
@@ -57,7 +57,6 @@ DECLARE_MODULE_AV1(connect, NULL, NULL, connect_clist, NULL, NULL, "$Revision: 3
  * Added by Jto 11 Feb 1989
  *
  * m_connect
- *      parv[0] = sender prefix
  *      parv[1] = servername
  *      parv[2] = port number
  *      parv[3] = remote server
@@ -161,7 +160,6 @@ mo_connect(struct Client *client_p, struct Client *source_p, int parc, const cha
  * Added by Jto 11 Feb 1989
  *
  * m_connect
- *      parv[0] = sender prefix
  *      parv[1] = servername
  *      parv[2] = port number
  *      parv[3] = remote server
diff --git a/modules/m_etrace.c b/modules/m_etrace.c
index be65ab66c..a0a1e072a 100644
--- a/modules/m_etrace.c
+++ b/modules/m_etrace.c
@@ -80,7 +80,6 @@ static const char *spoofed_sockhost = "0";
 
 /*
  * m_etrace
- *      parv[0] = sender prefix
  *      parv[1] = options [or target]
  *	parv[2] = [target]
  */
diff --git a/modules/m_help.c b/modules/m_help.c
index ae5b90e9f..f1f1d2eae 100644
--- a/modules/m_help.c
+++ b/modules/m_help.c
@@ -57,7 +57,6 @@ DECLARE_MODULE_AV1(help, NULL, NULL, help_clist, NULL, NULL, "$Revision: 254 $")
 
 /*
  * m_help - HELP message handler
- *      parv[0] = sender prefix
  */
 static int
 m_help(struct Client *client_p, struct Client *source_p, int parc, const char *parv[])
@@ -69,7 +68,6 @@ m_help(struct Client *client_p, struct Client *source_p, int parc, const char *p
 
 /*
  * mo_help - HELP message handler
- *      parv[0] = sender prefix
  */
 static int
 mo_help(struct Client *client_p, struct Client *source_p, int parc, const char *parv[])
@@ -81,7 +79,6 @@ mo_help(struct Client *client_p, struct Client *source_p, int parc, const char *
 /*
  * mo_uhelp - HELP message handler
  * This is used so that opers can view the user help file without deopering
- *      parv[0] = sender prefix
  */
 static int
 mo_uhelp(struct Client *client_p, struct Client *source_p, int parc, const char *parv[])
diff --git a/modules/m_info.c b/modules/m_info.c
index 2fba465b2..eaf920f07 100644
--- a/modules/m_info.c
+++ b/modules/m_info.c
@@ -597,7 +597,6 @@ static struct InfoStruct info_table[] = {
 
 /*
 ** m_info
-**  parv[0] = sender prefix
 **  parv[1] = servername
 */
 static int
@@ -630,7 +629,6 @@ m_info(struct Client *client_p, struct Client *source_p, int parc, const char *p
 
 /*
 ** mo_info
-**  parv[0] = sender prefix
 **  parv[1] = servername
 */
 static int
diff --git a/modules/m_invite.c b/modules/m_invite.c
index 04e04f061..91254adb4 100644
--- a/modules/m_invite.c
+++ b/modules/m_invite.c
@@ -52,7 +52,6 @@ DECLARE_MODULE_AV1(invite, NULL, NULL, invite_clist, NULL, NULL, "$Revision: 343
 static void add_invite(struct Channel *, struct Client *);
 
 /* m_invite()
- *      parv[0] - sender prefix
  *      parv[1] - user to invite
  *      parv[2] - channel name
  */
diff --git a/modules/m_knock.c b/modules/m_knock.c
index 958951d3a..9c39e35b9 100644
--- a/modules/m_knock.c
+++ b/modules/m_knock.c
@@ -48,7 +48,6 @@ mapi_clist_av1 knock_clist[] = { &knock_msgtab, NULL };
 DECLARE_MODULE_AV1(knock, NULL, NULL, knock_clist, NULL, NULL, "$Revision: 3570 $");
 
 /* m_knock
- *    parv[0] = sender prefix
  *    parv[1] = channel
  *
  *  The KNOCK command has the following syntax:
diff --git a/modules/m_links.c b/modules/m_links.c
index e4a0f8811..3aafbc7f2 100644
--- a/modules/m_links.c
+++ b/modules/m_links.c
@@ -59,10 +59,8 @@ DECLARE_MODULE_AV1(links, NULL, NULL, links_clist, links_hlist, NULL, "$Revision
 
 /*
  * m_links - LINKS message handler
- *      parv[0] = sender prefix
  *      parv[1] = servername mask
  * or
- *      parv[0] = sender prefix
  *      parv[1] = server to query 
  *      parv[2] = servername mask
  */
diff --git a/modules/m_list.c b/modules/m_list.c
index ab05e405f..ba83d898f 100644
--- a/modules/m_list.c
+++ b/modules/m_list.c
@@ -103,7 +103,6 @@ static void safelist_check_cliexit(hook_data_client_exit * hdata)
 }
 
 /* m_list()
- *      parv[0] = sender prefix
  *      parv[1] = channel
  *
  * XXX - With SAFELIST, do we really need to continue pacing?
@@ -138,7 +137,6 @@ static int m_list(struct Client *client_p, struct Client *source_p, int parc, co
 }
 
 /* mo_list()
- *      parv[0] = sender prefix
  *      parv[1] = channel
  */
 static int mo_list(struct Client *client_p, struct Client *source_p, int parc, const char *parv[])
diff --git a/modules/m_locops.c b/modules/m_locops.c
index bf2e01447..4e6215768 100644
--- a/modules/m_locops.c
+++ b/modules/m_locops.c
@@ -54,7 +54,6 @@ DECLARE_MODULE_AV1(locops, NULL, NULL, locops_clist, NULL, NULL, "$Revision: 254
 /*
  * m_locops - LOCOPS message handler
  * (write to *all* local opers currently online)
- *      parv[0] = sender prefix
  *      parv[1] = message text
  */
 static int
diff --git a/modules/m_lusers.c b/modules/m_lusers.c
index 58dfdeedd..1a3bd355d 100644
--- a/modules/m_lusers.c
+++ b/modules/m_lusers.c
@@ -49,7 +49,6 @@ DECLARE_MODULE_AV1(lusers, NULL, NULL, lusers_clist, NULL, NULL, "$Revision: 254
 
 /*
  * m_lusers - LUSERS message handler
- * parv[0] = sender
  * parv[1] = host/server mask.
  * parv[2] = server to query
  * 
@@ -85,7 +84,6 @@ m_lusers(struct Client *client_p, struct Client *source_p, int parc, const char
 
 /*
  * ms_lusers - LUSERS message handler for servers and opers
- * parv[0] = sender
  * parv[1] = host/server mask.
  * parv[2] = server to query
  * 
diff --git a/modules/m_map.c b/modules/m_map.c
index 7c679fb30..c2ab6be4c 100644
--- a/modules/m_map.c
+++ b/modules/m_map.c
@@ -48,7 +48,6 @@ static void dump_map(struct Client *client_p, struct Client *root, char *pbuf);
 static char buf[BUFSIZE];
 
 /* m_map
-**	parv[0] = sender prefix
 */
 static int
 m_map(struct Client *client_p, struct Client *source_p, int parc, const char *parv[])
@@ -67,7 +66,6 @@ m_map(struct Client *client_p, struct Client *source_p, int parc, const char *pa
 
 /*
 ** mo_map
-**      parv[0] = sender prefix
 */
 static int
 mo_map(struct Client *client_p, struct Client *source_p, int parc, const char *parv[])
diff --git a/modules/m_motd.c b/modules/m_motd.c
index 15742ff3f..cb4b17138 100644
--- a/modules/m_motd.c
+++ b/modules/m_motd.c
@@ -59,7 +59,6 @@ static void motd_spy(struct Client *);
 
 /*
 ** m_motd
-**      parv[0] = sender prefix
 **      parv[1] = servername
 */
 static int
@@ -90,7 +89,6 @@ m_motd(struct Client *client_p, struct Client *source_p, int parc, const char *p
 
 /*
 ** mo_motd
-**      parv[0] = sender prefix
 **      parv[1] = servername
 */
 static int
diff --git a/modules/m_names.c b/modules/m_names.c
index 76425fe74..d01baeb50 100644
--- a/modules/m_names.c
+++ b/modules/m_names.c
@@ -57,7 +57,6 @@ static void names_global(struct Client *source_p);
 
 /*
  * m_names
- *      parv[0] = sender prefix
  *      parv[1] = channel
  */
 static int
diff --git a/modules/m_oper.c b/modules/m_oper.c
index 1b0b7c928..061a9b71e 100644
--- a/modules/m_oper.c
+++ b/modules/m_oper.c
@@ -55,7 +55,6 @@ static int match_oper_password(const char *password, struct oper_conf *oper_p);
 
 /*
  * m_oper
- *      parv[0] = sender prefix
  *      parv[1] = oper name
  *      parv[2] = oper password
  */
diff --git a/modules/m_pass.c b/modules/m_pass.c
index b66de738f..5f59f95f3 100644
--- a/modules/m_pass.c
+++ b/modules/m_pass.c
@@ -52,7 +52,6 @@ DECLARE_MODULE_AV1(pass, NULL, NULL, pass_clist, NULL, NULL, "$Revision: 3550 $"
  *
  *
  * mr_pass - PASS message handler
- *      parv[0] = sender prefix
  *      parv[1] = password
  *      parv[2] = "TS" if this server supports TS.
  *      parv[3] = optional TS version field -- needed for TS6
diff --git a/modules/m_ping.c b/modules/m_ping.c
index 6269c54ee..bb5cadeee 100644
--- a/modules/m_ping.c
+++ b/modules/m_ping.c
@@ -50,7 +50,6 @@ DECLARE_MODULE_AV1(ping, NULL, NULL, ping_clist, NULL, NULL, "$Revision: 254 $")
 
 /*
 ** m_ping
-**      parv[0] = sender prefix
 **      parv[1] = origin
 **      parv[2] = destination
 */
diff --git a/modules/m_post.c b/modules/m_post.c
index 50367e1d5..e67b133b8 100644
--- a/modules/m_post.c
+++ b/modules/m_post.c
@@ -59,7 +59,6 @@ DECLARE_MODULE_AV1(post, NULL, NULL, post_clist, NULL, NULL, "$Revision: 498 $")
 
 /*
 ** mr_dumb_proxy
-**      parv[0] = sender prefix
 **      parv[1] = comment
 */
 static int
diff --git a/modules/m_resv.c b/modules/m_resv.c
index 92e57309c..0c983694f 100644
--- a/modules/m_resv.c
+++ b/modules/m_resv.c
@@ -70,7 +70,6 @@ static int remove_resv_from_file(struct Client *source_p, const char *name);
 
 /*
  * mo_resv()
- *      parv[0] = sender prefix
  *      parv[1] = channel/nick to forbid
  *      parv[2] = reason
  */
@@ -140,7 +139,6 @@ mo_resv(struct Client *client_p, struct Client *source_p, int parc, const char *
 }
 
 /* ms_resv()
- *     parv[0] = sender prefix
  *     parv[1] = target server
  *     parv[2] = channel/nick to forbid
  *     parv[3] = reason
@@ -370,7 +368,6 @@ cluster_resv(struct Client *source_p, int temp_time, const char *name,
 
 /*
  * mo_unresv()
- *     parv[0] = sender prefix
  *     parv[1] = channel/nick to unforbid
  */
 static int
@@ -407,7 +404,6 @@ mo_unresv(struct Client *client_p, struct Client *source_p, int parc, const char
 }
 
 /* ms_unresv()
- *     parv[0] = sender prefix
  *     parv[1] = target server
  *     parv[2] = resv to remove
  */
diff --git a/modules/m_scan.c b/modules/m_scan.c
index bb90d559d..7f4718761 100644
--- a/modules/m_scan.c
+++ b/modules/m_scan.c
@@ -79,7 +79,6 @@ static const char *spoofed_sockhost = "0";
 
 /*
  * m_scan
- *      parv[0] = sender prefix
  *      parv[1] = options [or target]
  *	parv[2] = [target]
  */
diff --git a/modules/m_services.c b/modules/m_services.c
index ffc77cd5f..c1536e3e2 100644
--- a/modules/m_services.c
+++ b/modules/m_services.c
@@ -240,7 +240,6 @@ me_rsfnc(struct Client *client_p, struct Client *source_p,
 
 /*
 ** me_nickdelay
-**      parv[0] = sender prefix
 **      parv[1] = duration in seconds (0 to remove)
 **      parv[2] = nick
 */
diff --git a/modules/m_snote.c b/modules/m_snote.c
index 2ab7f7b33..74f51a713 100644
--- a/modules/m_snote.c
+++ b/modules/m_snote.c
@@ -62,7 +62,6 @@ DECLARE_MODULE_AV1(snote, NULL, NULL, snote_clist, NULL, NULL, "$Revision: 623 $
 
 /*
  * me_snote
- *      parv[0] = sender prefix
  *      parv[1] = snomask letter
  *	parv[2] = message
  */
diff --git a/modules/m_stats.c b/modules/m_stats.c
index dd678a312..29e7c7ed7 100644
--- a/modules/m_stats.c
+++ b/modules/m_stats.c
@@ -174,7 +174,6 @@ static struct StatsStruct stats_cmd_table[] = {
 
 /*
  * m_stats by fl_
- *      parv[0] = sender prefix
  *      parv[1] = stat letter/command
  *      parv[2] = (if present) server/mask in stats L, or target
  *
diff --git a/modules/m_svinfo.c b/modules/m_svinfo.c
index 27ff52570..3ffb8f488 100644
--- a/modules/m_svinfo.c
+++ b/modules/m_svinfo.c
@@ -48,7 +48,6 @@ DECLARE_MODULE_AV1(svinfo, NULL, NULL, svinfo_clist, NULL, NULL, "$Revision: 494
 
 /*
  * ms_svinfo - SVINFO message handler
- *      parv[0] = sender prefix
  *      parv[1] = TS_CURRENT for the server
  *      parv[2] = TS_MIN for the server
  *      parv[3] = unused, send 0
diff --git a/modules/m_time.c b/modules/m_time.c
index d677fe49e..81031ddc2 100644
--- a/modules/m_time.c
+++ b/modules/m_time.c
@@ -60,7 +60,6 @@ static const char *weekdays[] = {
 
 /*
  * m_time
- *      parv[0] = sender prefix
  *      parv[1] = servername
  */
 static int
diff --git a/modules/m_topic.c b/modules/m_topic.c
index a69a99e29..d8ad5b9d6 100644
--- a/modules/m_topic.c
+++ b/modules/m_topic.c
@@ -53,7 +53,6 @@ DECLARE_MODULE_AV1(topic, NULL, NULL, topic_clist, NULL, NULL, "$Revision: 254 $
 
 /*
  * m_topic
- *      parv[0] = sender prefix
  *      parv[1] = channel name
  *	parv[2] = new topic, if setting topic
  */
@@ -166,7 +165,6 @@ m_topic(struct Client *client_p, struct Client *source_p, int parc, const char *
 
 /*
  * ms_topic
- *      parv[0] = sender prefix
  *      parv[1] = channel name
  *	parv[2] = topic_info
  *	parv[3] = topic_info time
diff --git a/modules/m_trace.c b/modules/m_trace.c
index 2b9f70be8..603922e6f 100644
--- a/modules/m_trace.c
+++ b/modules/m_trace.c
@@ -67,7 +67,6 @@ static const char *empty_sockhost = "255.255.255.255";
 
 /*
  * m_trace
- *      parv[0] = sender prefix
  *      parv[1] = servername
  */
 static int
diff --git a/modules/m_users.c b/modules/m_users.c
index da3937991..80b8b801d 100644
--- a/modules/m_users.c
+++ b/modules/m_users.c
@@ -47,7 +47,6 @@ DECLARE_MODULE_AV1(users, NULL, NULL, users_clist, NULL, NULL, "$Revision: 254 $
 
 /*
  * m_users
- *      parv[0] = sender prefix
  *      parv[1] = servername
  */
 static int
diff --git a/modules/m_version.c b/modules/m_version.c
index 05d8bdf09..60d793c57 100644
--- a/modules/m_version.c
+++ b/modules/m_version.c
@@ -51,7 +51,6 @@ DECLARE_MODULE_AV1(version, NULL, NULL, version_clist, NULL, NULL, "$Revision: 1
 
 /*
  * m_version - VERSION command handler
- *      parv[0] = sender prefix
  *      parv[1] = remote server
  */
 static int
@@ -87,7 +86,6 @@ m_version(struct Client *client_p, struct Client *source_p, int parc, const char
 
 /*
  * mo_version - VERSION command handler
- *      parv[0] = sender prefix
  *      parv[1] = remote server
  */
 static int
diff --git a/modules/m_wallops.c b/modules/m_wallops.c
index 1a591abe6..d2c2b28de 100644
--- a/modules/m_wallops.c
+++ b/modules/m_wallops.c
@@ -78,7 +78,6 @@ mo_operwall(struct Client *client_p, struct Client *source_p, int parc, const ch
 /*
  * ms_operwall - OPERWALL message handler
  *  (write to *all* local opers currently online)
- *      parv[0] = sender prefix
  *      parv[1] = message text
  */
 static int
diff --git a/modules/m_who.c b/modules/m_who.c
index 8dfcfbad8..63fb2ed35 100644
--- a/modules/m_who.c
+++ b/modules/m_who.c
@@ -84,7 +84,6 @@ static void do_who(struct Client *source_p,
 
 /*
 ** m_who
-**      parv[0] = sender prefix
 **      parv[1] = nickname mask list
 **      parv[2] = additional selection flag and format options
 */
diff --git a/modules/m_whois.c b/modules/m_whois.c
index 085e4d64d..ca8dc2384 100644
--- a/modules/m_whois.c
+++ b/modules/m_whois.c
@@ -69,7 +69,6 @@ DECLARE_MODULE_AV1(whois, NULL, NULL, whois_clist, whois_hlist, NULL, "$Revision
 
 /*
  * m_whois
- *      parv[0] = sender prefix
  *      parv[1] = nickname masklist
  */
 static int
@@ -115,7 +114,6 @@ m_whois(struct Client *client_p, struct Client *source_p, int parc, const char *
 
 /*
  * ms_whois
- *      parv[0] = sender prefix
  *      parv[1] = server to reply
  *      parv[2] = nickname to whois
  */
diff --git a/modules/m_whowas.c b/modules/m_whowas.c
index 5ad67dfd3..6007361aa 100644
--- a/modules/m_whowas.c
+++ b/modules/m_whowas.c
@@ -53,7 +53,6 @@ DECLARE_MODULE_AV1(whowas, NULL, NULL, whowas_clist, NULL, NULL, "$Revision: 171
 
 /*
 ** m_whowas
-**      parv[0] = sender prefix
 **      parv[1] = nickname queried
 */
 static int
diff --git a/src/parse.c b/src/parse.c
index 5fe0585dc..37d0c88f0 100644
--- a/src/parse.c
+++ b/src/parse.c
@@ -50,7 +50,7 @@ struct Dictionary *alias_dict = NULL;
  */
 static char *sender;
 
-/* parv[0] == source, and parv[LAST] == NULL */
+/* parv[0] is not used, and parv[LAST] == NULL */
 static char *para[MAXPARA + 2];
 
 static void cancel_clients(struct Client *, struct Client *, char *);
@@ -104,7 +104,7 @@ string_to_array(char *string, char **parv)
 		if(*buf == '\0')
 			return x;
 	}
-	/* we can go upto parv[MAXPARA], as parv[0] is taken by source */
+	/* we can go upto parv[MAXPARA], as parv[0] is skipped */
 	while (x < MAXPARA);
 
 	if(*p == ':')
@@ -560,7 +560,6 @@ remove_unknown(struct Client *client_p, char *lsender, char *lbuffer)
 /*
  *
  *      parc    number of arguments ('sender' counted as one!)
- *      parv[0] pointer to 'sender' (may point to empty string) (not used)
  *      parv[1]..parv[parc-1]
  *              pointers to additional parameters, this is a NULL
  *              terminated list (parv[parc] == NULL).
diff --git a/src/s_user.c b/src/s_user.c
index f9984f40c..7ba25c34a 100644
--- a/src/s_user.c
+++ b/src/s_user.c
@@ -882,7 +882,6 @@ show_other_user_mode(struct Client *source_p, struct Client *target_p)
  * user_mode - set get current users mode
  *
  * m_umode() added 15/10/91 By Darren Reed.
- * parv[0] - sender
  * parv[1] - username to change mode for
  * parv[2] - modes to change
  */
diff --git a/unsupported/m_clearchan.c b/unsupported/m_clearchan.c
index 0a3921f02..70c583dbc 100644
--- a/unsupported/m_clearchan.c
+++ b/unsupported/m_clearchan.c
@@ -49,7 +49,6 @@ DECLARE_MODULE_AV1(clearchan, NULL, NULL, clearchan_clist, NULL, NULL, "$Revisio
 
 /*
 ** mo_clearchan
-**      parv[0] = sender prefix
 **      parv[1] = channel
 */
 static int
diff --git a/unsupported/m_force.c b/unsupported/m_force.c
index 146fa9c16..4a621f46c 100644
--- a/unsupported/m_force.c
+++ b/unsupported/m_force.c
@@ -69,7 +69,6 @@ DECLARE_MODULE_AV1(force, NULL, NULL, force_clist, NULL, NULL, "$Revision: 3297
 
 /*
  * m_forcejoin
- *      parv[0] = sender prefix
  *      parv[1] = user to force
  *      parv[2] = channel to force them into
  */