Added test files for UTF-8 character testing (use test/editor).

See the README file for more info.


git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@7514 ea41ed52-d2ee-0310-a9c1-e6b18d33e121

7 files changed, 170 insertions, 2 deletions

diff --git a/misc/README b/misc/README
new file mode 100644
index 000000000..f36f6ae02
--- /dev/null
+++ b/misc/README
@@ -0,0 +1,72 @@
+// $Id$
+//
+// Miscellaneous files for developers:
+//
+
+Developer files for testing UTF-8 character sets and functions:
+================================================================================
+
+Open these files in test/editor and compare the contents.
+
+Test scrolling, move the cursor over the "special" characters (> U+007F),
+watch cursor movement, drawing artefacts, etc..
+
+CAUTION: Do not 'cat' these files unless you know what you're doing.
+Especially the cp1252* files can contain control characters that may freeze
+your screen (xterm etc.). 
+
+
+The "native" encoded files contain 8-bit characters with binary values that
+can be seen at the top and left borders, resp. (add both). They should look
+like the image file (cp1252.png) on Windows only (if the current codepage is
+"Western, CP 1252", a superset of ISO-8859-1). They will look different with
+other codepages or on Linux, Unix, or Mac OS X. Use these files with FLTK 1.1
+or an editor with the corresponding codepage or locale.
+
+The UTF-8 encoded files should be usable with FLTK 1.3, FLTK 2, or FLTK 3
+(future). They contain UTF-8 encoded characters at the table positions,
+where the corresponding ISO-8859-1 or Windows copepage 1252 characters would
+be. They should look identical as the image file (cp1252.png) on all UTF-8
+capable systems.
+
+The files with names iso-8859-1_* contain only the ISO-8859-1 subset, i.e.
+the colums with character codes x'80' - x'9F' (U+0080 - U+009F) are empty.
+
+References:
+
+  http://unicode.org/Public/MAPPINGS/ISO8859/8859-1.TXT
+  http://unicode.org/Public/MAPPINGS/VENDORS/MICSFT/WINDOWS/CP1252.TXT
+
+Files:
+
+The first file is an image of how it should look:
+
+ cp1252.png		full Windows Codepage 1252 (Western)
+
+The following two files contain the full Windows Codepage 1252:
+
+ cp1252.txt		native (Windows) encoding, suitable for FLTK 1.1
+ cp1252_utf-8.txt	UTF-8 encoding, suitable for FLTK 1.3 and greater
+
+The following two files contain only the ISO-8859-1 characters:
+
+ iso-8859-1.txt
+ iso-8859-1_utf-8.txt
+
+
+
+Other developer support files:
+================================================================================
+
+  doxystar.cxx		Use this to reformat doxygen comments (test only).
+
+	Compile with:	g++ -o doxystar doxystar.cxx
+	
+	Usage:		cat file | doxystar
+
+  DO NOT USE this for current code development!
+  It is intended for testing of for future code reformatting !
+
+//
+// End of $Id$.
+//
diff --git a/misc/cp1252.png b/misc/cp1252.png
new file mode 100644
index 000000000..79d0a876a
--- /dev/null
+++ b/misc/cp1252.png
diff --git a/misc/cp1252.txt b/misc/cp1252.txt
new file mode 100644
index 000000000..77209bf7c
--- /dev/null
+++ b/misc/cp1252.txt
@@ -0,0 +1,24 @@
++--------------------------------------------------------------------------+
+| dec. ->|   0  16  32  48  64  80  96 112 128 144 160 176 192 208 224 240 |
+|  v |hex|   0   1   2   3   4   5   6   7   8   9   A   B   C   D   E   F |
++----+---+-----------------------------------------------------------------+
+|  0 | 0 |  NUL DLE      0   @   P   `   p   �       �   �   �   �   �   � |
+|  1 | 1 |  SOH DC1  !   1   A   Q   a   q       �   �   �   �   �   �   � |
+|  2 | 2 |  STX DC2  ""  2   B   R   b   r   �   �   �   �   �   �   �   � |
+|  3 | 3 |  ETX DC3  #   3   C   S   c   s   �   �   �   �   �   �   �   � |
+|  4 | 4 |  EOT DC4  $   4   D   T   d   t   �   �   �   �   �   �   �   � |
+|  5 | 5 |  ENQ NAK  %   5   E   U   e   u   �   �   �   �   �   �   �   � |
+|  6 | 6 |  ACK SYN  &   6   F   V   f   v   �   �   �   �   �   �   �   � |
+|  7 | 7 |  BEL ETB  '   7   G   W   g   w   �   �   �   �   �   �   �   � |
+|  8 | 8 |  BS  CAN  (   8   H   X   h   x   �   �   �   �   �   �   �   � |
+|  9 | 9 |  HT  EM   )   9   I   Y   i   y   �   �   �   �   �   �   �   � |
+| 10 | A |  LF  SUB  *   :   J   Z   j   z   �   �   �   �   �   �   �   � |
+| 11 | B |  VT  ESC  +   ;   K   [   k   {   �   �   �   �   �   �   �   � |
+| 12 | C |  FF  FS   ,   <   L   \   l   |   �   �   �   �   �   �   �   � |
+| 13 | D |  CR  GS   -   =   M   ]   m   }           �   �   �   �   �   � |
+| 14 | E |  SO  RS   .   >   N   ^   n   ~   �   �   �   �   �   �   �   � |
+| 15 | F |  SI  US   /   ?   O   _   o  DEL      �   �   �   �   �   �   � |
++----+---+-----------------------------------------------------------------+
+
+File:		cp1252.txt
+Encoding:	Windows CP 1252 (aka "ansi", western, ...)
diff --git a/misc/cp1252_utf-8.txt b/misc/cp1252_utf-8.txt
new file mode 100644
index 000000000..14ef81da7
--- /dev/null
+++ b/misc/cp1252_utf-8.txt
@@ -0,0 +1,24 @@
++--------------------------------------------------------------------------+
+| dec. ->|   0  16  32  48  64  80  96 112 128 144 160 176 192 208 224 240 |
+|  v |hex|   0   1   2   3   4   5   6   7   8   9   A   B   C   D   E   F |
++----+---+-----------------------------------------------------------------+
+|  0 | 0 |  NUL DLE      0   @   P   `   p   €           °   À   Ð   à   ð |
+|  1 | 1 |  SOH DC1  !   1   A   Q   a   q       ‘   ¡   ±   Á   Ñ   á   ñ |
+|  2 | 2 |  STX DC2  ""  2   B   R   b   r   ‚   ’   ¢   ²   Â   Ò   â   ò |
+|  3 | 3 |  ETX DC3  #   3   C   S   c   s   ƒ   “   £   ³   Ã   Ó   ã   ó |
+|  4 | 4 |  EOT DC4  $   4   D   T   d   t   „   ”   ¤   ´   Ä   Ô   ä   ô |
+|  5 | 5 |  ENQ NAK  %   5   E   U   e   u   …   •   ¥   µ   Å   Õ   å   õ |
+|  6 | 6 |  ACK SYN  &   6   F   V   f   v   †   –   ¦   ¶   Æ   Ö   æ   ö |
+|  7 | 7 |  BEL ETB  '   7   G   W   g   w   ‡   —   §   ·   Ç   ×   ç   ÷ |
+|  8 | 8 |  BS  CAN  (   8   H   X   h   x   ˆ   ˜   ¨   ¸   È   Ø   è   ø |
+|  9 | 9 |  HT  EM   )   9   I   Y   i   y   ‰   ™   ©   ¹   É   Ù   é   ù |
+| 10 | A |  LF  SUB  *   :   J   Z   j   z   Š   š   ª   º   Ê   Ú   ê   ú |
+| 11 | B |  VT  ESC  +   ;   K   [   k   {   ‹   ›   «   »   Ë   Û   ë   û |
+| 12 | C |  FF  FS   ,   <   L   \   l   |   Œ   œ   ¬   ¼   Ì   Ü   ì   ü |
+| 13 | D |  CR  GS   -   =   M   ]   m   }           ­   ½   Í   Ý   í   ý |
+| 14 | E |  SO  RS   .   >   N   ^   n   ~   Ž   ž   ®   ¾   Î   Þ   î   þ |
+| 15 | F |  SI  US   /   ?   O   _   o  DEL      Ÿ   ¯   ¿   Ï   ß   ï   ÿ |
++----+---+-----------------------------------------------------------------+
+
+File:		cp1252_utf8.txt
+Encoding:	UTF-8
diff --git a/misc/doxystar.cxx b/misc/doxystar.cxx
index bc3abdbe5..f5fd26974 100644
--- a/misc/doxystar.cxx
+++ b/misc/doxystar.cxx
@@ -1,5 +1,5 @@
 //
