summaryrefslogtreecommitdiff
path: root/misc/README
diff options
context:
space:
mode:
authorAlbrecht Schlosser <albrechts.fltk@online.de>2018-12-10 16:50:56 +0100
committerAlbrecht Schlosser <albrechts.fltk@online.de>2018-12-10 16:50:56 +0100
commit745828154547e0dbd635afb9fae469eac37a255a (patch)
tree98f5264fd76dbfa1d6c513a176903e83d6f179a1 /misc/README
parent810b91471761e3d1736ed79de06b4c8a69125b30 (diff)
Rename README files to README.txt (and several similar files).
Files without '.txt' suffix can't be handled well by Windows (users), hence renaming such text files to *.txt makes FLTK more "Windows-friendly". There are a few exceptions (this is intentional): README and other files in bundled libraries (maintained upstream) are not changed.
Diffstat (limited to 'misc/README')
-rw-r--r--misc/README109
1 files changed, 0 insertions, 109 deletions
diff --git a/misc/README b/misc/README
deleted file mode 100644
index 189aaf9b8..000000000
--- a/misc/README
+++ /dev/null
@@ -1,109 +0,0 @@
-//
-// $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.).
-
-Detailed file description:
-
-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, Windows copepage 1252, or Mac OS Roman
-characters would be. They should look identical as the image file (cp1252.png)
-or MacRoman_utf-8.png, resp., 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 0x80 - 0x9F (U+0080 - U+009F) are empty.
-
-Mac OS Roman is the Apple Mac native character set before it became Unicode
-by default (OS X). The corresponding files are ordered as they would appear
-with the native character set / encoding.
-
-The *.html files contain a character encoding meta tag, so that they should
-be viewable with all standard browsers. They can be used for cut'n'paste and
-drag'n'drop tests from a 'native' application (browser) to FLTK, e.g.
-test/editor or test/input.
-
-Special Notes:
-
- 0x22 (U+0022: "quotation mark") is doubled intentionally. This has been
- done for better results in test/editor, because otherwise the rest of the
- file would be shown in blue color (as a comment).
-
- 0x98 (U+02DC: "small tilde") may not display correctly on Windows systems.
- I saw the same effect with other Windows editors as well. The following
- characters may be displayed "shifted left" by one position. Seems to work
- correctly on Linux (with UTF-8 encoding).
-
- Mac OS Roman: 0xF0 (U+F8FF: "Apple logo") may not be printable, depending
- on installed fonts on other systems.
-
- There may currently be drawing artefacts when moving the cursor forwards
- and/or backwards over some "special" characters.
-
-References:
-
- http://unicode.org/Public/MAPPINGS/ISO8859/8859-1.TXT
- http://unicode.org/Public/MAPPINGS/VENDORS/MICSFT/WINDOWS/CP1252.TXT
- http://unicode.org/Public/MAPPINGS/VENDORS/APPLE/ROMAN.TXT
- http://en.wikipedia.org/wiki/Mac_OS_Roman
-
-Files:
-
-The first two files are images of how it should look:
-
- cp1252.png full Windows Codepage 1252 (Western)
- MacRoman_utf-8.png full Mac OS Roman character set (w/o Apple logo)
-
-The following four 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
- cp1252.html native (Windows) encoding, use with any browser
- cp1252_utf-8.html UTF-8 encoding, use with any browser
-
-The following two files contain only the ISO-8859-1 subset:
-
- iso-8859-1.txt native (Windows) encoding, suitable for FLTK 1.1
- iso-8859-1_utf-8.txt UTF-8 encoding, suitable for FLTK 1.3 and greater
-
-The following file contains the full Mac OS Roman character set:
-
- MacRoman_utf-8.txt UTF-8 encoding, suitable for FLTK 1.3 and greater
- (use cp1252.txt with FLTK 1.1 on Mac OS instead)
-
-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 future code reformatting !
-
-//
-// End of $Id$.
-//