Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

[skip-ci][WIP][CI][Doc] Generate Doxygen docs with CMake + GitHub Actions #15314

Draft
wants to merge 54 commits into
base: master
Choose a base branch
from
Draft

[skip-ci][WIP][CI][Doc] Generate Doxygen docs with CMake + GitHub Actions #15314

wants to merge 54 commits into from

Commits on May 16, 2024

  1. [docu] Add new ROOT build option: docu 

    This allows to build the documentation as part of the normal build
and sets the basis for integrating it into the GitHub CI. And to
test new PullRequests so that they do not break the existing
documentation or do not add new warnings to it.

You can still build the documentation as an external project, like
is done now.
    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    beeaeee View commit details
    Browse the repository at this point in the history

  2. [cmake] If not calling thisroot.sh, prevent not finding libs

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    9f7a073 View commit details
    Browse the repository at this point in the history

  3. fix bug: multiple COMMAND must share WORKING_DIRECTORY

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    7275ce4 View commit details
    Browse the repository at this point in the history

  4. split targets for better structure 

    fix also several bugs with paths and typos
    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    4cbdad4 View commit details
    Browse the repository at this point in the history

  5. exit 0 so that there is no error if DOCU_INPUT contains no notebooks

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    c78d067 View commit details
    Browse the repository at this point in the history

  6. Updates from makeinput

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    38384df View commit details
    Browse the repository at this point in the history

  7. Fix cat 'input file is output file' error

    @jolly-chen @ferdymercury
    jolly-chen authored and ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    ba4c4e1 View commit details
    Browse the repository at this point in the history

  8. Fix converttonotebook.py not found

    @jolly-chen @ferdymercury
    jolly-chen authored and ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    0c7b082 View commit details
    Browse the repository at this point in the history

  9. try to fix library not found path when running macro

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    5d34598 View commit details
    Browse the repository at this point in the history

  10. fix cascaded path not found

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    d940426 View commit details
    Browse the repository at this point in the history

  11. fix python variable name

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    a830f64 View commit details
    Browse the repository at this point in the history

  12. give more sensful error message

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    e372bbf View commit details
    Browse the repository at this point in the history

  13. add pyzdoc

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    c819ce2 View commit details
    Browse the repository at this point in the history

  14. minor fixes

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    57e4b00 View commit details
    Browse the repository at this point in the history

  15. Fix preparation target dependencies

    @jolly-chen @ferdymercury
    jolly-chen authored and ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    1046422 View commit details
    Browse the repository at this point in the history

  16. cleanup CMakeLists.txt 

    dislodge PreparationPyz
    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    d172103 View commit details
    Browse the repository at this point in the history

  17. Update CMakeLists.txt

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    fb582d9 View commit details
    Browse the repository at this point in the history

  18. properly get git-version when builtin_docu=ON

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    11b3e0b View commit details
    Browse the repository at this point in the history

  19. Fix empty ROOT_CXX_COMPILER

    @jolly-chen @ferdymercury
    jolly-chen authored and ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    3441999 View commit details
    Browse the repository at this point in the history

  20. fix cxx compiler 

    it should be the cxx compiler used for compiling root, not the ROOT executable command
    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    68d3951 View commit details
    Browse the repository at this point in the history

  21. fix missing ROOTcmd when builtin

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    795178f View commit details
    Browse the repository at this point in the history

  22. allow default doxygen, no need to specify

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    fb51735 View commit details
    Browse the repository at this point in the history

  23. default docu output location is now home/rootdoc

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    8ff5dcf View commit details
    Browse the repository at this point in the history

  24. correct way of getting HOME in cmake

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    a2813ef View commit details
    Browse the repository at this point in the history

  25. modernize headers, prevent int comparison warning

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    f57ef1d View commit details
    Browse the repository at this point in the history

  26. do not unset doxygen cache and use cmake cxx standard variable

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    272fd46 View commit details
    Browse the repository at this point in the history

  27. allow caching options

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    fb2f0b1 View commit details
    Browse the repository at this point in the history

  28. fix standard

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    7f417fe View commit details
    Browse the repository at this point in the history

  29. fix html image path 

    otherwise need to add ../images/ to 4-5 places in the filter.cxx because
DOXYGEN_IMAGE_PATH is not well recognized
    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    c605c66 View commit details
    Browse the repository at this point in the history

  30. should remove worklist from previous run!! 

    otherwise you might end up with 26GB large worklist
    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    a0192ad View commit details
    Browse the repository at this point in the history

  31. fix paths

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    0b25ac1 View commit details
    Browse the repository at this point in the history

  32. fix paths

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    f77e5cb View commit details
    Browse the repository at this point in the history

  33. fix rm moment

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    6626430 View commit details
    Browse the repository at this point in the history

  34. copy missing script

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    31dc377 View commit details
    Browse the repository at this point in the history

  35. additional clean

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    b17e42f View commit details
    Browse the repository at this point in the history

  36. avoid pollute source tree

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    3a58875 View commit details
    Browse the repository at this point in the history

  37. fix typo

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    9421b60 View commit details
    Browse the repository at this point in the history

  38. fix notebook conversion

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    4b92fbb View commit details
    Browse the repository at this point in the history

  39. fix pythonpath

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    993f369 View commit details
    Browse the repository at this point in the history

  40. fix infinite loop - tee command

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    36988e5 View commit details
    Browse the repository at this point in the history

  41. fix typo

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    eed2f37 View commit details
    Browse the repository at this point in the history

  42. Update .gitignore

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    d826990 View commit details
    Browse the repository at this point in the history

  43. rm from previous run if incremental build

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    b3e97c2 View commit details
    Browse the repository at this point in the history

  44. fix python3 path

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    a9ba8e7 View commit details
    Browse the repository at this point in the history

  45. [ci] Add documentation option to build_root.py

    @jolly-chen @ferdymercury
    jolly-chen authored and ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    ef09aee View commit details
    Browse the repository at this point in the history

  46. [ci] Add doxygen generation workflow 

    Fix --docu_input arg passing
    @jolly-chen @ferdymercury
    jolly-chen authored and ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    332b176 View commit details
    Browse the repository at this point in the history

  47. Create archive before uploading artifact

    @jolly-chen @ferdymercury
    jolly-chen authored and ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    867cfcb View commit details
    Browse the repository at this point in the history

  48. try run on mac runner 

    mac12 not found, try with mac13
    @jolly-chen @ferdymercury
    jolly-chen authored and ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    6567c4d View commit details
    Browse the repository at this point in the history

  49. try with dmg doxygen

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    e34e578 View commit details
    Browse the repository at this point in the history

  50. switch to mac12 that is x64 

    so that dmg works

hard-code mac12 options, somehow they are not well picked up

fix path to doxygen on mac dmg

temporary workaround for missing graphviz on mac12 CI
    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    dd65efb View commit details
    Browse the repository at this point in the history

  51. add timer

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    6c5230e View commit details
    Browse the repository at this point in the history

  52. build all docu

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    89c3a16 View commit details
    Browse the repository at this point in the history

  53. temporarily disable tutorials

    @ferdymercury
    ferdymercury committed May 16, 2024
    Configuration menu
    Copy the full SHA
    0029b3a View commit details
    Browse the repository at this point in the history

Commits on Jun 25, 2024

  1. do not depend on hsimple but rather on onepcm 

    in advance of root-project#15930
    @ferdymercury
    ferdymercury authored Jun 25, 2024
    Configuration menu
    Copy the full SHA
    2ce2bc8 View commit details
    Browse the repository at this point in the history