'\" t
.\"     Title: package-tracker
.\"    Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 20170515
.\"    Manual: Open Infrastructure
.\"    Source: package-tracker
.\"  Language: English
.\"
.TH "PACKAGE\-TRACKER" "7" "20170515" "package\-tracker" "Open Infrastructure"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
package-tracker \- Compare and track package versions in debian repositories
.SH "DESCRIPTION"
.sp
A common, but not unique pattern for derivatives is that of reusing/rebuilding most of the official Debian packages and adding some custom packages of their own\&.  \(em Wikipedia (https://wiki\&.debian\&.org/Derivatives/)
.sp
\fBpackage\-tracker\fR is desinged to compare apt(1) archives from a derrivate (debian extending repositories) against their parent ones\&. A such it is possible to track changes in versions in other archives\&.
.SH "DOWNLOAD"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Upstream Releases:
https://files\&.open\-infrastructure\&.net/software/package\-tracker/upstream
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Upstream Sources:
https://sources\&.open\-infrastructure\&.net/software/package\-tracker
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Debian Releases:
https://files\&.open\-infrastructure\&.net/software/package\-tracker/debian
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Debian Sources:
https://sources\&.progress\-linux\&.org/users/daniel/debian/packages/open\-infrastructure\-package\-tracker
.RE
.SH "INSTALLATION"
.SS "SOURCE"
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
sudo apt install asciidoc git docbook\-xml docbook\-xsl libxml2\-utils make xsltproc python3
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
git clone
https://sources\&.open\-infrastructure\&.net/software/package\-tracker
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
cd package\-tracker && sudo make install
.RE
.SH "DEVELOPMENT"
.sp
Bug reports, feature requests, help, patches, support and everything else are welcome on the Open Infrastructure Software Mailing List:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
https://lists\&.open\-infrastructure\&.net/listinfo/software
.RE
.sp
Please base patches against the \fInext\fR Git branch using common sense:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
https://www\&.kernel\&.org/doc/Documentation/SubmittingPatches
.RE
.sp
Debian specific bugs can also be reported in the Debian Bug Tracking System:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
https://bugs\&.debian\&.org
.RE
.SH "USAGE"
.PP
\fBCreate a html file containing all compare results:\fR
.RS 4
package\-tracker myderivate\&.list debian\&.list \-i mycodename \-o html
.RE
.sp
See package\-tracker(1) for a list of all options\&.
.SH "AUTHORS"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Andreas Kreuzer <andreas\&.kreuzer@open\-infrastructure\&.net>
.RE