The Magma Handbook has 5583 pages -- remember the mission statement! Of course I never look at the Sage pdf reference (OK, I just did -- it is rather beautiful)
John On 12 June 2014 13:45, Nathann Cohen <nathann.co...@gmail.com> wrote: > (remember that removing the pdf manual can also save trees, for it is likely > that some people got the idea to print these files :-P) > > > On 12 June 2014 14:43, Nathann Cohen <nathann.co...@gmail.com> wrote: >> >> Hello guys ! >> >> I wanted to ask you if you had ever found the pdf version of the manual >> useful for anything, or if we could just give it up. >> >> The problem we have is that the category/ folder contains things like >> >> class A: >> class B: >> class C: >> class D: >> def Hey(): >> pass >> >> and that function "Hey" does not appear in the doc as a result. A ticket >> [1] was opened for this 4 years ago but it got stuck because documenting >> these functions leads Sphinx to generate a LaTeX document that does not >> compile, because "the nesting is too important". >> >> This should of course remind us that we cannot trust LaTeX with anything, >> but more importantly we *DO* need those functions to appear in the >> documentation. >> >> So well. Given that the ticket is already 4 years old, if everybody agrees >> that the pdf documentation is totally useless, we could just throw it away >> and have all our functions appear in the doc at zero cost. >> >> Have fun ! >> >> Nathann >> >> P.S. : If you never opened the PDF version of the manual you can see for >> yourself how useless it is to find any info by going there : >> http://www.sagemath.org/pdf/en/reference/ >> (yes, many doctests cross the margins) >> >> [1] http://trac.sagemath.org/ticket/9107 > > > -- > You received this message because you are subscribed to the Google Groups > "sage-devel" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to sage-devel+unsubscr...@googlegroups.com. > To post to this group, send email to sage-devel@googlegroups.com. > Visit this group at http://groups.google.com/group/sage-devel. > For more options, visit https://groups.google.com/d/optout. -- You received this message because you are subscribed to the Google Groups "sage-devel" group. To unsubscribe from this group and stop receiving emails from it, send an email to sage-devel+unsubscr...@googlegroups.com. To post to this group, send email to sage-devel@googlegroups.com. Visit this group at http://groups.google.com/group/sage-devel. For more options, visit https://groups.google.com/d/optout.
