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 -~----------~----~----~----~------~----~------~--~---