.\" Automatically generated by Pod::Man 2.27 (Pod::Simple 3.28)
.\"
.\" Standard preamble:
.\" ========================================================================
.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. \*(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-
.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" ''
. ds C`
. ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD. Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{
. if \nF \{
. de IX
. tm Index:\\$1\t\\n%\t"\\$2"
..
. if !\nF==2 \{
. nr % 0
. nr F 2
. \}
. \}
.\}
.rr rF
.\"
.\" 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 "2017-09-10" "VBinDiff 3.0_beta5" "Christopher J. Madsen"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.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).
.SS "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. If bytes have
been added or removed in one of the files, you can adjust the
comparison by moving just one of the files.
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 8
\& Other Keys
\& \-\-\-\-\-\-\-\-\-\-
\& Enter Move to the next difference between the files
\& Space (same as Enter)
\& 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.
.SS "Line editor"
.IX Subsection "Line editor"
The line editor is used to enter search strings and file positions.
It uses the basic Emacs-style editing keys.
.PP
.Vb 10
\& Keys
\& \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
\& Ctrl\-B, Left Move the cursor one character left
\& Ctrl\-F, Right Move the cursor one character right
\& Ctrl\-A, Home Move to the beginning of the line
\& Ctrl\-E, End Move to the end of the line
\& Ctrl\-P, Up Move up in input history
\& Ctrl\-N, Down Move down in input history
\& Ctrl\-H, Backspace Delete the character to the left
\& Ctrl\-D, Delete Delete the character under the cursor
\& Ctrl\-K Delete from cursor to end of line
\& Insert Toggle between insert & overstrike mode
\& Enter Finished entering text
\& Esc Abort the operation
.Ve
.SS "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 ANY WARRANTY\s0; without even the implied warranty of
\&\s-1MERCHANTABILITY\s0 or \s-1FITNESS FOR A PARTICULAR PURPOSE. \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, see .
.SH "AUTHOR"
.IX Header "AUTHOR"
Christopher J. Madsen