]> jfr.im git - irc/charybdis-ircd/charybdis.git/commitdiff
some styling
authorAntoine Beaupré <redacted>
Sat, 25 Mar 2017 15:33:06 +0000 (11:33 -0400)
committerSimon Arlott <sa.me.uk>
Sun, 12 Aug 2018 08:24:47 +0000 (09:24 +0100)
turn all +flags into preformatted flags, fix admonitions

doc/oper-guide/cmodes.rst
doc/oper-guide/commands.rst
doc/oper-guide/config.rst
doc/oper-guide/oprivs.rst
doc/oper-guide/ucommands.rst
doc/oper-guide/umodes.rst

index 0232e1ee182bf9915cd122b0200ad1ca083dfe40..7c805dd6d169ebf19e0e792de9e833ba4a1b36e2 100644 (file)
@@ -1,15 +1,15 @@
 Channel modes
 =============
 
-+b, channel ban
----------------
+``+b``, channel ban
+-------------------
 
 Bans take one parameter which can take several forms. The most common
-form is +b nick!user@host. The wildcards \* and ? are allowed, matching
+form is ``+b nick!user@host``. The wildcards ``*`` and ``?`` are allowed, matching
 zero-or-more, and exactly-one characters respectively. The masks will be
 trimmed to fit the maximum allowable length for the relevant element.
 Bans are also checked against the IP address, even if it resolved or is
-spoofed. CIDR is supported, like \*!\*@10.0.0.0/8. This is most useful
+spoofed. CIDR is supported, like ``*!*@10.0.0.0/8``. This is most useful
 with IPv6. Bans are not checked against the real hostname behind any
 kind of spoof, except if host mangling is in use (e.g.
 ``extensions/ip_cloaking.so``): if the user's host is mangled, their
@@ -18,11 +18,11 @@ could enable mangling, the mangled form of their hostname is checked
 additionally. Hence, it is not possible to evade bans by toggling host
 mangling.
 
-The second form (extban) is +b $type or +b $type:data. type is a single
+The second form (extban) is ``+b $type`` or ``+b $type:data``. type is a single
 character (case insensitive) indicating the type of match, optionally
-preceded by a tilde (~) to negate the comparison. data depends on type.
+preceded by a tilde (``~``) to negate the comparison. data depends on type.
 Each type is loaded as a module. The available types (if any) are listed
-in the EXTBAN token of the 005 (RPL\_ISUPPORT) numeric. See
+in the EXTBAN token of the 005 (``RPL_ISUPPORT``) numeric. See
 ``doc/extban.txt`` in the source distribution for more information.
 
 If no parameter is given, the list of bans is returned. All users can
@@ -32,98 +32,97 @@ Matching users will not be allowed to join the channel or knock on it.
 If they are already on the channel, they may not send to it or change
 their nick.
 
-+c, colour filter
------------------
+``+c``, colour filter
+---------------------
 
 This cmode activates the colour filter for the channel. This filters out
 bold, underline, reverse video, beeps, mIRC colour codes, and ANSI
 escapes. Note that escape sequences will usually leave cruft sent to the
 channel, just without the escape characters themselves.
 
-+e, ban exemption
------------------
+``+e``, ban exemption
+---------------------
 
 This mode takes one parameter of the same form as bans, which overrides
-+b and +q bans for all clients it matches.
+``+b`` and ``+q`` bans for all clients it matches.
 
 This can be useful if it is necessary to ban an entire ISP due to
 persistent abuse, but some users from that ISP should still be allowed
-in. For example: /mode #channel +be \*!\*@\*.example.com
-\*!\*someuser@host3.example.com
+in. For example: ``/mode #channel +be *!*@*.example.com *!*someuser@host3.example.com``
 
-Only channel operators can see +e changes or request the list.
+Only channel operators can see ``+e`` changes or request the list.
 
-+f, channel forwarding
-----------------------
+``+f``, channel forwarding
+--------------------------
 
