On Sat, Feb 28, 2009 at 3:00 PM, Mike Hansen <mhan...@gmail.com> wrot
> Not quite.  The following will work though:

Why is there only one colon after INPUT but two after EXAMPLES?
Why is the newline necessarily after INPUT?

>
> def QuaternionAlgebra(K, a, b, names=['i','j','k'], denom=1):
>    """
>    Return the quaternion algebra over `K` generated by
>    `i`, `j`, and `k` such that
>    `i^2 = a`, `j^2 = b`, and `ij=-ji=k`.
>
>    INPUT:
>
>    -  ``K`` - field
>    -  ``a`` - element of K
>    -  ``b`` - element of K
>    -  ``names`` - list of three strings
>    -  ``denom`` - (optional, default 1)
>
>    EXAMPLES::
>
>        sage: A.<i,j,k> = QuaternionAlgebra(QQ, -1,-1)
>        sage: i^2
>        -1
>        sage: j^2
>        -1
>        sage: i*j
>        k
>        sage: j*i
>        -k
>        sage: (i + j + k)^2
>        -3
>        sage: A.ramified_primes()
>        [2]
>    """
>
>> Is there a command in sage-3.4.alpha0 that I can use to validate ReST
>> markup?  Or even one not in Sage?
>
> You can just build the docs with "sage -docbuild reference html" and
> it will only rebuild changed modules.
>
> That being said, Sphinx has an actual markup for input and output
> which would make more sense to use.  See
> http://sphinx.pocoo.org/markup/desc.html#info-field-lists
>
> --Mike
>
> >
>



-- 
William Stein
Associate Professor of Mathematics
University of Washington
http://wstein.org

--~--~---------~--~----~------------~-------~--~----~
To post to this group, send email to sage-devel@googlegroups.com
To unsubscribe from this group, send email to 
sage-devel-unsubscr...@googlegroups.com
For more options, visit this group at http://groups.google.com/group/sage-devel
URLs: http://www.sagemath.org
-~----------~----~----~----~------~----~------~--~---

Reply via email to