Skip to content

sphinx_git: add 'repo-dir' in option_spec of GitCommitDetail#60

Open
mccaffrey-jonathan wants to merge 1 commit intoOddBloke:masterfrom
mccaffrey-jonathan:patch-1
Open

sphinx_git: add 'repo-dir' in option_spec of GitCommitDetail#60
mccaffrey-jonathan wants to merge 1 commit intoOddBloke:masterfrom
mccaffrey-jonathan:patch-1

Conversation

@mccaffrey-jonathan
Copy link
Copy Markdown

Add 'repo-dir' option in the option_spec of GitCommitDetail class.
GitCommitDetail extends class GitDirectiveBase. GitDirectiveBase base class checks for 'repo-dir' option, with an environment default.
'repo-dir' option previously is in option_spec of GitChangelog but not of GitCommitDetail.
If 'repo-dir' option is added to the option_spec, that option becomes functional for GitCommitDetail because the option is queried in GitDirectiveBase.

1 use of 'repo-dir' option with GitCommitDetail is to embed the git revision (by commit SHA) of a neighboring git repository which is documented by the Sphinx documents, importing doxygen comments from that neighboring git repository by Breathe extension.

Add 'repo-dir' option in the option_spec of GitCommitDetail class.
GitCommitDetail extends class GitDirectiveBase.  GitDirectiveBase base class checks for 'repo-dir' option, with an environment default.
'repo-dir' option previously is in option_spec of GitChangelog but not of GitCommitDetail.
If 'repo-dir' option is added to the option_spec, that option becomes functional for GitCommitDetail because the option is queried in GitDirectiveBase.

1 use of 'repo-dir' option with GitCommitDetail is to embed the git revision (by commit SHA) of a neighboring git repository which is documented by the Sphinx documents, importing doxygen comments from that neighboring git repository by Breathe extension.
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.

1 participant