DragonFly On-Line Manual Pages

Search: Section:  


BUILDTOOL(1)           DragonFly General Commands Manual          BUILDTOOL(1)

NAME

buildtool - build infrastructure for source packages

SYNOPSIS

buildtool [-h] target [target_args]

DESCRIPTION

This manual page is intended as a reference document only, addressed to users who want to build source packages. If you are interested in development (and a more detailed description of what is explained here), please read the Buildtool's Manual available online, together with more documentation, at the official documentation page: http://buildtool.sourceforge.net/docs.html Thank you for choosing buildtool. USER'S REFERENCE This section provides a quick reference on how to build source packages. After unpacking the source distribution file, enter the new directory and follow the instructions provided in the next sections. Reading documentation To get started, issue the following command, which will show several information useful to build that specific package: $ buildtool doc Configuring the sources For a standard, automated setup, type this command: $ buildtool config which configures the source package to build cleanly on the host system. However, this uses all default settings, which may be not suitable for your system. To change the installation prefix (which defaults to /usr/local), do: $ buildtool config --prefix=/opt Aside from the prefix, you can customize where things get installed on a directory basis and enable or disable specific features. The commands: $ buildtool config --help $ buildtool config --help 2>&1 | less show a list of all directories and features that can be tuned, together with their default values (use the later for a paged output). To change the value of a customizable directory, use the --dir flag, as in the following example: $ buildtool config --dir-bin=/usr/local/bin-test To change the value of a customizable feature, use one of the --feature, --enable or --disable flags, as in the following examples: $ buildtool config --feature-developer=yes $ buildtool config --enable-developer $ buildtool config --disable-developer Short options are available too. All examples shown above use long options because they are easier to remember. Building the sources Assuming the configuration step finished successfully, issue the following command to build the entire source tree: $ buildtool build You can run this command in a specific subdirectory to only build that part of the tree. Testing the build After a successful build of the sources, you might want to run some tests to check that the program behaves properly in your system. To run the test suite, simply do: $ buildtool test Note that these checks are specific to each package, and are only available if the developer took care to write them. Installing the results Issue the following command to install the binaries generated by the build step: $ buildtool install You can run this command in a specific subdirectory to only install that part of the tree. Cleanup If you want to keep the source tree around, you may want to clean all object files and work stuff to reduce the amount of space it uses. The commands: $ buildtool clean $ buildtool cleandir will clean all the tree, the later beeing more aggressive than the former. DragonFly 6.5-DEVELOPMENT May 8, 2004 DragonFly 6.5-DEVELOPMENT

Search: Section: