Skip to content

Commit d9465c4

Browse files
committed
plugin: add important notes about non-standard privilege levels
1 parent e112867 commit d9465c4

File tree

1 file changed

+28
-0
lines changed

1 file changed

+28
-0
lines changed

sopel/plugin.py

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -69,6 +69,13 @@
6969
"""Privilege level for the +h channel permission
7070
7171
.. versionadded:: 4.1
72+
73+
.. important::
74+
75+
Not all IRC networks support this privilege mode. If you are writing a
76+
plugin for public distribution, ensure your code behaves sensibly if only
77+
``+v`` (voice) and ``+o`` (op) modes exist.
78+
7279
"""
7380

7481
OP = 4
@@ -81,12 +88,26 @@
8188
"""Privilege level for the +a channel permission
8289
8390
.. versionadded:: 4.1
91+
92+
.. important::
93+
94+
Not all IRC networks support this privilege mode. If you are writing a
95+
plugin for public distribution, ensure your code behaves sensibly if only
96+
``+v`` (voice) and ``+o`` (op) modes exist.
97+
8498
"""
8599

86100
OWNER = 16
87101
"""Privilege level for the +q channel permission
88102
89103
.. versionadded:: 4.1
104+
105+
.. important::
106+
107+
Not all IRC networks support this privilege mode. If you are writing a
108+
plugin for public distribution, ensure your code behaves sensibly if only
109+
``+v`` (voice) and ``+o`` (op) modes exist.
110+
90111
"""
91112

92113
OPER = 32
@@ -96,6 +117,13 @@
96117
store any user's OPER status.
97118
98119
.. versionadded:: 7.0.0
120+
121+
.. important::
122+
123+
Not all IRC networks support this privilege mode. If you are writing a
124+
plugin for public distribution, ensure your code behaves sensibly if only
125+
``+v`` (voice) and ``+o`` (op) modes exist.
126+
99127
"""
100128

101129

0 commit comments

Comments
 (0)