The Free and Open Productivity Suite
Released: Apache OpenOffice 4.1.15

Build tool

The build tool is a tool written in Perl. It reads the file <build.lst> in the prj directory of the cvs module, builds a dependencies chain and according to the chain goes through the directories of the module calling dmake in each of them. It can also generate a shell script (-file option), which can be started afterwards. All directories to build and their dependencies are listed in the file <build.lst>. The build.lst has the following format:

  1. two character prefix of the project (obsolete)

  2. directory name (described in Windows\MSDOS pathname convention; using a backslash '\' between each subdirectory)

  3. The action to be done. Usually the name of the make-tool, for historical reason still called nmake. There is also a get-action which indicates, that this directory contains source files but no makefiles. If the third entry is a ":" the next entry is a list of dependent modules. This list has to be terminated with an 'NULL' string.

  4. Special Entry. I have no idea what this is for. In all cases '-'.

  5. platform: Used if this directory is only relevant for platform 'x'. 'x' is a placeholder for "all, w, p, m u". all stands for all platforms, w for windows, p for OS/2 (Presentation Manager), u for Unix platforms.

  6. Name for directory: Unique name for this directory.

  7. List of dependency for this directory. List has to be terminated with 'NULL'. The list contains list or directory names. No circular dependencies are allowed.

Example for an build.lst:

r rsc : tools NULL
r rsc\source\misc nmake - all rsc_misc NULL
r rsc\source\tools nmake - all rsc_tool NULL
r rsc\source\res nmake - all rsc_res NULL
r rsc\source\parser nmake - all rsc_pars NULL
r rsc\source\rsc nmake - all rsc_rsc NULL
r rsc\source\prj nmake - all rsc_sprj rsc_misc rsc_tool rsc_res rsc_pars rsc_rsc NULL
r rsc\inc get - all rsc_inc NULL
r rsc\util nmake - all rsc_util rsc_sprj NULL

The build accepts following switches:

All unknown switches are passed to dmake tool.

In general, build is used via alias which is created by configure.

alias build="perl $SOLARENV/bin/" 

Apache Software Foundation

Copyright & License | Privacy | Contact Us | Donate | Thanks

Apache, OpenOffice, and the seagull logo are registered trademarks of The Apache Software Foundation. The Apache feather logo is a trademark of The Apache Software Foundation. Other names appearing on the site may be trademarks of their respective owners.