summaryrefslogtreecommitdiff
path: root/source4
diff options
context:
space:
mode:
Diffstat (limited to 'source4')
-rw-r--r--source4/build/smb_build/README.txt33
1 files changed, 18 insertions, 15 deletions
diff --git a/source4/build/smb_build/README.txt b/source4/build/smb_build/README.txt
index 85d61f6bc2..0e127882d6 100644
--- a/source4/build/smb_build/README.txt
+++ b/source4/build/smb_build/README.txt
@@ -2,6 +2,11 @@ The Samba Build System
----------------------
----------------------
+The build system basically has two main parts: the autoconf-generated
+shell scripts which check for availability of functions and libraries
+which is stored in the .m4 files and the information about the various
+subsystems which is stored in the .mk files.
+
Object Types
------------
the build system knows about the following object types
@@ -36,11 +41,16 @@ LIBRARY:
a LIBRARY typicly has only glue code in it and depends on
SUBSYSTEM's (required_subsystems/REQUIRED_SUBSYSTEMS).
-
-Macrodescriptions
-----------------
-On top of build/smb_build/public.m4 is a list of all public macros of the build system.
-
+File summary:
+-------------
+public.m4 - public M4 macros of the build system
+config_mk.pm - Support for reading .mk files
+dot.pm - Support for generating .dot files for analysis of dependencies
+input.pm - Input validation
+main.pm - Main
+makefile.pm - Makefile generation
+output.pm - Dependency calculation
+smb_build_h.pm - smb_build.h generation
Layout
-------
@@ -54,16 +64,16 @@ Toplevel file: configure.in
(mostly compiler and basic C type and function
checks)
-- subsystem specific stuff should be included by 'SMB_INLUDE_M4()'
+- subsystem specific stuff should be included by 'SMB_INCLUDE_M4()'
-Generating of 'configure'
+Generating the configure file
-------------------------
you need to rerun ./autogen.sh when 'configure.in' or any
'.m4' file was modified, then you need to rerun configure.
-Generating of 'config.status'
+Generating config.status
-----------------------------
you need to run ./config.status (or 'configure') after a '.mk'
file was changed.
@@ -73,10 +83,3 @@ Examples
--------
for now please take a look at the .m4 and .mk files
you find in the source tree, they should be a good reference to start.
-
-
-README-TODO
-------------
-SMB_XYZ() vs. SMB_XYZ_MK()
-meaning of the macros parameters and the .mk file handling
-examples