aboutsummaryrefslogtreecommitdiff
path: root/README
blob: 6e57e6dc3c15a45bbd78d506c3b17282d365cf0d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
uxd (UTF-8-aware Hex Dumper)

uxd is a hex dump utility that's aware of UTF-8 multibyte sequence
semantics, and uses colorized output to indicate which byte
sequences go with which human-readable characters.

uxd should compile and run on any modern POSIX-ish system. It's
developed on Linux, and has been tested on Mac OS X. It's written in
ANSI/ISO C89 and uses no libraries other than the standard C library.
The Makefile should be compatible with any make utility (does not use
GNU or BSD specific constructs).

To install, use "make install" as root. This will put the binary
in /usr/bin and the gzipped man page in /usr/man/man1. To adjust
the install paths, use the standard make variables PREFIX, DESTDIR,
BINDIR, DESTDIR, etc. See the top of the Makefile for the full list.
Installation isn't required: the binary doesn't depend on any other
files at runtime, and can just be copied somewhere on your $PATH.

See uxd.rst for full documentation, or (after installation), "man uxd".