Skip to content

Commit d9bd5ef

Browse files
to: correct doc "rtype" not "Result"
1 parent 31896ae commit d9bd5ef

5 files changed

Lines changed: 42 additions & 42 deletions

File tree

docs/source/data-structures/presentations/to-inverse-present.rst

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -22,8 +22,8 @@ using the :any:`to` function.
2222
Various uses
2323
------------
2424

25-
Recall that the signature for the :any:`to` function is ``to(*args, Return)``.
26-
In what follows, we explain how different values of *args* and *Return* may be
25+
Recall that the signature for the :any:`to` function is ``to(*args, rtype)``.
26+
In what follows, we explain how different values of *args* and *rtype* may be
2727
used to construct :any:`InversePresentation` objects. The following options are
2828
possible:
2929

@@ -41,7 +41,7 @@ the following values for *args*:
4141

4242
- **p** (:any:`Presentation`) -- the :any:`Presentation` to convert.
4343

44-
Additionally, specify the following for *Return*:
44+
Additionally, specify the following for *rtype*:
4545

4646
- ``(InversePresentation,)`` for constructing an :any:`InversePresentation`
4747
over words of the same type as those in *p*.
@@ -92,22 +92,22 @@ specify the following values for *args*:
9292
- **ip** (:any:`InversePresentation`) -- the :any:`InversePresentation` to
9393
convert.
9494

95-
Additionally, specify one of the following for *Return*:
95+
Additionally, specify one of the following for *rtype*:
9696

9797
- ``(InversePresentation, str)`` for constructing an
9898
- :any:`InversePresentation` over words of type ``str``.
9999
- ``(InversePresentation, list[int])`` for constructing an
100100
:any:`InversePresentation` over words of type ``list[int]``.
101101

102102
This function behaves in one of two ways, depending on type of words in *p*, and
103-
the type of words specified in *Return*:
103+
the type of words specified in *rtype*:
104104

105-
1. When the type of words in *ip* and type of words specified in *Return*
105+
1. When the type of words in *ip* and type of words specified in *rtype*
106106
are not the same, this function returns an :any:`InversePresentation`
107107
equivalent to the input :any:`InversePresentation` *ip* but with words a
108108
different type (for example, can be used to convert from ``str`` to
109109
``list[int]``).
110-
2. When the type of words in *ip* and type of words specified in *Return*
110+
2. When the type of words in *ip* and type of words specified in *rtype*
111111
are the same, this function just returns its argument *ip*, and is
112112
included solely for the purpose of simplifying certain client code, where
113113
objects of type :any:`InversePresentation` must be converted from one
@@ -120,7 +120,7 @@ of type ``list[int]``, then the conversion from one type to another is
120120
:math:`a_i \mapsto` ``human_readable_letter(a_i)``.
121121

122122
This function throws a :any:`LibsemigroupsError` if the type of words in *ip* is
123-
not the same as that specified in *Return* and
123+
not the same as that specified in *rtype* and
124124
``p.throw_if_bad_alphabet_rules_or_inverses()`` throws.
125125

126126
.. seealso::
@@ -164,7 +164,7 @@ using a custom letter conversion function, specify the following values for
164164
- **f** (``Callable[[str | int], int | str]``) -- the function used to
165165
convert between the different types of letters.
166166

167-
Additionally, specify one of the following for *Return*:
167+
Additionally, specify one of the following for *rtype*:
168168

169169
- ``(InversePresentation, str)`` for constructing an
170170
:any:`InversePresentation` over words of type ``str``.
@@ -180,7 +180,7 @@ to the other.
180180
This function throws a :any:`LibsemigroupsError` if
181181
``ip.throw_if_bad_alphabet_rules_or_inverses()`` throws, or if the function
182182
specified by *f* does not map letters of the type used in *ip* to letters of the
183-
type of word specified in *Return*.
183+
type of word specified in *rtype*.
184184

185185
.. seealso::
186186

