CHANGES(1) Buildtool Distribution Information CHANGES(1) NNAAMMEE CCHHAANNGGEESS - Major changes between Buildtool versions DDEESSCCRRIIPPTTIIOONN This document describes most of the major changes between each public version of Buildtool. If you want to see all changes in detail, you will need to look at cvs(1) logs. CCHHAANNGGEESS IINN 00..1166 Sixteenth _a_l_p_h_a version, released on _2_0_0_4_/_0_7_/_0_4. ++oo Added preliminar support for work directories, which are used to put all temporary files created during a build in them. This allows mak- ing the source tree read only, as it won't get polluted in any way. Note that existing packages may need some tweaks in their logic files to support this completely. To help with testing, you should set the _B_T___U_S_E___W_O_R_K_D_I_R variable in _b_t___c_o_n_f_i_g_._c_o_n_f to `yes', so that this fea- ture is always used. ++oo Added a standard customizable `DOC' feature, which can be used by the end user to disable installation of documentation. Existing packages may need to be fixed to honour this, though. ++oo bt_logic's core has been rewritten. It is now much faster than before and has better dependency control, which solves many stupid bugs. ++oo A framework to run uninstalled programs (those which may be linked to uninstalled libraries) has been readded. It is very similar to what libtool does with its _._l_i_b_s directory, and is completely transparent to the end user. ++oo Added (in fact, readded, as it was lost during the conversion to bt_logic) support to install packages in a fake root directory, needed in many package systems to support Buildtool-ized programs. ++oo Definitions' names (those written to the configuration header) have been changed to include the language name they refer to in them. This provides better support when the C and C++ compilers do not match. Note that for this to take effect you need to set _B_T___R_E_Q_U_I_R_E to (at least) `0.16'; otherwise, the previous behavior is kept. ++oo Multiple fixes have been done in the bbtt__cchheecckk__bbiittss() function. ++oo Fixed the link command in bt_logic so that library directories appearing under the same project hierarchy (and manually specified by the --LL flag) are not converted to an rpath. ++oo Fixed build under OpenBSD 3.4, HP-UX and Tru64. ++oo Added the bbtt__cchheecckk__pprroogg__mmaakkee() check in bt_config, which looks for a make utility. ++oo Added the bbtt__eecchhoo() and bbtt__ssoouurrccee() functions to bt_swcgen. ++oo The installation was changed to use unversioned directories and bina- ries. CCHHAANNGGEESS IINN 00..1155 Fifteenth _a_l_p_h_a version, released on _2_0_0_4_/_0_2_/_0_4. ++oo Finally dropped bt_make and bt_wrap, together with all compatibility code introduced around them. ++oo M4 is no longer needed. It was introduced to clean up code, but it has proven to only ofuscate it. As a side effect, bt_swcgen uses shell scripts instead of macro files to generate system wide configu- ration. ++oo Added some checks to bt_config: bbtt__cchheecckk__hhddrr__ttiimmee(), bbtt__cchheecckk__pprroogg__cccc__ffllaagg() and bbtt__cchheecckk__pprroogg__ccxxxx__ffllaagg(). ++oo Support for the `+=' operator (append text to a variable) was added to bt_sh. This can be used to simplify syntax when writting scripts. ++oo Support for pkgconfig files was added to bt_pkgflags. ++oo Support for pkgconfig command line syntax was added to bt_pkgflags (it is not exactly the same, but we now support operators in their real form, like `=' or `!=', plus spaces to separate keywords). ++oo Multiple portability problems fixed. CCHHAANNGGEESS IINN 00..1144 Fourteenth _a_l_p_h_a version, released on _2_0_0_3_/_0_9_/_0_5. ++oo Added the `qt_program' type to bt_logic as a replacement for the old _q_t_._m_o_c_._m_k makefile. ++oo Added logging functionality to bt_logic, to help debugging problems present in it and to tell the developer what is happening during a build. ++oo Added a standard customizable directory (named `doc') where a package may install documents. Package documents (those registered in the ddooccss() function) will get installed in this directory by default. ++oo Removed all uses of the getopt(1) command. This means that all mod- ules that still used it now support long options, aside from the standard short ones. ++oo Multiple bug fixes. CCHHAANNGGEESS IINN 00..1133 Thirteenth _a_l_p_h_a version, released on _2_0_0_3_/_0_8_/_3_1. ++oo All Buildtool control files (the ones in the _b_u_i_l_d_t_o_o_l_._d subdirec- tory) were unified into a single file, _G_e_n_e_r_i_c_._b_t, which is placed in the top level directory for simplicity. Everything is now controlled from shell functions defined in that file. Buildtool will assist you in this conversion when needed. ++oo The bt_sh module was added, a very fast and small shell interpreter. ++oo The bt_logic module was extended (really, rewritten from scratch) to provide a shell based program to track dependancies and build tar- gets. It still acts as a wrapper for compilation and linking com- mands. As a side effect, the old code was readded as the bt_wrap module, needed to keep bt_make working until both can be safely removed. ++oo bt_config will now check for several programs to generate dependancy files. Aside from the standard cpp(1), it also searches for fastdep, which will give better results on slow computers. ++oo Some bug fixes. CCHHAANNGGEESS IINN 00..1122 Twelfth _a_l_p_h_a version, released on _2_0_0_3_/_0_7_/_2_4. ++oo The bt_wizard module was added, which creates the basic structure needed for a project based on a serie of interactive questions. ++oo Added cache support for many checks in bt_config. This makes the program run a lot faster if checks are duplicated, and more impor- tant, lets the administrator define check results beforehand in the system wide _b_t___c_o_n_f_i_g_._c_o_n_f configuration file. ++oo The bt_swcgen module was added, which aids the system administrator in the creation of system-wide configuration files for bt_config (that is, files that store check results to avoid rechecking the same thing over and over again). ++oo The _b_u_i_l_d_t_o_o_l_._d_/_c_o_n_f_i_g___i_n_i_t file was deprecated. The entire configu- ration script is now read from a single file, _b_u_i_l_d_t_o_o_l_._d_/_c_o_n_f_i_g, as the old framework was confusing and error prone. Compatibility will be kept for some time. ++oo The TeXinfo documentation was removed. The manual is now distributed in its own `buildtool-doc' package, written using Docbook/XML. ++oo The _b_u_i_l_d_t_o_o_l_._s_p_e_c file was added, needed to create RPM packages. It actually supports building binary packages for RedHat Linux and SuSE Linux. ++oo Improved user experience: better usage messages and support for long options added. ++oo A developer mode was added to all configure scripts (disabled by default). It enables extra functionality during the build process, ideal for developers but which may annoy end users. ++oo Removed license description files. bt_dist will suggest a _C_O_P_Y_I_N_G file instead, as this is the most common practice suggested by licenses. ++oo New standard checks in the bt_config module, specially bbtt__cchheecckk__pprroogg__mm44() and bbtt__cchheecckk__aattttrriibbuuttee(). ++oo Code cleanup and simplification (using M4 in some places). CCHHAANNGGEESS IINN 00..1111 Eleventh _a_l_p_h_a version, released on _2_0_0_3_/_0_4_/_1_2. ++oo Lots of bugfixes. ++oo The bt_pkgflags module was added, which provides a replacement for the pkg-config utility (not compatible). ++oo The bbtt__mmssgg__ssuummmmaarryy() function was added to bt_config, which provides an homogeneous way to output diagnostic messages at the end of the configuration process. ++oo The bbtt__eerrrr() function in bt_config does not accept error codes any more as its first argument. ++oo The buildtool(1) manpage was rewrote, including a simple user refer- ence so people can easily learn how to build packages without having to dig into the big manual. CCHHAANNGGEESS IINN 00..1100 Tenth _a_l_p_h_a version, released on _2_0_0_3_/_0_2_/_0_5. ++oo The bt_logic module was added. It parses each call to the compiler and linker, sorts arguments, adapts them to the current platform and runs the resulting converted command. It also provides generation of dependancy files and installation of stuff. ++oo Initial support of shared libraries through bt_logic's framework. Buildtool can now build them on different platforms and use different naming schemes (needed for Darwin), set rpaths automatically, and more. Note that this is still very _e_x_p_e_r_i_m_e_n_t_a_l. ++oo New tunable features related with libraries are available for Build- tool-ized packages. They are called _S_H_A_R_E_D and _S_T_A_T_I_C, and tune which kind of libraries you want to build. ++oo Standalone bt_mkdep and bt_install modules were removed. All their functionality is now superseded by bt_logic. ++oo The _x_1_1_._s_u_b_r module was added to bt_config. It provides checks for automatic detection of the X Window System. ++oo The _p_k_g_c_o_n_f_i_g_._s_u_b_r module was added to bt_config. It provides a frontend to the pkg-config(1) program. The bbtt__cchheecckk__ppkkggffllaaggss() func- tion was deprecated in favour of this module. ++oo Added functions to automate the detection of a C/C++ compilation environment in bt_config. They are called bbtt__cchheecckk__eennvv__cc() and bbtt__cchheecckk__eennvv__ccxxxx(). CCHHAANNGGEESS IINN 00..99 Ninth _a_l_p_h_a version, released on _2_0_0_3_/_0_1_/_2_3. ++oo Distribution documents converted to mdoc. ++oo Improved the bbtt__ggeenneerraattee__oouuttppuutt() function in bt_config; it now gen- erates an external script, called bt_output, that can be used to recreate files at any time. ++oo Implemented Buildtool version checking (BT_REQUIRE can be used now). We cannot wait until 1.0 to have this feature. ++oo Miscellaneous bug fixes (in bt_config and bt_lint). ++oo Automatically generated configuration files have been prefixed with `bt_' to avoid conflicts with user files. For example, _c_o_n_f_i_g_._h is now named _b_t___c_o_n_f_i_g_._h by default. ++oo Support for shared libraries has now been disabled by default. It is still too incomplete. CCHHAANNGGEESS IINN 00..88 Eighth _a_l_p_h_a version, released on _2_0_0_2_/_1_2_/_1_5. ++oo Full rewrite of Buildtool's own build system, which should improve maintenance and portability. ++oo New module bt_install, which provides a portable install program to not depend on specific system details to do installation. ++oo New pthread.subr module for bt_config, which provides functions for automatic detection of a pthreads implementation in the current sys- tem. ++oo Added checks in bt_config: bt_check_func, to check for generic func- tions (not specific to any library), and bt_check_type, to check for the presence of a generic type. ++oo Fixes in bt_config's loadable module support. It was severely broken in the previous version. CCHHAANNGGEESS IINN 00..77 Seventh _a_l_p_h_a version, released on _2_0_0_2_/_1_1_/_3_0. ++oo New check bt_check_bits, which determines appropiate C types for dif- ferent sizes. ++oo New check bt_check_hdr_std, which searches standard headers. You must use this function, as it is now required for further checks (improves portability). ++oo Addition of the siteinfo target to the main program. It allows to get specific information about where Buildtool is installed by third party programs. ++oo Default name of Makefile's changed to Makefile.bt. This allows Automake and Buildtool to coexist in the same package and also avoids running a regular Make tool within a Buildtool-ized package (which will confuse the user). ++oo Build fixes under MacOS X (Darwin). ++oo Minor bug fixes to run cleanly under Win32, using Cygwin. ++oo Runtime fixes under GNU-based systems (the getopt command did not behave properly). CCHHAANNGGEESS IINN 00..66 Sixth _a_l_p_h_a version, released on _2_0_0_2_/_0_9_/_2_9. ++oo Many bug fixes in bt_make's infrastructure, specially when dealing with C++ code. ++oo Solve compilation problems in Solaris and OpenBSD. ++oo Reorganization of the manual; full rewrite of several chapters. ++oo Addition of qt.moc.mk, to manage QT Toolkit's moc files. CCHHAANNGGEESS IINN 00..55 Fifth _a_l_p_h_a version, released on _2_0_0_2_/_0_9_/_1_4. ++oo Addition of loadable modules (subroutines) in bt_config. ++oo Configuration scripts (like gtk-config) and pkg-config support. ++oo New module bt_dist, used to build packages. ++oo Inclusion of the new Buildtool's TestSuite, a sample package to check Buildtool's behavior in your system. ++oo Cleanup of bt_make's Makefiles. Should fix several bugs. ++oo Include files support through bt.inc.mk. CCHHAANNGGEESS IINN 00..44 Fourth _a_l_p_h_a version, released on _2_0_0_2_/_0_9_/_0_1. ++oo Addition of user configurable features and directories, during run- time configuration. ++oo System-wide configuration support. ++oo New module bt_lint, used to validate packages. ++oo Fixed installation target, so it works now. ++oo TeXinfo/Info support through bt.info.mk. ++oo Improved template files, to help the new developer. ++oo Initial style guidelines for packages. CCHHAANNGGEESS IINN 00..33 Third _a_l_p_h_a version, released on _2_0_0_2_/_0_8_/_3_0. ++oo Initial buildtool(1) manpage. ++oo Preliminary TeXinfo manual (installed as Info). ++oo Minor bug fixes. ++oo Added licenses: Apache, Artistic. CCHHAANNGGEESS IINN 00..22 Second _a_l_p_h_a version, released on _2_0_0_2_/_0_8_/_2_4. ++oo New module bt_doc, used to read package's building documents. ++oo Preliminary library support in bt_make through bt.lib.mk. ++oo Manpage support through bt.man.mk. ++oo Addition of buildtool.d/defs parsing; this file includes package variables defined by the maintainer. ++oo New buildtool wrapper, which selects proper version for current pack- age. ++oo Added licenses: BSD, GNU GPL v2. CCHHAANNGGEESS IINN 00..11 First _a_l_p_h_a version, released on _2_0_0_2_/_0_8_/_2_2. ++oo First public version. NetBSD 2.0 July 4, 2004 NetBSD 2.0