<chapter id="sec_gettingstarted">
<title>Getting started</title>
- <para> If you are already familiar with the Calculus of (co)Inductive
+ <para> If you are already familiar with the Calculus of (Co)Inductive
Constructions (CIC) and with interactive theorem provers with procedural
proof languages (expecially Coq), getting started with Matita is relatively
easy. You just need to learn how to type Unicode symbols, how to browse
<sect1 id="unicode">
<title>How to type Unicode symbols</title>
- Unicode characters can be typed in several ways:
+ <para>Unicode characters can be typed in several ways:</para>
<itemizedlist>
- <listitem>Using the "Shift+Ctrl+Unicode code" standard
- Gnome shortcut. E.g. Shift+Ctrl+3a9 generates "Ω".
+ <listitem><para>Using the "Ctrl+Shift+Unicode code" standard Gnome shortcut. E.g. Ctrl+Shift+3a9 generates "Ω".</para>
</listitem>
- <listitem>Typing the ligature "\name" where "name"
- is a standard Unicode or LaTeX name for the character. Pressing
- "Alt+L" just after the last character of the name converts
- the ligature to the Unicode symbol. This operation is
- not required since Matita understands also the "\name"
- sequences. E.g. "\Omega" followed by Alt+L generates
- "Ω".
+ <listitem><para>Typing the ligature "\name" where "name"
+ is a standard Unicode or LaTeX name for the character or an
+ ASCII art resembling the shape of the character. Pressing
+ "Alt+L" or Space or Enter just after the last character
+ of the name converts
+ the ligature to the Unicode symbol.
+ E.g. "\Delta" followed by Alt+L generates
+ "Δ", while pressing Alt-L after "=>" generates
+ "⇒"</para>
</listitem>
- <listitem>Typing one of the following ligatures (and opzionally converting
- the ligature to the Unicode character has described before):
- ":=" (which stands for ≝); "->" (which stands for "→"); "=>" (which stands for "⇒").
+ <listitem>
+ <para>Typing a symbol and rotating trough its equivalence class
+ with Alt-L. E.g. pressing Alt-L after an "l"
+ generates a "λ", while pressing Alt-L after an
+ "→" once generates "⇉" and pressing
+ Alt-L again generates "⇒".
+ </para>
</listitem>
</itemizedlist>
+ <para>
+ The comprehensive list of symbols names or shortcuts and their equivalence
+ classes is available clicking on the "TeX/UTF-8 table" item
+ of the "View" menu.
+ </para>
+ <para>
+ There is a memory mechanism related to equivalence classes that
+ remembers your last choice, making it the default one. For example,
+ if you use "_" to generate "⎻"
+ (that is the third choice, after "⎽" and "⎼"),
+ the next time you type Alt-L
+ after "_" you immediately get "⎻".
+ </para>
</sect1>
<sect1 id="cicbrowser">
<title>Browsing and searching</title>
an action in the drop down menu right of it.</para>
<sect3 id="locate">
<title>Searching by name</title>
- &TODO;
- </sect3>
+ <para> &TODO;</para>
+ </sect3>
<sect3 id="hint">
<title>List of lemmas that can be applied</title>
- &TODO;
- </sect3>
+ <para> &TODO;</para>
+ </sect3>
<sect3 id="match">
<title>Searching by exact match</title>
- &TODO;
- </sect3>
+ <para> &TODO;</para>
+ </sect3>
<sect3 id="elim">
<title>List of elimination principles for a given type</title>
- &TODO;
- </sect3>
+ <para> &TODO;</para>
+ </sect3>
<sect3 id="instance">
<title>Searching by instantiation</title>
- &TODO;
- </sect3>
+ <para> &TODO;</para>
+ </sect3>
</sect2>
</sect1>
<sect1 id="authoring">
<title>Authoring</title>
- <sect2 id="developments">
- <title>How to use developments</title>
- &TODO;
+ <sect2 id="compilation">
+ <title>How to compile a script</title>
+ <para>
+ Scripts are compiled to base URIs. Base URIs are of the form
+ "cic:/matita/path" and are given once for all for a set
+ of scripts using the "root" file.
+ </para>
+ <para>
+ A "root" file has to be placed in the root of a script set,
+ for example, consider the following files and directories, and
+ assume you keep files in "list" separated from files
+ in "sort" (for example the former directory may contain
+ functions and proofs about lists, while latter sorting algorithms
+ for lists):
+<programlisting><![CDATA[
+ list/
+ list.ma (* depending just on the standard library *)
+ utils/
+ swap.ma (* including list.ma *)
+ sort/
+ qsort.ma (* including utils/swap.ma *)
+]]></programlisting>
+ To be able to compile properly the contents of "list"
+ a file called root has to be placed in it. The file should be like
+ the following snippet.
+<programlisting><![CDATA[
+ baseuri=cic:/matita/mydatastructures
+]]></programlisting>
+ This file tells &appname; that objects generated by
+ "list.ma" have to be placed in
+ "cic:/matita/mydatastructures/list" while
+ objects generated by
+ "swap.ma" have to be placed in
+ "cic:/matita/mydatastructures/utils/swap".
+ </para>
+ <para>
+ Once you created the root file, you must generate a depend file.
+ Enter the "list" directory (the root of yuor file set)
+ and type "matitadep". Remember to regenerate the depend file
+ every time you alter the dependencies of your files (for example
+ including other scripts).
+ You can now compile you files typing "matitac".
+ </para>
+ <para>
+ To compile the "sort" directory, create a root file
+ in "sort/" like the following one and then run
+ "matitadep".
+<programlisting><![CDATA[
+ baseuri=cic:/matita/myalgorithms
+ include_paths=../list
+]]></programlisting>
+ The include_paths field can declare a list of paths separated by space.
+ Please omit any "/" from the end of base URIs or paths.
+ </para>
+ </sect2>
+ <sect2 id="authoringinterface">
+ <title>The authoring interface</title>
+ <para>&TODO;</para>
</sect2>
- &TODO;
- </sect1>
+ </sect1>
</chapter>
+
projects / helm.git / blobdiff