From 62bed6778e71eba0472b64d1db18a2f856d8fed7 Mon Sep 17 00:00:00 2001
From: Sam Hocevar <sam@hocevar.net>
Date: Thu, 27 Nov 2003 09:38:16 +0000
Subject: [PATCH]   * NOTES: added information about colour support.

---
 NOTES        | 38 ++++++++++++++++++++++++++++++++++++++
 README       |  2 ++
 debian/rules |  4 ++--
 3 files changed, 42 insertions(+), 2 deletions(-)
 create mode 100644 NOTES

diff --git a/NOTES b/NOTES
new file mode 100644
index 0000000..26f9947
--- /dev/null
+++ b/NOTES
@@ -0,0 +1,38 @@
+$Id$
+
+   o  Colour does not work with all backends and all terminals. I tested
+      many terminal emulators and tried to summarise which combinations
+      worked properly and which ones did not.
+
+   o  In an XTerm terminal, the following shell commands output all possible
+      foreground/background combinations:
+
+      for fgpre in "" '\e[0;1m'; do for fg in 0 4 2 6 1 5 3 7; do
+        for bgpre in 4 10; do
+          echo -ne "$fgpre"'\e[3'$fg'm'
+          for bg in 0 4 2 6 1 5 3 7; do echo -ne '\e['$bgpre$bg'm# '; done
+          echo -ne '\e[0;0m '
+        done
+        echo ''
+      done; echo ''; done
+
+      Successfully tested
+
+   o  ncurses:
+
+      * bright combinations work in the following terminals:
+
+        - Linux console (TERM=linux)
+        - pterm (TERM=xterm)
+
+      * bright text on bright background is rendered as bright text on
+        normal background in the following terminals:
+
+        - xterm (TERM=xterm)
+        - gnome-terminal (TERM=xterm)
+
+   o  S-Lang:
+
+   o  MS-DOS: all bright colours, bright backgrounds, and bright combinations
+      work using <conio.h>.
+
diff --git a/README b/README
index 61d293c..c21d085 100644
--- a/README
+++ b/README
@@ -15,6 +15,8 @@ Building libcaca
 
 Using libcaca
 
+   o  Look into the examples/ directory for simple source code examples.
+
    o  Compiling a libcaca program is fairly simple:
 
       gcc -c foobar.c -o foobar.o `caca-config --cflags`
diff --git a/debian/rules b/debian/rules
index cc78e32..5c1ec81 100755
--- a/debian/rules
+++ b/debian/rules
@@ -60,8 +60,8 @@ binary-arch: build install
 	dh_testdir
 	dh_testroot
 #	dh_installdebconf	
-	dh_installdocs README BUGS TODO AUTHORS NEWS -pcaca-utils
-	dh_installdocs README BUGS TODO AUTHORS NEWS -plibcaca-dev
+	dh_installdocs README BUGS TODO AUTHORS NEWS NOTES -pcaca-utils
+	dh_installdocs README BUGS TODO AUTHORS NEWS NOTES -plibcaca-dev
 #	dh_installexamples
 	dh_installmenu
 #	dh_installemacsen