John and Jason, Thanks for all the advice and clarifications. I'll run the suggested experiments and report a ticket number here once its up.
Rob On Jun 3, 4:45 pm, John H Palmieri <[email protected]> wrote: > On Jun 3, 1:04 pm, Rob Beezer <[email protected]> wrote: > > > Mitesh Patel discovered that the tex macro "\leqslant" (a slanted > > inequality) breaks the PDF reference manual, while it survives just > > fine in the HTML version. (Introduced at Trac #8030, which is merged, > > fixed at Trac #9102, awaiting review.) This symbol seems to be > > provided by the AMS packages amssymb and/or amsfonts. On my tex > > installation, both are provided in texmf-texlive/tex/latex/amsfonts/, > > so I think these are fairly standard packages to expect a user/ > > developer to have. > > > Limited poking around shows: > > > (1) In doc/common/macros.tex, there is the line > > As far as I know, the file macros.tex is unused. See below. (I think > it is still around because it has occasionally been useful to know > what macros used to be included in the documentation. Perhaps it has > served its purpose and should die a graceful death...) > > > \usepackage{amsmath} > > > but this file makes no mention of amssymb or amsfonts > > > (2) In doc/common/conf.py (which looks Sphinx-specific?) there is the > > line > > > latex_elements['preamble'] = '\usepackage{amsmath}\n > > \usepackage{amsfonts}\n' > > This should be the relevant line. > > You can test this: prepare the pdf (or the latex) documentation, for > example > > sage -docbuild tutorial latex (or pdf) > > and look at the file in SAGE_ROOT/devel/sage/doc/output/latex/en/ > tutorial/. Its preamble should include the lines from > latex_elements['preamble'], along with various macros imported from > sage/misc/latex_macros.py, but should not include anything from > macros.tex. > > > Questions: > > > (a) Is the distinction conscious, or is this an omission of AMS > > symbols on the PDF side? > > The distinction is irrelevant, because the file macros.tex is unused. > > > (b) If in need of fixing, is macros.tex the place to add? > > No. > > > (c) And if so, is amsfonts superior to amssymb, or vice versa (or > > both?)? I always have good luck with amssymb only. I would assume we > > want the same macros available for both HTML and PDF versions of the > > docs? > > If I make a test file which just includes $\leqslant$, it bombs if I > use the amsfonts package, but if works if I use amssymb. So that's > what I would try. > > -- > John -- To post to this group, send an email to [email protected] To unsubscribe from this group, send an email to [email protected] For more options, visit this group at http://groups.google.com/group/sage-devel URL: http://www.sagemath.org
