Trac #34920: Fix description of inputs of primes.

[Eloitor]

Fix docstring of the primes function.

📚 Description

The documentation of primes states that "stop" is optional and "start" is required, when in fact it is the opposite.

Closes #34920

📝 Checklist

• I have made sure that the title is self-explanatory and the description concisely explains the PR.
• I have linked an issue or discussion.
• I have created tests covering the changes.
• I have updated the documentation accordingly.

⌛ Dependencies

[trevorkarn]

I see your point mathematically. On the other hand, stop is actually an optional argument in the code sense. Should you change the argument to the function rather than changing the docs?

Then see this SO post for keeping the user interface the same.

[Eloitor]

Should I change the signature to primes(start=2, stop=None, proof=None) ?

[trevorkarn]

Thats what I was thinking.

[trevorkarn]

Now let's wait for the tests to run and pass.

[github-actions]

Documentation preview for this PR is ready! 🎉
Built with commit: 4c2010c

[codecov-commenter]

Codecov Report

Patch coverage: 100.00% and project coverage change: +0.01 🎉

Comparison is base (52a81cb) 88.57% compared to head (4c2010c) 88.58%.

Additional details and impacted files

@@             Coverage Diff             @@
##           develop   #35215      +/-   ##
===========================================
+ Coverage    88.57%   88.58%   +0.01%     
===========================================
  Files         2140     2140              
  Lines       397273   397273              
===========================================
+ Hits        351891   351935      +44     
+ Misses       45382    45338      -44     

Impacted Files	Coverage Δ
src/sage/arith/misc.py	90.99% <100.00%> (ø)
...e/combinat/cluster_algebra_quiver/mutation_type.py	50.11% <0.00%> (-2.02%)	⬇️
src/sage/modular/local_comp/liftings.py	98.33% <0.00%> (-1.67%)	⬇️
src/sage/groups/generic.py	88.34% <0.00%> (-0.68%)	⬇️
src/sage/modular/modform/numerical.py	94.19% <0.00%> (-0.65%)	⬇️
src/sage/doctest/forker.py	80.24% <0.00%> (-0.54%)	⬇️
src/sage/doctest/reporting.py	74.45% <0.00%> (-0.44%)	⬇️
src/sage/modular/arithgroup/arithgroup_perm.py	92.57% <0.00%> (-0.38%)	⬇️
src/sage/modular/overconvergent/hecke_series.py	98.76% <0.00%> (-0.31%)	⬇️
src/sage/graphs/graph_plot.py	84.33% <0.00%> (-0.29%)	⬇️
... and 18 more

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

☔ View full report at Codecov.
📢 Do you have feedback about the report comment? Let us know in this issue.

[trevorkarn]

LGTM.