Update comments for parv[0] removal.

This commit is contained in:
Jilles Tjoelker 2009-01-18 18:22:43 +01:00
parent 564b19bf9a
commit ac408af6cb
62 changed files with 5 additions and 97 deletions

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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.
*/

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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
*/

View File

@ -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

View File

@ -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
*/

View File

@ -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
*/

View File

@ -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

View File

@ -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

View File

@ -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
*/

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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
*
*/

View File

@ -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
*
*/

View File

@ -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
*/

View File

@ -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

View File

@ -80,7 +80,6 @@ static const char *spoofed_sockhost = "0";
/*
* m_etrace
* parv[0] = sender prefix
* parv[1] = options [or target]
* parv[2] = [target]
*/

View File

@ -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[])

View File

@ -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

View File

@ -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
*/

View File

@ -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:

View File

@ -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
*/

View File

@ -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[])

View File

@ -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

View File

@ -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
*

View File

@ -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[])

View File

@ -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

View File

@ -57,7 +57,6 @@ static void names_global(struct Client *source_p);
/*
* m_names
* parv[0] = sender prefix
* parv[1] = channel
*/
static int

View File

@ -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
*/

View File

@ -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

View File

@ -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
*/

View File

@ -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

View File

@ -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
*/

View File

@ -79,7 +79,6 @@ static const char *spoofed_sockhost = "0";
/*
* m_scan
* parv[0] = sender prefix
* parv[1] = options [or target]
* parv[2] = [target]
*/

View File

@ -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
*/

View File

@ -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
*/

View File

@ -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
*

View File

@ -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

View File

@ -60,7 +60,6 @@ static const char *weekdays[] = {
/*
* m_time
* parv[0] = sender prefix
* parv[1] = servername
*/
static int

View File

@ -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

View File

@ -67,7 +67,6 @@ static const char *empty_sockhost = "255.255.255.255";
/*
* m_trace
* parv[0] = sender prefix
* parv[1] = servername
*/
static int

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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
*/

View File

@ -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
*/

View File

@ -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

View File

@ -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).

View File

@ -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
*/

View File

@ -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

View File

@ -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
*/