-// "$Id: doxystar.cxx 6615 2009-01-01 16:35:13Z matt $"
+// "$Id$"
 //
 // Doxygen pre-formatting program for the Fast Light Tool Kit (FLTK).
 //
@@ -98,5 +98,5 @@ int main(int argc, char **argv) {
 }
 
 //
-// End of "$Id: doxystar.cxx 6615 2009-01-01 16:35:13Z matt $".
+// End of "$Id$".
 //
diff --git a/misc/iso-8859-1.txt b/misc/iso-8859-1.txt
new file mode 100644
index 000000000..2e99b04ac
--- /dev/null
+++ b/misc/iso-8859-1.txt
@@ -0,0 +1,24 @@
++--------------------------------------------------------------------------+
+| dec. ->|   0  16  32  48  64  80  96 112 128 144 160 176 192 208 224 240 |
+|  v |hex|   0   1   2   3   4   5   6   7   8   9   A   B   C   D   E   F |
++----+---+-----------------------------------------------------------------+
+|  0 | 0 |  NUL DLE      0   @   P   `   p               �   �   �   �   � |
+|  1 | 1 |  SOH DC1  !   1   A   Q   a   q           �   �   �   �   �   � |
+|  2 | 2 |  STX DC2  ""  2   B   R   b   r           �   �   �   �   �   � |
+|  3 | 3 |  ETX DC3  #   3   C   S   c   s           �   �   �   �   �   � |
+|  4 | 4 |  EOT DC4  $   4   D   T   d   t           �   �   �   �   �   � |
+|  5 | 5 |  ENQ NAK  %   5   E   U   e   u           �   �   �   �   �   � |
+|  6 | 6 |  ACK SYN  &   6   F   V   f   v           �   �   �   �   �   � |
+|  7 | 7 |  BEL ETB  '   7   G   W   g   w           �   �   �   �   �   � |
+|  8 | 8 |  BS  CAN  (   8   H   X   h   x           �   �   �   �   �   � |
+|  9 | 9 |  HT  EM   )   9   I   Y   i   y           �   �   �   �   �   � |
+| 10 | A |  LF  SUB  *   :   J   Z   j   z           �   �   �   �   �   � |
+| 11 | B |  VT  ESC  +   ;   K   [   k   {           �   �   �   �   �   � |
+| 12 | C |  FF  FS   ,   <   L   \   l   |           �   �   �   �   �   � |
+| 13 | D |  CR  GS   -   =   M   ]   m   }           �   �   �   �   �   � |
+| 14 | E |  SO  RS   .   >   N   ^   n   ~           �   �   �   �   �   � |
+| 15 | F |  SI  US   /   ?   O   _   o DEL           �   �   �   �   �   � |
++----+---+-----------------------------------------------------------------+
+
+File:		iso-8859-1.txt
+Encoding:	Windows CP 1252 (aka "ansi", western, ISO-8859-1)
diff --git a/misc/iso-8859-1_utf-8.txt b/misc/iso-8859-1_utf-8.txt
new file mode 100644
index 000000000..05b1bd276
--- /dev/null
+++ b/misc/iso-8859-1_utf-8.txt
@@ -0,0 +1,24 @@
++--------------------------------------------------------------------------+
+| dec. ->|   0  16  32  48  64  80  96 112 128 144 160 176 192 208 224 240 |
+|  v |hex|   0   1   2   3   4   5   6   7   8   9   A   B   C   D   E   F |
++----+---+-----------------------------------------------------------------+
+|  0 | 0 |  NUL DLE      0   @   P   `   p               °   À   Ð   à   ð |
+|  1 | 1 |  SOH DC1  !   1   A   Q   a   q           ¡   ±   Á   Ñ   á   ñ |
+|  2 | 2 |  STX DC2  ""  2   B   R   b   r           ¢   ²   Â   Ò   â   ò |
+|  3 | 3 |  ETX DC3  #   3   C   S   c   s           £   ³   Ã   Ó   ã   ó |
+|  4 | 4 |  EOT DC4  $   4   D   T   d   t           ¤   ´   Ä   Ô   ä   ô |
+|  5 | 5 |  ENQ NAK  %   5   E   U   e   u           ¥   µ   Å   Õ   å   õ |
+|  6 | 6 |  ACK SYN  &   6   F   V   f   v           ¦   ¶   Æ   Ö   æ   ö |
+|  7 | 7 |  BEL ETB  '   7   G   W   g   w           §   ·   Ç   ×   ç   ÷ |
+|  8 | 8 |  BS  CAN  (   8   H   X   h   x           ¨   ¸   È   Ø   è   ø |
+|  9 | 9 |  HT  EM   )   9   I   Y   i   y           ©   ¹   É   Ù   é   ù |
+| 10 | A |  LF  SUB  *   :   J   Z   j   z           ª   º   Ê   Ú   ê   ú |
+| 11 | B |  VT  ESC  +   ;   K   [   k   {           «   »   Ë   Û   ë   û |
+| 12 | C |  FF  FS   ,   <   L   \   l   |           ¬   ¼   Ì   Ü   ì   ü |
+| 13 | D |  CR  GS   -   =   M   ]   m   }           ­   ½   Í   Ý   í   ý |
+| 14 | E |  SO  RS   .   >   N   ^   n   ~           ®   ¾   Î   Þ   î   þ |
+| 15 | F |  SI  US   /   ?   O   _   o DEL           ¯   ¿   Ï   ß   ï   ÿ |
++----+---+-----------------------------------------------------------------+
+
+File:		iso-8859-1_utf-8.txt
+Encoding:	UTF-8