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

[Joshua Colp]

Joshua Colp has submitted this change and it was merged. ( 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, 12 insertions(+), 12 deletions(-)

Approvals:
  Sean Bright: Looks good to me, but someone else must approve
  Corey Farrell: Looks good to me, but someone else must approve
  Joshua Colp: Looks good to me, approved; Approved for Submit



diff --git a/configs/samples/modules.conf.sample b/configs/samples/modules.conf.sample
index 179e9ef..c6c0dbc 100644
--- a/configs/samples/modules.conf.sample
+++ b/configs/samples/modules.conf.sample
@@ -8,26 +8,26 @@
 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'.  'preload' forces a module and the modules it
+; is known to depend upon to be loaded earlier than they normally get
+; loaded.
 ;
-; An example of loading ODBC support would be:
-;preload => res_odbc.so
-;preload => res_config_odbc.so
+; NOTE: There is no good reason left to use 'preload' anymore.  It was
+; historically required to preload realtime driver modules so you could
+; map Asterisk core configuration files to Realtime storage.
+; This is no longer needed.
 ;
-; 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: merged
Gerrit-Change-Id: Id449d4435c38148b56ac4cfd61ae4d90ac66bb90
Gerrit-Change-Number: 10525
Gerrit-PatchSet: 3
Gerrit-Owner: Richard Mudgett <rmudgett at digium.com>
Gerrit-Reviewer: Corey Farrell <git at cfware.com>
Gerrit-Reviewer: George Joseph <gjoseph at digium.com>
Gerrit-Reviewer: Jenkins2 (1000185)
Gerrit-Reviewer: Joshua Colp <jcolp at digium.com>
Gerrit-Reviewer: Sean Bright <sean.bright at gmail.com>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.digium.com/pipermail/asterisk-code-review/attachments/20181025/b205903f/attachment.html>