]> jfr.im git - irc/charybdis-ircd/charybdis.git/commitdiff
review oprivs.rst style
authorAntoine Beaupré <redacted>
Sat, 25 Mar 2017 15:44:51 +0000 (11:44 -0400)
committerSimon Arlott <sa.me.uk>
Sun, 12 Aug 2018 08:22:46 +0000 (09:22 +0100)
doc/oper-guide/oprivs.rst

index ca25dfd4cb6a6efb09fff28669b1e4c0ef016625..50768f5e81b6cba9d6688a8f946f98599d641566 100644 (file)
@@ -12,13 +12,13 @@ things, this automatically sets umode +a and allows loading modules.
 oper:die, die and restart
 -------------------------
 
-This grants permission to use DIE and RESTART, shutting down or
+This grants permission to use ``DIE`` and ``RESTART``, shutting down or
 restarting the server.
 
 oper:global\_kill, global kill
 ------------------------------
 
-Allows using KILL on users on any server.
+Allows using ``KILL`` on users on any server.
 
 oper:hidden, hide from /stats p
 -------------------------------
@@ -36,40 +36,40 @@ possessed, umode +a can still not be used.
 oper:kline, kline and dline
 ---------------------------
 
-Allows using KLINE and DLINE, to ban users by user@host mask or IP
+Allows using ``KLINE`` and ``DLINE``, to ban users by user@host mask or IP
 address.
 
 oper:local\_kill, kill local users
 ----------------------------------
 
-This grants permission to use KILL on users on the same server,
+This grants permission to use ``KILL`` on users on the same server,
 disconnecting them from the network.
 
 oper:mass\_notice, global notices and wallops
 ---------------------------------------------
 
-Allows using server name ($$mask) and hostname ($#mask) masks in NOTICE
-and PRIVMSG to send a message to all matching users, and allows using
-the WALLOPS command to send a message to all users with umode +w set.
+Allows using server name ($$mask) and hostname ($#mask) masks in ``NOTICE``
+and ``PRIVMSG`` to send a message to all matching users, and allows using
+the ``WALLOPS`` command to send a message to all users with umode +w set.
 
 oper:operwall, send/receive operwall
 ------------------------------------
 
-Allows using the OPERWALL command and umode +z to send and receive
+Allows using the ``OPERWALL`` command and umode +z to send and receive
 operwalls.
 
 oper:rehash, rehash
 -------------------
 
-Allows using the REHASH command, to rehash various configuration files
+Allows using the ``REHASH`` command, to rehash various configuration files
 or clear certain lists.
 
 oper:remoteban, set remote bans
 -------------------------------
 
-This grants the ability to use the ON argument on DLINE/KLINE/XLINE/RESV
-and UNDLINE/UNKLINE/UNXLINE/UNRESV to set and unset bans on other
-servers, and the server argument on REHASH. This is only allowed if the
+This grants the ability to use the ON argument on ``DLINE``/``KLINE``/``XLINE``/``RESV``
+and ``UNDLINE``/``UNKLINE``/``UNXLINE``/``UNRESV`` to set and unset bans on other
+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.
 
@@ -85,40 +85,40 @@ This allows using /resv, /unresv and changing the channel modes +L and
 oper:routing, remote routing
 ----------------------------
 
-This allows using the third argument of the CONNECT command, to instruct
-another server to connect somewhere, and using SQUIT with an argument
+This allows using the third argument of the ``CONNECT`` command, to instruct
+another server to connect somewhere, and using ``SQUIT`` with an argument
 that is not locally connected. (In both cases all opers with +w set will
 be notified.)
 
 oper:spy, use operspy
 ---------------------
 
-This allows using /mode !#channel, /whois !nick, /who !#channel,
-/chantrace !#channel, /topic !#channel, /who !mask, /masktrace
-!user@host :gecos and /scan umodes +modes-modes global list to see
+This allows using ``/mode !#channel``, ``/whois !nick``, ``/who !#channel``,
+``/chantrace !#channel``, ``/topic !#channel``, ``/who !mask``, ``/masktrace
+!user@host :gecos`` and ``/scan umodes +modes-modes global list`` to see
 through secret channels, invisible users, etc.
 
-All operspy usage is broadcasted to opers with snomask +Z set (on the
+All operspy usage is broadcasted to opers with snomask ``+Z`` set (on the
 entire network) and optionally logged. If you grant this to anyone, it
 is a good idea to establish concrete policies describing what it is to
 be used for, and what not.
 
-If operspy\_dont\_care\_user\_info is enabled, /who mask is operspy
-also, and /who !mask, /who mask, /masktrace !user@host :gecos and /scan
-umodes +modes-modes global list do not generate +Z notices or logs.
+If ``operspy_dont_care_user_info`` is enabled, ``/who mask`` is operspy
+also, and ``/who !mask``, ``/who mask``, ``/masktrace !user@host :gecos`` and ``/scan
+umodes +modes-modes global list`` do not generate ``+Z`` notices or logs.
 
 oper:unkline, unkline and undline
 ---------------------------------
 
-Allows using UNKLINE and UNDLINE.
+Allows using ``UNKLINE`` and ``UNDLINE``.
 
 oper:xline, xline and unxline
 -----------------------------
 
-Allows using XLINE and UNXLINE, to ban/unban users by realname.
+Allows using ``XLINE`` and ``UNXLINE``, to ban/unban users by realname.
 
 snomask:nick\_changes, see nick changes
 ---------------------------------------
 
-Allows using snomask +n to see local client nick changes. This is
+Allows using snomask ``+n`` to see local client nick changes. This is
 designed for monitor bots.