diff options
author | Andrew Bartlett <abartlet@samba.org> | 2020-06-03 15:51:48 +1200 |
---|---|---|
committer | Jeremy Allison <jra@samba.org> | 2020-06-12 22:11:43 +0000 |
commit | bfe4e84bb917e00c8b8d9e6db40527378e8bfb97 (patch) | |
tree | 8328731680bc98fa9c924922a09dee1c2c113ec1 | |
parent | 8a08dc0074de2e85058849e81524eb5e73dfe7e6 (diff) | |
download | samba-bfe4e84bb917e00c8b8d9e6db40527378e8bfb97.tar.gz |
docs: Remove the statement about why we moved to Waf
This is not important for new users or developers, and has little useful information
Signed-off-by: Andrew Bartlett <abartlet@samba.org>
Reviewed-by: Jeremy Allison <jra@samba.org>
-rw-r--r-- | BUILD_SYSTEMS.txt | 80 |
1 files changed, 0 insertions, 80 deletions
diff --git a/BUILD_SYSTEMS.txt b/BUILD_SYSTEMS.txt deleted file mode 100644 index f1d1ce393fb..00000000000 --- a/BUILD_SYSTEMS.txt +++ /dev/null @@ -1,80 +0,0 @@ -BUILDING SAMBA 4.0 -=================================== - -The waf build -------------- - -Samba 4.0 ships with a new build system, based on waf. A background to -this build system can be found at https://wiki.samba.org/index.php/Waf - -This is the build system that is used when you run ./configure && make -in the top level of a Samba 4.0 release tree. - -For the vast majority of our users, this is the build system you should -use. It supports parallel and incremental builds, and builds the whole -Samba suite, the file server, the print server, the NT4 domain -controller, winbind, the AD Domain Controller, the client libraries and -the python libraries. - -A key feature for many of our distributors and OEMs is that despite the -range of additional features, the resulting binaries and libraries are -substantially smaller, because we use shared libraries extensively. - -For distributions that have a requirement to use the system-supplied -Kerberos library, we support building against a Heimdal or system MIT -Kerberos library, provided the version is recent enough (otherwise we -will use our internal version of Heimdal). Please note that builds -with MIT krb5 support will not have AD DC features. - -Where we provide a tool under a name that was used in Samba 3.x, it -continues to behave in the same way it always has. This will ensure -that our change in build system does not impact on our user's ability -to use Samba as they always have. - -For developers, this build system backs a comprehensive 'make test', -which provides code coverage of around 48% of our code by line: -https://build.samba.org/lcov/data/coverage/samba_4_0_test/ - -This build system also implements important features such as ABI -checking (which protects you as users from accidental changes to our -published libraries), symbol versions and dependency checked incremental -rebuilds after header-file changes. - -The waf build also assists developers by providing fully-linked binaries -that run from bin/ without needing to set LD_LIBRARY_PATH. - -For users who do not have python installed on their systems, we provide -a install_with_python.sh script, which will install a local copy of -python sufficient to run the build system, without impacting on the rest -of the system. - -Within this requirement, we expect that this build will run on all our -supported platforms, and will actively deal with any portability issues -that users can bring to our attention. - -For all these reasons, we highly recommend this new build system to all -our users, for whatever purpose you want to put Samba to. - -The autoconf build ------------------- - -The autoconf build was removed in Samba 4.1. If you have tried and -failed to use our waf build system, you may wish to use the latest -supported 4.0 release instead, while we address your use case. - -Optional Libraries ------------------- - -To assist users and distributors to build Samba with the full feature -set, the build system will abort if our dependent libraries and their -header files are not found on the target system. This will mean for -example, that xattr, acl and ldap headers must be installed for the -default build to complete. The configure system will check for these -headers, and the error message will indicate the option (such as ---without-acl-support) that can be specified to skip this requirement. - -This will assist users and in particular distributors in building fully -functional packages, while allowing those on systems truly without these -facilities to continue to build Samba after careful consideration. - -This feature is not currently supported for xattr. |