Account Options

  1. Sign in
The old Google Groups will be going away soon, but your browser is incompatible with the new version.
Google Groups Home
« Groups Home
sage-devel
Home
About this group
Apply for group membership
EXAMPLES in perm_group_named.py
Options
There are currently too many topics in this group that display first. To make this topic appear first, remove this option from another topic.
There was an error processing your request. Please try again.
flag
   4 messages - Collapse all  -  Translate all to Translated (View all originals)
The group you are posting to is a Usenet group. Messages posted to this group will make your email address visible to anyone on the Internet.
Your reply message has not been sent.
Your post was successful
 
From:
To:
Cc:
Followup To:
Add Cc | Add Followup-to | Edit Subject
Subject:
Validation:
For verification purposes please type the characters you see in the picture below or the numbers you hear by clicking the accessibility icon. Listen and type the numbers you hear
 
Vincent D  
View profile  
 More options Apr 29 2012, 10:51 am
From: Vincent D <20100.delecr...@gmail.com>
Date: Sun, 29 Apr 2012 07:51:28 -0700 (PDT)
Local: Sun, Apr 29 2012 10:51 am
Subject: EXAMPLES in perm_group_named.py
Print | Individual message | Show original | Report this message | Find messages by this author
Hello,

In many documentation string (more than a hundred) of the file
sage.groups.perm_groups.permgroup_named.py there are many EXAMPLES
that are followed by only one ':' and no whiteline after it. It seems
that the associated examples are tested with "sage -t" but the
documentation looks ugly. Does this need a ticket ?

Best,
Vincent


 
You must Sign in before you can post messages.
To post a message you must first join this group.
Please update your nickname on the subscription settings page before posting.
You do not have the permission required to post.
William Stein  
View profile  
 More options Apr 29 2012, 11:12 am
From: William Stein <wst...@gmail.com>
Date: Sun, 29 Apr 2012 10:12:11 -0500
Local: Sun, Apr 29 2012 11:12 am
Subject: Re: [sage-devel] EXAMPLES in perm_group_named.py
Print | Individual message | Show original | Report this message | Find messages by this author

On Sunday, April 29, 2012, Vincent D <20100.delecr...@gmail.com> wrote:
> Hello,

> In many documentation string (more than a hundred) of the file
> sage.groups.perm_groups.permgroup_named.py there are many EXAMPLES
> that are followed by only one ':' and no whiteline after it. It seems
> that the associated examples are tested with "sage -t" but the
> documentation looks ugly. Does this need a ticket ?

Yes - it was surely missed by the automated conversion to Sphinx a long
time ago.

> Best,
> Vincent

> --
> To post to this group, send an email to sage-devel@googlegroups.com<javascript:;>
> To unsubscribe from this group, send an email to
> sage-devel+unsubscribe@googlegroups.com <javascript:;>
> For more options, visit this group at
> http://groups.google.com/group/sage-devel
> URL: http://www.sagemath.org

--
William Stein
Professor of Mathematics
University of Washington
http://wstein.org

 
You must Sign in before you can post messages.
To post a message you must first join this group.
Please update your nickname on the subscription settings page before posting.
You do not have the permission required to post.
Simon King  
View profile  
 More options Apr 29 2012, 11:17 am
From: Simon King <simon.k...@uni-jena.de>
Date: Sun, 29 Apr 2012 15:17:23 +0000 (UTC)
Local: Sun, Apr 29 2012 11:17 am
Subject: Re: EXAMPLES in perm_group_named.py
Print | Individual message | Show original | Report this message | Find messages by this author
Hi!

On 2012-04-29, Vincent D <20100.delecr...@gmail.com> wrote:

> Hello,

> In many documentation string (more than a hundred) of the file
> sage.groups.perm_groups.permgroup_named.py there are many EXAMPLES
> that are followed by only one ':' and no whiteline after it. It seems
> that the associated examples are tested with "sage -t" but the
> documentation looks ugly. Does this need a ticket ?

Yes! If you create a trac ticket and choose a component, you will find
that there is a component "documentation", which should be the right one
for that purpose.

Best regards,
Simon


 
You must Sign in before you can post messages.
To post a message you must first join this group.
Please update your nickname on the subscription settings page before posting.
You do not have the permission required to post.
Nicolas M. Thiery  
View profile  
 More options Apr 29 2012, 6:38 pm
From: "Nicolas M. Thiery" <Nicolas.Thi...@u-psud.fr>
Date: Mon, 30 Apr 2012 00:38:12 +0200
Local: Sun, Apr 29 2012 6:38 pm
Subject: Re: [sage-devel] Re: EXAMPLES in perm_group_named.py
Print | Individual message | Show original | Report this message | Find messages by this author

On Sun, Apr 29, 2012 at 03:17:23PM +0000, Simon King wrote:
> On 2012-04-29, Vincent D <20100.delecr...@gmail.com> wrote:
> > Hello,

> > In many documentation string (more than a hundred) of the file
> > sage.groups.perm_groups.permgroup_named.py there are many EXAMPLES
> > that are followed by only one ':' and no whiteline after it. It seems
> > that the associated examples are tested with "sage -t" but the
> > documentation looks ugly. Does this need a ticket ?

> Yes! If you create a trac ticket and choose a component, you will find
> that there is a component "documentation", which should be the right one
> for that purpose.

And as usual one should be careful to synchronize well with other
developers working on that file since that's likely to create
conflicts.

Speaking of which, Roberto DiCosmo mentioned the other day a tool to
manipulate meta-patches:

        http://www.irill.org/activities/projects/coccinelle

The idea is that instead of writing a patch replacing one by one each
occurrence of ``EXAMPLES:'' by ``EXAMPLES::'' one writes a meta patch
with a single rule specifying that all ``EXAMPLES:'' shall be replaced
with ``EXAMPLES::''. Then the meta patch can apply indifferently on
any version of the sources; and the added semantic opens the door for
more clever merges.

Cheers,
                                Nicolas
--
Nicolas M. Thi ry "Isil" <nthi...@users.sf.net>
http://Nicolas.Thiery.name/


 
You must Sign in before you can post messages.
To post a message you must first join this group.
Please update your nickname on the subscription settings page before posting.
You do not have the permission required to post.
End of messages
« Back to Discussions « Newer topic     Older topic »

Create a group - Google Groups - Google Home - Terms of Service - Privacy Policy
©2013 Google