X-Git-Url: http://matita.cs.unibo.it/gitweb/?a=blobdiff_plain;f=helm%2Fsoftware%2Fmatita%2Fhelp%2FC%2Fsec_terms.xml;h=add3ba750bf181683c65ae473be1269cc745377c;hb=2bd3b029f7f67d9c616b7756278573cc9e96510c;hp=dd2af7f5fe09596c922865c7f25e456cefb29de2;hpb=26778a467329055d706f9b8d9d6869f17186e453;p=helm.git
diff --git a/helm/software/matita/help/C/sec_terms.xml b/helm/software/matita/help/C/sec_terms.xml
index dd2af7f5f..add3ba750 100644
--- a/helm/software/matita/help/C/sec_terms.xml
+++ b/helm/software/matita/help/C/sec_terms.xml
@@ -5,65 +5,123 @@
Syntax
To describe syntax in this manual we use the following conventions:
- Non terminal symbols are emphasized and have a link to their definition. E.g.: &term;
- Terminal symbols are in bold. E.g.: theorem
- Optional sequences of elements are put in square brackets.
- E.g.: [in &term;]
- Alternatives are put in square brakets and they are separated
- by vertical bars. E.g.: [<|>]
- Repetition of sequences of elements are given by putting the
- first sequence in square brackets, that are followed by three dots.
- E.g.: [and &term;]â¦
+ Non terminal symbols are emphasized and have a link to their
+ definition. E.g.: &term;
+ Terminal symbols are in bold. E.g.:
+ theorem
+ Optional sequences of elements are put in square brackets.
+ E.g.: [in &term;]
+ Alternatives are put in square brakets and they are
+ separated by vertical bars. E.g.: [<|>]
+ Repetitions of a sequence of elements are given by putting the
+ sequence in square brackets, that are followed by three dots. The empty
+ sequence is a valid repetition.
+ E.g.: [and &term;]â¦
+ Characters belonging to a set of characters are given
+ by listing the set elements in square brackets. Hyphens are used to
+ specify ranges of characters in the set.
+ E.g.: [a-zA-Z0-9_-]
Terms & co.
Lexical conventions
-
-
-
-
-
- &id;
- ::=
- â©â©&TODO;âªâª
-
-
-
-
-
-
-
-
-
- &nat;
- ::=
- â©â©&TODO;âªâª
-
-
-
-
-
-
-
-
-
- &uri;
- ::=
- â©â©&TODO;âªâª
-
-
-
-
+
+ qstring
+
+
+
+ &qstring;
+ ::=
+ "â©â©any sequence of characters excluded "âªâª"
+
+
+
+
+
+ id
+
+
+
+ &id;
+ ::=
+ â©â©any sequence of letters, underscores or valid XML digits prefixed by a latin letter ([a-zA-Z]) and post-fixed by a possible empty sequence of decorators ([?'`])âªâª
+
+
+
+
+
+ nat
+
+
+
+ &nat;
+ ::=
+ â©â©any sequence of valid XML digitsâªâª
+
+
+
+
+
+ char
+
+
+
+ &char;
+ ::=
+ [a-zA-Z0-9_-]
+
+
+
+
+
+ uri-step
+
+
+
+ &uri-step;
+ ::=
+ &char;[&char;]â¦
+
+
+
+
+
+ uri
+
+
+
+ &uri;
+ ::=
+ [cic:/|theory:/]&uri-step;[/&uri-step;]â¦.&id;[.&id;]â¦[#xpointer(&nat;/&nat;[/&nat;]â¦)]
+
+
+
+
Terms
-
-
-
+
+
+
+
+
+
+ Terms
+
- &term;
+ &term;
::=
&sterm;
simple or delimited term
@@ -107,11 +165,10 @@
|
- let
- [co]rec
- &id; [&id;|(&id;[,&term;]⦠:&term;)]⦠[on &nat;]
- [: &term;]
- â &term;
+
+ let
+ [co]rec
+ &rec_def;
(co)recursive definitions
@@ -119,10 +176,7 @@
- [and
- [&id;|(&id;[,&term;]⦠:&term;)]⦠[on &nat;]
- [: &term;]
- â &term;]â¦
+ [and &rec_def;]â¦
@@ -140,16 +194,34 @@
â¦
user provided notation
+
+ &rec_def;
+ ::=
+
+ &id; [&id;|(&id;[,&term;]⦠:&term;)]â¦
+
+
+
+
+
+
+
+ [on &id;]
+ [: &term;]
+ â &term;]
+
+
+
-
-
-
+
+ Simple terms
+
- &sterm;
+ &sterm;
::=
(&term;)
@@ -182,6 +254,12 @@
Set
the impredicate sort of datatypes
+
+
+ |
+ CProp
+ one fixed predicative sort of constructive propositions
+
|
@@ -218,11 +296,9 @@
[
- &match_pattern; â &term;
- [
- |
- &match_pattern; â &term;
- ]â¦]
+ &match_branch;[|&match_branch;]â¦
+ ]
+
@@ -241,12 +317,12 @@
-
-
-
+
+ Arguments
+
- &args;
+ &args;
::=
_[: &term;]
@@ -273,16 +349,34 @@
(&id;[,&id;]â¦[: &term;])
+
+ &args2;
+ ::=
+ &id;
+
+
+
+
+ |
+ (&id;[,&id;]â¦: &term;)
+
+
-
-
-
+
+ Pattern matching
+
-
- &match_pattern;
+
+ &match_branch;
+ ::=
+ &match_pattern; â &term;
+
+
+
+ &match_pattern;
::=
&id;
0-ary constructor
@@ -296,6 +390,7 @@
+
@@ -303,13 +398,13 @@
Definitions and declarations
- axiom &id;: &term;
+ axiom &id;: &term;
axiom
axiom H: P
H is declared as an axiom that states P
- definition &id;[: &term;] [â &term;]
+ definition &id;[: &term;] [â &term;]
definition
definition f: T â t
f is defined as t;
@@ -323,16 +418,63 @@
Notice that the command is equivalent to theorem f: T â t.
- [co]inductive &id; (of inductive types)
+ [inductive|coinductive] &id; [&args2;]⦠: &term; â [|] [&id;:&term;] [| &id;:&term;]â¦
+[with &id; : &term; â [|] [&id;:&term;] [| &id;:&term;]â¦]â¦
+
(co)inductive types declaration
- &TODO;
+ inductive i x y z: S â k1:T1 | ⦠| kn:Tn with i' : S' â k1':T1' | ⦠| km':Tm'
+ Declares a family of two mutually inductive types
+ i and i' whose types are
+ S and S', which must be convertible
+ to sorts.
+ The constructors ki of type Ti
+ and ki' of type Ti' are also
+ simultaneously declared. The declared types i and
+ i' may occur in the types of the constructors, but
+ only in strongly positive positions according to the rules of the
+ calculus.
+ The whole family is parameterized over the arguments x,y,z.
+ If the keyword coinductive is used, the declared
+ types are considered mutually coinductive.
+ Elimination principles for the record are automatically generated
+ by Matita, if allowed by the typing rules of the calculus according to
+ the sort S. If generated,
+ they are named i_ind, i_rec and
+ i_rect according to the sort of their induction
+ predicate.
+
+
+ record &id; [&args2;]⦠: &term; â{[&id; [:|:>] &term;] [;&id; [:|:>] &term;]â¦}
+ record
+ record id x y z: S â { f1: T1; â¦; fn:Tn }
+ Declares a new record family id parameterized over
+ x,y,z.
+ S is the type of the record
+ and it must be convertible to a sort.
+ Each field fi is declared by giving its type
+ Ti. A record without any field is admitted.
+ Elimination principles for the record are automatically generated
+ by Matita, if allowed by the typing rules of the calculus according to
+ the sort S. If generated,
+ they are named i_ind, i_rec and
+ i_rect according to the sort of their induction
+ predicate.
+ For each field fi a record projection
+ fi is also automatically generated if projection
+ is allowed by the typing rules of the calculus according to the
+ sort S, the type T1 and
+ the definability of depending record projections.
+ If the type of a field is declared with :>,
+ the corresponding record projection becomes an implicit coercion.
+ This is just syntactic sugar and it has the same effect of declaring the
+ record projection as a coercion later on.
Proofs
- theorem &id;[: &term;] [â &term;]
+ theorem &id;[: &term;] [â &term;]
theorem
theorem f: P â p
Proves a new theorem f whose thesis is
@@ -349,7 +491,7 @@
Notice that the command is equivalent to definition f: T â t.
- variant &id;[: &term;] [â &term;]
+ variant &id;: &term; â &term;
variant
variant f: T â t
Same as theorem f: T â t, but it does not
@@ -357,24 +499,195 @@
an alternative name or proof to a theorem.
- lemma &id;[: &term;] [â &term;]
+ lemma &id;[: &term;] [â &term;]
lemma
lemma f: T â t
Same as theorem f: T â t
- fact &id;[: &term;] [â &term;]
+ fact &id;[: &term;] [â &term;]
fact
fact f: T â t
Same as theorem f: T â t
+
+ Tactic arguments
+ This section documents the syntax of some recurring arguments for
+ tactics.
+
+
+ intros-spec
+
+ intros-spec
+
+
+
+ &intros-spec;
+ ::=
+ [&nat;] [([&id;]â¦)]
+
+
+
+
+ The natural number is the number of new hypotheses to be introduced. The list of identifiers gives the name for the first hypotheses.
+
+
+
+ pattern
+
+ pattern
+
+
+
+ &pattern;
+ ::=
+ in
+ [&id;[: &path;]]â¦
+ [⢠&path;]]
+ simple pattern
+
+
+
+ |
+ in match &term;
+ [in
+ [&id;[: &path;]]â¦
+ [⢠&path;]]
+ full pattern
+
+
+
+
+
+ path
+
+
+
+ &path;
+ ::=
+ â©â©any &sterm; whithout occurrences of Set, Prop, CProp, Type, &id;, &uri; and user provided notation; however, % is now an additional production for &sterm;âªâª
+
+
+
+
+ A path locates zero or more subterms of a given term by mimicking the term structure up to:
+
+ Occurrences of the subterms to locate that are
+ represented by %.
+ Subterms without any occurrence of subterms to locate
+ that can be represented by ?.
+
+
+ For instance, the path
+ â_,_:?.(? ? % ?)â(? ? ? %)
+ locates at once the subterms
+ x+y and x*y in the
+ term âx,y:nat.x+y=1â0=x*y
+ (where the notation A=B hides the term
+ (eq T A B) for some type T).
+
+ A simple pattern extends paths to locate
+ subterms in a whole sequent. In particular, the pattern
+ in H: p K: q ⢠r locates at once all the subterms
+ located by the pattern r in the conclusion of the
+ sequent and by the patterns p and
+ q in the hypotheses H
+ and K of the sequent.
+
+ If no list of hypotheses is provided in a simple pattern, no subterm
+ is selected in the hypothesis. If the ⢠p
+ part of the pattern is not provided, no subterm will be matched in the
+ conclusion if at least one hypothesis is provided; otherwise the whole
+ conclusion is selected.
+
+ Finally, a full pattern is interpreted in three
+ steps. In the first step the match T in
+ part is ignored and a set S of subterms is
+ located as for the case of
+ simple patterns. In the second step the term T
+ is parsed and interpreted in the context of each subterm
+ s â S. In the last term for each
+ s â S the interpreted term T
+ computed in the previous step is looked for. The final set of subterms
+ located by the full pattern is the set of occurrences of
+ the interpreted T in the subterms s.
+
+ A full pattern can always be replaced by a simple pattern,
+ often at the cost of increased verbosity or decreased readability.
+ Example: the pattern
+ ⢠in match x+y in â_,_:?.(? ? % ?)
+ locates only the first occurrence of x+y
+ in the sequent x,y: nat ⢠âz,w:nat. (x+y) * (z+w) =
+ z * (x+y) + w * (x+y). The corresponding simple pattern
+ is ⢠â_,_:?.(? ? (? % ?) ?).
+
+ Every tactic that acts on subterms of the selected sequents have
+ a pattern argument for uniformity. To automatically generate a simple
+ pattern:
+
+ Select in the current goal the subterms to pass to the
+ tactic by using the mouse. In order to perform a multiple selection of
+ subterms, hold the Ctrl key while selecting every subterm after the
+ first one.
+ From the contextual menu select "Copy".
+ From the "Edit" or the contextual menu select
+ "Paste as pattern"
+
+
+
+
+ reduction-kind
+ Reduction kinds are normalization functions that transform a term
+ to a convertible but simpler one. Each reduction kind can be used both
+ as a tactic argument and as a stand-alone tactic.
+
+ reduction-kind
+
+
+
+ &reduction-kind;
+ ::=
+ normalize
+ Computes the βδιζ-normal form
+
+
+
+ |
+ reduce
+ Computes the βδιζ-normal form
+
+
+
+ |
+ simplify
+ Computes a form supposed to be simpler
+
+
+
+ |
+ unfold [&sterm;]
+ δ-reduces the constant or variable if specified, or that
+ in head position
+
+
+
+ |
+ whd
+ Computes the βδιζ-weak-head normal form
+
+
+
+
+
+
+