]> matita.cs.unibo.it Git - helm.git/blobdiff - helm/software/matita/help/C/matita.xml
new documentation for the decompose tactic
[helm.git] / helm / software / matita / help / C / matita.xml
index 7f90e51b93536fc7f6c1e3d3cd3073008c060fc1..7f259909b70e2f612044b4e42ad265f112561ba8 100644 (file)
@@ -1,21 +1,50 @@
 <?xml version="1.0"?>
-<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
-    "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
-  <!ENTITY legal SYSTEM "legal.xml">
-  <!ENTITY appversion "0.0">
-  <!ENTITY manrevision "0.0">
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
+"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
+
+  <!ENTITY license SYSTEM "legal.xml">
+  <!ENTITY install SYSTEM "sec_install.xml">
+  <!ENTITY gettingstarted SYSTEM "sec_gettingstarted.xml">
+  <!ENTITY intro SYSTEM "sec_intro.xml">
+  <!ENTITY terms SYSTEM "sec_terms.xml">
+  <!ENTITY tactics SYSTEM "sec_tactics.xml">
+  <!ENTITY tacticals SYSTEM "sec_tacticals.xml">
+  <!ENTITY othercommands SYSTEM "sec_commands.xml">
+  <!ENTITY usernotation SYSTEM "sec_usernotation.xml">
+
+  <!ENTITY manrevision "0">
   <!ENTITY date "February 2006">
   <!ENTITY app "<application>Matita</application>">
   <!ENTITY appname "Matita">
-  <!ENTITY version "0.0">
+  <!ENTITY appversion SYSTEM "version.txt">
+
+  <!ENTITY TODO "<emphasis>TODO</emphasis>">
+  <!ENTITY MYSQL "<application> <ulink type='http'
+      url='http://www.mysql.com'>MySQL</ulink> </application>">
+
+  <!-- Entities for BNF -->
+  <!ENTITY id "<emphasis><link linkend='id'>id</link></emphasis>">
+  <!ENTITY uri "<emphasis><link linkend='uri'>uri</link></emphasis>">
+  <!ENTITY char "<emphasis><link linkend='char'>char</link></emphasis>">
+  <!ENTITY uri-step "<emphasis><link linkend='uri-step'>uri-step</link></emphasis>">
+  <!ENTITY nat "<emphasis><link linkend='nat'>nat</link></emphasis>">
+  <!ENTITY term "<emphasis><link linkend='term'>term</link></emphasis>">
+  <!ENTITY match_pattern "<emphasis><link linkend='match_pattern'>match_pattern</link></emphasis>">
+  <!ENTITY args "<emphasis><link linkend='args'>args</link></emphasis>">
+  <!ENTITY args2 "<emphasis><link linkend='args2'>args2</link></emphasis>">
+  <!ENTITY sterm "<emphasis><link linkend='sterm'>sterm</link></emphasis>">
+  <!ENTITY intros-spec "<emphasis><link linkend='intros-spec'>intros-spec</link></emphasis>">
+  <!ENTITY pattern "<emphasis><link linkend='pattern'>pattern</link></emphasis>">
+  <!ENTITY reduction-kind "<emphasis><link linkend='reduction-kind'>reduction-kind</link></emphasis>">
 ]>
 
-<!-- =============Document Header ============================= -->
-<article id="index" lang="en">
+<?yelp:chunk-depth 3?>
+
+<book id="matita_manual" lang="en">
 <!-- please do not change the id; for translations, change lang to -->
 <!-- appropriate code -->
-<articleinfo>
- <title>&app; Manual V&manrevision;</title>
+<title>&app; V&appversion; Manual (rev. &manrevision;)</title>
+<bookinfo>
 
  <copyright>
   <year>2006</year>
     </publisher> 
 -->
 
-   &legal;
-   <!-- This file  contains link to license for the documentation (GNU FDL), and 
-        other legal stuff such as "NO WARRANTY" statement. Please do not change 
-       any of this. -->
-
     <authorgroup> 
       <author> 
        <firstname>Andrea</firstname> 
        <affiliation> 
          <address> <email>zacchiro@cs.unibo.it</email> </address> 
        </affiliation> 
