.TH hex 1 "February, 9, 1998" "GANAware"
.SH NAME
hex \- hexadecimal dump tool (with Japanese support)
.SH SYNOPSIS
.B hex
[
.I options...
] [
.I file
]
.br
.B hex \-r
[
.I file
]
.SH DESCRIPTION
.PP
.B hex
will show the contents of
.I file
(or standard input) in hexadecimal and/or character.
At this time, this will show in Japanese text as if it seems to be.

.SS OPTIONS
You can specify option in environment variable
.B HEX_OPTIONS
.SS OPTIONS \- how to show `non printable character'
see
.B EXAMPLE
below

`Non printable character' here is that control codes and/or
codes that is 8bits and out of range of kanji or kana character codes.
.TP
.BR "\-c,\ \-\-color " "(default if output is tty)"
show `non printable character' with colors.  Terminal with color support,
such as
.B kterm
,
.B MS\-DOS Prompt in Windows95
and so on) show all of J with color by 
.B EXAMPLE
options.

Blue and light bule is used by default, using escape sequence such as
.BR ^[ [34m
These colors can be changed by 
.B "\-cs1, \-cs2 "
option described below.
.TP
.B "\-b, \-\-bold "
show `non printable character' in bold.
.B EXAMPLE
will show all J in bold.  It will be showen in bold even if you see via
.B less
.

When output is tty, escape sequence
.BR ^[ [1m
is used, and otherwise (such pipe), it will output like
.RB A ^H A
for bold A.

This program does not refer
.BR termcap / terminfo
, so some terminal can not show in bold.
In Windows95, it looks brighter.
.TP
.BR "\-d, \-\-dot " "(default if output is not tty)"
show `non printable character' as `.' as if
`J' substituted in `.' in 
.B EXAMPLE
case.
.TP
.B "\-t, \-\-text "
show `non printable character' in normal text. Same as
.B EXAMPLE
No use.
.TP
.B "\-u, \-\-underline "
show `non printable character' with underline.
In 
.B EXAMPLE
case, all J has underline.  You can see with underline even if you see via
.B less
or
.B more
.

When output to tty, escape sequence
.BR ^[ [4m
is used, otherwise (such as pipe), it will output like
.RB _ ^H A
for A with underline.
You can't see underline in Windows95.
.TP
.B EXAMPLE
.nf
0x00000000: a4 cf a4 e8 a4 f3 0a 0a \- 0a 0a 0a 0a 0a 0a 0a 0a ϤJJJJJJJJJJ
.fi
.SS OPTION \- output code
To check what is specified by default, 
.B "hex \-h "
.TP
.B "\-e, \-oe, \-\-oeuc "
output using *euc\-japan*
.TP
.B "\-s, \-os, \-\-osjis "
output using *sjis*
.TP
.B "\-j, \-oj, \-\-ojis "
output using *iso\-2022\-jp*
.SS OPTION \- input code
To check what is specified by default, 
.B "hex \-h "
.TP
.B "\-E, \-ie, \-\-ieuc "
Assume *euc\-japan* or *iso\-2022\-jp* for input.
.TP
.B "\-S, \-is, \-\-isjis "
Assume *sjis* or *iso\-2022\-jp* for input
.TP
.B "\-U, \-iu, \-\-iunknown "
Assume unknown input code.  Japanese handling won't be done by this option.
.SS OPTION \- other
.TP
.BI "\-cs1 " "cs, " "\-\-colorstring1 " "cs "
specify code 1 of color.  This color is used for control codes and/or
codes that is 8bits and out of range of kanji or kana character codes.

For example,  if you specified
.BI "\-cs1 " "43;31 "
(`;' will be handled by shell, so you should escape it as
.BI "\-cs1 " "'43;31' "
), output red character with yellow background.
.TP
.BI "\-cs2 " "cs, " "\-\-colorstring2 " "cs "
specify code 2 for color.  This color is used for half of kanji character,
part of EUC halfwidth kana and/or escape sequence of iso\-2022.
.TP
.B "\-dsiso, \-\-disablesiso, \+siso"
Usually, character between ^N/^O is treated as halfwidth kana, but disabled 
with this option.
.TP
.B "\-siso, \-\-enablesiso"
Oppose to above (default)
.TP
.B "\-r, \-\-restore "
.B % hex < hoe |
.B hex \-r > hoge
.br
is same as
.br
.B % cat < hoe > hoge
.br
.
.TP
.B "\-h, \-\-help "
show usage.
.SH PAGER
If you use pager such as less for output of hex, you can't see color
however, you can see color by doing like the followings:
.br
.B % hex \-c `which hex` |
.B less \-r
.br
.B % hex \-c `which hex` |
.B lv \-C
.br
If you use command prompt on WindowsNT, try
.br
.B % hex \-u `which hex` |
.B less
.br
.  less will show with colors for underline, so it looks like with color 
option.  (disabled hex color option)
.SH SEE ALSO
od(1), hexdump(1), jhd(1), less(1), lv(1)
.SH COPYRIGHT
Copyright (C) 1996\-1998, TAGA Nayuta <nayuta@is.s.u\-tokyo.ac.jp>
.PP
This program is free software.
.PP
THERE IS NO WARRANTY FOR THE PROGRAM.
.PP
The latest version can be found at
.B http://www.is.s.u\-tokyo.ac.jp/~nayuta/
.SH AUTHOR
TAGA Nayuta (nayuta@is.s.u\-tokyo.ac.jp)
.PP
This manual page was translated by Fumitoshi UKAI <ukai@debian.or.jp>,
for the Debian GNU/Linux system (but may be used by others).
.SH BUGS
.PP
This program doesn't refer
.BR termcap / terminfo
so some terminal can't show bold.
.PP
No autodetection of Japanese encodings.
.PP
Wrong efficiency for output. (color sequence with each characters.
For *iso\-2022\-jp* output, 
.BR ^[ (J
for each characters.)

.PP
Space of halfwidth kana (
.B 0x8e 0xa0
in *euc\-japan*
, 
.B 0xa0
in *sjis*
, 
.B 0x20
in *iso\-2022\-jp* 
) will output as normal space character (
.B 0x20
)
.
.PP
You can't see color in some part on Windows95. (bug of Windows95 ?)
.PP
No support supplimental characters in *iso\-2022\-jp*.