Non Product Build

From Apache OpenOffice Wiki
Jump to: navigation, search

A so-called Non-Product Build of Apache OpenOffice contains a lot of additional diagnostics and debug code, which is available in this special mode only. Such a build is usually larger and slower than an ordinary Product Build (which basically means: every build you ever downloaded from OpenOffice.org), but is very useful for developers.

By default a Product Build is created, i.e. it is ready for release after completion. Non-Product Builds are created using the --enable-dbgutil switch during configure, which makes creation a non-product build simple. The debug options window lets you control your level of annoyance. At least the assertions raised are interesting for developers.

The most visible feature of Non-Product Builds are so-called assertions - Basically message boxes popping up and saying that something went not the way the developer expected it to go. Such assertions are interesting for developers and are considered bugs. As such they should be reported in IssueZilla, with the summary starting with "ASSERT:" or "ERROR:" (since ERROR: is used by most of the assertion message boxes themself).

To use (or do QA for) the additional debug features: just run AOO, and when it's in full-flow, press <Alt>-<Shift>-<Control>-'D' in that order; this should popup a debugging options window:


Vcl debug options.png


The debugging options are subsequently saved to the .dbgsv.ini file for the next run (you can control the location of that with e.g. export DBGSV_INIT=$(HOME)/.dbgsv.init).

Try the help integrated into the debugging options window to see what features it offers.

For available tools in non-product builds, have a look at the various DBG_foo macros in tools/inc/tools/debug.hxx, or, if you already are knowledgeable about this, let others participate by writing your knowledge down here.

Personal tools