-      </author> 
+      </author>
+      <author> 
+       <firstname>Ferruccio</firstname> 
+       <surname>Guidi</surname> 
+       <affiliation> 
+         <address> <email>fguidi@cs.unibo.it</email> </address> 
+       </affiliation> 
+      </author>       
 <!-- This is appropriate place for other contributors: translators,
       maintainers,  etc. Commented out by default.
        <othercredit role="translator">
     
 <revhistory>
       <revision> 
-       <revnumber>&appname; Manual V&manrevision;</revnumber> 
+       <revnumber>&appname; V&appversion; Manual (rev. &manrevision;)</revnumber> 
        <date>&date;</date> 
        <revdescription> 
          <para role="author">The HELM team
        </revdescription> 
       </revision>
   <revision>
-   <revnumber>0.0</revnumber>
+   <revnumber>&manrevision;</revnumber>
    <date>4 February 2006</date>
    <authorinitials>HELM</authorinitials>
    <revremark>
 
     <releaseinfo>This manual describes version &appversion; of &appname;.
     </releaseinfo>
+
+    <legalnotice>
+      &license;
+    </legalnotice>
+
     <!-- The following feedback information only applies to appliactions
     listed in bugzilla.gnome.org and bugzilla.ximian.com. For other
     applications, please provide your own feedback info or remove thsi
     section altogether -->
     <legalnotice> 
       <title>Feedback</title> 
-      <para>To report a bug or make a suggestion regarding the &app; application or
-       this manual, follow the directions in the 
-       <ulink url="http://mowgli.cs.unibo.it/bugs"
-         type="help">HELM Bugzilla Page</ulink>. 
+      <para>To report a bug or make a suggestion regarding the &app;
+       application or this manual, follow the directions in the
+       <ulink url="http://bugs.mowgli.cs.unibo.it" type="http">HELM Bug
+         Tracking System Page</ulink>. 
       </para>
 <!-- Translators may also add here feedback address for translations -->
     </legalnotice>
 
-</articleinfo>
-
-  <indexterm zone="index"> 
-    <primary>Matita</primary> 
-  </indexterm>
+</bookinfo>
 
 <!-- ============= Document Body ============================= -->
