Skip to content

Various documentation improvements#1152

Merged
ischoegl merged 8 commits intoCantera:mainfrom
speth:doc-fixups
Dec 5, 2021
Merged

Various documentation improvements#1152
ischoegl merged 8 commits intoCantera:mainfrom
speth:doc-fixups

Conversation

@speth
Copy link
Copy Markdown
Member

@speth speth commented Dec 4, 2021

Changes proposed in this pull request

  • Correct documentation of newThermoPhase regarding exceptions and return types
  • Deprecate unused silane.yaml input file
  • Fix incorrect / unbalanced Doxygen group delimiters
  • Fix Doxygen warnings about @TODO command (only @todo is recognized)
  • Fix miscellaneous Doxygen warnings
  • Remove configuration settings for deprecated Doxygen options
  • Make reactor network docs more discoverable and easier to navigate

Checklist

  • The pull request includes a clear description of this code change
  • Commit messages have short titles and reference relevant issues
  • Build passes (scons build & scons test) and unit tests address code coverage
  • Style & formatting of contributed code follows contributing guidelines
  • The pull request is ready for review

speth added 8 commits December 4, 2021 15:35
This file is of unknown provenance, contains discontinuous thermo
data, and is no longer used in any examples or tests.
The group delimeters "@{" and "@}" are only evaluated inside a Doxygen
comment, e.g. on a line starting with '//!'.
Doxygen only recognizes lowercase '@todo'.

This commit also changes instances of @todo that aren't actually read
by Doxygen, such as ones in Python files or ones inside C++ methods to
standardize use of the lowercase version in the places where it does
matter.
Add Doxygen docstrings for all classes reactor-related classes,
including factories.

Create a "module" entry within the Doxygen docs, with a link to the
"Science" docs on the Cantera website.
@codecov
Copy link
Copy Markdown

codecov bot commented Dec 4, 2021

Codecov Report

Merging #1152 (4fa54e7) into main (6a6034f) will not change coverage.
The diff coverage is 100.00%.

Impacted file tree graph

@@           Coverage Diff           @@
##             main    #1152   +/-   ##
=======================================
  Coverage   73.76%   73.76%           
=======================================
  Files         370      370           
  Lines       48983    48983           
=======================================
  Hits        36133    36133           
  Misses      12850    12850           
Impacted Files Coverage Δ
include/cantera/base/Units.h 100.00% <ø> (ø)
include/cantera/base/global.h 93.33% <ø> (ø)
include/cantera/base/utilities.h 100.00% <ø> (ø)
include/cantera/base/xml.h 100.00% <ø> (ø)
include/cantera/equil/MultiPhase.h 100.00% <ø> (ø)
include/cantera/kinetics/Arrhenius.h 95.58% <ø> (ø)
include/cantera/kinetics/FalloffFactory.h 100.00% <ø> (ø)
include/cantera/kinetics/GasKinetics.h 100.00% <ø> (ø)
include/cantera/kinetics/Kinetics.h 55.26% <ø> (ø)
include/cantera/kinetics/Reaction.h 100.00% <ø> (ø)
... and 61 more

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 6a6034f...4fa54e7. Read the comment docs.

Copy link
Copy Markdown
Member

@ischoegl ischoegl left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me. Thanks for going over this!

@ischoegl ischoegl merged commit 7fc5a2d into Cantera:main Dec 5, 2021
@speth speth deleted the doc-fixups branch July 23, 2024 15:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants