tools: Add make_cppdocs.sh for Linux/MacOS (see issue #3385)

The make_distrib script will now generate Doxygen docs by default
if the doxygen command-line tool is installed. Run with `--no-docs`
(`--no-distrib-docs` with automate-git.py) to disable docs generation.
This commit is contained in:
Marshall Greenblatt
2022-09-02 11:22:42 -07:00
parent fa2464e843
commit 8645e88e0e
2 changed files with 47 additions and 18 deletions

View File

@ -856,6 +856,26 @@ if mode == 'standard':
# transfer Doxyfile
transfer_doxyfile(output_dir, options.quiet)
if not options.nodocs:
# generate doc files
sys.stdout.write("Generating docs...\n")
result = exec_cmd(
os.path.join('tools', 'make_cppdocs.%s' %
('bat' if platform == 'windows' else 'sh')), cef_dir)
if (len(result['err']) > 0):
sys.stdout.write(result['err'])
sys.stdout.write(result['out'])
src_dir = os.path.join(cef_dir, 'docs')
if path_exists(src_dir):
# create the docs output directory
docs_output_dir = create_output_dir(output_dir_base + '_docs',
options.outputdir)
# transfer contents
copy_dir(src_dir, docs_output_dir, options.quiet)
else:
sys.stdout.write("ERROR: No docs generated.\n")
if platform == 'windows':
libcef_dll = 'libcef.dll'
libcef_dll_lib = '%s.lib' % libcef_dll
@ -1016,24 +1036,6 @@ if platform == 'windows':
transfer_gypi_files(cef_dir, cef_paths2['ceftests_sources_resources_win'], \
'tests/ceftests/', ceftests_dir, options.quiet)
if not options.nodocs:
# generate doc files
sys.stdout.write("Generating docs...\n")
result = exec_cmd(os.path.join('tools', 'make_cppdocs.bat'), cef_dir)
if (len(result['err']) > 0):
sys.stdout.write(result['err'])
sys.stdout.write(result['out'])
src_dir = os.path.join(cef_dir, 'docs')
if path_exists(src_dir):
# create the docs output directory
docs_output_dir = create_output_dir(output_dir_base + '_docs',
options.outputdir)
# transfer contents
copy_dir(src_dir, docs_output_dir, options.quiet)
else:
sys.stdout.write("ERROR: No docs generated.\n")
elif platform == 'mac':
framework_name = 'Chromium Embedded Framework'
framework_dsym = '%s.dSYM' % framework_name