aboutsummaryrefslogtreecommitdiff
path: root/mathcomp/algebra/poly.v
diff options
context:
space:
mode:
authorAnton Trunov2018-11-27 12:17:47 +0100
committerAnton Trunov2018-12-04 12:43:20 +0100
commit8c82657e7692049dde4a4c44a2ea53d0c4fa7cb5 (patch)
treec973a8517cb257f127c60299e86d3f553ba51462 /mathcomp/algebra/poly.v
parentadd6e85884691faef1bf8742e803374815672cc2 (diff)
Document parameter names whenever possible
As suggested by @ggonthier [here](https://github.com/math-comp/math-comp/pull/249#pullrequestreview-177938295) > One of the design ideas for the `Arguments` command was that it would allow to centralise the documentation of the application of constants. In that spirit it would be in my opinion better to make as much use of this as possible, and to document the parameter names whenever possible, especially that of implicit parameters. and [here](https://github.com/math-comp/math-comp/pull/253#discussion_r237434163): > As a general rule, defined functional constants should have maximal prenex implicit arguments, as this facilitates their use as arguments to functionals, because this mimics the way function constants are treated in functional programming languages with Hindley-Milner type inference. Conversely, lemmas and theorems should have on-demand implicit arguments, possibly interspersed with explicit ones, as it's fairly common for other lemmas to have universally quantified premises; also, this makes it easier to specify such arguments with the apply: tactic. This policy may be amended for lemmas that are used as functional arguments, such as reflection or cancellation lemmas. Unfortunately there is currently no easy way to tell Coq to use different defaults for definitions and lemmas, so MathComp sticks to the on-demand default, as there are significantly more lemmas than definition, and use the Prenex Implicits to redress matters in bulk for definitions. However, this is not completely systematic, and is sometimes omitted for constants that are not used as functional arguments in the library, or inside the sections in which the definition occur, since such commands need to be repeated after the section is closed. Since Arguments commands should document the intended constant usage as best as possible, they should follow the implicits policy - even in cases such as this where the Prenex Implicits had been skipped.
Diffstat (limited to 'mathcomp/algebra/poly.v')
-rw-r--r--mathcomp/algebra/poly.v8
1 files changed, 4 insertions, 4 deletions
diff --git a/mathcomp/algebra/poly.v b/mathcomp/algebra/poly.v
index 34174bf..929c313 100644
--- a/mathcomp/algebra/poly.v
+++ b/mathcomp/algebra/poly.v
@@ -146,9 +146,9 @@ End Polynomial.
(* directives take effect. *)
Bind Scope ring_scope with poly_of.
Bind Scope ring_scope with polynomial.
-Arguments polyseq _ _%R.
-Arguments poly_inj _ _%R _%R _.
-Arguments coefp_head _ _ _%N _%R.
+Arguments polyseq {R} p%R.
+Arguments poly_inj {R} [p1%R p2%R] : rename.
+Arguments coefp_head {R} h i%N p%R.
Notation "{ 'poly' T }" := (poly_of (Phant T)).
Notation coefp i := (coefp_head tt i).
@@ -2430,7 +2430,7 @@ Qed.
End MapFieldPoly.
-Arguments map_poly_inj {F R} f [x1 x2].
+Arguments map_poly_inj {F R} f [p1 p2] : rename.
Section MaxRoots.