Replace entities with xi:include
[Samba.git] / docs / devel / packagers.xml
bloba55f4c6581c3e646049db1396f031e1d2cc8b5ca
1 <?xml version="1.0" encoding="iso-8859-1"?>
2 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3                 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
4   <!ENTITY % global_entities SYSTEM '../entities/global.entities'>
5   %global_entities;
6 ]>
7 <chapter id="Packaging">
8 <chapterinfo>
9         <author>
10                 <firstname>Jelmer</firstname><surname>Vernooij</surname>
11         </author>
12 </chapterinfo>
14 <title>Notes to packagers</title>
16 <sect1>
17 <title>Versioning</title>
19 <para>Please, please update the version number in 
20 <filename>source/include/version.h</filename> to include the versioning of your package. This makes it easier to distinguish standard samba builds
21 from custom-build samba builds (distributions often patch packages). For 
22 example, a good version would be: </para>
24 <para><programlisting>
25 Version 2.999+3.0.alpha21-5 for Debian
26 </programlisting></para>
28 </sect1>
30 <sect1>
31 <title>Modules</title>
33 <para>Samba now has support for building parts of samba as plugins. This 
34 makes it possible to, for example, put ldap or mysql support in a seperate 
35 package, thus making it possible to have a normal samba package not 
36 depending on ldap or mysql. To build as much parts of samba 
37 as a plugin, run: </para>
39 <para><programlisting>
40 ./configure --with-shared-modules=rpc,vfs,auth,pdb,charset
41 </programlisting></para>
43 </sect1>
46 </chapter>