[Forensics-changes] [forensics-colorize] 02/02: Imported Debian patch 1.1-1
Joao Eriberto Mota Filho
eriberto at moszumanska.debian.org
Mon Sep 21 02:20:40 UTC 2015
This is an automated email from the git hooks/post-receive script.
eriberto pushed a commit to branch debian
in repository forensics-colorize.
commit d0d75c48f8fa2971b507513a263d867a8095a682
Author: Joao Eriberto Mota Filho <eriberto at debian.org>
Date: Sun Sep 20 16:27:26 2015 -0300
Imported Debian patch 1.1-1
---
debian/README.Debian | 13 ++++
debian/changelog | 5 ++
debian/compat | 1 +
debian/control | 29 ++++++++
debian/copyright | 28 ++++++++
debian/docs | 1 +
debian/examples | 1 +
debian/examples.d/test1 | Bin 0 -> 1048576 bytes
debian/examples.d/test2 | Bin 0 -> 1048576 bytes
debian/links | 2 +
debian/manpage/forensics-colorize.1 | 118 +++++++++++++++++++++++++++++++
debian/manpage/forensics-colorize.header | 1 +
debian/manpage/forensics-colorize.txt | 72 +++++++++++++++++++
debian/manpage/genallman.sh | 29 ++++++++
debian/manpages | 1 +
debian/rules | 10 +++
debian/source/format | 1 +
debian/source/include-binaries | 2 +
debian/watch | 2 +
19 files changed, 316 insertions(+)
diff --git a/debian/README.Debian b/debian/README.Debian
new file mode 100644
index 0000000..aeed192
--- /dev/null
+++ b/debian/README.Debian
@@ -0,0 +1,13 @@
+forensics-colorize for Debian
+-----------------------------
+
+A very good article written by the upstream with more information and examples
+can be found here:
+
+https://jessekornblum.livejournal.com/290358.html
+
+You can use the files inside /usr/share/doc/forensics-colorize/examples/
+directory to test the filecompare and colorize commands. Please, decompress
+the files before to use.
+
+ -- Joao Eriberto Mota Filho <eriberto at debian.org> Sat, 22 Aug 2015 10:18:33 -0300
diff --git a/debian/changelog b/debian/changelog
new file mode 100644
index 0000000..d09f4b3
--- /dev/null
+++ b/debian/changelog
@@ -0,0 +1,5 @@
+forensics-colorize (1.1-1) unstable; urgency=low
+
+ * Initial release (Closes: #796393)
+
+ -- Joao Eriberto Mota Filho <eriberto at debian.org> Sun, 20 Sep 2015 16:27:26 -0300
diff --git a/debian/compat b/debian/compat
new file mode 100644
index 0000000..ec63514
--- /dev/null
+++ b/debian/compat
@@ -0,0 +1 @@
+9
diff --git a/debian/control b/debian/control
new file mode 100644
index 0000000..80e6c1c
--- /dev/null
+++ b/debian/control
@@ -0,0 +1,29 @@
+Source: forensics-colorize
+Section: utils
+Priority: optional
+Maintainer: Debian Forensics <forensics-devel at lists.alioth.debian.org>
+Uploaders: Joao Eriberto Mota Filho <eriberto at debian.org>
+Build-Depends: debhelper (>= 9), dh-autoreconf
+Standards-Version: 3.9.6
+Homepage: https://github.com/jessek/colorize
+Vcs-Git: git://anonscm.debian.org/forensics/forensics-colorize.git
+Vcs-Browser: https://anonscm.debian.org/git/forensics/forensics-colorize.git
+
+Package: forensics-colorize
+Architecture: any
+Depends: ${shlibs:Depends}, ${misc:Depends}
+Suggests: sxiv
+Description: show differences between files using color graphics
+ forensics-colorize is a set of tools to visually compare large files, as
+ filesystem images, creating graphics of them. It is intuitive because the
+ produced graphics provide a quick and perfect sense about the percentage
+ of changes between two files.
+ .
+ Comparing large textual files using a simple diff can produce a very big
+ result in lines, causing confusion. On the other hand, diff is improper
+ to compare binary files.
+ .
+ This package provides two command line programs: filecompare and colorize.
+ The filecompare command is used to create a special and auxiliary input
+ file for colorize. The colorize command will generate an intuitive graphic
+ that will make easier to perceive the level of changes between the files.
diff --git a/debian/copyright b/debian/copyright
new file mode 100644
index 0000000..d674421
--- /dev/null
+++ b/debian/copyright
@@ -0,0 +1,28 @@
+Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
+Upstream-Name: colorize
+Source: https://github.com/jessek/colorize
+
+Files: *
+Copyright: 2013 Jesse Kornblum <research at jessekornblum.com>
+License: GPL-2
+
+Files: debian/*
+Copyright: 2015 Joao Eriberto Mota Filho <eriberto at debian.org>
+License: GPL-2+
+
+License: GPL-2 or GPL-2+
+ This package 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 package 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 <https://www.gnu.org/licenses/>
+ .
+ On Debian systems, the complete text of the GNU General
+ Public License version 2 can be found in "/usr/share/common-licenses/GPL-2".
diff --git a/debian/docs b/debian/docs
new file mode 100644
index 0000000..edc0071
--- /dev/null
+++ b/debian/docs
@@ -0,0 +1 @@
+NEWS
diff --git a/debian/examples b/debian/examples
new file mode 100644
index 0000000..07b0269
--- /dev/null
+++ b/debian/examples
@@ -0,0 +1 @@
+debian/examples.d/*
diff --git a/debian/examples.d/test1 b/debian/examples.d/test1
new file mode 100644
index 0000000..0c98d82
Binary files /dev/null and b/debian/examples.d/test1 differ
diff --git a/debian/examples.d/test2 b/debian/examples.d/test2
new file mode 100644
index 0000000..9e0f96a
Binary files /dev/null and b/debian/examples.d/test2 differ
diff --git a/debian/links b/debian/links
new file mode 100644
index 0000000..f2be4c8
--- /dev/null
+++ b/debian/links
@@ -0,0 +1,2 @@
+usr/share/man/man1/forensics-colorize.1 usr/share/man/man1/colorize.1
+usr/share/man/man1/forensics-colorize.1 usr/share/man/man1/filecompare.1
diff --git a/debian/manpage/forensics-colorize.1 b/debian/manpage/forensics-colorize.1
new file mode 100644
index 0000000..18cccef
--- /dev/null
+++ b/debian/manpage/forensics-colorize.1
@@ -0,0 +1,118 @@
+.TH forensics-colorize "1" "Sep 2015" "FORENSICS-COLORIZE 1.1" "show differences between files using color graphics"
+.\" Text automatically generated by txt2man
+.SH NAME
+\fBforensics-colorize \fP- show differences between files using color graphics
+\fB
+.SH SYNOPSIS
+.nf
+.fam C
+\fBfilecompare\fP [\fB-b\fP size[bkmgpe]] [\fB-Vh\fP] \fIFILE1\fP \fIFILE2\fP
+
+\fBcolorize\fP [\fB-h\fP|\fB-V\fP] [\fB-w\fP <num>] [\fB-ovd\fP] \fIFILES\fP
+
+.fam T
+.fi
+.fam T
+.fi
+.SH DESCRIPTION
+forensics-\fBcolorize\fP is a set of tools to visually compare large files, as
+filesystem images, creating graphics of them. It is intuitive because the
+produced graphics provide a quick and perfect sense about the percentage
+of changes between two files.
+.PP
+Comparing large textual files using a simple diff can produce a very big
+result in lines, causing confusion. On the other hand, diff is improper
+to compare binary files.
+.PP
+forensics-\fBcolorize\fP uses two command line programs: \fBfilecompare\fP and \fBcolorize\fP.
+The \fBfilecompare\fP command is used to create a special and auxiliary input
+file for \fBcolorize\fP. The \fBcolorize\fP command will generate an intuitive graphic
+that will make easier to perceive the level of changes between the files. In
+other words, you can use the \fBfilecompare\fP command to generate a graphic to be
+analyzed by \fBcolorize\fP command.
+.SH OPTIONS FOR FILECOMPARE
+.TP
+.B
+\fB-b\fP
+Set block size with optional suffix b, k, m, g, p, or e. Note that the
+program will output at least one complete block. Make sure that you have
+enough disk space!
+.TP
+.B
+\fB-t\fP
+Use transitional colors instead of default red or green.
+.TP
+.B
+\fB-V\fP
+Display version number and exit.
+.TP
+.B
+\fB-h\fP
+Display this help message.
+.SH OPTIONS FOR COLORIZE
+.TP
+.B
+\fB-d\fP
+Change direction data flows. Default is down or right.
+.TP
+.B
+\fB-o\fP
+Change image orientation. Default is vertical.
+.TP
+.B
+\fB-v\fP
+Verbose mode.
+.TP
+.B
+\fB-w\fP
+Set output image width, defaults to 100.
+.TP
+.B
+\fB-V\fP
+Display version number and exit.
+.TP
+.B
+\fB-h\fP
+Display this help message and exit.
+.SH EXAMPLES
+To generate an initial graphic between 'test1' and 'test2' files to be
+analyzed by \fBcolorize\fP:
+.PP
+.nf
+.fam C
+ $ filecompare test1 test2 > test.fc
+
+.fam T
+.fi
+To analyze the result:
+.PP
+.nf
+.fam C
+ $ colorize test.fc
+
+.fam T
+.fi
+The last command will generate the test.fc.bmp file. You can open it using a
+trivial image viewer, as sxiv or similar. If using default parameters for the
+both commands (\fBfilecompare\fP and \fBcolorize\fP), unchanged parts will be shown as
+green and changed parts will be colorized with red.
+.PP
+To get larger or smaller final graphics, use the \fB-b\fP option for the '\fBfilecompare\fP'
+command. As an example, the following command will produce a result greater than
+the default:
+.PP
+.nf
+.fam C
+ $ filecompare -b 64 test1 test2 > test.fc
+
+.fam T
+.fi
+.SH NOTE
+In most cases, the default block size is the same of the logical disk sector
+value (now a days, 512 bytes). Try 'fdisk \fB-l\fP' or 'gdisk \fB-l\fP /dev/<disk>' to
+find the right value.
+.SH AUTHOR
+The forensics-\fBcolorize\fP was written by Jesse Kornblum <research at jessekornblum.com>.
+.PP
+This manual page was written by Joao Eriberto Mota Filho <eriberto at debian.org>
+for the Debian project (but may be used by others).
diff --git a/debian/manpage/forensics-colorize.header b/debian/manpage/forensics-colorize.header
new file mode 100644
index 0000000..bd78f4f
--- /dev/null
+++ b/debian/manpage/forensics-colorize.header
@@ -0,0 +1 @@
+.TH forensics-colorize "1" "Sep 2015" "FORENSICS-COLORIZE 1.1" "show differences between files using color graphics"
diff --git a/debian/manpage/forensics-colorize.txt b/debian/manpage/forensics-colorize.txt
new file mode 100644
index 0000000..2198c5d
--- /dev/null
+++ b/debian/manpage/forensics-colorize.txt
@@ -0,0 +1,72 @@
+NAME
+ forensics-colorize - show differences between files using color graphics
+
+SYNOPSIS
+ filecompare [-b size[bkmgpe]] [-Vh] FILE1 FILE2
+
+ colorize [-h|-V] [-w <num>] [-ovd] FILES
+
+DESCRIPTION
+ forensics-colorize is a set of tools to visually compare large files, as
+ filesystem images, creating graphics of them. It is intuitive because the
+ produced graphics provide a quick and perfect sense about the percentage
+ of changes between two files.
+
+ Comparing large textual files using a simple diff can produce a very big
+ result in lines, causing confusion. On the other hand, diff is improper
+ to compare binary files.
+
+ forensics-colorize uses two command line programs: filecompare and colorize.
+ The filecompare command is used to create a special and auxiliary input
+ file for colorize. The colorize command will generate an intuitive graphic
+ that will make easier to perceive the level of changes between the files. In
+ other words, you can use the filecompare command to generate a graphic to be
+ analyzed by colorize command.
+
+OPTIONS FOR FILECOMPARE
+ -b Set block size with optional suffix b, k, m, g, p, or e. Note that the
+ program will output at least one complete block. Make sure that you have
+ enough disk space!
+ -t Use transitional colors instead of default red or green.
+ -V Display version number and exit.
+ -h Display this help message.
+
+OPTIONS FOR COLORIZE
+ -d Change direction data flows. Default is down or right.
+ -o Change image orientation. Default is vertical.
+ -v Verbose mode.
+ -w Set output image width, defaults to 100.
+ -V Display version number and exit.
+ -h Display this help message and exit.
+
+EXAMPLES
+ To generate an initial graphic between 'test1' and 'test2' files to be
+ analyzed by colorize:
+
+ $ filecompare test1 test2 > test.fc
+
+ To analyze the result:
+
+ $ colorize test.fc
+
+ The last command will generate the test.fc.bmp file. You can open it using a
+ trivial image viewer, as sxiv or similar. If using default parameters for the
+ both commands (filecompare and colorize), unchanged parts will be shown as
+ green and changed parts will be colorized with red.
+
+ To get larger or smaller final graphics, use the -b option for the 'filecompare'
+ command. As an example, the following command will produce a result greater than
+ the default:
+
+ $ filecompare -b 64 test1 test2 > test.fc
+
+NOTE
+ In most cases, the default block size is the same of the logical disk sector
+ value (now a days, 512 bytes). Try 'fdisk -l' or 'gdisk -l /dev/<disk>' to
+ find the right value.
+
+AUTHOR
+ The forensics-colorize was written by Jesse Kornblum <research at jessekornblum.com>.
+
+ This manual page was written by Joao Eriberto Mota Filho <eriberto at debian.org>
+ for the Debian project (but may be used by others).
diff --git a/debian/manpage/genallman.sh b/debian/manpage/genallman.sh
new file mode 100755
index 0000000..fe4054f
--- /dev/null
+++ b/debian/manpage/genallman.sh
@@ -0,0 +1,29 @@
+#!/bin/bash
+
+# Generate several manpages at the same time.
+# C 2014-2015 Joao Eriberto Mota Filho <eriberto at debian.org>
+#
+# You can use this code in the same terms of the BSD-3-clause license or,
+# optionally, in the same terms of the license used in debian/ directory
+# in this Debian package. Please, to the last option, refer the package
+# name when using.
+#
+# This script uses txt2man. You need 2 files: program_name.txt and
+# program_name.header.
+#
+# The program_name.header must be use this structure:
+#
+# .TH <program_name> "<manpage_level>" "<date>" "<program_name_upper_case> <program_version>" "<program_description>"
+#
+# Example:
+#
+# .TH mac-robber "1" "May 2013" "MAC-ROBBER 1.02" "collects data about allocated files in mounted filesystems"
+
+[ ! -f /usr/bin/txt2man ] && echo txt2man not installed. && exit 0
+
+for NAME in $(ls | grep header | cut -d'.' -f1)
+do
+ LEVEL=$(cat $NAME.header | cut -d" " -f3 | tr -d '"')
+ cat $NAME.header > $NAME.$LEVEL
+ txt2man $NAME.txt | grep -v '^.TH ' >> $NAME.$LEVEL
+done
diff --git a/debian/manpages b/debian/manpages
new file mode 100644
index 0000000..08b88d9
--- /dev/null
+++ b/debian/manpages
@@ -0,0 +1 @@
+debian/manpage/forensics-colorize.1
diff --git a/debian/rules b/debian/rules
new file mode 100755
index 0000000..b2fe1ea
--- /dev/null
+++ b/debian/rules
@@ -0,0 +1,10 @@
+#!/usr/bin/make -f
+#export DH_VERBOSE = 1
+
+export DEB_BUILD_MAINT_OPTIONS = hardening=+all
+
+%:
+ dh $@ --with autoreconf
+
+
+
diff --git a/debian/source/format b/debian/source/format
new file mode 100644
index 0000000..163aaf8
--- /dev/null
+++ b/debian/source/format
@@ -0,0 +1 @@
+3.0 (quilt)
diff --git a/debian/source/include-binaries b/debian/source/include-binaries
new file mode 100644
index 0000000..e41d17a
--- /dev/null
+++ b/debian/source/include-binaries
@@ -0,0 +1,2 @@
+debian/examples.d/test1
+debian/examples.d/test2
diff --git a/debian/watch b/debian/watch
new file mode 100644
index 0000000..fbe5577
--- /dev/null
+++ b/debian/watch
@@ -0,0 +1,2 @@
+version=3
+https://github.com/jessek/colorize/releases .*/archive/(?:release-|v|v-)?(\d\S+)\.tar\.(?:bz2|gz|xz)
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/forensics/forensics-colorize.git
More information about the forensics-changes
mailing list