Dan Drake wrote:
> On Wed, 23 Apr 2008 at 01:25PM -0700, John H Palmieri wrote:
> This is exactly why die-hard Python people say "don't use backslashes to
> continue statements":
> 
> http://docs.python.org/dev/howto/doanddont.html#using-backslash-to-continue-statements
> 
> Perhaps we should link to the above guide in the Sage Programming Guide?
> 

I'm responsible for most (all?) of those backslashes, and at the time 
this seemed to be the easiest solution to the problem of having very 
long example lines that don't get wrapped in verbatim environments (and 
so get cut off in the pdf version of the tutorial, constructions, etc.).

I agree that it wasn't the most elegant solution.  On the other hand, 
not doing it at all rendered chunks of the pdf documentation useless, 
since an example that you cannot read is basically useless.

But the spirit of Sage (and of these lists) is: "tell me how I can do 
this properly, or better yet, do it yourself and post a patch".  The one 
sticky point is that whatever solution we come up with must behave well 
with respect to making both pdf and html documentation.

Best,
Alex


-- 
Alexandru Ghitza
Assistant Professor
Department of Mathematics
Colby College
Waterville, ME 04901
http://bayes.colby.edu/~ghitza/

--~--~---------~--~----~------------~-------~--~----~
To post to this group, send email to sage-devel@googlegroups.com
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at http://groups.google.com/group/sage-devel
URLs: http://www.sagemath.org
-~----------~----~----~----~------~----~------~--~---

Reply via email to