[sage-devel] Re: LaTeX in docstrings

2009-03-17 Thread Carl Witty
On Tue, Mar 17, 2009 at 11:55 AM, John H Palmieri wrote: > Well, I've been trying to modify 'latex_preamble' in sage/doc/common/ > conf.py, and I'm having no luck at all: no changes I make have any > effect. It seems like a good place to put a few macros (like \ZZ), but > maybe that variable isn'

[sage-devel] Re: LaTeX in docstrings

2009-03-17 Thread John H Palmieri
On Mar 17, 11:16 am, Carl Witty wrote: > On Tue, Mar 17, 2009 at 11:10 AM, John H Palmieri > > wrote: > > I think \ZZ is a good option, too.  Does anyone know if the file > > $SAGE_ROOT/devel/sage/doc/common/macros.tex has any role, currently? > > I'm pretty sure it doesn't.  (I searched through

[sage-devel] Re: LaTeX in docstrings

2009-03-17 Thread Carl Witty
On Tue, Mar 17, 2009 at 11:10 AM, John H Palmieri wrote: > I think \ZZ is a good option, too.  Does anyone know if the file > $SAGE_ROOT/devel/sage/doc/common/macros.tex has any role, currently? I'm pretty sure it doesn't. (I searched through the whole sage/doc tree for the word "macros", and i

[sage-devel] Re: LaTeX in docstrings

2009-03-17 Thread John H Palmieri
On Mar 17, 10:44 am, Robert Bradshaw wrote: > On Mar 17, 2009, at 10:39 AM, Martin Albrecht wrote: > > > > > > > On Tuesday 17 March 2009, Carl Witty wrote: > >> On Tue, Mar 17, 2009 at 9:59 AM, Martin Albrecht > > >> wrote: > >>> On Tuesday 17 March 2009, Carl Witty wrote: > My vote would

[sage-devel] Re: LaTeX in docstrings

2009-03-17 Thread Robert Bradshaw
On Mar 17, 2009, at 10:39 AM, Martin Albrecht wrote: > On Tuesday 17 March 2009, Carl Witty wrote: >> On Tue, Mar 17, 2009 at 9:59 AM, Martin Albrecht >> >> wrote: >>> On Tuesday 17 March 2009, Carl Witty wrote: My vote would be for `H_d(X, \ZZ)` (for easier typing), combined with >>

[sage-devel] Re: LaTeX in docstrings

2009-03-17 Thread John H Palmieri
On Mar 17, 9:59 am, Martin Albrecht wrote: > On Tuesday 17 March 2009, Carl Witty wrote: > > > On Tue, Mar 17, 2009 at 9:35 AM, John H Palmieri > wrote: > > > Do we have any conventions or standards for the use of LaTeX in > > > docstrings?  Consider this: > > > >    r""" > > >    This computes

[sage-devel] Re: LaTeX in docstrings

2009-03-17 Thread Martin Albrecht
On Tuesday 17 March 2009, Carl Witty wrote: > On Tue, Mar 17, 2009 at 9:59 AM, Martin Albrecht > > wrote: > > On Tuesday 17 March 2009, Carl Witty wrote: > >> My vote would be for `H_d(X, \ZZ)` (for easier typing), combined with > >> some sort of LaTeX-to-plain-text processing to change \ZZ to Z

[sage-devel] Re: LaTeX in docstrings

2009-03-17 Thread Carl Witty
On Tue, Mar 17, 2009 at 9:59 AM, Martin Albrecht wrote: > > On Tuesday 17 March 2009, Carl Witty wrote: >> My vote would be for `H_d(X, \ZZ)` (for easier typing), combined with >> some sort of LaTeX-to-plain-text processing to change \ZZ to Z or ZZ >> (I'm not sure which).  (We have some LaTeX-to

[sage-devel] Re: LaTeX in docstrings

2009-03-17 Thread Martin Albrecht
On Tuesday 17 March 2009, Carl Witty wrote: > On Tue, Mar 17, 2009 at 9:35 AM, John H Palmieri wrote: > > Do we have any conventions or standards for the use of LaTeX in > > docstrings?  Consider this: > > > >    r""" > >    This computes the integral homology `H_d(X, ZZ)` of `X` in > > dimensio

[sage-devel] Re: LaTeX in docstrings

2009-03-17 Thread Carl Witty
On Tue, Mar 17, 2009 at 9:35 AM, John H Palmieri wrote: > > Do we have any conventions or standards for the use of LaTeX in > docstrings?  Consider this: > >    r""" >    This computes the integral homology `H_d(X, ZZ)` of `X` in > dimension `d`. >    """ > > versus > >    r""" >    This computes