1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113
|
/*
* Copyright (c) 2003-2004 E. Will et al.
* Rights to this code are documented in doc/LICENSE.
*
* This file contains routines to handle the CService HELP command.
*
*/
#include "atheme.h"
DECLARE_MODULE_V1
(
"chanserv/help", false, _modinit, _moddeinit,
PACKAGE_STRING,
VENDOR_STRING
);
static void cs_cmd_help(sourceinfo_t *si, int parc, char *parv[]);
command_t cs_help = { "HELP", N_("Displays contextual help information."),
AC_NONE, 1, cs_cmd_help, { .path = "help" } };
void _modinit(module_t *m)
{
service_named_bind_command("chanserv", &cs_help);
}
void _moddeinit(module_unload_intent_t intent)
{
service_named_unbind_command("chanserv", &cs_help);
}
/* HELP <command> [params] */
static void cs_cmd_help(sourceinfo_t *si, int parc, char *parv[])
{
char *command = parv[0];
/* strip off channel name for fantasy commands */
if (si->c)
{
command = strchr(command, ' ');
if (command != NULL)
command++;
}
if (!command)
{
command_success_nodata(si, _("***** \2%s Help\2 *****"), chansvs.nick);
command_success_nodata(si, _("\2%s\2 gives normal users the ability to maintain control\n"
"of a channel, without the need of a bot. Channel takeovers are\n"
"virtually impossible when a channel is registered with \2%s\2.\n"
"Registration is a quick and painless process. Once registered,\n"
"the founder can maintain complete and total control over the channel."),
chansvs.nick, chansvs.nick);
if (chansvs.expiry > 0)
{
command_success_nodata(si, _("Please note that channels will expire after %d days of inactivity,\n"
"or if there are no eligible channel successors.\n"
"Activity is defined as a user with one of %s being on the channel."), (chansvs.expiry / 86400), bitmask_to_flags2(CA_USEDUPDATE & ca_all, 0));
}
else
{
command_success_nodata(si, _("Please note that channels will expire if there are no eligible channel successors."));
}
command_success_nodata(si, _("Successors are primarily those who have the +S (if available) or +R flag\n"
"set on their account in the channel, although other people may be chosen\n"
"depending on their access level and activity."));
command_success_nodata(si, " ");
if (chansvs.fantasy && config_options.join_chans && chansvs.trigger != '\0')
{
command_success_nodata(si, _("Commands can also be given on channel by prefixing one of '%s'\n"
"and omitting the channel name. These are called \"fantasy\"\n"
"commands and can also be disabled on a per-channel basis."), chansvs.trigger);
command_success_nodata(si, " ");
}
command_success_nodata(si, _("For more information on a command, type:"));
command_success_nodata(si, "\2/%s%s help <command>\2", (ircd->uses_rcommand == false) ? "msg " : "", chansvs.me->disp);
command_success_nodata(si, _("For a verbose listing of all commands, type:"));
command_success_nodata(si, "\2/%s%s help commands\2", (ircd->uses_rcommand == false) ? "msg " : "", chansvs.me->disp);
command_success_nodata(si, " ");
command_help_short(si, chansvs.me->commands, "REGISTER OP INVITE UNBAN FLAGS INFO SET CLOSE FDROP FFLAGS FTRANSFER");
command_success_nodata(si, _("***** \2End of Help\2 *****"));
/* Fun for helpchan/helpurl. */
if (config_options.helpchan && config_options.helpurl)
command_success_nodata(si, _("If you're having trouble or you need some additional help, you may want to join the help channel %s or visit the help webpage %s"),
config_options.helpchan, config_options.helpurl);
else if (config_options.helpchan && !config_options.helpurl)
command_success_nodata(si, _("If you're having trouble or you need some additional help, you may want to join the help channel %s"), config_options.helpchan);
else if (!config_options.helpchan && config_options.helpurl)
command_success_nodata(si, _("If you're having trouble or you need some additional help, you may want to visit the help webpage %s"), config_options.helpurl);
return;
}
if (!strcasecmp("COMMANDS", command))
{
command_success_nodata(si, _("***** \2%s Help\2 *****"), chansvs.nick);
command_help(si, chansvs.me->commands);
command_success_nodata(si, _("***** \2End of Help\2 *****"));
return;
}
help_display(si, chansvs.me, command, chansvs.me->commands);
}
/* vim:cinoptions=>s,e0,n0,f0,{0,}0,^0,=s,ps,t0,c3,+s,(2s,us,)20,*30,gs,hs
* vim:ts=8
* vim:sw=8
* vim:noexpandtab
*/
|