Skip to content

Documentation improvements#1958

Open
jkeiren wants to merge 20 commits into
mCRL2org:masterfrom
jkeiren:fixes/doc
Open

Documentation improvements#1958
jkeiren wants to merge 20 commits into
mCRL2org:masterfrom
jkeiren:fixes/doc

Conversation

@jkeiren

@jkeiren jkeiren commented Jul 9, 2026

Copy link
Copy Markdown
Collaborator

Several documentation improvements.

  • Mostly focus on fixing Doxygen warnings.
  • Resolve race condition in generating latex math which causes the wrong images to show up in generated documentation.

jkeiren added 20 commits July 7, 2026 08:45
- conf.in.py: guard html_extra_path/doxylink under build_doxygen tag,  enable numfig, add mcrl2_imgmath extension for parallel-write fix
-_extensions/mcrl2_imgmath.py: new extension — gives each worker process its own imgmath tempdir, eliminating math.dvi race condition under -jauto
- mcrl2ide.rst: replace :numref: with :ref: for a note-block label
- pbeschain.rst: replace smart-quote open-backtick with straight quote
- data_rewriters.rst: replace malformed grid table with list-table
- state_space_exploration.rst: add title to list-table so :ref: resolves
- symbolic_library.rst: replace raw .. include:: with toctree entry to avoid duplicate equation label registration
- data.rst: remove duplicate dparser token declarations (IdsDecl, VarsDecl, VarsDeclList, SortExpr)
- index.rst: use anonymous hyperlinks for YouTube links to avoid duplicate target name warnings from identically-named Coursera links
@jkeiren jkeiren requested a review from mlaveaux July 9, 2026 14:19
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