docs/source/data-structures/presentations/to-present.rst

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -22,8 +22,8 @@ This page contains documentation relating to converting
2222
Various uses
2323
------------
2424

25-
Recall that the signature for the :any:`to` function is ``to(*args, Return)``.
26-
In what follows, we explain how different values of *args* and *Return* may be
25+
Recall that the signature for the :any:`to` function is ``to(*args, rtype)``.
26+
In what follows, we explain how different values of *args* and *rtype* may be
2727
used to construct :any:`Presentation` objects. The following options are
2828
possible:
2929

@@ -46,21 +46,21 @@ following values for *args*:
4646

4747
- **p** (:any:`Presentation`) -- the :any:`Presentation` to convert.
4848

49-
Additionally, specify one of the following for *Return*:
49+
Additionally, specify one of the following for *rtype*:
5050

5151
- ``(Presentation, str)`` for constructing a :any:`Presentation` over words
5252
of type ``str``.
5353
- ``(Presentation, list[int])`` for constructing a :any:`Presentation` over
5454
words of type ``list[int]``.
5555

5656
This function behaves in one of two ways, depending on type of words in *p*, and
57-
the type of words specified in *Return*:
57+
the type of words specified in *rtype*:
5858

59-
1. When the type of words in *p* and type of words specified in *Return* are
59+
1. When the type of words in *p* and type of words specified in *rtype* are
6060
not the same, this function returns a :any:`Presentation` equivalent to
6161
the input :any:`Presentation` *p* but with words a different type (for
6262
example, can be used to convert from ``str`` to ``list[int]``).
63-
2. When the type of words in *p* and type of words specified in *Return* are
63+
2. When the type of words in *p* and type of words specified in *rtype* are
6464
the same, this function just returns its argument *p*, and is included
6565
solely for the purpose of simplifying certain client code, where
6666
presentations must be converted from one type to another sometimes, but
@@ -73,7 +73,7 @@ of type ``list[int]``, then the conversion from one type to another is
7373
:math:`a_i \mapsto` ``human_readable_letter(a_i)``.
7474

7575
This function throws a :any:`LibsemigroupsError` if the type of words in *p* is
76-
not the same as that specified in *Return*, and
76+
not the same as that specified in *rtype*, and
7777
``p.throw_if_bad_alphabet_or_rules()`` throws.
7878

7979
.. seealso::
@@ -115,7 +115,7 @@ letter conversion function, specify the following values for *args*:
115115
- **f** (``Callable[[str | int], int | str]``) -- the function used to
116116
convert between the different types of letters.
117117

118-
Additionally, specify one of the following for *Return*:
118+
Additionally, specify one of the following for *rtype*:
119119

120120
- ``(Presentation, str)`` for constructing a :any:`Presentation` over words
121121
of type ``str``.
@@ -131,7 +131,7 @@ other.
131131
This function throws a :any:`LibsemigroupsError` if
132132
``p.throw_if_bad_alphabet_or_rules()`` throws, or if the function specified by
133133
*f* does not map letters of the type used in *p* to letters of the type of word
134-
specified in *Return*.
134+
specified in *rtype*.
135135

136136
.. seealso::
137137

@@ -169,7 +169,7 @@ following values for *args*:
169169
- **kb** (:any:`KnuthBendix`) -- the :any:`KnuthBendix` from which to obtain
170170
the rules.
171171

172-
Additionally, specify one of the following for *Return*:
172+
Additionally, specify one of the following for *rtype*:
173173

174174
- ``(Presentation,)`` for constructing a :any:`Presentation` over words of
175175
the same type as that in *kb*.
@@ -211,7 +211,7 @@ enumerates *kb*) prior to calling this function.
211211
>>> kb.run()
212212
>>> p2 = to(kb, rtype=(Presentation,))
213213
>>> for p in [p1, p2]:
214-
... # Returns whether any changes have been made
214+
... # rtypes whether any changes have been made
215215
... presentation.sort_each_rule(p)
216216
... presentation.sort_rules(p)
217217
True
@@ -230,7 +230,7 @@ following values for *args*:
230230
- **fp** (:any:`FroidurePin`) -- the :any:`FroidurePin` from which to obtain
231231
the rules.
232232

