| 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> |