Updating projdoc from HEAD brach.
[kai/samba.git] / docs / docbook / projdoc / samba-doc.sgml
1 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
2 <!ENTITY UNIX-INSTALL SYSTEM "UNIX_INSTALL.sgml">
3 <!ENTITY MS-Dfs-Setup SYSTEM "msdfs_setup.sgml">
4 <!ENTITY PRINTER-DRIVER2 SYSTEM "printer_driver2.sgml">
5 <!ENTITY DOMAIN-MEMBER SYSTEM "DOMAIN_MEMBER.sgml">
6 <!ENTITY WINBIND SYSTEM "winbind.sgml">
7 <!ENTITY NT-Security SYSTEM "NT_Security.sgml">
8 <!ENTITY ServerType SYSTEM "ServerType.sgml">
9 <!ENTITY Samba-PDC-HOWTO SYSTEM "Samba-PDC-HOWTO.sgml">
10 <!ENTITY Samba-BDC-HOWTO SYSTEM "Samba-BDC-HOWTO.sgml">
11 <!ENTITY IntegratingWithWindows SYSTEM "Integrating-with-Windows.sgml">
12 <!ENTITY Samba-PAM SYSTEM "PAM-Authentication-And-Samba.sgml">
13 <!ENTITY Diagnosis SYSTEM "Diagnosis.sgml">
14 <!ENTITY BUGS SYSTEM "Bugs.sgml">
15 <!ENTITY SECURITY-LEVEL SYSTEM "security_level.sgml">
16 <!ENTITY SPEED SYSTEM "Speed.sgml">
17 <!ENTITY BROWSING SYSTEM "Browsing.sgml">
18 <!ENTITY BROWSING-Quick SYSTEM "Browsing-Quickguide.sgml">
19 <!ENTITY GROUP-MAPPING-HOWTO SYSTEM "GROUP-MAPPING-HOWTO.sgml">
20 <!ENTITY Portability SYSTEM "Portability.sgml">
21 <!ENTITY Other-Clients SYSTEM "Other-Clients.sgml">
22 <!ENTITY ADS-HOWTO SYSTEM "ADS-HOWTO.sgml">
23 <!ENTITY Passdb SYSTEM "passdb.sgml">
24 <!ENTITY VFS SYSTEM "VFS.sgml">
25 <!ENTITY GroupProfiles SYSTEM "GroupProfiles.sgml">
26 <!ENTITY SecuringSamba SYSTEM "securing-samba.sgml">
27 <!ENTITY Compiling SYSTEM "Compiling.sgml">
28 <!ENTITY unicode SYSTEM "unicode.sgml">
29 <!ENTITY CUPS SYSTEM "CUPS-printing.sgml">
30 ]>
31
32 <book id="Samba-HOWTO-Collection">
33
34 <title>SAMBA Project Documentation</title>
35
36 <bookinfo>
37         <author>
38                 <surname>SAMBA Team</surname>
39         </author>
40         <address><email>samba@samba.org</email></address>
41 </bookinfo>
42
43 <dedication>
44 <title>Abstract</title>
45
46 <para>
47 <emphasis>Last Update</emphasis> : Wed Jan 15
48 </para>
49
50 <para>
51 This book is a collection of HOWTOs added to Samba documentation over the years.
52 I try to ensure that all are current, but sometimes the is a larger job
53 than one person can maintain.  The most recent version of this document
54 can be found at <ulink url="http://www.samba.org/">http://www.samba.org/</ulink>
55 on the "Documentation" page.  Please send updates to <ulink 
56 url="mailto:jerry@samba.org">jerry@samba.org</ulink> or 
57 <ulink url="mailto:jelmer@samba.org">jelmer@samba.org</ulink>.
58 </para>
59
60 <para>
61 This documentation is distributed under the GNU General Public License (GPL) 
62 version 2.  A copy of the license is included with the Samba source
63 distribution.  A copy can be found on-line at <ulink 
64 url="http://www.fsf.org/licenses/gpl.txt">http://www.fsf.org/licenses/gpl.txt</ulink>
65 </para>
66
67 <para>
68 Cheers, jerry
69 </para>
70
71 </dedication>
72
73 <!-- Chapters -->
74 <part id="introduction">
75 <title>General installation</title>
76 <partintro>
77 <title>Introduction</title>
78 <para>This part contains general info on how to install samba 
79 and how to configure the parts of samba you will most likely need.
80 PLEASE read this.</para>
81 </partintro>
82 &UNIX-INSTALL;
83 &BROWSING-Quick;
84 &Passdb;
85 </part>
86
87 <part id="type">
88 <title>Type of installation</title>
89 <partintro>
90 <title>Introduction</title>
91 <para>
92 Samba can operate in various SMB networks. This part contains information on configuring samba 
93 for various environments.
94 </para>
95 </partintro>
96 &ServerType;
97 &SECURITY-LEVEL;
98 &Samba-PDC-HOWTO;
99 &Samba-BDC-HOWTO;
100 &ADS-HOWTO;
101 &DOMAIN-MEMBER;
102 </part>
103
104 <part id="optional">
105 <title>Optional configuration</title>
106 <partintro>
107 <title>Introduction</title>
108 <para>Samba has several features that you might want or might not want to use. The chapters in this 
109 part each cover one specific feature.</para>
110 </partintro>
111 &IntegratingWithWindows;
112 &NT-Security;
113 &Samba-PAM;
114 &MS-Dfs-Setup;
115 &PRINTER-DRIVER2;
116 &CUPS;
117 &WINBIND;
118 &BROWSING;
119 &VFS;
120 &GROUP-MAPPING-HOWTO;
121 &SPEED;
122 &GroupProfiles;
123 &SecuringSamba;
124 &unicode;
125 </part>
126
127 <part id="Appendixes">
128 <title>Appendixes</title>
129 &Portability;
130 &Other-Clients;
131 &Compiling;
132 &BUGS;
133 &Diagnosis;
134 </part>
135
136 </book>