mirror of
https://github.com/open-source-parsers/jsoncpp.git
synced 2024-12-27 11:21:02 +08:00
f66d370741
- documentation is now correctly generated once when source are changed on the first scons run.
61 lines
3.1 KiB
Plaintext
61 lines
3.1 KiB
Plaintext
Import( 'env' )
|
|
import os.path
|
|
|
|
if 'doxygen' in env['TOOLS']:
|
|
doc_topdir = str(env['ROOTBUILD_DIR'])
|
|
html_dir = 'jsoncpp-api-doc'
|
|
|
|
doxygen_inputs = env.Glob( includes = '*.dox', dir = '#doc' ) \
|
|
+ env.Glob( includes = '*.h', dir = '#include/json/' ) \
|
|
+ env.Glob( includes = ('*.dox','*.h','*.inl','*.cpp'),
|
|
dir = '#src/lib_json' )
|
|
## for p in doxygen_inputs:
|
|
## print p.abspath
|
|
|
|
top_dir = env.Dir('#').abspath
|
|
include_top_dir = env.Dir('#include').abspath
|
|
env['DOXYFILE_DICT'] = { 'PROJECT_NAME': 'JsonCpp',
|
|
'PROJECT_NUMBER': env['JSONCPP_VERSION'],
|
|
'STRIP_FROM_PATH': top_dir,
|
|
'STRIP_FROM_INC_PATH': include_top_dir,
|
|
'HTML_OUTPUT': html_dir,
|
|
'HTML_HEADER': env.File('#doc/header.html').abspath,
|
|
'HTML_FOOTER': env.File('#doc/footer.html').abspath,
|
|
'INCLUDE_PATH': include_top_dir,
|
|
'PREDEFINED': 'JSONCPP_DOC_EXCLUDE_IMPLEMENTATION JSON_VALUE_USE_INTERNAL_MAP'
|
|
}
|
|
env['DOXYFILE_FILE'] = 'doxyfile.in'
|
|
doxfile_nodes = env.Doxyfile( os.path.join( doc_topdir, 'doxyfile' ), doxygen_inputs )
|
|
html_doc_path = os.path.join( doc_topdir, html_dir )
|
|
doc_nodes = env.Doxygen( source = doxfile_nodes,
|
|
target = os.path.join( html_doc_path, 'index.html' ) )
|
|
alias_doc_cmd = env.Alias('doc', doc_nodes )
|
|
env.Alias('doc', env.Install( html_doc_path, '#README.txt' ) )
|
|
targz_path = os.path.join( env['DIST_DIR'], '%s.tar.gz' % html_dir )
|
|
zip_doc_cmd = env.TarGz( targz_path, [env.Dir(html_doc_path)],
|
|
TARGZ_BASEDIR = env['ROOTBUILD_DIR'] )
|
|
env.Depends( zip_doc_cmd, alias_doc_cmd )
|
|
env.Alias( 'doc-dist', zip_doc_cmd )
|
|
##
|
|
## doxyfile = env.SubstInFile( '#doc/doxyfile', 'doxyfile.in',
|
|
## SUBST_DICT = {
|
|
## '%JSONCPP_VERSION%' : env['JSONCPP_VERSION'],
|
|
## '%TOPDIR%' : env.Dir('#').abspath,
|
|
## '%DOC_TOPDIR%' : str(doc_topdir) } )
|
|
## doc_cmd = env.Doxygen( doxyfile )
|
|
## alias_doc_cmd = env.Alias('doc', doc_cmd )
|
|
## env.AlwaysBuild(alias_doc_cmd)
|
|
##
|
|
## for dir in doc_cmd:
|
|
## env.Alias('doc', env.Install( '#' + dir.path, '#README.txt' ) )
|
|
## filename = os.path.split(dir.path)[1]
|
|
## targz_path = os.path.join( env['DIST_DIR'], '%s.tar.gz' % filename )
|
|
## zip_doc_cmd = env.TarGz( targz_path, [env.Dir(dir)],
|
|
## TARGZ_BASEDIR = doc_topdir )
|
|
## env.Depends( zip_doc_cmd, alias_doc_cmd )
|
|
## env.Alias( 'doc-dist', zip_doc_cmd )
|
|
##
|
|
## # When doxyfile gets updated, I get errors on the first pass.
|
|
## # I have to run scons twice. Something is wrong with the dependencies
|
|
## # here, but I avoid it by running "scons doc/doxyfile" first.
|