Debian Codegraph @

manual/intro.xml

raw
1 <?xml version="1.0" encoding="utf-8"?>
2 <!DOCTYPE chapter SYSTEM "docbook-dtd-45/docbookx.dtd">
3
4 <chapter id="intro">
5 <title>Intro</title>
6
7 <section id="caveat">
8 <title>Caveat Emptor</title>
9 <para>
10 <emphasis>
11 This manual should be regarded as a guideline. Some of the features or functionality
12 described is either not implemented yet, or does not work exactly as advertised.
13 A good place to see what is and is not implemented is to run the regression test suite
14 as the test names are indicative of features. The individual tests are also good starting points
15 to find examples on how a specific feature works.
16 </emphasis>
17 </para>
18 </section>
19
20 <section id="whatis">
21 <title>What this is...</title>
22 <para>
23 This document describes the design, features, implementation, usability, etc
24 of an evolution in the <ulink url="http://en.wikipedia.org/wiki/Constraint_Grammar">constraint grammar</ulink> formalism.
25 </para>
26 </section>
27
28 <section id="naming">
29 <title>Naming</title>
30 <para>
31 I have called this version of CG "VISL CG-3" since it implements the functionality of the
32 VISL CG-2 variant of constraint grammar and is a
33 general update of the grammar format and parser features that warrants a version bump.
34 VISL CG-3 is feature-wise backwards compatible with CG-2 and VISLCG, and contains switches
35 to enforce their respective behavior in certain areas.
36 </para>
37 </section>
38
39 <section id="unicode">
40 <title>Unicode</title>
41 <para>
42 Even before any other designing and development had started, the desire to include
43 <ulink url="http://unicode.org/">Unicode</ulink> support was a strong requirement.
44 By default, the codepage for the grammar file, input stream, and output stream is
45 detected from the environment.
46 Internally and through switches there is full support
47 for Unicode and any other encoding known by the Unicode library.
48 I have chosen the <ulink url="http://icu-project.org/">International Components for Unicode</ulink>
49 library as it provides strong cross-platform Unicode support with built-in regular expressions.
50 </para>
51 </section>
52
53 <section id="discussion">
54 <title>Dicussion, Mailing Lists, Bug Reports, etc...</title>
55 <para>
56 All public discussion, feature requests, bug reports, and talk of related technologies happen in
57 the <ulink url="http://groups.google.com/group/constraint-grammar">Constraint Grammar via Google Groups</ulink>.
58 </para>
59 </section>
60 </chapter>