Merge "Document usage of verbatim expressions"
diff --git a/kalamar.queries.dict b/kalamar.queries.dict
index 5192f8a..dc54a8c 100644
--- a/kalamar.queries.dict
+++ b/kalamar.queries.dict
@@ -17,6 +17,7 @@
complexre => '[orth="l(au|ie)fen"/xi]',
complexlemma => '[base=Baum]',
complexplural => '[mate/m=number:pl]',
+ complexverbatim => '[orth=\'http://www.ids-mannheim.de/cosmas2/projekt/\']',
neg1 => '[pos!=ADJA]',
neg2 => '[!pos=ADJA]',
span => '<corenlp/c=NP>',
diff --git a/templates/de/doc/ql/poliqarp-plus.html.ep b/templates/de/doc/ql/poliqarp-plus.html.ep
index c1d9120..1da6013 100644
--- a/templates/de/doc/ql/poliqarp-plus.html.ep
+++ b/templates/de/doc/ql/poliqarp-plus.html.ep
@@ -44,6 +44,7 @@
<blockquote class="warning">
<p>Achtung: Diese Art von Abfragen (mit vorangestellten <code>.*</Code> Ausdrücken) können extrem langsam sein!</p>
+ <p>In der ursprünglichen Poliqarp-Implementation konnten sowohl doppelte Anführungszeichen als auch einfache Anführungszeichen reguläre Ausdrücke markieren. In Poliqarp+ hingegen werden einfache Anführungszeichen für zeichengetreue Ausdrücke verwendet.</p>
</blockquote>
<p>Sie können das <code>/i</code> Flag erneut anwenden, um unabhängig von Groß-Kleinschreibung zu suchen.</p>
@@ -86,6 +87,10 @@
%= doc_query poliqarp => loc('Q_poliqarp_complexplural', '** [mate/m=number:pl]'), cutoff => 1
+ <p>Falls eine Annotation Sonderzeichen enthält, sorgen umschließende einfache Anführungszeichen für eine zeichengetreue Interpretation.</p>
+
+ %= doc_query poliqarp => loc('Q_poliqarp_complexverbatim', '** [mate/o=\'This is an annotation with space characters\']'), cutoff => 1
+
<h4>Negation</h4>
<p>Die Negation von Termen in komplexen Ausdrücken kann durch Voranstellen eines Ausrufezeichens vor dem Gleichheitszeichen oder dem gesamten Term ausgedrückt werden.</p>
diff --git a/templates/doc/ql/poliqarp-plus.html.ep b/templates/doc/ql/poliqarp-plus.html.ep
index 6d7a58e..a020b45 100644
--- a/templates/doc/ql/poliqarp-plus.html.ep
+++ b/templates/doc/ql/poliqarp-plus.html.ep
@@ -44,6 +44,7 @@
<blockquote class="warning">
<p>Beware: Queries with prepended <code>.*</code> expressions can become extremely slow!</p>
+ <p>In the original Poliqarp specification, regular expressions can be marked both by double quotes and single quotes. In Poliqarp+ only double quotes are used for regular expressions, while single quotes are used to mark verbatim strings.</p>
</blockquote>
<p>You can again apply the <code>/i</code> flag to regular expressions to search case insensitive.</p>
@@ -84,6 +85,10 @@
%= doc_query poliqarp => loc('Q_poliqarp_complexplural', '** [mate/m=number:pl]'), cutoff => 1
+ <p>In case an annotation contains special non-alphabetic and non-numeric characters, the annotation part can be surrounded by single quotes to ensure a verbatim interpretation:</p>
+
+ %= doc_query poliqarp => loc('Q_poliqarp_complexverbatim', '** [mate/o=\'This is an annotation with space characters\']'), cutoff => 1
+
<h4>Negation</h4>
<p>Negation of terms in complex expressions can be expressed by prepending the equal sign or the whole expression with an exclamation mark.</p>