1UNFTRIP(1)                      Unftrip Manual                      UNFTRIP(1)
2
3
4

NAME

6       unftrip - normalize Unicode text
7

SYNOPSIS

9       unftrip [--ascii] [--encoding=VAL] [--unicode-version] [OPTION]… [FILE]
10

DESCRIPTION

12       unftrip inputs Unicode text from stdin and rewrites it to stdout
13       according to a specified Unicode normalization form (see UAX 15).
14
15       If no normalization form is specified the character stream is left
16       intact.
17
18       Invalid byte sequences in the input are reported on stderr and replaced
19       by the Unicode replacement character (U+FFFD) in the output.
20

NORMALIZATION

22       --nfc
23           Normalization Form C (NFC), canonical decomposition followed by
24           canonical composition.
25
26       --nfd
27           Normalization Form D (NFD), canonical decomposition.
28
29       --nfkc
30           Normalization form KC (NFKC), compatibility decomposition followed
31           by canonical composition.
32
33       --nfkd
34           Normalization form KD (NFKD), compatibility decomposition.
35

ARGUMENTS

37       FILE (absent=-)
38           The input file. Reads from stdin if unspecified.
39

OPTIONS

41       -a, --ascii
42           Output the input text as newline (U+000A) separated Unicode scalar
43           values written in the US-ASCII charset.
44
45       -e VAL, --encoding=VAL
46           Input encoding, must one of UTF-8, UTF-16, UTF-16LE, UTF-16BE,
47           ASCII or latin1. If unspecified the encoding is guessed. The output
48           encoding is the same as the input encoding except for ASCII and
49           latin1 where UTF-8 is output.
50
51       --unicode-version
52           Output supported Unicode version.
53

COMMON OPTIONS

55       --help[=FMT] (default=auto)
56           Show this help in format FMT. The value FMT must be one of auto,
57           pager, groff or plain. With auto, the format is pager or plain
58           whenever the TERM env var is dumb or undefined.
59
60       --version
61           Show version information.
62

EXIT STATUS

64       unftrip exits with one of the following values:
65
66       0   no error occurred
67
68       1   a command line parsing error occurred
69
70       2   the input text was malformed
71
72       0   on success.
73
74       123 on indiscriminate errors reported on standard error.
75
76       124 on command line parsing errors.
77
78       125 on unexpected internal errors (bugs).
79

BUGS

81       This program is distributed with the Uunf OCaml library. See
82       http://erratique.ch/software/uunf for contact information.
83
84
85
86Unftrip v15.0.0                                                     UNFTRIP(1)