Skip to content

Commit

Permalink
Fix typo in class documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
JakubAndrysek committed Apr 2, 2024
1 parent 0e29374 commit 62afbe4
Showing 1 changed file with 10 additions and 10 deletions.
20 changes: 10 additions & 10 deletions mkdoxy/doxyrun.py
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@

class DoxygenRun:
"""! Class for running Doxygen.
@detailss This class is used to run Doxygen and parse the XML output.
@details This class is used to run Doxygen and parse the XML output.
"""

def __init__(
Expand All @@ -37,7 +37,7 @@ def __init__(
- GENERATE_HTML: NO
- GENERATE_LATEX: NO
@detailss
@details
@param doxygenBinPath: (str) Path to the Doxygen binary.
@param doxygenSource: (str) Source files for Doxygen.
@param tempDoxyFolder: (str) Temporary folder for Doxygen.
Expand Down Expand Up @@ -116,7 +116,7 @@ def setDoxyCfg(self, doxyCfgNew: dict) -> dict:

def is_doxygen_valid_path(self, doxygen_bin_path: str) -> bool:
"""! Check if the Doxygen binary path is valid.
@detailss Accepts a full path or just 'doxygen' if it exists in the system's PATH.
@details Accepts a full path or just 'doxygen' if it exists in the system's PATH.
@param doxygen_bin_path: (str) The path to the Doxygen binary or just 'doxygen'.
@return: (bool) True if the Doxygen binary path is valid, False otherwise.
"""
Expand All @@ -131,7 +131,7 @@ def is_doxygen_valid_path(self, doxygen_bin_path: str) -> bool:
# Source of dox_dict2str: https://xdress-fabio.readthedocs.io/en/latest/_modules/xdress/doxygen.html#XDressPlugin
def dox_dict2str(self, dox_dict: dict) -> str:
"""! Convert a dictionary to a string that can be written to a doxygen config file.
@detailss
@details
@param dox_dict: (dict) Dictionary to convert.
@return: (str) String that can be written to a doxygen config file.
"""
Expand All @@ -152,7 +152,7 @@ def dox_dict2str(self, dox_dict: dict) -> str:

def str2dox_dict(self, dox_str: str) -> dict:
"""! Convert a string from a doxygen config file to a dictionary.
@detailss
@details
@param dox_str: (str) String from a doxygen config file.
@return: (dict) Dictionary.
"""
Expand All @@ -176,9 +176,9 @@ def str2dox_dict(self, dox_str: str) -> dict:
) from e
return dox_dict

def hasChanged(self):
def hasChanged(self) -> bool:
"""! Check if the source files have changed since the last run.
@detailss
@details
@return: (bool) True if the source files have changed since the last run.
"""

Expand Down Expand Up @@ -217,7 +217,7 @@ def hashRead(filename: PurePath) -> str:

def run(self):
"""! Run Doxygen with the current configuration using the Popen class.
@detailss
@details
"""
doxyBuilder = Popen(
[self.doxygenBinPath, "-"],
Expand All @@ -232,7 +232,7 @@ def run(self):

def checkAndRun(self):
"""! Check if the source files have changed since the last run and run Doxygen if they have.
@detailss
@details
@return: (bool) True if Doxygen was run.
"""
if self.hasChanged():
Expand All @@ -243,7 +243,7 @@ def checkAndRun(self):

def getOutputFolder(self) -> PurePath:
"""! Get the path to the XML output folder.
@detailss
@details
@return: (PurePath) Path to the XML output folder.
"""
return Path.joinpath(Path(self.tempDoxyFolder), Path("xml"))
Expand Down

0 comments on commit 62afbe4

Please sign in to comment.