Merge bug notes into README

README

@@ -4,17 +4,36 @@ Fast Food Bash library
 ffood - Fast Food - a Bash Library
 
 
-BUGS
-----
+NOTES
+-----
 
-  * *core.debug():* if `debug -v "x*:` is used, `x*` apparently tries to match
-    match *filenames* first, and only if there is no match, it goes on to
-    match variable names.  This does not seem to affect `@`, though.
+ *  if `debug -v "x*:` is used, `x*` apparently tries to match
+    *filenames* first, and only if there is no match, it goes
+    on to match variable names.  This does not seem to affect
+    `@`, though.
 
-    Probably some eval pitfall.  For now I'll just remove `*`.  If somebody
-    can fix it, we can re-add it.
+    Probably some eval pitfall.  For now I'll just remove `*`.
+    If somebody can fix it, we can re-add it.
 
-    On the other hand, I don't even understand how `*` should exactly behave
-    compared to `@`, so having it disabled does not seem like such a loss.
-    And by the way, did you know that the eval is evil?  So in the end, maybe
-    we should not have this feature in the first place... :)
+    On the other hand, I don't even understand how `*` should
+    exactly behave compared to `@`, so having it disabled does
+    not seem like such a loss.  And by the way, did you know
+    that the eval is evil?  So in the end, maybe we should not
+    have this feature in the first place... :)
+
+ *  debug_pipe and all `while read`-based commands will throw
+    away last line if there is no newline at the end.
+
+    This is "fixed" by adding at least one all-matching `grep`
+    command before the while loop.
+
+ *  iniread: when same key is found in eg. /etc/ffood/ffood.ini
+    and ~/.ffood.ffood.ini, output is concatenated.  If you
+    want the value be rather overriden, you can simply add
+    `-1` to limit output to the last one.
+
+    Problem is this the workaround obviously won't work for
+    multi-line values since they are represented as multiple
+    keys.
+
+    It's not yet decided what should be the behavior.

doc/BUGS.md

@@ -1,8 +0,0 @@
-Bugs
-====
-
-*   debug_pipe and all `while read`-based commands will throw away
-    last line if there is no newline at the end.
-
-    This is "fixed" by adding at least one (possibly all-matching)
-    `grep` command before the while loop

notes/BUGS.md

@@ -1,10 +0,0 @@
-BUGS
-====
-
-  * iniread: when same key is found in e.g. /etc/ffood.ffood.ini
-    and ~/.ffood.ffood.ini, output is concatenated.  If you want
-    the value be rather overriden, you can simply add `-1` to
-    limit output to the last one but that obviously won't work
-    for multi-line values.
-
-    It's not yet decided what should be the behavior.