-<!-- ============= Introduction ============================== -->
-<sect1 id="intro">
- <title>Introduction</title>
- <sect2 id="what">
-  <title>What is Matita?</title>
-  
-  <para>
-  <application>Matita</application> is a proof assistant for ...
-  </para>
-
- </sect2>
-</sect1>
-
-<!-- =========== Terms, declarations and definitions ============ -->
-<sect1 id="terms_decl_def">
- <title>Terms, definitions, declarations and proofs</title>
- <sect2 id="terms">
- <title>Terms</title>
- </sect2>
- <sect2 id="definitions">
- <title>Definitions</title>
- </sect2>
- <sect2 id="declarations">
- <title>Declarations (of inductive types)</title>
- </sect2>
- <sect2 id="proofs">
- <title>Proofs</title>
- </sect2>
-</sect1>
-
-<!-- ============ Tactics ====================== -->
-<sect1 id="tactics">
- <title>Tactics</title>
-
-  <sect2 id="absurd">
-    <title>absurd &lt;term&gt;</title>
-    <para>The tactic <command>absurd</command> </para>
-<para>
-<ulink url="#terms">ciao</ulink>
-</para>
-  </sect2>
-  <sect2 id="apply">
-    <title>apply &lt;term&gt;</title>
-    <para>The tactic <command>apply</command> </para>
-  </sect2>
-  <sect2 id="assumption">
-    <title>assumption</title>
-    <para>The tactic <command>assumption</command> </para>
-  </sect2>
-  <sect2 id="auto">
-    <title>auto [depth=&lt;int&gt;] [width=&lt;int&gt;] [paramodulation] [full]</title>
-    <para>The tactic <command>auto</command> </para>
-  </sect2>
-  <sect2 id="clear">
-    <title>clear &lt;id&gt;</title>
-    <para>The tactic <command>clear</command> </para>
-  </sect2>
-  <sect2 id="clearbody">
-    <title>clearbody &lt;id&gt;</title>
-    <para>The tactic <command>clearbody</command> </para>
-  </sect2>
-  <sect2 id="change">
-    <title>change &lt;pattern&gt; with &lt;term&gt;</title>
-    <para>The tactic <command>change</command> </para>
-  </sect2>
-  <sect2 id="compare">
-    <title>compare &lt;term&gt;</title>
-    <para>The tactic <command>compare</command> </para>
-  </sect2>
-  <sect2 id="constructor">
-    <title>constructor &lt;int&gt;</title>
-    <para>The tactic <command>constructor</command> </para>
-  </sect2>
-  <sect2 id="contradiction">
-    <title>contradiction</title>
-    <para>The tactic <command>contradiction</command> </para>
-  </sect2>
-  <sect2 id="cut">
-    <title>cut &lt;term&gt; [as &lt;id&gt;]</title>
-    <para>The tactic <command>cut</command> </para>
-  </sect2>
-  <sect2 id="decide equality">
-    <title>decide</title>
-    <para>The tactic <command>decide equality</command> </para>
-  </sect2>
-  <sect2 id="decompose">
-    <title>decompose [&lt;ident list&gt;] &lt;ident&gt; [&lt;intros_spec&gt;]</title>
-    <para>The tactic <command>decompose</command> </para>
-  </sect2>
-  <sect2 id="discriminate">
-    <title>discriminate &lt;term&gt;</title>
-    <para>The tactic <command>discriminate</command> </para>
-  </sect2>
-  <sect2 id="elim">
-    <title>elim &lt;term&gt; [using &lt;term&gt;] [&lt;intros_spec&gt;]</title>
-    <para>The tactic <command>elim</command> </para>
-  </sect2>
-  <sect2 id="elimType">
-    <title>elimType &lt;term&gt; [using &lt;term&gt;]</title>
-    <para>The tactic <command>elimType</command> </para>
-  </sect2>
-  <sect2 id="exact">
-    <title>exact &lt;term&gt;</title>
-    <para>The tactic <command>exact</command> </para>
-  </sect2>
-  <sect2 id="exists">
-    <title>exists</title>
-    <para>The tactic <command>exists</command> </para>
-  </sect2>
-  <sect2 id="fail">
-    <title>fail</title>
-    <para>The tactic <command>fail</command> </para>
-  </sect2>
-  <sect2 id="fold">
-    <title>fold &lt;reduction_kind&gt; &lt;term&gt; &lt;pattern&gt;</title>
-    <para>The tactic <command>fold</command> </para>
-  </sect2>
-  <sect2 id="fourier">
-    <title>fourier</title>
-    <para>The tactic <command>fourier</command> </para>
-  </sect2>
-  <sect2 id="fwd">
-    <title>fwd &lt;ident&gt; [&lt;ident list&gt;]</title>
-    <para>The tactic <command>fwd</command> </para>
-  </sect2>
-  <sect2 id="generalize">
-    <title>generalize &lt;pattern&gt; [as &lt;id&gt;]</title>
-    <para>The tactic <command>generalize</command> </para>
-  </sect2>
-  <sect2 id="id">
-    <title>id</title>
-    <para>The tactic <command>id</command> </para>
-  </sect2>
-  <sect2 id="injection">
-    <title>injection &lt;term&gt;</title>
-    <para>The tactic <command>injection</command> </para>
-  </sect2>
-  <sect2 id="intro">
-    <title>intro [&lt;ident&gt;]</title>
-    <para>The tactic <command>intro</command> </para>
-  </sect2>
-  <sect2 id="intros">
-    <title>intros &lt;intros_spec&gt;</title>
-    <para>The tactic <command>intros</command> </para>
-  </sect2>
-  <sect2 id="inversion">
-    <title>intros &lt;term&gt;</title>
-    <para>The tactic <command>intros</command> </para>
-  </sect2>
-  <sect2 id="lapply">
-    <title>lapply [depth=&lt;int&gt;] &lt;term&gt; [to &lt;term list] [using &lt;ident&gt;]</title>
-    <para>The tactic <command>lapply</command> </para>
-  </sect2>
-  <sect2 id="left">
-    <title>left</title>
-    <para>The tactic <command>left</command> </para>
-  </sect2>
-  <sect2 id="letin">
-    <title>letin &lt;ident&gt; ≝ &lt;term&gt;</title>
-    <para>The tactic <command>letin</command> </para>
-  </sect2>
-  <sect2 id="normalize">
-    <title>normalize &lt;pattern&gt;</title>
-    <para>The tactic <command>normalize</command> </para>
-  </sect2>
-  <sect2 id="paramodulation">
-    <title>paramodulation &lt;pattern&gt;</title>
-    <para>The tactic <command>paramodulation</command> </para>
-  </sect2>
-  <sect2 id="reduce">
-    <title>reduce &lt;pattern&gt;</title>
-    <para>The tactic <command>reduce</command> </para>
-  </sect2>
-  <sect2 id="reflexivity">
-    <title>reflexivity</title>
-    <para>The tactic <command>reflexivity</command> </para>
-  </sect2>
-  <sect2 id="replace">
-    <title>replace &lt;pattern&gt; with &lt;term&gt;</title>
-    <para>The tactic <command>replace</command> </para>
-  </sect2>
-  <sect2 id="rewrite">
-    <title>rewrite {&lt;|&gt;} &lt;term&gt; &lt;pattern&gt;</title>
-    <para>The tactic <command>rewrite</command> </para>
-  </sect2>
-  <sect2 id="right">
-    <title>right</title>
-    <para>The tactic <command>right</command> </para>
-  </sect2>
-  <sect2 id="ring">
-    <title>ring</title>
-    <para>The tactic <command>ring</command> </para>
-  </sect2>
-  <sect2 id="simplify">
-    <title>simplify &lt;pattern&gt;</title>
-    <para>The tactic <command>simplify</command> </para>
-  </sect2>
-  <sect2 id="split">
-    <title>split</title>
-    <para>The tactic <command>split</command> </para>
-  </sect2>
-  <sect2 id="symmetry">
-    <title>symmetry</title>
-    <para>The tactic <command>symmetry</command> </para>
-  </sect2>
-  <sect2 id="transitivity">
-    <title>transitivity &lt;term&gt;</title>
-    <para>The tactic <command>transitivity</command> </para>
-  </sect2>
-  <sect2 id="unfold">
-    <title>unfold [&lt;term&gt;] &lt;pattern&gt;</title>
-    <para>The tactic <command>unfold</command> </para>
-  </sect2>
-  <sect2 id="whd">
-    <title>whd &lt;pattern&gt;</title>
-    <para>The tactic <command>whd</command> </para>
-  </sect2>
 
