Skip to content

Update sphinx-build --define with nested values - #14546

Open
parulin wants to merge 1 commit into
sphinx-doc:masterfrom
parulin:nested-lists
Open

Update sphinx-build --define with nested values#14546
parulin wants to merge 1 commit into
sphinx-doc:masterfrom
parulin:nested-lists

Conversation

@parulin

@parulin parulin commented Jul 21, 2026

Copy link
Copy Markdown

Purpose

Document the sphinx-build --define option limited ability to use nested dict/lists. Also:

  • Remove the mention to "dictionary value"
  • Mention that "None" will be treated as a string
  • Minor change in paragraphs order (complex cases at the end)
  • Examples for list/dict

References

Fix: #14539

Comment thread doc/man/sphinx-build.rst Outdated
Comment thread doc/man/sphinx-build.rst Outdated
Comment thread doc/man/sphinx-build.rst Outdated
Comment thread doc/man/sphinx-build.rst Outdated
Comment thread doc/man/sphinx-build.rst Outdated
* Remove the mention to "dictionary value"
* Mention that "None" will be treated as a string
* Minor change in paragraphs order (complex cases at the end)
* Examples for list/dict
* Note about limited nested values/keys and how to deal with that
* Update an old versionchanged

Fix: sphinx-doc#14539
@jdillard

Copy link
Copy Markdown
Member

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Nested dictionaries/lists not supported by sphinx-build --define

2 participants