Skip to content

doc: fix errors in the reference manual - #995

Merged
giacomofiorin merged 2 commits into
masterfrom
doc_fixes
Nov 9, 2026
Merged

giacomofiorin merged 2 commits into
masterfrom
doc_fixes

Conversation

@jhenin

@jhenin jhenin commented Nov 7, 2026 •

Copy link
Copy Markdown
Member

Fixes found while building the manual with LaTeXML (#996). All of them also apply to the PDF.

  • itemize nesting: an itemize was opened before the "Histogramming vector variables" subsubsection and closed after it.
  • gatherVectorColvars: documented type was "UNIX filename", should be boolean; removed an unmatched ) in its description.
  • Broken link: the grid section linked to sec:colvarbias_metadynamics, which doesn't exist (the label is sec:colvarbias_meta). Links to section labels now use \hyperref[...] instead of \hyperlink.
  • \refkey missing an argument (layeri_activation): the following . was used as the link target.
  • Split math: $f(\xi_{1}$, $\xi_{2}$, \ldots $)$ and similar are now single formulas.
  • Tinker-HP manual: two references to sec:apath_scripted were guarded by \cvscriptcallbacks, but the section only exists with \cvvmdornamd, so they were dangling. Both now use \cvvmdornamd.
  • Example input: straight quotes in two comments (``charge'' → "charge").
  • colvars-code-refs.bib: escaped & in a publisher field.

Tested: the NAMD and Tinker-HP PDFs build with no errors or undefined references.

🤖 Generated with Claude Code

- Close an itemize that was opened before the "Histogramming vector
  variables" subsubsection and closed after it
- gatherVectorColvars is a boolean (was documented as a UNIX filename);
  remove an unmatched parenthesis in its description
- Fix the link to the metadynamics section (wrong label
  sec:colvarbias_metadynamics) and use \hyperref for links to section labels
- Add the missing first argument of a \refkey (its link target was ".")
- Merge math expressions that were split across several $...$
- Guard references to sec:apath_scripted with \cvvmdornamd, like the
  section itself (they were dangling in the Tinker-HP manual)
- Use straight quotes in comments of example input
- Escape & in a BibTeX publisher field

[update-doc]

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@giacomofiorin

Copy link
Copy Markdown
Member

I stacked this PR with #997 and added a small fix that got overlooked because we have unrelated CI failures

@giacomofiorin
giacomofiorin merged commit 4e95425 into master Nov 9, 2026
11 of 17 checks passed
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