[Asterisk-code-review] modules.conf.sample: Update preload usage documentation. (asterisk[16])

[Richard Mudgett]

Richard Mudgett has uploaded this change for review. ( https://gerrit.asterisk.org/10525


Change subject: modules.conf.sample: Update preload usage documentation.
......................................................................

modules.conf.sample: Update preload usage documentation.

Change-Id: Id449d4435c38148b56ac4cfd61ae4d90ac66bb90
---
M configs/samples/modules.conf.sample
1 file changed, 13 insertions(+), 12 deletions(-)



  git pull ssh://gerrit.asterisk.org:29418/asterisk refs/changes/25/10525/1

diff --git a/configs/samples/modules.conf.sample b/configs/samples/modules.conf.sample
index 179e9ef..db85fae 100644
--- a/configs/samples/modules.conf.sample
+++ b/configs/samples/modules.conf.sample
@@ -8,26 +8,27 @@
 autoload=yes
 ;
 ; Any modules that need to be loaded before the Asterisk core has been
-; initialized (just after the logger has been initialized) can be loaded
-; using 'preload'. This will frequently be needed if you wish to map all
-; module configuration files into Realtime storage, since the Realtime
-; driver will need to be loaded before the modules using those configuration
-; files are initialized.
+; initialized (just after the logger initialization) can be loaded
+; using 'preload'.
 ;
-; An example of loading ODBC support would be:
-;preload => res_odbc.so
-;preload => res_config_odbc.so
+; NOTE: 'preload' is a legacy module loading method that is not really
+; needed anymore and generally should not be used.  It was historically
+; required to preload realtime driver modules so you could map all module
+; configuration files to Realtime storage.  The Realtime drivers needed
+; to be loaded before any module (including modules internal to Asterisk)
+; using configuration files got initialized.  Realtime driver modules no
+; longer need to be preloaded.
 ;
-; Uncomment the following if you wish to use the Speech Recognition API
-;preload => res_speech.so
+;preload => your_special_module.so
 ;
 ; If you want Asterisk to fail if a module does not load, then use
 ; the "require" keyword. Asterisk will exit with a status code of 2
 ; if a required module does not load.
 ;
-; require = chan_sip.so
+; require = chan_pjsip.so
+;
 ; If you want you can combine with preload
-; preload-require = res_odbc.so
+; preload-require = your_special_module.so
 ;
 ;load => res_musiconhold.so
 ;

-- 
To view, visit https://gerrit.asterisk.org/10525
To unsubscribe, or for help writing mail filters, visit https://gerrit.asterisk.org/settings

Gerrit-Project: asterisk
Gerrit-Branch: 16
Gerrit-MessageType: newchange
Gerrit-Change-Id: Id449d4435c38148b56ac4cfd61ae4d90ac66bb90
Gerrit-Change-Number: 10525
Gerrit-PatchSet: 1
Gerrit-Owner: Richard Mudgett <rmudgett at digium.com>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.digium.com/pipermail/asterisk-code-review/attachments/20181022/69d9fbae/attachment.html>