From a2dcf9a1ad535e270cc6816373aa91a3bcdd06be Mon Sep 17 00:00:00 2001 From: Matt Schatz Date: Mon, 16 Apr 2018 03:02:49 -0600 Subject: Improve some documentation (#1483). * Improve exemptchanops in inspircd.conf.example () and modules.conf.example; along with both helpop examples. * Add "the" to all "requires X module" in both helpop examples. * Refer to customprefix instead of chanprotect and halfop. * Add SNOMASK 'r' and 'R' (OPERLOG) to both helpop examples. * Clean up unnecessarily split SNOMASK lines in both helpop examples. * Move chmode 'g' to be in alphabetical order in both helpops examples. * Specify the needed mask formats for TLINE in helpop-full example. * Remove extra '\' in RLINE mask format in helpop-full example. Force xml format in helpop-full * Generalize "color codes" to "formatting codes" * Fix file name in include for example helpop-full --- docs/conf/helpop-full.conf.example | 222 ++++++++++++++++++++----------------- 1 file changed, 119 insertions(+), 103 deletions(-) (limited to 'docs/conf/helpop-full.conf.example') diff --git a/docs/conf/helpop-full.conf.example b/docs/conf/helpop-full.conf.example index 910689dfa..72ec2a7d4 100644 --- a/docs/conf/helpop-full.conf.example +++ b/docs/conf/helpop-full.conf.example @@ -2,6 +2,8 @@ # Helpop Standard # ##################### + + Returns the ip and nickname of the given users."> - +(by IP address or by hostname). Mask should be given as either a +nick!user@host or user@IP (wildcards acceptable)."> ---------- c Blocks private messages and notices from users who do - not share a common channel with you (requires + not share a common channel with you (requires the commonchans module). d Deaf mode. User will not receive any messages or notices - from channels they are in (requires deaf module). + from channels they are in (requires the deaf module). g In combination with /ACCEPT, provides for server side - ignore (requires callerid module). + ignore (requires the callerid module). h Marks as 'available for help' in WHOIS (IRCop only, - requires helpop module). + requires the helpop module). i Makes invisible to /WHO if the user using /WHO is not in a common channel. k Prevents the user from being kicked from channels, or having op modes removed from them (services only, - requires servprotect module). + requires the servprotect module). o Marks as a IRC operator. s Receives server notices specified by (IRCop only). r Marks as a having a registered nickname - (requires services account module). + (requires the services account module). w Receives wallops messages. - x Gives a cloaked hostname (requires cloaking module). - B Marks as a bot (requires botmode module). + x Gives a cloaked hostname (requires the cloaking module). + B Marks as a bot (requires the botmode module). G Censors messages sent to the user based on filters - configured for the network (requires censor module). - H Hides an oper's oper status from WHOIS (requires + configured for the network (requires the censor module). + H Hides an oper's oper status from WHOIS (requires the hideoper module). I Hides a user's entire channel list in WHOIS from - non-IRCops (requires hidechans module). + non-IRCops (requires the hidechans module). L Stops redirections done by m_redirect (mode must be enabled in the config). R Blocks private messages from unregistered users - (requires services account module). - S Strips mIRC color/bold/underline codes out of private - messages to the user (requires stripcolor module). + (requires the services account module). + S Strips formatting codes out of private messages + to the user (requires the stripcolor module). W Receives notification when a user uses WHOIS on them - (IRCop only, requires showwhois module)."> + (IRCop only, requires the showwhois module)."> p Make channel private, hiding it in users' whoises and replacing it with * in /LIST. r Marks the channel as registered with Services - (requires services account module). + (requires the services account module). s Make channel secret, hiding it in users' whoises and /LIST. t Prevents users without +h or +o from changing the topic. u Makes the channel an auditorium; normal users only see themselves or themselves and the operators, - while operators see all the users (requires + while operators see all the users (requires the auditorium module). w : Adds basic channel access controls of to , via the +w listmode. For example, +w o:R:Brain will op anyone identified to the account 'Brain' on join. - (requires autoop module) + (requires the autoop module) z Blocks non-SSL clients from joining the channel. A Allows anyone to invite users to the channel (normally only chanops can invite, requires - allowinvite module). + the allowinvite module). B Blocks messages with too many capital letters, as determined by the network configuration - (requires blockcaps module). - C Blocks any CTCPs to the channel (requires noctcp - module). - D Delays join messages from users until they - message the channel (requires delayjoin module). + (requires the blockcaps module). + C Blocks any CTCPs to the channel (requires the + noctcp module). + D Delays join messages from users until they message + the channel (requires the delayjoin module). F : Blocks nick changes when they equal or exceed the - specified rate (requires nickflood module). + specified rate (requires the nickflood module). G Censors messages to the channel based on the - network configuration (requires censor module). + network configuration (requires the censor module). H : Displays the last lines of chat to joining users. is the maximum time to keep - lines in the history buffer (requires chanhistory - module). + lines in the history buffer (requires the + chanhistory module). J Prevents rejoin after kick for the specified number of seconds. This prevents auto-rejoin - (requires kicknorejoin module). + (requires the kicknorejoin module). K Blocks /KNOCK on the channel. L If the channel reaches its limit set by +l, - redirect users to (requires redirect - module). + redirect users to (requires the + redirect module). M Blocks unregistered users from speaking (requires - services account module). + the services account module). N Prevents users on the channel from changing nick - (requires nonicks module). + (requires the nonicks module). O Channel is IRCops only (can only be set by IRCops, - requires operchans module). + requires the operchans module). P Makes the channel permanent; Bans, invites, the topic, modes, and such will not be lost when it empties (can only be set by IRCops, requires - permchannels module). + the permchannels module). Q Only ulined servers and their users can kick - (requires nokicks module) + (requires the nokicks module) R Blocks unregistered users from joining (requires - services account module). - S Strips mIRC color codes from messages to the - channel (requires stripcolor module). + the services account module). + S Strips formatting codes from messages to the + channel (requires the stripcolor module). T Blocks /NOTICEs to the channel from users who are - not at least halfop (requires nonotice module). - - g Blocks messages matching the given glob mask - (requires chanfilter module). - X Makes channel operators immune to the specified - restrictive mode (requires exemptchanops module). + not at least halfop (requires the nonotice module). + X : Makes users of or higher exempt to the + specified restriction . For example: flood:h + (requires the exemptchanops module). + Possible restriction types to exempt with +X are: + + auditorium-see Permission required to see the full user list of + a +u channel (requires the auditorium module). + auditorium-vis Permission required to be visible in a +u channel + (requires the auditorium module). + blockcaps Channel mode +B + blockcolor Channel mode +c + censor Channel mode +G + filter Channel mode +g + flood Channel mode +f + nickflood Channel mode +F + noctcp Channel mode +C + nonick Channel mode +N + nonotice Channel mode +T + regmoderated Channel mode +M + stripcolor Channel mode +S + topiclock Channel mode +t ------------- NOTE: A large number of these modes are dependent upon server-side modules @@ -992,30 +1013,25 @@ Note that all /STATS use is broadcast to online IRC operators."> A Allows receipt of remote announcement messages. c Allows receipt of local connect messages. C Allows receipt of remote connect messages. - d Allows receipt of general (and sometimes random) debug - messages. + d Allows receipt of general (and sometimes random) debug messages. f Allows receipt of flooding notices. - g Allows receipt of globops (requires globops module). - j Allows receipt of channel creation notices (requires - chancreate module). - J Allows receipt of remote channel creation notices (requires - chancreate module). + g Allows receipt of globops (requires the globops module). + j Allows receipt of channel creation notices (requires the chancreate module). + J Allows receipt of remote channel creation notices (requires the chancreate module). k Allows receipt of local kill messages. K Allows receipt of remote kill messages. - l Allows receipt of local linking related - messages. - L Allows receipt of remote linking related - messages. - n See local nickname changes (requires seenicks module). - N See remote nickname changes (requires seenicks modules). - o Allows receipt of oper-up, oper-down, and oper-failure - messages. - O Allows receipt of remote oper-up, oper-down, and oper-failure - messages. + l Allows receipt of local linking related messages. + L Allows receipt of remote linking related messages. + n See local nickname changes (requires the seenicks module). + N See remote nickname changes (requires the seenicks modules). + o Allows receipt of oper-up, oper-down, and oper-failure messages. + O Allows receipt of remote oper-up, oper-down, and oper-failure messages. q Allows receipt of local quit messages. Q Allows receipt of remote quit messages. + r Allows receipt of local oper commands (requires the operlog module). + R Allows receipt of remote oper commands (requires the operlog module). t Allows receipt of attempts to use /STATS (local and remote). - v Allows receipt of oper-override notices (requires override module). + v Allows receipt of oper-override notices (requires the override module). x Allows receipt of local Xline notices (g/Z/q/k/e/R/shuns). X Allows receipt of remote Xline notices (g/Z/q/k/e/R/shuns)."> @@ -1040,42 +1056,42 @@ setting +I . Matching extbans: j: Matches anyone in the given channel. Does not support - wildcards (requires channelban module). - r: Matches users with a matching realname (requires gecosban - module). - s: Matches users on a matching server (requires serverban - module). + wildcards (requires the channelban module). + r: Matches users with a matching realname (requires the + gecosban module). + s: Matches users on a matching server (requires the + serverban module). z: Matches users having the given SSL certificate - fingerprint (requires sslmodes module). + fingerprint (requires the sslmodes module). O: Matches IRCops of a matching type, mostly useful as an - an invite exception (requires operchans module). + an invite exception (requires the operchans module). R: Matches users logged into a matching account (requires - services account module). + the services account module). U: Matches unregistered users matching the given banmask. - (requires services account module). + (requires the services account module). Acting extbans: - c: Blocks any messages that contain color codes from - matching users (requires blockcolor module). - m: Blocks messages from matching users (requires muteban + c: Blocks any messages that contain formatting codes from + matching users (requires the blockcolor module). + m: Blocks messages from matching users (requires the muteban module). Users with +v or above are not affected. p: Blocks part messages from matching users (requires - nopartmsg module). + the nopartmsg module). A: Blocks invites by matching users even when +A is set - (requires allowinvite module). + (requires the allowinvite module). B: Blocks all capital or nearly all capital messages from - matching users (requires blockcaps module). - C: Blocks CTCPs from matching users (requires noctcp + matching users (requires the blockcaps module). + C: Blocks CTCPs from matching users (requires the noctcp module). N: Blocks nick changes from matching users (requires - nonicks module). - Q: Blocks kicks by matching users (requires nokicks - module). - S: Strips color/bold/underline from messages from matching - users (requires stripcolor module). - T: Blocks notices from matching users (requires nonotice + the nonicks module). + Q: Blocks kicks by matching users (requires the nokicks module). + S: Strips formatting codes from messages from matching + users (requires the stripcolor module). + T: Blocks notices from matching users (requires the + nonotice module). A ban given to an Acting extban may either be a nick!user@host mask (unless stated otherwise), matched against users as for a normal ban, @@ -1084,4 +1100,4 @@ or a Matching extban. There is an additional special type of extended ban, a redirect ban: Redirect n!u@h#channel will redirect the banned user to #channel - when they try to join (requires banredirect module)."> + when they try to join (requires the banredirect module)."> -- cgit v1.2.3