#19319: iterator over pairs on diagonals a la Cantor pairing
-------------------------------------+-------------------------------------
Reporter: dkrenn | Owner:
Type: enhancement | Status: needs_review
Priority: major | Milestone: sage-6.9
Component: misc | Resolution:
Keywords: | Merged in:
Authors: Daniel Krenn, | Reviewers:
Clemens Heuberger | Work issues:
Report Upstream: N/A | Commit:
Branch: | d4dec2be9048e1b8fc9de246fe5c698d3676a13a
u/cheuberg/product_cantor_pairing | Stopgaps:
Dependencies: |
-------------------------------------+-------------------------------------
Comment (by dkrenn):
Replying to [comment:22 ncohen]:
> You got me wrong: I did not ask you to remove the seealso block. I
proposed to have a
> {{{
> SEEALSO::
>
> For related functions, refer to the module's documentation
> }}}
> with a link of course.
I understood.
> Linking n functions to each other requires n*(n-1) different links. If a
function is moved, if a function is added, that requires much more work.
Additionally, it possible that somebody *adding* a function may forget to
update the others, which will not happen if we have an index of function
at the head of the module.
Having these links directly in the `SEEALSO` block of the function helps
the user...and this ranks higher to me than what a developer has to add
when moving something around (and of course there is `--warn-links` which
alerts when something is not where it should be). When adding a new
function it is fine that not all `SEEALSO` blocks contain it; maybe only
the close related ones. In `sage.misc.mrange` there are just a few
functions and all those should IMHO be linked. In larger files I would
*not* link all in all, but only build "cliques" of very related functions
(but this depends on the functions, of course).
--
Ticket URL: <http://trac.sagemath.org/ticket/19319#comment:25>
Sage <http://www.sagemath.org>
Sage: Creating a Viable Open Source Alternative to Magma, Maple, Mathematica,
and MATLAB
--
You received this message because you are subscribed to the Google Groups
"sage-trac" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/sage-trac.
For more options, visit https://groups.google.com/d/optout.
