Rework the README and the ChangeLog

2 files changed, 15 insertions, 18 deletions

diff --git a/ChangeLog b/ChangeLog
index a6e9935..13d916e 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -5,6 +5,8 @@
     in numbered mode has been fixed
   + The PgUp/PgDn moves have been fixed and improved in the presence of
     excluded words
+  + The height of the windows when a message is present is now correctly
+    calculated
   + The SIGINT signal handling is working properly now
   + A vt100 terminal is assumed when the environment variable TERM
     is unset
diff --git a/README.rst b/README.rst
index b8618ae..c6660f0 100644
--- a/README.rst
+++ b/README.rst
@@ -4,22 +4,25 @@ What is it?
 ===========
 **smenu** is a selection filter just like ``sed`` is an editing filter.
 
-This simple tool reads words from the standard input, presents them in
-a cool interactive window after the current line on the terminal and writes
-the selected word, if any, on the standard output.
+This tool takes words from standard input or from a file and presents
+them on the screen in different layouts in a scrolling window.
+A cursor that you can easily move lets you select one or more of them.
 
-After having unsuccessfully searched the NET for what I wanted, I
-decided to try to write my own.
+Note that the screen is not previously cleared when the scrolling window
+of **smenu** is displayed.
 
-I have tried hard to made its usage as simple as possible. It should
-work, even when using an old ``vt100`` terminal and is ``UTF-8`` aware.
+I tried to make its use as simple as possible. It supports the ``UTF-8``
+encoding and should work on all terminals managed by the ``terminfo``
+database.
+
+Please use the included man page to learn more about this little program.
 
 The wiki (https://github.com/p-gen/smenu/wiki) contains screenshots and
-animations that detail some of the concepts and features of smenu.
+animations that detail some of the concepts and features of **smenu**.
 
 How to build it?
 ================
-**smenu** can be built on every system where a working ``terminfo``
+**smenu** can be built on any system on which a working ``terminfo``
 development platform is available. This includes every Unix and
 Unix-like system I am aware of.
 
@@ -72,10 +75,6 @@ A cursor should be under ``"VmHWM "``.
 After having moved the cursor to ``"      136 kB"`` and ended the program
 with ``<Enter>``, the shell variable R should contain: ``"      136 kB"``.
 
-.. raw:: pdf
-
-  PageBreak
-
 Unix example.
 -------------
 The following command, which is Unix brand agnostic, should give you a
@@ -117,7 +116,7 @@ The included testing system is relatively young, please be indulgent.
 
 **NOTE** on some systems like \*BSD some tests may fail. This can be
 explained by differences in posix/libc/... implementations.  This can
-notably occur when some specific regular expressions or uncommon UTF-8
+notably occur when some specific regular expressions or uncommon ``UTF-8``
 byte sequences are used.
 
 If a test fails for unknown reason, then please send me its directory
@@ -128,7 +127,3 @@ test in the ``tests`` directory in an existing or new directory: read the
 ``tests/README.rst`` file, use an existing test as model, create an
 ``.in`` file and a ``.tst`` file and send them to me as well as the
 produced files.
-
-Interested?
------------
-Please use the included man page to learn more about this little program.