[ET Trac] [Einstein Toolkit] #1885: support bibtex in thorn documenation files

[Einstein Toolkit]

#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)

-- 
Ticket URL: <https://trac.einsteintoolkit.org/ticket/1885#comment:3>
Einstein Toolkit <http://einsteintoolkit.org>
The Einstein Toolkit