Skip to content

Scons fails to configure with sphinx_docs option enabled #1871

@band-a-prend

Description

@band-a-prend

Problem description

When using scons sphinx_docs options while building Cantera the scons configuration error arise:

scons: Reading SConscript files ...
SCons 4.9.1 is using the following Python interpreter:
    /usr/bin/python3.12 (Python 3.12)
INFO: Building Cantera from git commit '3f2057c6b'
NameError: name 'windows_options_full' is not defined:
  File "/home/sorath/Downloads/packages/cantera_test/cantera_docs/cantera/SConstruct", line 986:
    config_full.add(windows_options_full)

Steps to reproduce

  1. Clone Cantera's github repo git clone https://github.com/Cantera/cantera.git
  2. Change directory to ./cantera/
  3. Try to run build process, e.g. with command scons -j4 build debug="no" f90_interface=y python_package=y python_cmd=python3.13 system_blas_lapack=n optimize_flags="-Wno-inline" renamed_shared_libraries="no" use_pch="no" system_fmt="y" system_sundials="y" system_eigen="y" system_yamlcpp="y" env_vars="all" extra_inc_dirs="/usr/include/eigen3" prefix="/usr" doxygen_doc=yes sphinx_docs=y.
    Please notice that sphinx_docs=y option is used at the end of command (or sphinx_docs=True if prefer).

Behavior

The error appears:
scons: Reading SConscript files ...
SCons 4.9.1 is using the following Python interpreter:
    /usr/bin/python3.12 (Python 3.12)
INFO: Building Cantera from git commit '3f2057c6b'
NameError: name 'windows_options_full' is not defined:
  File "/home/sorath/Downloads/packages/cantera_test/cantera_docs/cantera/SConstruct", line 986:
    config_full.add(windows_options_full)

System information

  • Cantera version: 3.1.0 or 3f2057c
  • OS: Gentoo Linux x86_64
  • Python/MATLAB/other software versions: Python 3.12, Scons 4.9.1

Attachments

Additional context

It seems the broken changes were introduced in commit 97c2b6c and now windows_options_full and config_options_full aren't defined because sphinx wasn't in COMMAND_LINE_TARGETS (i.e. scons sphinx command wasn't called).

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions