# HG changeset patch # User František Kučera # Date 1604180164 -3600 # Node ID 137f63652fa206eab9ca01773d8801ad9980fc95 # Parent fce3d6290c40befffcbdb48001ae843f4caa5dee formatting, don't → do not diff -r fce3d6290c40 -r 137f63652fa2 relpipe-data/classic-example.xml --- 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 @@

The great parts

- The authors of cat, grep, cut or tr programs don't have to know anything about catsn.b. the cat in the command name is a different cat than in our text file and dogs and our business domain. + The authors of cat, grep, cut or tr programs do not have to know anything about catsn.b. the cat in the command name is a different cat than in our text file 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.

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

@@ -94,11 +94,11 @@ YELLOW WHITE]]> -

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 doggish color.

+

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 doggish color.

This problem is caused by the fact that the grep dog filters lines containing the word dog 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.

@@ -117,10 +117,10 @@

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. the color must not contain a space character (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 \; is not a separator but a part of the field value) + So we must invent some kind of escaping (like \; is not a separator but a part of the field value) 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.