ccbuild - A strict developer's build utility - The tools directory

[ previous ] [ Contents ] [ 1 ] [ 2 ] [ 3 ] [ 4 ] [ 5 ] [ 6 ] [ A ] [ B ] [ next ]

# `ccbuild` - A strict developer's build utility
Appendix A - The tools directory

The `tools` directory contains a few scripts and default files that may come in handy. These are not meant to be used a lot and are mostly there as examples of using `ccbuild` in combination with other programs. These utilities are often crude and come with NO WARRANTY WHATSOEVER.

Bottom line: read them before you use them and enjoy.

## A.1 genPkgconfigList.sh

This script will generate a list of includes that might be part of the given package. The scripts needs to get a valid package name as it's first argument. It will then call pkg-config to get a list of include paths used for the package. All these paths are searched and all files found are linked to the package using pkg-config in a way that is compatible with ccResolutions syntax.

This list will be very large, and it's not, generally, a good idea to add this list to your local ccResolutions file. A better way of using this is by adding the file to your ccResolutions.d directory under the name of the package.

Using this is of course a brute way of handling resolutions, because it's much nicer to only resolve the ones you need.

## A.2 ccbuildStatusPage.sh

This is a small `ccbuild` status page creation script. All command line arguments you give it will be passed to `ccbuild` directly. It runs "ccbuild check" to check which files are up to date and which are not. Then using AWK it translates this into a small auto-refreshing web page. The web page uses ccbuild.css as it's style sheet.

General usage for a single run is:

             sh ccbuildStatusPage.sh -C "someproject/src"

Then use your favourite browser to open the generated html file: ccbuildstatus.html.

You can easily loop it in the background using:

             while [[ 1 ]];
               do sleep 5;
               nice sh ccbuildStatusPage.sh -C "someproject/src";
             done;

By default the up to date files are not shown by using "display: none" in the ccbuild.css. Remove this line from ccbuild.css to show all up to date files as well.

[ previous ] [ Contents ] [ 1 ] [ 2 ] [ 3 ] [ 4 ] [ 5 ] [ 6 ] [ A ] [ B ] [ next ]

`ccbuild` - A strict developer's build utility