Add notes for packagers
authorJelmer Vernooij <jelmer@samba.org>
Mon, 24 Mar 2003 18:47:18 +0000 (18:47 +0000)
committerJelmer Vernooij <jelmer@samba.org>
Mon, 24 Mar 2003 18:47:18 +0000 (18:47 +0000)
docs/docbook/devdoc/dev-doc.sgml
docs/docbook/devdoc/packagers.sgml [new file with mode: 0644]

index f10fe7241483dbca48ba1f96f68182cc97c96809..5e1af3d3a0354acc8f1fddb2a9c9bb3cf09ffd59 100644 (file)
@@ -14,6 +14,7 @@
 <!ENTITY encryption SYSTEM "encryption.sgml">
 <!ENTITY rpc-plugin SYSTEM "rpc_plugin.sgml">
 <!ENTITY modules SYSTEM "modules.sgml">
+<!ENTITY packagers SYSTEM "packagers.sgml">
 ]>
 
 <book id="Samba-Developers-Guide">
@@ -70,5 +71,6 @@ url="http://www.fsf.org/licenses/gpl.txt">http://www.fsf.org/licenses/gpl.txt</u
 &encryption;
 &modules;
 &rpc-plugin;
+&packagers;
 
 </book>
diff --git a/docs/docbook/devdoc/packagers.sgml b/docs/docbook/devdoc/packagers.sgml
new file mode 100644 (file)
index 0000000..5042070
--- /dev/null
@@ -0,0 +1,40 @@
+<chapter id="Packaging">
+<chapterinfo>
+       <author>
+               <firstname>Jelmer</firstname><surname>Vernooij</surname>
+       </author>
+</chapterinfo>
+
+<title>Notes to packagers</title>
+
+<sect1>
+<title>Versioning</title>
+
+<para>Please, please update the version number in 
+<filename>source/include/version.h</filename> to include the versioning of your package. This makes it easier to distinguish standard samba builds
+from custom-build samba builds (distributions often patch packages). For 
+example, a good version would be: </para>
+
+<para><programlisting>
+
+</programlisting></para>
+
+</sect1>
+
+<sect1>
+<title>Modules</title>
+
+<para>Samba now has support for building parts of samba as plugins. This 
+makes it possible to, for example, put ldap or mysql support in a seperate 
+package, thus making it possible to have a normal samba package not 
+depending on ldap or mysql. To build as much parts of samba 
+as a plugin, run: </para>
+
+<para><programlisting>
+./configure --with-shared-modules=rpc,vfs,auth,pdb,charset
+</programlisting></para>
+
+</sect1>
+
+
+</chapter>