.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.13
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  | will give a
.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
.\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
.\" expand to `' in nroff, nothing in troff, for use with C<>.
.tr \(*W-|\(bv\*(Tr
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.if \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.\"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "VBINDIFF 1"
.TH VBINDIFF 1 "2005-11-11" "VBinDiff 3.0_beta1" "Christopher J. Madsen"
.SH "NAME"
vbindiff \- hexadecimal file display and comparison
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBvbindiff\fR \fIfile1\fR [ \fIfile2\fR ]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
Visual Binary Diff (VBinDiff) displays files in hexadecimal and \s-1ASCII\s0
(or \s-1EBCDIC\s0).  It can also display two files at once, and highlight
the differences between them.  Unlike \fBdiff\fR, it works well with
large files (up to 4 \s-1GB\s0).
.Sh "Viewing files"
.IX Subsection "Viewing files"
.Vb 12
\& Movement Keys
\& -------------
\& Up      Move one line (16 bytes) towards the beginning of the file
\& Down    Move one line (16 bytes) towards the end of the file
\& Left    Move one byte towards the beginning of the file
\& Right   Move one byte towards the end of the file
\& PageUp  Move one page towards the beginning of the file
\& PageDn  Move one page towards the end of the file
\& Home    Move to the beginning of the file
\& End     Move to the end of the (shorter) file
\& F       Search for a string or byte sequence
\& G       Move to a specified file position
.Ve
.PP
When displaying two files, both files move together.  To move only the
top file, press \f(CW\*(C`T\*(C'\fR.  To move only the bottom file, press \f(CW\*(C`B\*(C'\fR.  To
return to moving both files, press the same key again.  (The window at
the bottom of the screen will indicate when you are moving only one
file.)
.PP
.Vb 7
\& Other Keys
\& ----------
\& Enter  Move to the next difference between the files
\& C      Toggle between ASCII and EBCDIC display
\& E      Edit currently displayed section of file
\& Esc    Exit VBinDiff
\& Q      Exit VBinDiff
.Ve
.PP
The \f(CW\*(C`Enter\*(C'\fR key will advance to the next difference between the files
(after those already displayed on the screen).  If there are no more
differences, it moves to the end.
.Sh "Editing files"
.IX Subsection "Editing files"
You can press \f(CW\*(C`E\*(C'\fR to edit the current file.  When displaying two
files, this edits the one in the top window, unless you are in \*(L"move bottom\*(R" mode.
.PP
When editing, you can move the cursor around with the arrow keys.  Use
\&\s-1TAB\s0 to switch between entering hexadecimal or \s-1ASCII\s0 (or \s-1EBCDIC\s0)
characters.  Press the Esc key when you are done.  You will be given
the choice to save or discard your changes then.
.PP
If you are displaying two files, you can use the Enter key to copy a
byte from the other file into the one you are editing.
.PP
You cannot scroll through the file while editing, although you can
save your changes and then move to a different part of the file.
Also, you cannot insert or delete bytes, only change them.
.SH "OPTIONS"
.IX Header "OPTIONS"
.Vb 3
\& -L, --license   Display license information for vbindiff
\& -V, --version   Display the version number
\&     --help      Display help information
.Ve
.SH "BUGS"
.IX Header "BUGS"
Does not work properly with files over 4 gigabytes.  It should be
able to view the first 4 gigabytes ok, but the display only has room
for 8 hex digits of file position, and the Goto box is also limited to
8 digits.
.SH "LICENSE"
.IX Header "LICENSE"
VBinDiff is free software; you can redistribute it and/or modify it
under the terms of the \s-1GNU\s0 General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
.PP
VBinDiff is distributed in the hope that it will be useful, but
\&\s-1WITHOUT\s0 \s-1ANY\s0 \s-1WARRANTY\s0; without even the implied warranty of
\&\s-1MERCHANTABILITY\s0 or \s-1FITNESS\s0 \s-1FOR\s0 A \s-1PARTICULAR\s0 \s-1PURPOSE\s0.  See the \s-1GNU\s0
General Public License for more details.
.PP
You should have received a copy of the \s-1GNU\s0 General Public License
along with VBinDiff (see the file \s-1COPYING\s0); if not, write to the Free
Software Foundation, Inc., 675 Mass Ave, Cambridge, \s-1MA\s0 02139, \s-1USA\s0.
.SH "AUTHOR"
.IX Header "AUTHOR"
Christopher J. Madsen <cjm .at. pobox.com>
<http://www.pobox.com/~cjm/vbindiff/>