#1885: support bibtex in thorn documenation files --------------------------+------------------------------------------------- Reporter: rhaas | Owner: Type: enhancement | Status: review Priority: optional | Milestone: Component: Cactus | Version: development version Resolution: | Keywords: --------------------------+-------------------------------------------------
Comment (by rhaas):
The bibtex files go into the doc directories (usually, this is not really required). The code parses (as far as TeX is parsable by anything other than TeX) the code for bibliography commands then prepends the full path in front of each bibtex file listed (this is legal in LaTeX). The tricky piece is actually mixing thorns that use LaTeX's thebibliography with those that use bibliography. ThornGuide.pl collects all entries in thebibliography as before. It also outputs a single bibdata statement with all the collected bib files from all bibliography commands. The bibdata statement is the same as LaTeX's own bibliography command uses (see {{{texmf/tex/latex/base/latex.ltx}}} and search for {{{\def\bibliography}}}). Having the bibdata statements in the aux file is sufficient to run bibtex (which will generate lots of warnings about all the non-bibtex keys). The code the strips the extra {{{\begin{thebibliography}, \end{thebibliography}}}} lines from the beginning and end of the bibtex generated bbl file and includes the interior into the ThornGuide just after the collected thebibliography entries.
There are already example thorns that use bibtex files (and failed before): * EinsteinAnalysis/AHFinderDirect * ExternalLibraries/MPI (this one is new and in a separate pull request)