From b2213b9fbc56461ef47b971686edbba82a9658bf Mon Sep 17 00:00:00 2001
From: Enrico Tassi <enrico.tassi@inria.fr>
Date: Wed, 6 Jun 2007 09:07:33 +0000
Subject: [PATCH] added doc for compose

---
 matita/help/C/sec_tactics.xml      | 52 ++++++++++++++++++++++++++++++
 matita/help/C/tactics_quickref.xml |  5 +++
 2 files changed, 57 insertions(+)

diff --git a/matita/help/C/sec_tactics.xml b/matita/help/C/sec_tactics.xml
index e03dece5b..0fabbbf7c 100644
--- a/matita/help/C/sec_tactics.xml
+++ b/matita/help/C/sec_tactics.xml
@@ -344,6 +344,58 @@
       </variablelist>
     </para>
   </sect1>
+  <sect1 id="tac_compose">
+    <title>compose</title>
+    <titleabbrev>compose</titleabbrev>
+    <para><userinput>compose n t1 with t2 hyps</userinput></para>
+    <para>
+      <variablelist>
+        <varlistentry role="tactic.synopsis">
+          <term>Synopsis:</term>
+          <listitem>
+            <para><emphasis role="bold">compose</emphasis> [&nat;] &sterm; [<emphasis role="bold">with</emphasis> &sterm;] [&intros-spec;]</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Pre-conditions:</term>
+          <listitem>
+            <para></para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Action:</term>
+          <listitem>
+            <para>Composes t1 with t2 in every possible way
+              <command>n</command> times introducing generated terms
+              as if <command>intros hyps</command> was issued.</para>
+            <para>If <command>t1:∀x:A.B[x]</command> and
+            <command>t2:∀x,y:A.B[x]→B[y]→C[x,y]</command> it generates:
+              <varlistentry>
+                <listitem>
+                  <command>λx,y:A.t2 x y (t1 x) : ∀x,y:A.B[y]→C[x,y]</command> 
+                </listitem>
+                <listitem>
+                  <command>λx,y:A.λH:B[x].t2 x y H (t1 y) : ∀x,y:A.B[x]→C[x,y]
+                  </command>
+                </listitem>
+              </varlistentry>
+          </para>
+          <para>If <command>t2</command> is omitted it composes 
+            <command>t1</command>
+              with every hypothesis that can be introduced.  
+              <command>n</command> iterates the process.</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>New sequents to prove:</term>
+          <listitem>
+            <para>The same, but with more hypothesis eventually introduced
+            by the &intros-spec;.</para>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+    </para>
+  </sect1>
   <sect1 id="tac_change">
     <title>change</title>
     <titleabbrev>change</titleabbrev>
diff --git a/matita/help/C/tactics_quickref.xml b/matita/help/C/tactics_quickref.xml
index 70d42ac2b..119985dc4 100644
--- a/matita/help/C/tactics_quickref.xml
+++ b/matita/help/C/tactics_quickref.xml
@@ -57,6 +57,11 @@
         <entry>|</entry>
         <entry><link linkend="tac_clearbody"><emphasis role="bold">clearbody</emphasis></link> <emphasis><link linkend="grammar.id">id</link></emphasis></entry>
       </row>
+      <row>
+        <entry/>
+        <entry>|</entry>
+        <entry><link linkend="tac_compose"><emphasis role="bold">compose</emphasis></link> [&nat;] &sterm; [<emphasis role="bold">with</emphasis> &sterm;] [&intros-spec;]</entry>
+      </row>
       <row>
         <entry/>
         <entry>|</entry>
-- 
2.39.2