NOX Developer's Guide to Prerelease Code

We define prerelease code to be code that should not be distributed, documented, or tested as part of the automatic nightly scripts.

Prerelease code will only be used if configure is executed with the --enable-prerelease option. In that case,

• all prerelease code will be compiled (-DWITH_PRERELEASE is added to CPPFLAGS),
• doxygen will document prerelease code (WITH_PRERELEASE is added to the PREDEFINED variable in Doxyfile),
• BUILD_PRERELEASE is true for automake/autoconf Makefile generation.

There are two steps to adding prerelease code.

1. Add ifdef's to the source and header files.

   In other words, the code should be surrounded by a WITH_PRERELEASE ifdef as follows.

   #ifdef WITH_PRERELEASE
   // Insert All Code Here
   #endif
   

2. Modify Makefile.am.

   For example, the following modifications were made to nox/src/Makefile.am to add NOX_Direction_QuasiNewton as prerelease code in the libnox.a library.

   if BUILD_PRERELEASE
   
   nodist_pkginclude_HEADERS = \
   	$(srcdir)/NOX_Direction_QuasiNewton.H 
   
   nodist_libnox_a_SOURCES = \
   	$(srcdir)/NOX_Direction_QuasiNewton.C
   
   endif
   

Remember to run configure with the --enable-prerelease option!!

Note:

Prerelease code must still be able to compile.