From e0c6872cf40896c7be36b11dcc744620f10adf1d Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Mon, 2 Sep 2019 13:46:59 +0900 Subject: Initial commit --- support/utf2any/README | 109 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 109 insertions(+) create mode 100644 support/utf2any/README (limited to 'support/utf2any/README') diff --git a/support/utf2any/README b/support/utf2any/README new file mode 100644 index 0000000000..d8b700227d --- /dev/null +++ b/support/utf2any/README @@ -0,0 +1,109 @@ + ++===========+ +| utf2any | ++===========+ + +utf2any translates a file encoded in UTF-7 or UTF-8 (Unicode) into any +7- or 8-bit text format. Currently, mapping tables are supplied for +LaTeX, HTML, iso-8859-1, iso-8859-15 and rfc-1345. These tables don't +provide a complete mapping, but they can be easily extended to personal +needs. + +Usage: utf2any -7|-8 [-f mapfile] [-v] [-w] [infile] + + -7 : Input is UTF-7 + -8 : Input is UTF-8 + -f : File with definitions of the symbol mappings + -v : Verbose + -w : Warning messages + +If multiple -f options are given, the files are processed in turn. +If name of mapfile has no path, it will be search for in: + 1. current directory + 2. compiled-in default directory +If no -f option is given, a default mapping will be used. + +If no infile is given, the program will read from stdin. + + +Syntax of symbol map file: +-------------------------- + +Empty lines, and lines starting with a hash (#) are ignored. + + +Another mapfile can be included: + + I filename + +If filename does not contain a path, it will be searched for in the +following directories: + 1. current directory + 2. the same directory as the file this map was included from + + +A default mapping for a range of characters can be defined as follows: + + D first last size format + D first last action + +first: Unicode number of first symbol in default range +last: Unicode number of last symbol in default range +size: this should be one of: uchar unsigned ulong +format: a format given to the C printf function to display the symbol. + The format receives one argument: the code number. This number will be + cast to one of: + (unsigned char) if size equals uchar + (unsigned) if size equals unsigned + (long unsigned) if size equals ulong +action: one of: + #ECHO# : print the character as is, only possible for codes up to 255 + #SKIP# : don't print anything + #SPACE# : print a space + +Numbers can be given as: + + Unicode type number: hexadecimal number with prefix U+ + decimal + octal: number with prefix 0 + hexadecimal: number with prefix 0x + + +Default ranges take lower precedence than explicit codes (see below), +accept in the range 0 to 255, where they overwrite explicit definitions. +To be safe, define all default mappings before explicit mappings. + + +Explicit mapping, a number followed by a string: + + number action + number string + +number: a Unicode number, in the same format as with default ranges +action: the same as with default ranges +string: a literal string + + ++===========+ +| utfcode | ++===========+ + +utfcode translates one or more Unicode numbers into UTF-7 and/or UTF-8. + +Usage: utfcode [-7|-8] [number...] + + -7 : utf-7 only + -8 : utf-8 only + +Numbers can be given in the same format as in the mapfiles for utf2any. + + +==================================== + +(c) Peter Kleiweg 2000 +http://www.let.rug.nl/~kleiweg/ + +This is free software; you can redistribute it and/or modify it under +the terms of the GNU General Public License as published by the Free +Software Foundation; either version 2, or (at your option) any later +version. -- cgit v1.2.3