Difference between revisions of "Build Environment Effort/Status And Next Steps"

Revision as of 09:56, 14 February 2011

Integration of first milestone of the new build system in DEV300 m96

New features

With the integration of the CWS gnumake2 we got support for the following target types in our new build system:

• compiling and linking C, C++, Objective-C files into
  • shared libraries
  • non-GUI executables
• compiling src files into resources including localization
• copying a bunch of files ("package") into solver

For cxx compilation we also support some sub-targets:

• compilation of sdi files
• delivery of header files into solver
• processing of component files for UNO service libraries
• support for precompiled headers (currently used only with MSVC++)

Some features have been implemented differently. Here's a list of the most remarkable changes to the old build system:

• no intermediate libraries will be created anymore
• linking with MSVC++ does not use DEF files anymore; this requires proper dllimport/dllexport specifications in the code
• header dependencies on Unix platforms are created by the compiler, no additional makedepend step is required
• header dependencies in converted modules now always include those to headers in solver
• in converted modules a "build" command does not work (you will get a response telling what to do)
• when compiling with DEBUG=TRUE, PCH is not disabled automatically

Converted Modules

Along with the new features we converted the following modules to use the new build system:

• tools
• svl
• svtools
• xmloff
• framework
• toolkit
• sfx2
• sw

If you want to support us by converting other modules, please refer to Module Migration.

Ongoing and planned work can be found here.

Detected problems, caveats and known issues

• Compiling with ENABLE_PCH=TRUE and DEBUG=T with MSVC creates dlls that contain debug information only for the symbols of the library; all debug symbols for linked libraries are missing
  • root cause: PCH object needs to be linked into DLL to let mspdbserv find the necessary debug information
  • fix time line: cws gnumake3
  • workaround: call "unset ENABLE_PCH" when compiling with debug until the bug is fixed
• make tells you: *** Warning: .LOW_RESOLUTION_TIME file (...) has a high resolution time stamp
  • root cause: different tools and file systems use different time stamps; some of them just have a resolution of seconds, others even support micro or nano seconds; for checking dependencies the build system is told that it must not use the sub-second parts as it can't rely on all tools and file systems using the full time stamps. The only way to do that is telling make that there are no such parts in the time stamps. Unfortunately this triggers this warning.
  • fix time line: can only be fixed in GNU make, thus unclear
  • workaround: setting the environment variable gb_HIRESTIME=TRUE silences the warning (but enables checking of sub-second parts); in case this causes permanent re-delivery of files to solver because the tools have different resolutions (e.g. micro seconds vs. nano seconds), you can't use the workaround and have to live with the warning; this case was found in builds over nfs on Solaris Intel.
• adjustvisibility tool needs to be used in new build system on Solaris
  • root cause: not supported yet
  • fix time line: planned for cws gnumake4
  • workaround: not necessary
• fwe library needs to export all symbols on Linux
  • root cause: ancient sv_decl... macro prevents proper usage of DLLEXPORT declarations
  • fix time line: planned for cws gnumake4
  • workaround: not necessary
• GNU make crashes at times on cygwin
  • more info: it doesn't crash always, and the more often the more parallel threads are used; at least Ubuntu seems to have a patched GNU make 3.81 without the bug
  • root cause: there is a bug in GNU make 3.81
  • workaround: none available except manual restarting the build until it finishes
  • fix time line: GNU make 3.82 fixed the bug, but it has a performance regression and is not recommended; we will soon provide a patched GNU make for cygwin and ask the cygwin maintainers to patch their own version too