Skip to content

Commit 92d10b2

Browse files
committed
docs: clarify what two registrars can do
1 parent cd52324 commit 92d10b2

1 file changed

Lines changed: 8 additions & 3 deletions

File tree

user_guide_src/source/general/configuration.rst

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -292,9 +292,11 @@ There are two ways to implement a Registrar: **implicit** and **explicit**.
292292
Implicit Registrars
293293
===================
294294

295-
Any namespace may define registrars by using the **Config/Registrar.php** file.
296-
These files are classes whose methods are
297-
named for each configuration class you wish to extend.
295+
Implicit Registrars can change any Config class properties.
296+
297+
Any namespace may define implicit registrars by using the **Config/Registrar.php**
298+
file. These files are classes whose methods are named for each configuration class
299+
you wish to extend.
298300

299301
For example, a third-party module or Composer package might
300302
wish to supply an additional template to ``Config\Pager`` without overwriting whatever a developer has
@@ -310,6 +312,9 @@ overwrite priority.
310312
Explicit Registrars
311313
===================
312314

315+
Explicit Registrars can only change the Config class properties in which they are
316+
registered.
317+
313318
A configuration file can also specify any number of registrars explicitly.
314319
This is done by adding a ``$registrars`` property to your configuration file,
315320
holding an array of the names of candidate registrars:

0 commit comments

Comments
 (0)