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,

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.

Generated on Wed May 12 21:41:53 2010 for NOX by  doxygen 1.4.7