Add notes about the rebuilding of files

(This used to be commit 0ab6e96c9b32526936878da62b3cc00edd0ac27c)

1 files changed, 15 insertions, 6 deletions

diff --git a/docs/docbook/devdoc/modules.sgml b/docs/docbook/devdoc/modules.sgml
index 99cba605bd..0bcdadc66c 100644
--- a/docs/docbook/devdoc/modules.sgml
+++ b/docs/docbook/devdoc/modules.sgml
@@ -63,11 +63,8 @@ it is here currently (from <filename>include/config.h</filename>):
 </programlisting></para>
 
 <para>
-These functions should be called before the subsystem is used. That can be 
-done either from the executable that will be using the subsystem (
-static_init_rpc is called from the main() function of smbd), or 
-from the subsystem itself when it's first used (like passdb's
-lazy_initialise_passdb does).
+These functions should be called before the subsystem is used. That 
+should be done when the subsystem is initialised or first used. 
 </para>
 
 </sect2>
@@ -138,10 +135,22 @@ for each module and SMB_SUBSYSTEM() for each subsystem.
 <para>Syntax:</para>
 
 <para><programlisting>
-SMB_MODULE($MODULE_<replaceable>subsystem</replaceable>_<replaceable>backend</replaceable>, <replaceable>subsystem</replaceable>_<replaceable>backend</replaceable>, <replaceable>object files</replaceable>, <replaceable>plugin name</replaceable>, <replaceable>subsystem name</replaceable>)
+SMB_MODULE(<replaceable>subsystem</replaceable>_<replaceable>backend</replaceable>, <replaceable>object files</replaceable>, <replaceable>plugin name</replaceable>, <replaceable>subsystem name</replaceable>, <replaceable>static_action</replaceable>, <replaceable>shared_action</replaceable>)
 SMB_SUBSYSTEM(<replaceable>subsystem</replaceable>)
 </programlisting></para>
 
+<para>Also, make sure to add the correct directives to 
+<filename>Makefile.in</filename>. <replaceable>@SUBSYSTEM_STATIC@</replaceable>
+will be replaced with a list of objects files of the modules that need to 
+be linked in statically. <replaceable>@SUBSYSTEM_MODULES@</replaceable> will 
+be replaced with the names of the plugins to build.
+</para>
+
+<para>You must make sure all .c files that contain defines that can 
+be changed by ./configure are rebuilded in the 'modules_clean' make target. 
+Practically, this means all c files that contain <command>static_init_subsystem;</command> calls need to be rebuilded.
+</para>
+
 </sect2>
 </sect1>
 </chapter>