233-
Additionally, specify the following for *Return*:
233+
Additionally, specify the following for *rtype*:
234234

235235
- ``(Presentation, str)`` for constructing a :any:`Presentation` over words
236236
of type ``str``.
@@ -282,7 +282,7 @@ following values for *args*:
282282
- **k** (:any:`Kambites`) -- the :any:`Kambites` from which to obtain
283283
the presentation.
284284

285-
Additionally, specify one of the following for *Return*:
285+
Additionally, specify one of the following for *rtype*:
286286

287287
- ``(Presentation,)`` for constructing a :any:`Presentation` over words of
288288
the same type as that in *k*.
@@ -342,7 +342,7 @@ following values for *args*:
342342
- **tc** (:any:`ToddCoxeter`) -- the :any:`ToddCoxeter` from which to obtain
343343
the presentation.
344344

345-
Additionally, specify one of the following for *Return*:
345+
Additionally, specify one of the following for *rtype*:
346346

347347
- ``(Presentation,)`` for constructing a :any:`Presentation` over words of
348348
the same type as that in *tc*.
@@ -402,7 +402,7 @@ following values for *args*:
402402
- **c** (:any:`Congruence`) -- the :any:`Congruence` from which to obtain
403403
the presentation.
404404

405-
Additionally, specify one of the following for *Return*:
405+
Additionally, specify one of the following for *rtype*:
406406

407407
- ``(Presentation,)`` for constructing a :any:`Presentation` over words of
408408
the same type as that in *c*.
@@ -463,7 +463,7 @@ following values for *args*:
463463
- **s** (:any:`Stephen`) -- the :any:`Stephen` from which to obtain
464464
the presentation.
465465

466-
Additionally, specify one of the following for *Return*:
466+
Additionally, specify one of the following for *rtype*:
467467

468468
- ``(Presentation,)`` for constructing a :any:`Presentation` over words of
469469
the same type as that in *s*.

docs/source/main-algorithms/froidure-pin/to-froidure-pin.rst

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -22,8 +22,8 @@ This page contains documentation relating to converting
2222
Various uses
2323
------------
2424

25-
Recall that the signature for the :any:`to` function is ``to(*args, Return)``.
26-
In what follows, we explain how different values of *args* and *Return* may be
25+
Recall that the signature for the :any:`to` function is ``to(*args, rtype)``.
26+
In what follows, we explain how different values of *args* and *rtype* may be
2727
used to construct :any:`FroidurePin` objects. The following options are
2828
possible:
2929

@@ -44,7 +44,7 @@ following values for *args*:
4444
- **cong** (:any:`Congruence`) -- the :any:`Congruence` object being
4545
converted.
4646

47-
Additionally, specify the following for *Return*:
47+
Additionally, specify the following for *rtype*:
4848

4949
- ``(FroidurePin,)`` for constructing a :any:`FroidurePin`.
5050

@@ -88,7 +88,7 @@ values for *args*:
8888

8989
- **k** (:any:`Kambites`) -- the :any:`Kambites` object being converted.
9090

91-
Additionally, specify the following for *Return*:
91+
Additionally, specify the following for *rtype*:
9292

9393
- ``(FroidurePin,)`` for constructing a :any:`FroidurePin`.
9494

@@ -138,7 +138,7 @@ following values for *args*:
138138
- **kb** (:any:`KnuthBendix`) -- the :any:`KnuthBendix` object being
139139
converted.
140140

141-
Additionally, specify the following for *Return*:
141+
Additionally, specify the following for *rtype*:
142142

143143
- ``(FroidurePin,)`` for constructing a :any:`FroidurePin`.
144144

@@ -182,7 +182,7 @@ following values for *args*:
182182
- **tc** (:any:`ToddCoxeter`) -- the :any:`ToddCoxeter` object being
183183
converted.
184184

