Skip to content

"scons install" doesn't install doxygen documentation subdirectories recursively #553

@band-a-prend

Description

@band-a-prend

Cantera version

2.4.0

Operating System

Linux

Python/MATLAB version

none

Expected Behavior

Successful install doxygen documentation subdirectories

Actual Behavior

Absence of doxygen documentation subdirectories i "../cantera/doc/doxygen/html/" folder

Steps to reproduce

  1. Set scons "doxygen_docs" configuration option to "y"
  2. Build Cantera (scons build)and notify that doxygen documentation subdirectories are presented in appropriate build subfolder
  3. Run "scons install" and check the "../cantera/doc/doxygen/html/" folder under installation path. Notice that it contains only some of files laying in one level without subdirectories.

I'm try to modify my installation script of Cantera for Gentoo Linux for upcoming Cantera version 2.4.0 that is available as tarball under release link of project
and encounter that now doxygen documentation uses "CREATE_SUBDIRS = YES" rule
that was implemented in commit b84d3e3

The problem is that generated "cantera/doc/doxygen/html/" subdirectories aren't installed for me by scons install command. So navigation through the doxygen documentation isn't possible due to absence of many files.

If I revert mentioned commit by patching than documentation navigation is OK due to all files lay in one level.

I'm not sure but could it be due to the "doc/Sconscript" rule for install wasn't changed to recursively install directories?

94 if localenv['doxygen_docs']:
...

102 env.Alias('doxygen', docs)
103 install('$inst_docdir/doxygen/html',
104 mglob(localenv, '#/build/docs/doxygen/html', 'html', 'svg', 'css', 'png'))

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions