#17860: Auto-generate gen.pyx -- part 2
-------------------------------------+-------------------------------------
       Reporter:  jdemeyer           |        Owner:
           Type:  enhancement        |       Status:  needs_review
       Priority:  major              |    Milestone:  sage-6.6
      Component:  interfaces         |   Resolution:
       Keywords:                     |    Merged in:
        Authors:  Jeroen Demeyer     |    Reviewers:
Report Upstream:  N/A                |  Work issues:
         Branch:                     |       Commit:
  u/jdemeyer/ticket/17860            |  c683c1946e0bb790996664b06b989a88ae50ce18
   Dependencies:  #17631, #17906     |     Stopgaps:
-------------------------------------+-------------------------------------

Comment (by vdelecroix):

 It looks globally nice!

 There are some bad formatting:
 - some `:emphasis:` gets wrong (see `bnrconductor` or `bnrdisc`)
 - some `:math:` directives get wrong  (see `binomial`, `contfrac`,
 `divrem` or `elleta`). Apparently, some backslash disappeared since we
 have {{{:math:`binomial(x,y)`}}} instead of {{{:math:`\binomial{x}{y}`}}}.
 Idem in `polgalois`: `TbelongstoQQ[X]`
 - the hyperlink to sections via `[Label: se:XYZ]` are very bad (see
 `factornf`, `fflog`, `fforder`, `galoisfixedfield`, `znlog`, `znorder`)

 Some of the issue above looks fine in the `pari.desc` file... might be
 because of the `gphelp` script. For example
 {{{
 $ gphelp -raw binomial
 ...
 binomial coefficient @[dollar]binom{x}{y}@[dollar].
 ...

 $ gphelp -raw polgalois
 ...
 @[dollar]T belongs to @[startbi]Q@[endbi][X]@[dollar]
 ...
 }}}
 On the other hand, the tex documentation with {{{gphelp XYZ}}} looks fine.

--
Ticket URL: <http://trac.sagemath.org/ticket/17860#comment:13>
Sage <http://www.sagemath.org>
Sage: Creating a Viable Open Source Alternative to Magma, Maple, Mathematica, 
and MATLAB

-- 
You received this message because you are subscribed to the Google Groups 
"sage-trac" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/sage-trac.
For more options, visit https://groups.google.com/d/optout.

Reply via email to