--- a/relpipe-data/classic-example.xml Thu Oct 22 01:51:32 2020 +0200
+++ b/relpipe-data/classic-example.xml Sat Oct 31 22:36:04 2020 +0100
@@ -49,12 +49,12 @@
<h2>The great parts</h2>
<p>
- The authors of <code>cat</code>, <code>grep</code>, <code>cut</code> or <code>tr</code> programs don't have to know anything about cats<m:podČarou>n.b. the cat in the command name is a different cat than in our text file</m:podČarou> and dogs and our business domain.
+ The authors of <code>cat</code>, <code>grep</code>, <code>cut</code> or <code>tr</code> programs do not have to know anything about cats<m:podČarou>n.b. the cat in the command name is a different cat than in our text file</m:podČarou> and dogs and our business domain.
They can focus on their tasks which are reading files, filtering by regular expressions, doing some substrings and text conversions. And they do it well without being distracted by any animals.
</p>
<p>
- And we don't have to know anything about the low-level programming in the C language or compile anything.
+ And we do not have to know anything about the low-level programming in the C language or compile anything.
We just simply build a pipeline in a shell (e.g. GNU Bash) from existing programs and focus on our business logic.
And we do it well without being distracted by any low-level issues.
</p>
@@ -94,11 +94,11 @@
YELLOW
WHITE]]></pre>
- <p>Which is really unexpected and unwanted result. We don't have a RED dog and this is just an accident. The same would happen if we have a monkey of a <em>doggish</em> color.</p>
+ <p>Which is really unexpected and unwanted result. We do not have a RED dog and this is just an accident. The same would happen if we have a monkey of a <em>doggish</em> color.</p>
<p>
This problem is caused by the fact that the <code>grep dog</code> filters lines containing the word <em>dog</em> regardless its position (first, second or third field).
- Sometimes we could avoid such problems by a bit more complicated regular expression and/or by using Perl, but our pipeline wouldn't be as simple and legible as before.
+ Sometimes we could avoid such problems by a bit more complicated regular expression and/or by using Perl, but our pipeline would not be as simple and legible as before.
</p>
<p>
@@ -117,10 +117,10 @@
<p>
Which is definitively wrong because the second turtle is not LIGHT, it is LIGHT GREEN.
- This problem is caused by the fact that we don't have a well-defined separators between fields.
+ This problem is caused by the fact that we do not have a well-defined separators between fields.
Sometimes we could avoid such problems by restrictions/presumptions e.g. <em>the color must not contain a space character</em> (we could replace spaces by hyphens).
Or we could use some other field delimiter e.g. ; or | or ,. But still we would not be able to use such character in the field values.
- So we must invent some kind of escaping (like <code>\;</code> is not a separator but a part of the field value)
+ So we must invent some kind of escaping (like <i><code>\;</code> is not a separator but a part of the field value</i>)
or add some quotes/apostrophes (which still requires escaping, because what if we have e.g. name field containing an apostrophe?).
And parsing such inputs by classic tools and regular expressions is not easy and sometimes even not possible.
</p>