Skip to content

Commit f8bc02f

Browse files
committed
Add docstring about determinism of roots
1 parent 0aea29c commit f8bc02f

File tree

1 file changed

+8
-0
lines changed

1 file changed

+8
-0
lines changed

src/sage/rings/polynomial/polynomial_element.pyx

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2309,6 +2309,14 @@ cdef class Polynomial(CommutativePolynomial):
23092309
used for polynomials over finite fields. If not ``None`` only returns
23102310
irreducible factors of ``self`` whose degree divides ``ext_degree``.
23112311
2312+
.. NOTE::
2313+
2314+
Any root is non-deterministic when finding linear roots of a polynomial
2315+
over the base ring. However, if ``degree`` is greater than one, or `ring`
2316+
is an extension of the base ring, then eventually the root is found by
2317+
returning a single root after factorisation. Roots found in this way are
2318+
deterministic. This may change in the future.
2319+
23122320
EXAMPLES::
23132321
23142322
sage: # needs sage.rings.finite_rings

0 commit comments

Comments
 (0)