Document latex formatting limitation (closes issue #300).

mcmtroffaes · Aug 26, 2022 · 03d924b · 03d924b
1 parent 82b5704
commit 03d924b
Showing 1 changed file with 8 additions and 0 deletions.
diff --git a/doc/usage.rst b/doc/usage.rst
@@ -944,6 +944,14 @@ The complete list of warning subtypes that can be suppressed is::
 Known Issues and Workarounds
 ----------------------------
 
+LaTeX Formatting Inside Bibtex Entries
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Beyond simple unicode/LaTeX symbol conversions,
+LaTeX formatting in bib files is not supported by pybtex.
+Since sphinxcontrib-bibtex uses pybtex to parse and format bibtex entries,
+that limitation is carried over to sphinxcontrib-bibtex.
+
 Encoding: Percent Signs
 ~~~~~~~~~~~~~~~~~~~~~~~