Re: [sage-devel] Re: Docbuild options for sage -docbuild and make doc
Le jeudi 15 mars, leif a écrit: P.S.: Perhaps the opportunity to introduce yet another Sage environment variable; to be set in ~/.sagerc of course! -((10^10)!)! because environment variables for everything is bad practice. What is this .sagerc? I don't know about it... Snark -- To post to this group, send an email to sage-devel@googlegroups.com To unsubscribe from this group, send an email to sage-devel+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/sage-devel URL: http://www.sagemath.org
Re: [sage-devel] Re: Docbuild options for sage -docbuild and make doc
I volunteer for opening a ticket and implementing it: this will very soon save me time! Sounds good to me. I can't figure out when it was introduced, so i don't know why it was introduced, either. Anyone else know? A quick search on sage-release reveals #10811: by default build HTML doc without PDF links [1] IIRC there's repeatedly been discussion about this (on sage-release); the ticket only refers to the following short sage-devel thread: http://groups.google.com/group/sage-devel/browse_thread/thread/04c3d373d5451a96 (So there's a reason we do use '--no-pdf-links'... ;-) ) Then why not having 'sage docbuild' not producing pdf links if no option is given and if you want them change the option to '--with-pdf-links' ? The only drawback I can see is that it adds yet another think to remember for the release manager and people who are maintaining the web sites. Did I miss something ? Cheers, Florent -- To post to this group, send an email to sage-devel@googlegroups.com To unsubscribe from this group, send an email to sage-devel+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/sage-devel URL: http://www.sagemath.org
[sage-devel] Re: Docbuild options for sage -docbuild and make doc
On Mar 16, 1:29 am, Julien Puydt julien.pu...@laposte.net wrote: Le jeudi 15 mars, leif a écrit: P.S.: Perhaps the opportunity to introduce yet another Sage environment variable; to be set in ~/.sagerc of course! -((10^10)!)! because environment variables for everything is bad practice. Like HOME, CC, CFLAGS, PAGER, etc. etc.? Well, they're very flexible, and you can set them in your .*rc files. Nobody wants to type 100 export SAGE_FOO=bar lines before running (or building) Sage. I meant: 1) Don't hardcode '--no-pdf-links' in the Makefile. 2) Don't surprise people by switching the behaviour if they happen to just run 'sage --docbuild ...', i.e., if the HTML documentation has already been built without links, don't rebuild the whole stuff *with* links unless explicitly specified. What is this .sagerc? Something I suggested years ago ;-) and still looking forward to it... -leif -- To post to this group, send an email to sage-devel@googlegroups.com To unsubscribe from this group, send an email to sage-devel+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/sage-devel URL: http://www.sagemath.org
Re: [sage-devel] Re: Docbuild options for sage -docbuild and make doc
On 2012-03-16 09:31, leif wrote: Something I suggested years ago ;-) and still looking forward to it... http://trac.sagemath.org/sage_trac/ticket/12647 -- To post to this group, send an email to sage-devel@googlegroups.com To unsubscribe from this group, send an email to sage-devel+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/sage-devel URL: http://www.sagemath.org
[sage-devel] Re: Docbuild options for sage -docbuild and make doc
On Thursday, March 15, 2012 2:28:02 PM UTC-7, Nicolas M. Thiéry wrote: Dear Sage doc compilation fans, Currently, make doc calls sage -docbuild with the option --no-pdf-links. I don't have an opinion about this specific option, but a very anoying consequence is that if you do a make and later a sage -docbuild, then all the doc is recompiled (GASP!). And reciprocally. Is there a very good reason to use different options for make doc and sage -docbuild? Otherwise, I vote for having make doc just call sage -docbuild. And I let the expert decide whether they want to throw --no-pdf-links in those default options or not. I volunteer for opening a ticket and implementing it: this will very soon save me time! Sounds good to me. I can't figure out when it was introduced, so i don't know why it was introduced, either. Anyone else know? -- John -- To post to this group, send an email to sage-devel@googlegroups.com To unsubscribe from this group, send an email to sage-devel+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/sage-devel URL: http://www.sagemath.org
[sage-devel] Re: Docbuild options for sage -docbuild and make doc
On Mar 16, 1:00 am, John H Palmieri jhpalmier...@gmail.com wrote: On Thursday, March 15, 2012 2:28:02 PM UTC-7, Nicolas M. Thiéry wrote: Dear Sage doc compilation fans, Currently, make doc calls sage -docbuild with the option --no-pdf-links. I don't have an opinion about this specific option, but a very anoying consequence is that if you do a make and later a sage -docbuild, then all the doc is recompiled (GASP!). And reciprocally. Is there a very good reason to use different options for make doc and sage -docbuild? Otherwise, I vote for having make doc just call sage -docbuild. And I let the expert decide whether they want to throw --no-pdf-links in those default options or not. I volunteer for opening a ticket and implementing it: this will very soon save me time! Sounds good to me. I can't figure out when it was introduced, so i don't know why it was introduced, either. Anyone else know? A quick search on sage-release reveals #10811: by default build HTML doc without PDF links [1] IIRC there's repeatedly been discussion about this (on sage-release); the ticket only refers to the following short sage-devel thread: http://groups.google.com/group/sage-devel/browse_thread/thread/04c3d373d5451a96 (So there's a reason we do use '--no-pdf-links'... ;-) ) -leif [1] http://trac.sagemath.org/sage_trac/ticket/10811 -- To post to this group, send an email to sage-devel@googlegroups.com To unsubscribe from this group, send an email to sage-devel+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/sage-devel URL: http://www.sagemath.org
[sage-devel] Re: Docbuild options for sage -docbuild and make doc
On Mar 16, 1:32 am, leif not.rea...@online.de wrote: On Mar 16, 1:00 am, John H Palmieri jhpalmier...@gmail.com wrote: On Thursday, March 15, 2012 2:28:02 PM UTC-7, Nicolas M. Thiéry wrote: Dear Sage doc compilation fans, Currently, make doc calls sage -docbuild with the option --no-pdf-links. I don't have an opinion about this specific option, but a very anoying consequence is that if you do a make and later a sage -docbuild, then all the doc is recompiled (GASP!). And reciprocally. Is there a very good reason to use different options for make doc and sage -docbuild? Otherwise, I vote for having make doc just call sage -docbuild. And I let the expert decide whether they want to throw --no-pdf-links in those default options or not. I volunteer for opening a ticket and implementing it: this will very soon save me time! Sounds good to me. I can't figure out when it was introduced, so i don't know why it was introduced, either. Anyone else know? A quick search on sage-release reveals #10811: by default build HTML doc without PDF links [1] IIRC there's repeatedly been discussion about this (on sage-release); the ticket only refers to the following short sage-devel thread: http://groups.google.com/group/sage-devel/browse_thread/thread/04c3d3... (So there's a reason we do use '--no-pdf-links'... ;-) ) -leif [1]http://trac.sagemath.org/sage_trac/ticket/10811 P.S.: Perhaps the opportunity to introduce yet another Sage environment variable; to be set in ~/.sagerc of course! -leif -- To post to this group, send an email to sage-devel@googlegroups.com To unsubscribe from this group, send an email to sage-devel+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/sage-devel URL: http://www.sagemath.org