Skip to content

Commit 2f890e7

Browse files
author
Release Manager
committed
sagemathgh-39366: Add documentation to LaurentSeries point to accessors I feel it's originally too undiscoverable. Since `f` and `n` are explicitly mentioned in the documentation I think it's a good idea to mention how to access it programmatically. ### 📝 Checklist <!-- Put an `x` in all the boxes that apply. --> - [x] The title is concise and informative. - [x] The description explains in detail what this PR is about. - [ ] I have linked a relevant issue or discussion. - [x] I have created tests covering the changes. - [x] I have updated the documentation and checked the documentation preview. ### ⌛ Dependencies <!-- List all open PRs that this PR logically depends on. For example, --> <!-- - sagemath#12345: short description why this is a dependency --> <!-- - sagemath#34567: ... --> URL: sagemath#39366 Reported by: user202729 Reviewer(s): Kwankyu Lee
2 parents 238de86 + 7002dbd commit 2f890e7

File tree

1 file changed

+10
-9
lines changed

1 file changed

+10
-9
lines changed

src/sage/rings/laurent_series_ring_element.pyx

Lines changed: 10 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,12 @@
1-
"""
1+
r"""
22
Laurent Series
33
4+
Laurent series in Sage are represented internally as a power of the variable
5+
times the power series part. If a Laurent series `f` is represented as
6+
`f = t^n \cdot u` where `t` is the variable and `u` has nonzero constant term,
7+
`u` can be accessed through :meth:`~LaurentSeries.valuation_zero_part` and `n`
8+
can be accessed through :meth:`~LaurentSeries.valuation`.
9+
410
EXAMPLES::
511
612
sage: R.<t> = LaurentSeriesRing(GF(7), 't'); R
@@ -35,11 +41,6 @@ Saving and loading.
3541
sage: loads(K.dumps()) == K # needs sage.rings.real_mpfr
3642
True
3743
38-
IMPLEMENTATION: Laurent series in Sage are represented internally
39-
as a power of the variable times the unit part (which need not be a
40-
unit - it's a polynomial with nonzero constant term). The zero
41-
Laurent series has unit part 0.
42-
4344
AUTHORS:
4445
4546
- William Stein: original version
@@ -89,8 +90,8 @@ cdef class LaurentSeries(AlgebraElement):
8990
r"""
9091
A Laurent Series.
9192
92-
We consider a Laurent series of the form `t^n \cdot f` where `f` is a
93-
power series.
93+
We consider a Laurent series of the form `f = t^n \cdot u` where `u` is a
94+
power series with nonzero constant term.
9495
9596
INPUT:
9697
@@ -1301,7 +1302,7 @@ cdef class LaurentSeries(AlgebraElement):
13011302
sage: g.valuation()
13021303
0
13031304
1304-
Note that the valuation of an element undistinguishable from
1305+
Note that the valuation of an element indistinguishable from
13051306
zero is infinite::
13061307
13071308
sage: h = f - f; h

0 commit comments

Comments
 (0)