-</sect1>
+&intro;
+&install;
+&gettingstarted;
+&terms;
+&usernotation;
+&tactics;
+&tacticals;
+&othercommands;
 
  <!-- ============= Application License ============================= -->
 
- <sect1 id="license">
+ <chapter id="sec_license">
   <title>License</title>
-  <para>
-   This program is free software; you can redistribute it and/or
-   modify it under the terms of the <citetitle>GNU General Public
-   License</citetitle> as published by the Free Software Foundation;
-   either version 2 of the License, or (at your option) any later
-   version.
-  </para>
-  <para>
-   This program is distributed in the hope that it will be useful, but
-   WITHOUT ANY WARRANTY; without even the implied warranty of
-   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-   <citetitle>GNU General Public License</citetitle> for more details.
-  </para>
-  <para>
-   A copy of the <citetitle>GNU General Public License</citetitle> is
-   included as an appendix to the <citetitle>GNOME Users
-   Guide</citetitle>.  You may also obtain a copy of the
-   <citetitle>GNU General Public License</citetitle> from the Free
-   Software Foundation by visiting <ulink type="http"
-   url="http://www.fsf.org">their Web site</ulink> or by writing to
-   <address>
-    Free Software Foundation, Inc.
-    <street>59 Temple Place</street> - Suite 330
-    <city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode>
-    <country>USA</country>
-   </address>
-  </para>
- </sect1>
-</article>
+  &license;
+ </chapter>
+</book>
 
 <!-- CSC: valid element tags
 <sect1 id="intro"> <title>Introduction</title> ...