README: add Bugs section, similarly to a man page.

* README.md: New section, Bugs.

1 files changed, 15 insertions, 0 deletions

diff --git a/README.md b/README.md
index 83e808a..97f8abf 100644
--- a/README.md
+++ b/README.md
@@ -167,3 +167,18 @@ See the license block at the bottom of the file.
 The second clause says that any binary code (as if that would
 exist for shell customization code, ha!) is not required to
 carry any copyright notice.
+
+# Bugs
+
+1. When `basta.fullscreen` programs are used in a pipeline, whose
+   other elements write to the terminal, those elements are not
+   in the full screen context; their output may appear messed up.
+   For instance `basta.fullscreen git log | cat`. The `cat`
+   program executes asynchronously with regard to `basta.fullscreen`,
+   producing output even while that function prepares the terminal
+   in order to restore the status line.
+
+2. Some impossible to solve race conditions situations in which
+   Basta queries the terminal for information (like the current
+   cursor position) and the user types input at around the same time.
+   From time to time, there are glitches.