185-
Additionally, specify the following for *Return*:
185+
Additionally, specify the following for *rtype*:
186186

187187
- ``(FroidurePin,)`` for constructing a :any:`FroidurePin`.
188188

@@ -235,7 +235,7 @@ or
235235
- **last** (:any:`int`) -- the value of :math:`b` in the following
236236
discussion.
237237

238-
Additionally, specify the following for *Return*:
238+
Additionally, specify the following for *rtype*:
239239

240240
- ``(FroidurePin,)`` for constructing a :any:`FroidurePin`.
241241

docs/source/main-algorithms/knuth-bendix/to-knuth-bendix.rst

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -22,8 +22,8 @@ This page contains documentation relating to converting
2222
Various uses
2323
------------
2424

25-
Recall that the signature for the :any:`to` function is ``to(*args, Return)``.
26-
In what follows, we explain how different values of *args* and *Return* may be
25+
Recall that the signature for the :any:`to` function is ``to(*args, rtype)``.
26+
In what follows, we explain how different values of *args* and *rtype* may be
2727
used to construct :any:`KnuthBendix` objects. The following options are
2828
possible:
2929

@@ -44,7 +44,7 @@ rewriter, specify all of the following values for *args*:
4444
- **tc** (:any:`ToddCoxeter`) -- the :any:`ToddCoxeter` object being
4545
converted.
4646

47-
Additionally, specify the following for *Return*:
47+
Additionally, specify the following for *rtype*:
4848

4949
- ``(KnuthBendix,)`` for constructing a :any:`KnuthBendix` with the default
5050
rewriter.
@@ -97,7 +97,7 @@ following values for *args*:
9797
- **tc** (:any:`ToddCoxeter`) -- the :any:`ToddCoxeter` object being
9898
converted.
9999

100-
Additionally, specify one of the following for *Return*:
100+
Additionally, specify one of the following for *rtype*:
101101

102102
- ``(KnuthBendix, 'RewriteTrie')`` for constructing a :any:`KnuthBendix`
103103
with the the ``RewriteTrie'`` rewriter.
@@ -152,7 +152,7 @@ following values for *args*:
152152
- **fpb** (:any:`FroidurePin`) -- the :any:`FroidurePin` object being
153153
converted.
154154

155-
Additionally, specify one of the following for *Return*:
155+
Additionally, specify one of the following for *rtype*:
156156

157157
- ``(KnuthBendix, str, 'RewriteTrie')`` for constructing a
158158
:any:`KnuthBendix` on words with type ``str`` using the ``RewriteTrie'``

docs/source/main-algorithms/todd-coxeter/to-todd-coxeter.rst

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -22,8 +22,8 @@ This page contains documentation relating to converting
2222
Various uses
2323
------------
2424

25-
Recall that the signature for the :any:`to` function is ``to(*args, Return)``.
26-
In what follows, we explain how different values of *args* and *Return* may be
25+
Recall that the signature for the :any:`to` function is ``to(*args, rtype)``.
26+
In what follows, we explain how different values of *args* and *rtype* may be
2727
used to construct :any:`ToddCoxeter` objects. The following options are
2828
possible:
2929

@@ -44,7 +44,7 @@ following values for *args*:
4444
converted; and
4545
- **wg** (:any:`WordGraph`) -- the left or right Cayley graph of *fpb*.
4646

47-
Additionally, specify one of the following for *Return*:
47+
Additionally, specify one of the following for *rtype*:
4848

4949
- ``(ToddCoxeter, str)`` for constructing a :any:`ToddCoxeter` on words with
5050
type ``str``.
@@ -103,7 +103,7 @@ following values for *args*:
103103
- **kb** (:any:`KnuthBendix`) -- the :any:`KnuthBendix` object being
104104
converted.
105105

106-
Additionally, specify the following for *Return*:
106+
Additionally, specify the following for *rtype*:
107107

108108
- ``(ToddCoxeter,)`` for constructing a :any:`ToddCoxeter`.
109109

0 commit comments

Comments
 (0)