Homec4science
Diffusion tamaas (ci-fix-static-checks) Browse

tamaas/doc/SConscript
57a0b603d12eci-fix-static-checks

Last Change
Raw File

SConscript
View Options

# -*- mode:python; coding: utf-8 -*-
# vim: set ft=python:
# @file
# @section LICENSE
#
# Copyright (©) 2016-2021 EPFL (École Polytechnique Fédérale de Lausanne),
# Laboratory (LSMS - Laboratoire de Simulation en Mécanique des Solides)
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU Affero General Public License as published
# by the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU Affero General Public License for more details.
#
# You should have received a copy of the GNU Affero General Public License
# along with this program. If not, see <https://www.gnu.org/licenses/>.
from __future__ import print_function
from SCons.Script import Import, Glob, Dir, File
def add_sources(source_list, dirname, fnames):
source_list += Dir(dirname).glob('*.hh')
source_list += Dir(dirname).glob('*.cpp')
Import('main_env')
Import('libTamaas')
doc_env = main_env.Clone()
# Generating Doxyfile
doxyfile_target = doc_env.Substfile('doxygen/Doxyfile', 'doxygen/Doxyfile.in',
SUBST_DICT={
'@version@': '$version',
'@build_dir@': Dir('doxygen').path,
'@logo@': File('icon.svg').path,
'@src_dir@': Dir('#src').abspath,
})
# Generate Doxygen API documentation
doc_env.Tool('doxygen')
doxygen_target = doc_env.Doxygen('doxygen/xml/index.xml',
[doxyfile_target, 'icon.svg'])
# Adding all source files as dependencies
sources = []
Dir('#src').walk(add_sources, sources)
doc_env.Depends(doxygen_target, sources)
# Generate Sphinx User documentation
doc_env.Tool('sphinx')
sphinx_sources = [Glob('sphinx/source/*'), Glob('sphinx/source/figures/*')]
sphinx_targets = []
sphinx_targets.append(doc_env.Sphinx('sphinx/html/index.html', sphinx_sources))
sphinx_targets.append(doc_env.Sphinx('sphinx/tamaas.1', sphinx_sources))
doc_env.Depends(sphinx_targets, doxygen_target)
# Alias for both docs
doc_targets = [doxygen_target] + sphinx_targets
main_env.Alias('build-doc', doc_targets)
# Install target for documentation
share = Dir('share', doc_env['prefix'])
doc_prefix = share.Dir('doc').Dir('tamaas')
man_prefix = share.Dir('man').Dir('man1')
doc_install = []
doc_install.append(doc_env.Install(target=doc_prefix,
source=sphinx_targets[0][0].dir))
doc_install.append(doc_env.Install(target=man_prefix,
source=sphinx_targets[1]))
main_env.Alias('install-doc', doc_install)
c4science · Help