(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.
