Add tutorial-like docstring material on RecursivelyEnumeratedSet

[mkoeppe]

... from a forgotten branch on #16351 ...

CC: @hivert @tscrim @seblabbe @nthiery @slel

Component: combinatorics

Author: Florent Hivert, Sébastien Labbé

Branch/Commit: 90dc326

Reviewer: Travis Scrimshaw

Issue created by migration from https://trac.sagemath.org/ticket/29882

[mkoeppe]

Branch: u/hivert/move_searchforest_code_to_sage_sets_recursively_enumerated_set_pyx

[mkoeppe]

Commit: 1bf8c97

[seblabbe]

Author: Florent Hivert, Sébastien Labbé

[seblabbe]

Changed commit from 1bf8c97 to 8b9869f

[seblabbe]

comment:3

I just did few modifications to properly include Florent's example into the doc.

---

New commits:

cb48f33	Revert "Removed TODO in doc"
8b9869f	29882: including the two examples provided by Florent Hivert into docstring

[seblabbe]

Changed branch from u/hivert/move_searchforest_code_to_sage_sets_recursively_enumerated_set_pyx to public/29882

[seblabbe]

comment:4

Note that I rebased old Florent Hivert's commit on top of 9.2.beta1 (new commit hash is cb48f33).

[sagetrac-git]

Branch pushed to git repo; I updated commit sha1. New commits:

46cce8f	Merge branch 'public/29882' of git://trac.sagemath.org/sage into public/29882
b44aac2	Some reviewer changes.

[sagetrac-git]

Changed commit from 8b9869f to b44aac2

[tscrim]

comment:6

I made a few small changes to try and improve the exposition. If my changes are good, then positive review.

[tscrim]

Reviewer: Travis Scrimshaw

[mwageringel]

comment:7

There are a few lines which are syntax errors in Python 3:

    def children((lst, st)):

        post_process = lambda (l, s): tuple(l) if not s else None,

[sagetrac-git]

Branch pushed to git repo; I updated commit sha1. New commits:

0a8c6d8	Merge branch 'public/29882' of trac.sagemath.org:/sage into 29882
90dc326	29882: adapted examples to Python3 syntax

[sagetrac-git]

Changed commit from b44aac2 to 90dc326

[seblabbe]

comment:9

Needs review.

[tscrim]

comment:10

LGTM.

[vbraun]

Changed branch from public/29882 to 90dc326