readme.tt

vbindiff-3.0_beta4.tar.gz是一个linux下二进制比较工具

[% # $Id: ReadMe.tt 4759 2008-07-26 03:19:24Z cjm $ %]

[% IF Win32 %]
   [% outputFile = 'ReadMe.txt' %]
[% ELSE %]
   [% outputFile = 'README' %]
[% END %]
>../[% outputFile %]


===============================================================================
[% PERL %]
# Generate title line:
# ReadMe.txt                Visual Binary Diff 0.xx                 DD-Mmm-YYYY

use Date::Format 'time2str';

my $line   = $stash->get('outputFile');
my $center = sprintf '%s %s', $stash->get('name'), $stash->get('version');
my $date   = time2str('%e-%b-%Y', time);

$line .= (' ' x (int((79 - length $center) / 2) - length $line)) . $center;
$line .= (' ' x (79 - length($line) - length($date))) . $date . "\n";

print $line

[% END %]
===============================================================================
                                      Copyright 2000-2008 Christopher J. Madsen
CONTENTS
========
[% PERL %]
# Generate the table of contents:

my $Win32 = $stash->get('Win32');

my @sections = (
  'About Visual Binary Diff',
  'System Requirements',
  'Installation',
  ($Win32 ? 'Removal' : ()),
  'License',
  ($Win32 ? 'History' : ()),
  'Author',
);

my %section;
my $num = 0;
foreach (@sections) {
  $section{$_} = sprintf "[\%d] %s", ++$num, $_;
  print "  $section{$_}\n";
}

$stash->set(section => sub {
  my $s = $section{$_[0]};
  sprintf "%s\n%s", $s, '-' x length($s),
});
[% END %]

[% section('About Visual Binary Diff') %]

Visual Binary Diff (VBinDiff) displays files in hexadecimal and ASCII
(or EBCDIC).  It can also display two files at once, and highlight the
differences between them.  Unlike diff, it works well with large files
(up to 4 GB).

VBinDiff was inspired by the Compare Files function of the ProSel
utilities by Glen Bredon, for the Apple II.  When I couldn't find a
similar utility for the PC, I wrote it myself.

The single-file mode was inspired by the LIST utility of 4DOS and
friends (http://www.jpsoft.com/4ntdes.htm).  While less
(http://www.greenwoodsoftware.com/less/) provides a good line-oriented
display, it has no equivalent to LIST's hex display.  (True, you can
pipe the file through hexdump, but that's incredibly inefficient on
multi-gigabyte files.)


[% section('System Requirements') %]

Windows 95, Windows NT 4.0, or later
  or
A POSIX-compatible system with ncurses (eg, Linux)

It should be possible to port the ncurses version to work with other
curses libraries (as long as they provide the panel library), but I
don't have access to such a system.  Patches are welcome.


[% section('Installation') %]

[% IF Win32 %]
Copy VBinDiff.exe to a folder on your path.  If you don't know what a path
is, you can put it in your C:\Windows directory.  Then read VBinDiff.txt to
find out how to use it.
[% ELSE %]
VBinDiff uses the standard GNU autoconf system.  See the file INSTALL if
you're not familiar with that.
[% END %]


[% IF Win32 %]
[% section('Removal') %]

To remove VBinDiff, just delete it.  It makes no registry changes or INI
files.

The following files are included with VBinDiff (and should be deleted):
  ReadMe.txt	This file
  AUTHORS.txt   Credits
  COPYING.txt   The GNU General Public License
  VBinDiff.exe	The main program
  VBinDiff.txt	The documentation
  Source.zip    The source code for VBinDiff


[% END %]
[% section('License') %]

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of
the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, see <http://www.gnu.org/licenses/>.

The GNU General Public License can be found in the file COPYING[% '.txt' IF Win32 %].

The file putty.src is not part of VBinDiff and can be distributed
under the same terms as ncurses.


[% IF Win32 %]
[% section('History') %]
[% INCLUDE NEWS.tt %]


[% END %]
[% section('Author') %]

Christopher J. Madsen           vbindiff AT cjmweb.net
1113 Abrams Rd. Apt. 296
Richardson, TX  75081-5573

VBinDiff Home Page:
http://www.cjmweb.net/vbindiff/