-This mode takes one parameter, the name of a channel (+f #channel). If
-the channel also has the +i cmode set, and somebody attempts to join
-without either being expliticly invited, or having an invex (+I), then
+This mode takes one parameter, the name of a channel (``+f #channel``). If
+the channel also has the ``+i`` cmode set, and somebody attempts to join
+without either being expliticly invited, or having an invex (``+I``), then
 they will instead join the channel named in the mode parameter. The
 client will also be sent a 470 numeric giving the original and target
 channels.
 
-Users are similarly forwarded if the +j cmode is set and their attempt
-to join is throttled, if +l is set and there are already too many users
-in the channel or if +r is set and they are not identified.
+Users are similarly forwarded if the ``+j`` cmode is set and their attempt
+to join is throttled, if ``+l`` is set and there are already too many users
+in the channel or if ``+r`` is set and they are not identified.
 
-Forwards may only be set to +F channels, or to channels the setter has
+Forwards may only be set to ``+F`` channels, or to channels the setter has
 ops in.
 
-Without parameter (/mode #channel f or /mode #channel +f) the forward
+Without parameter (``/mode #channel f`` or ``/mode #channel +f``) the forward
 channel is returned. This form also works off channel.
 
-+F, allow anybody to forward to this
-------------------------------------
+``+F``, allow anybody to forward to this
+----------------------------------------
 
 When this mode is set, anybody may set a forward from a channel they
 have ops in to this channel. Otherwise they have to have ops in this
 channel.
 
-+g, allow anybody to invite
----------------------------
+``+g``, allow anybody to invite
+-------------------------------
 
 When this mode is set, anybody may use the INVITE command on the channel
 in question. When it is unset, only channel operators may use the INVITE
 command.
 
-When this mode is set together with +i, +j, +l or +r, all channel
+When this mode is set together with ``+i``, ``+j``, ``+l`` or ``+r``, all channel
 members can influence who can join.
 
-+i, invite only
----------------
+``+i``, invite only
+-------------------
 
 When this cmode is set, no client can join the channel unless they have
-an invex (+I) or are invited with the INVITE command.
+an invex (``+I``) or are invited with the INVITE command.
 
-+I, invite exception (invex)
-----------------------------
+``+I``, invite exception (invex)
+--------------------------------
 
 This mode takes one parameter of the same form as bans. Matching clients
 do not need to be invited to join the channel when it is invite-only
-(+i). Unlike the INVITE command, this does not override +j, +l and +r.
+(``+i``). Unlike the INVITE command, this does not override ``+j``, ``+l`` and ``+r``.
 
-Only channel operators can see +I changes or request the list.
+Only channel operators can see ``+I`` changes or request the list.
 
-+j, join throttling
--------------------
+``+j``, join throttling
+-----------------------
 
 This mode takes one parameter of the form n:t, where n and t are
 positive integers. Only n users may join in each period of t seconds.
 
-Invited users can join regardless of +j, but are counted as normal.
+Invited users can join regardless of ``+j``, but are counted as normal.
 
 Due to propagation delays between servers, more users may be able to
 join (by racing for the last slot on each server).
 
-+k, key (channel password)
---------------------------
+``+k``, key (channel password)
+------------------------------
 
 Taking one parameter, when set, this mode requires a user to supply the
 key in order to join the channel: /JOIN #channel key.
 
-+l, channel member limit
-------------------------
+``+l``, channel member limit
+----------------------------
 
 Takes one numeric parameter, the number of users which are allowed to be
 in the channel before further joins are blocked. Invited users may join
@@ -132,35 +131,35 @@ regardless.
 Due to propagation delays between servers, more users may be able to
 join (by racing for the last slot on each server).
 
-+L, large ban list
-------------------
+``+L``, large ban list
+----------------------
 
 Channels with this mode will be allowed larger banlists (by default, 500
-instead of 50 entries for +b, +q, +e and +I together). Only network
+instead of 50 entries for ``+b``, ``+q``, ``+e`` and ``+I`` together). Only network
 operators with resv privilege may set this mode.
 
-+m, moderated
--------------
+``+m``, moderated
+-----------------
 
-When a channel is set +m, only users with +o or +v on the channel can
+When a channel is set ``+m``, only users with ``+o`` or ``+v`` on the channel can
 send to it.
 
 Users can still knock on the channel or change their nick.
 
-+n, no external messages
-------------------------
+``+n``, no external messages
+----------------------------
 
 When set, this mode prevents users from sending to the channel without
 being in it themselves. This is recommended.
 
-+o, channel operator
---------------------
+``+o``, channel operator
+------------------------
 
 This mode takes one parameter, a nick, and grants or removes channel
 operator privilege to that user. Channel operators have full control
-over the channel, having the ability to set all channel modes except +L
-and +P, and kick users. Like voiced users, channel operators can always
-send to the channel, overriding +b, +m and +q modes and the per-channel
+over the channel, having the ability to set all channel modes except ``+L``
+and ``+P``, and kick users. Like voiced users, channel operators can always
+send to the channel, overriding ``+b``, ``+m`` and ``+q`` modes and the per-channel
 flood limit. In most clients channel operators are marked with an '@'
 sign.
 
@@ -172,16 +171,16 @@ which ensure the founder (and users designated by the founder) can
 always gain channel operator privileges and provide some features to
 manage the channel.
 
-+p, paranoid channel
---------------------
+``+p``, paranoid channel
+------------------------
 
 When set, the KNOCK command cannot be used on the channel to request an
 invite, and users will not be shown the channel in WHOIS replies unless
-they are on it. Unlike in traditional IRC, +p and +s can be set
+they are on it. Unlike in traditional IRC, ``+p`` and ``+s`` can be set
 together.
 
-+P, permanent channel
----------------------
+``+P``, permanent channel
+-------------------------
 
 Channels with this mode (which is accessible only to network operators
 with resv privilege) set will not be destroyed when the last user
@@ -191,61 +190,61 @@ This makes it less likely modes, bans and the topic will be lost and
 makes it harder to abuse network splits, but also causes more unwanted
 restoring of old modes, bans and topics after long splits.
 
-+q, quiet
----------
+``+q``, quiet
+-------------
 
-This mode behaves exactly like +b (ban), except that the user may still
+This mode behaves exactly like ``+b`` (ban), except that the user may still
 join the channel. The net effect is that they cannot knock on the
 channel, send to the channel or change their nick while on channel.
 
-+Q, block forwarded users
--------------------------
+``+Q``, block forwarded users
+-----------------------------
 
 Channels with this mode set are not valid targets for forwarding. Any
 attempt to forward to this channel will be ignored, and the user will be
 handled as if the attempt was never made (by sending them the relevant
 error message).
 
-This does not affect the ability to set +f.
+This does not affect the ability to set ``+f``.
 
-+r, block unidentified
-----------------------
+``+r``, block unidentified
+--------------------------
 
 When set, this mode prevents unidentified users from joining. Invited
 users can still join.
 
-+s, secret channel
-------------------
+``+s``, secret channel
+----------------------
 
 When set, this mode prevents the channel from appearing in the output of
 the LIST, WHO and WHOIS command by users who are not on it. Also, the
 server will refuse to answer WHO, NAMES, TOPIC and LIST queries from
 users not on the channel.
 
-+t, topic limit
----------------
+``+t``, topic limit
+-------------------
 
 When set, this mode prevents users who are not channel operators from
 changing the topic.
 
-+v, voice
----------
+``+v``, voice
+-------------
 
 This mode takes one parameter, a nick, and grants or removes voice
 privilege to that user. Voiced users can always send to the channel,
-overriding +b, +m and +q modes and the per-channel flood limit. In most
+overriding ``+b``, ``+m`` and ``+q`` modes and the per-channel flood limit. In most
 clients voiced users are marked with a plus sign.
 
 The privilege is lost if the user leaves the channel or server in any
 way.
 
-+z, reduced moderation
-----------------------
+``+z``, reduced moderation
+--------------------------
 
-When +z is set, the effects of +m, +b and +q are relaxed. For each
+When ``+z`` is set, the effects of ``+m``, ``+b`` and ``+q`` are relaxed. For each
 message, if that message would normally be blocked by one of these
 modes, it is instead sent to all channel operators. This is intended for
 use in moderated debates.
 
-Note that +n is unaffected by this. To silence a given user completely,
+Note that ``+n`` is unaffected by this. To silence a given user completely,
 remove them from the channel.
index 97725e561972c4a051576daa9408380ab0d019cb..f8804b0f6bbe95816ea9265f7b4061c3eb6d0c6c 100644 (file)
@@ -4,11 +4,9 @@ Operator Commands
 Network management commands
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-    **Note**
-
-    All commands and names are case insensitive. Parameters consisting
-    of one or more separate letters, such as in MODE, STATS and WHO, are
-    case sensitive.
+.. note:: All commands and names are case insensitive. Parameters
+          consisting of one or more separate letters, such as in MODE,
+          STATS and WHO, are case sensitive.
 
 CONNECT
 -------
@@ -95,10 +93,8 @@ scratch as if it had just been executed.
 This reexecutes the ircd using the compiled-in path, visible as SPATH in
 INFO.
 
-    **Note**
-
-    This command cannot be used remotely. The server name is used only
-    as a safety measure.
+.. note:: This command cannot be used remotely. The server name is
+          used only as a safety measure.
 
 DIE
 ---
@@ -108,10 +104,8 @@ server
 Immediately terminate the IRC server, after sending notices to all
 connected clients and servers
 
-    **Note**
-
-    This command cannot be used remotely. The server name is used only
-    as a safety measure.
+.. note:: This command cannot be used remotely. The server name is
+          used only as a safety measure.
 
 SET
 ---
@@ -513,7 +507,7 @@ H.S.
     A server we have established a TCP connection to, but is not yet
     registered.
 
-????
+\?\?\?\?
     An incoming connection that has not yet registered as a user or a
     server (“unknown”). Shows the username, hostname, IP address and the
     time the connection has been open. It is possible that the ident or
index 2ba7a471df721d7ee1e64d89c5907b40f1035028..3e666c539796db6c472863e066c43591e3fa319e 100644 (file)
@@ -287,14 +287,12 @@ jupe\_exempt
 resv\_exempt
     Users in this auth{} block may use reserved nicknames and channels.
 
-        **Note**
-
-        The initial nickname may still not be reserved.
-
-flood\_exempt (\|)
-    Users in this auth{} block may send arbitrary amounts of commands
-    per time unit to the server. This does not exempt them from any
-    other flood limits. You should use this setting with caution.
+.. note:: The initial nickname may still not be reserved.
+          
+flood\_exempt (\|) Users in this auth{} block may send arbitrary
+    amounts of commands per time unit to the server. This does not
+    exempt them from any other flood limits. You should use this
+    setting with caution.
 
 no\_tilde (-)
     Users in this auth{} block will not have a tilde added to their
@@ -437,11 +435,9 @@ Connect blocks define what servers may connect or be connected to.
 host
     The hostname or IP to connect to.
 
-        **Note**
-
-        Furthermore, if a hostname is used, it must have an A or AAAA
-        record (no CNAME) and it must be the primary hostname for
-        inbound connections to work.
+.. note:: Furthermore, if a hostname is used, it must have an ``A`` or
+          ``AAAA`` record (no ``CNAME``) and it must be the primary hostname
+          for inbound connections to work.
 
 send\_password
     The password to send to the other server.
@@ -685,10 +681,8 @@ flags
     another flags entry) will receive these flags. They are listed
     below.
 
-    **Note**
-
-    While they have the same names, the flags have subtly different
-    meanings from those in the cluster{} block.
+.. note:: While they have the same names, the flags have subtly
+          different meanings from those in the cluster{} block.
 
 kline (K)
     Permanent and temporary K:lines
index 5567b063a10ed9fd5a7e6996ff110d86ad877c7a..ca25dfd4cb6a6efb09fff28669b1e4c0ef016625 100644 (file)
@@ -73,10 +73,8 @@ servers, and the server argument on REHASH. This is only allowed if the
 oper may perform the action locally, and if the remote server has a
 shared{} block.
 
-    **Note**
-
-    If a cluster{} block is present, bans are sent remotely even if the
-    oper does not have oper:remoteban privilege.
+.. note:: If a cluster{} block is present, bans are sent remotely even
+          if the oper does not have oper:remoteban privilege.
 
 oper:resv, channel control
 --------------------------
index ba74edfa82e1de8012b99f70fc42a4101b6ef33c..d8805cbae7cd4e61eb896f8902a5677293e418ca 100644 (file)
@@ -74,10 +74,9 @@ FINDFORWARDS
 
 FINDFORWARDS
 channel
-    **Note**
 
-    This command is only available if the ``m_findforwards.so``
-    extension is loaded.
+.. note:: This command is only available if the ``m_findforwards.so``
+          extension is loaded.
 
 Displays which channels forward to the given channel (via cmode +f). If
 there are very many channels the list will be truncated.
@@ -101,10 +100,9 @@ IDENTIFY
 
 IDENTIFY
 parameters...
-    **Note**
 
-    This command is only available if the ``m_identify.so`` extension is
-    loaded.
+.. note:: This command is only available if the ``m_identify.so``
+          extension is loaded.
 
 Sends an identify command to either NickServ or ChanServ. If the first
 parameter starts with #, the command is sent to ChanServ, otherwise to
index a05523e8680a44bde46fe90ee9ffac9ff4fc5e1e..d38dfd7f0652e5cc4e8de69eb64ed77e8fa85f4d 100644 (file)
@@ -1,63 +1,57 @@
 User modes
 ==========
 
-+a, server administrator
-------------------------
+``+a``, server administrator
+----------------------------
 
 This vanity usermode is used to denote a server administrator in WHOIS
 output. All local “admin” privileges are independent of it, though
-services packages may grant extra privileges to +a users.
-
-+D, deaf
---------
+services packages may grant extra privileges to ``+a`` users.
 
-    **Note**
+``+D``, deaf
+------------
 
-    This is a user umode, which anybody can set. It is not specific to
-    operators.
+.. note:: This is a user umode, which anybody can set. It is not
+          specific to operators.
 
-Users with the +D umode set will not receive messages sent to channels.
+Users with the ``+D`` umode set will not receive messages sent to channels.
 Joins, parts, topic changes, mode changes, etc are received as normal,
 as are private messages.
 
-Support of this umode is indicated by the DEAF token in RPL\_ISUPPORT
+Support of this umode is indicated by the ``DEAF`` token in ``RPL_ISUPPORT``
 (005); the parameter indicates the letter of the umode. Note that
 several common IRCD implementations have an umode like this (typically
-+d) but do not have the token in 005.
-
-+g, Caller ID
--------------
+``+d``) but do not have the token in 005.
 
-    **Note**
+``+g``, Caller ID
+-----------------
 
-    This is a user umode, which anybody can set. It is not specific to
-    operators.
+.. note:: This is a user umode, which anybody can set. It is not
+    specific to operators.
 
-Users with the +g umode set will only receive private messages from
-users on a session-defined whitelist, defined by the /accept command. If
-a user who is not on the whitelist attempts to send a private message,
-the target user will receive a rate-limited notice saying that the user
-wishes to speak to them.
+Users with the ``+g`` umode set will only receive private messages
+from users on a session-defined whitelist, defined by the ``/accept``
+command. If a user who is not on the whitelist attempts to send a
+private message, the target user will receive a rate-limited notice
+saying that the user wishes to speak to them.
 
 Network operators are not affected by the callerid whitelist system in
 the event that they need to speak to users who have it enabled.
 
-Support of this umode is indicated by the CALLERID token in
-RPL\_ISUPPORT (005); the optional parameter indicates the letter of the
-umode, otherwise +g.
+Support of this umode is indicated by the ``CALLERID`` token in
+``RPL_ISUPPORT`` (005); the optional parameter indicates the letter of
+the umode, otherwise ``+g``.
 
-+i, invisible
--------------
-
-    **Note**
+``+i``, invisible
+-----------------
 
-    This is a user umode, which anybody can set. It is not specific to
-    operators.
+.. note:: This is a user umode, which anybody can set. It is not
+          specific to operators.
 
 Invisible users do not show up in WHO and NAMES unless you can see them.
 
-+l, receive locops
-------------------
+``+l``, receive locops
+----------------------
 
 LOCOPS is a version of OPERWALL that is sent to opers on a single server
 only. With cluster{} and shared{} blocks they can optionally be
@@ -65,84 +59,77 @@ propagated further.
 
 Unlike OPERWALL, any oper can send and receive LOCOPS.
 
-+o, operator
-------------
+``+o``, operator
+----------------
 
 This indicates global operator status.
 
-+Q, disable forwarding
-----------------------
-
-    **Note**
+``+Q``, disable forwarding
+--------------------------
 
-    This is a user umode, which anybody can set. It is not specific to
-    operators.
+.. note:: This is a user umode, which anybody can set. It is not
+          specific to operators.
 
 This umode prevents you from being affected by channel forwarding. If
 enabled on a channel, channel forwarding sends you to another channel if
-you could not join. See channel mode +f for more information.
+you could not join. See channel mode ``+f`` for more information.
 
-+R, reject messages from unauthenticated users
-----------------------------------------------
+``+R``, reject messages from unauthenticated users
+--------------------------------------------------
 
-    **Note**
+.. note:: This is a user umode, which anybody can set. It is not
+          specific to operators.
 
-    This is a user umode, which anybody can set. It is not specific to
-    operators.
-
-If a user has the +R umode set, then any users who are not authenticated
+If a user has the ``+R`` umode set, then any users who are not authenticated
 will receive an error message if they attempt to send a private message
-or notice to the +R user.
+or notice to the ``+R`` user.
 
-Opers and accepted users (like in +g) are exempt. Unlike +g, the target
+Opers and accepted users (like in ``+g``) are exempt. Unlike ``+g``, the target
 user is not notified of failed messages.
 
-+s, receive server notices
---------------------------
+``+s``, receive server notices
+------------------------------
 
 This umode allows an oper to receive server notices. The requested types
 of server notices are specified as a parameter (“snomask”) to this
 umode.
 
-+S, network service
--------------------
-
-    **Note**
+``+S``, network service
+-----------------------
 
-    This umode can only be set by servers named in a service{} block.
+.. note:: This umode can only be set by servers named in a service{}
+          block.
 
 This umode grants various features useful for services. For example,
 clients with this umode cannot be kicked or deopped on channels, can
 send to any channel, do not show channels in WHOIS, can be the target of
 services aliases and do not appear in /stats p. No server notices are
 sent for hostname changes by services clients; server notices about
-kills are sent to snomask +k instead of +s.
+kills are sent to snomask ``+k`` instead of ``+s``.
 
 The exact effects of this umode are variable; no user or oper on an
 actual charybdis server can set it.
 
-+w, receive wallops
--------------------
-
-    **Note**
+``+w``, receive wallops
+-----------------------
 
-    This is a user umode, which anybody can set. It is not specific to
-    operators.
+.. note:: This is a user umode, which anybody can set. It is not
+          specific to operators.
 
-Users with the +w umode set will receive WALLOPS messages sent by opers.
-Opers with +w additionally receive WALLOPS sent by servers (e.g. remote
+Users with the ``+w`` umode set will receive WALLOPS messages sent by opers.
+Opers with ``+w`` additionally receive WALLOPS sent by servers (e.g. remote
 CONNECT, remote SQUIT, various severe misconfigurations, many services
 packages).
 
-+z, receive operwall
---------------------
+``+z``, receive operwall
+------------------------
 
 OPERWALL differs from WALLOPS in that the ability to receive such
-messages is restricted. Opers with +z set will receive OPERWALL
+messages is restricted. Opers with ``+z`` set will receive OPERWALL
 messages.
 
-+Z, SSL user
-------------
+``+Z``, SSL user
+----------------
 
 This umode is set on clients connected via SSL/TLS. It cannot be set or
 unset after initial connection.
@@ -154,7 +141,7 @@ Usage is as follows:
 
 MODE
 nick
-+s
+``+s``
 +/-flags
 To set snomasks.
 
@@ -163,132 +150,128 @@ nick
 -s
 To clear all snomasks.
 
-Umode +s will be set if at least one snomask is set.
+Umode ``+s`` will be set if at least one snomask is set.
 
-Umode +s is oper only by default, but even if you allow nonopers to set
+Umode ``+s`` is oper only by default, but even if you allow nonopers to set
 it, they will not get any server notices.
 
 Meanings of server notice masks
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-+b, bot warnings
-----------------
+``+b``, bot warnings
+--------------------
 
-Opers with the +b snomask set will receive warning messages from the
+Opers with the ``+b`` snomask set will receive warning messages from the
 server when potential flooders and spambots are detected.
 
-+c, client connections
-----------------------
+``+c``, client connections
+--------------------------
 
-Opers who have the +c snomask set will receive server notices when
+Opers who have the ``+c`` snomask set will receive server notices when
 clients attach to the local server.
 
-+C, extended client connection notices
---------------------------------------
+``+C``, extended client connection notices
+------------------------------------------
 
-Opers who have the +C snomask set will receive server notices when
-clients attach to the local server. Unlike the +c snomask, the
+Opers who have the ``+C`` snomask set will receive server notices when
+clients attach to the local server. Unlike the ``+c`` snomask, the
 information is displayed in a format intended to be parsed by scripts,
 and includes the two unused fields of the USER command.
 
-+d, debug
----------
+``+d``, debug
+-------------
 
-The +d snomask provides opers extra information which may be of interest
+The ``+d`` snomask provides opers extra information which may be of interest
 to debuggers. It will also cause the user to receive server notices if
 certain assertions fail inside the server. Its precise meaning is
 variable. Do not depend on the effects of this snomask as they can and
 will change without notice in later revisions.
 
-+f, full warning
-----------------
+``+f``, full warning
+--------------------
 
-Opers with the +f snomask set will receive notices when a user
+Opers with the ``+f`` snomask set will receive notices when a user
 connection is denied because a connection limit is exceeded (one of the
 limits in a class{} block, or the total per-server limit settable with
 /quote set max).
 
-+F, far client connection notices
----------------------------------
+``+F``, far client connection notices
+-------------------------------------
 
-    **Note**
+.. note:: This snomask is only available if the ``sno_farconnect.so``
+          extension is loaded.
 
-    This snomask is only available if the ``sno_farconnect.so``
-    extension is loaded.
-
-Opers with +F receive server notices when clients connect or disconnect
-on other servers. The notices have the same format as those from the +c
+Opers with ``+F`` receive server notices when clients connect or disconnect
+on other servers. The notices have the same format as those from the ``+c``
 snomask, except that the class is ? and the source server of the notice
 is the server the user is/was on.
 
 No notices are generated for netsplits and netjoins. Hence, these
 notices cannot be used to keep track of all clients on the network.
 
-There is no far equivalent of the +C snomask.
+There is no far equivalent of the ``+C`` snomask.
 
-+k, server kill notices
------------------------
+``+k``, server kill notices
+---------------------------
 
-Opers with the +k snomask set will receive server notices when services
+Opers with the ``+k`` snomask set will receive server notices when services
 kill users and when other servers kill and save (forced nick change to
-UID) users. Kills and saves by this server are on +d or +s.
+UID) users. Kills and saves by this server are on ``+d`` or ``+s``.
 
-+n, nick change notices
------------------------
+``+n``, nick change notices
+---------------------------
 
-An oper with +n set will receive a server notice every time a local user
+An oper with ``+n`` set will receive a server notice every time a local user
 changes their nick, giving the old and new nicks. This is mostly useful
 for bots that track all users on a single server.
 
-+r, notices on name rejections
-------------------------------
+``+r``, notices on name rejections
+----------------------------------
 
 Opers with this snomask set will receive a server notice when somebody
 tries to use an invalid username, or if a dumb HTTP proxy tries to
 connect.
 
-+s, generic server notices
---------------------------
+``+s``, generic server notices
+------------------------------
 
 This snomask allows an oper to receive generic server notices. This
 includes kills from opers (except services).
 
-+u, unauthorized connections
-----------------------------
+``+u``, unauthorized connections
+--------------------------------
 
 This snomask allows an oper to see when users try to connect who do not
 have an available auth{} block.
 
-+W, whois notifications
------------------------
+``+W``, whois notifications
+---------------------------
 
-    **Note**
+.. note:: This snomask is only available if the ``sno_whois.so``
+          extension is loaded.
 
-    This snomask is only available if the ``sno_whois.so`` extension is
-    loaded.
-
-Opers with +W receive notices when a WHOIS is executed on them on their
+Opers with ``+W`` receive notices when a WHOIS is executed on them on their
 server (showing idle time).
 
-+x, extra routing notices
--------------------------
+``+x``, extra routing notices
+-----------------------------
 
-Opers who have the +x snomask set will get notices about servers
+Opers who have the ``+x`` snomask set will get notices about servers
 connecting and disconnecting on the whole network. This includes all
 servers connected behind the affected link. This can get rather noisy
 but is useful for keeping track of all linked servers.
 
-+y, spy
--------
+``+y``, spy
+-----------
 
-Opers with +y receive notices when users try to join RESV'ed (“juped”)
+Opers with ``+y`` receive notices when users try to join RESV'ed (“juped”)
 channels. Additionally, if certain extension modules are loaded, they
 will receive notices when special commands are used.
 
-+Z, operspy notices
--------------------
+``+Z``, operspy notices
+-----------------------
 
-Opers with +Z receive notices whenever an oper anywhere on the network
+Opers with ``+Z`` receive notices whenever an oper anywhere on the network
 uses operspy.
 
 This snomask can be configured to be only effective for admins.