[hamradio-commits] [dump1090] 322/373: Updated packaging to build on x86 and arm as well as to remove last few lintian nitpicks

Matthew Ernisse mernisse-guest at moszumanska.debian.org
Thu Oct 23 14:58:32 UTC 2014 

This is an automated email from the git hooks/post-receive script.

mernisse-guest pushed a commit to branch backport
in repository dump1090.

commit 232aa4c9251686478248e188e76aa150dd2c0ab6
Author: Matthew Ernisse <mernisse at ub3rgeek.net>
Date:   Sun Aug 17 20:23:08 2014 +0000

    Updated packaging to build on x86 and arm as well as to remove last few lintian nitpicks
---
 debian/changelog                   |  10 +-
 debian/control                     |   2 +
 debian/copyright                   |   4 +-
 debian/dump1090.1                  | 288 +++++++++++++++++++++++++++++++++++++
 debian/dump1090.debhelper.log      |  47 ++++++
 debian/dump1090.dirs               |   2 -
 debian/dump1090.manpages           |   1 +
 debian/dump1090.postinst.debhelper |   6 +
 debian/dump1090.postrm.debhelper   |   5 +
 debian/dump1090.prerm.debhelper    |   5 +
 debian/dump1090.substvars          |   2 +
 debian/files                       |   1 +
 debian/lintian-overrides           |   4 -
 debian/patches/00-makefile.patch   |  37 +++--
 debian/ppup1090.1                  |  80 +++++++++++
 debian/rules                       |   8 --
 debian/view1090.1                  | 139 ++++++++++++++++++
 17 files changed, 613 insertions(+), 28 deletions(-)

diff --git a/debian/changelog b/debian/changelog
index d5808dd..3099a75 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,4 +1,12 @@
-dump1090 (1.09.0608.14-1) unstable; urgency=low
+dump1090 (1.09.0608.14-2) UNRELEASED; urgency=low
+
+  * Add man pages per Debian Policy.
+  * Patch Makefile to only build the Planeplotter uploader on supported
+    architectures.
+
+ -- Matthew Ernisse <mernisse at ub3rgeek.net>  Sun, 17 Aug 2014 17:13:57 +0000
+
+dump1090 (1.09.0608.14-1) UNRELEASED; urgency=low
 
   * Initial release 
 
diff --git a/debian/control b/debian/control
index 10d86cd..ab0ea54 100644
--- a/debian/control
+++ b/debian/control
@@ -5,6 +5,8 @@ Maintainer: Matthew Ernisse <mernisse at ub3rgeek.net>
 Build-Depends: debhelper (>= 8.0.0), dpkg-dev (>= 1.16.1~), pkg-config, librtlsdr0-dev
 Standards-Version: 3.9.3
 Homepage: https://github.com/MalcolmRobb/dump1090
+Vcs-Git: https://github.com/MalcolmRobb/dump1090.git
+Vcs-Browser: https://github.com/MalcolmRobb/dump1090
 
 Package: dump1090
 Architecture: any
diff --git a/debian/copyright b/debian/copyright
index 1b687b3..e7d73c3 100644
--- a/debian/copyright
+++ b/debian/copyright
@@ -3,8 +3,8 @@ Upstream-Name: dump1090
 Source: https://github.com/MalcolmRobb/dump1090
 
 Files: *
-Copyright: 2009-2013 Salvatore Sanfilippo <antirez at gmail.com>
-           2013-2014 Malcom Robb
+Copyright: 2012 Salvatore Sanfilippo <antirez at gmail.com>
+           2014 Malcolm Robb <support at attavionics.com>
 License: BSD-3-Clause
 
 Files: debian/*
diff --git a/debian/dump1090.1 b/debian/dump1090.1
new file mode 100644
index 0000000..fececec
--- /dev/null
+++ b/debian/dump1090.1
@@ -0,0 +1,288 @@
+.\"Text automatically generated by txt2man
+.\" Copyright (c) 2014 Matthew John Ernisse <mernisse at ub3rgeek.net>
+.\" All Rights Reserved.
+.\" 
+.\"Redistribution and use in source and binary forms,
+.\"with or without modification, are permitted provided
+.\"that the following conditions are met:
+.\"
+.\"    * Redistributions of source code must retain the
+.\"      above copyright notice, this list of conditions
+.\"      and the following disclaimer.
+.\"    * Redistributions in binary form must reproduce
+.\"     the above copyright notice, this list of conditions
+.\"      and the following disclaimer in the documentation
+.\"      and/or other materials provided with the distribution.
+.\"
+.\"THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+.\""AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+.\"LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+.\"FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+.\"COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+.\"INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+.\"BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
+.\"OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+.\"ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
+.\"TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
+.\"USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
+.TH "DUMP1090" "1" "17 August 2014" "" "User Commands"
+.SH NAME dump1090 \- Mode-S decoder
+.SH SYNOPSIS
+.nf
+.fam C
+\fBdump1090\fP
+\fBdump1090\fP \fB--interactive\fP
+\fBdump1090\fP \fB--ifile\fP \fIfile\fP
+
+.fam T
+.fi
+.fam T
+.fi
+.SH DESCRIPTION
+\fBdump1090\fP receives and decodes Mode S packets using the Realtek RTL2832
+software defined radio interface.  It provides the ability to decode
+multiple frame types as well as correct bit errors using the embeded
+24-bit CRC.  Results can be viewed using a text client, via the built-
+in HTTP server or forwarded off to other locations for collection.
+.PP
+
+.SH OPTIONS
+The supported options are as follows:
+.TP
+.B
+\fB--device-index\fP \fIindex\fP
+Select RTL device (default: 0)
+.TP
+.B
+\fB--gain\fP \fIdb\fP
+Set gain (default: max gain. Use \fB-10\fP for auto-gain)
+.TP
+.B
+\fB--enable-agc\fP
+Enable the Automatic Gain Control (default: off)
+.TP
+.B
+\fB--freq\fP \fIhz\fP
+Set frequency (default: 1090 Mhz)
+.TP
+.B
+\fB--ifile\fP \fIfilename\fP
+Read data from \fIfile\fP (use '-' for stdin)
+.TP
+.B
+\fB--interactive\fP
+Display received in a textual table, in real-time.
+.TP
+.B
+\fB--interactive-rows\fP \fInum\fP
+Max number of rows in interactive mode (default: 15)
+.TP
+.B
+\fB--interactive-ttl\fP \fIsec\fP
+Remove from list if idle for \fIsec\fP (default: 60)
+.TP
+.B
+\fB--interactive-rtl1090\fP
+Display flight table in RTL1090 format
+.TP
+.B
+\fB--raw\fP
+Show only messages hex values
+.PP
+\fB--net\fP Enable networking
+.TP
+.B
+\fB--modeac\fP
+Enable decoding of SSR Modes 3/A & 3/C
+.TP
+.B
+\fB--net-beast\fP
+TCP raw output in Beast binary format
+.TP
+.B
+\fB--net-only\fP
+Enable just networking, no RTL device or \fIfile\fP used
+.TP
+.B
+\fB--net-http-port\fP \fIport\fP
+HTTP server port (default: 8080)
+.TP
+.B
+\fB--net-ri-port\fP \fIport\fP
+TCP raw input listen port  (default: 30001)
+.TP
+.B
+\fB--net-ro-port\fP \fIport\fP
+TCP raw output listen port (default: 30002)
+.PP
+\fB--net-sbs-port\fP \fIport\fP TCP BaseStation output listen port (default: 30003)
+.TP
+.B
+\fB--net-bi-port\fP \fIport\fP
+TCP Beast input listen port  (default: 30004)
+.TP
+.B
+\fB--net-bo-port\fP \fIport\fP
+TCP Beast output listen port (default: 30005)
+.TP
+.B
+\fB--net-ro-size\fP \fIsize\fP
+TCP raw output minimum size (default: 0)
+.TP
+.B
+\fB--net-ro-rate\fP \fIrate\fP
+TCP raw output memory flush rate (default: 0)
+.TP
+.B
+\fB--net-heartbeat\fP \fIrate\fP
+TCP heartbeat rate in seconds (default: 60; 0 to disable)
+.TP
+.B
+\fB--net-buffer\fP \fIn\fP
+TCP buffer size 64Kb * (2^n) (default: n=0, 64Kb)
+.TP
+.B
+\fB--lat\fP \fIlatitude\fP
+Reference/receiver latitude for surface posn (opt)
+.TP
+.B
+\fB--lon\fP \fIlongitude\fP
+Reference/receiver longitude for surface posn (opt)
+.TP
+.B
+\fB--fix\fP
+Enable single-bits error correction using CRC
+.TP
+.B
+\fB--no-fix\fP
+Disable single-bits error correction using CRC
+.TP
+.B
+\fB--no-crc-check\fP
+Disable messages with broken CRC (discouraged)
+.TP
+.B
+\fB--phase-enhance\fP
+Enable phase enhancement
+.TP
+.B
+\fB--aggressive\fP
+More CPU for more messages (two bits fixes, \.\.\.)
+.TP
+.B
+\fB--mlat\fP
+display raw messages in Beast ascii mode
+.TP
+.B
+\fB--stats\fP
+With \fB--ifile\fP print stats at exit. No other output
+.TP
+.B
+\fB--onlyaddr\fP
+Show only ICAO addresses (testing purposes)
+.TP
+.B
+\fB--metric\fP
+Use metric units (meters, km/h, \.\.\.)
+.TP
+.B
+\fB--snip\fP \fIlevel\fP
+Strip IQ \fIfile\fP removing samples \fI level
+.TP
+.B
+\fB--debug\fP \fIflags\fP
+Debug mode (verbose)
+.TP
+.B
+\fB--quiet\fP
+Disable output to stdout.
+.TP
+.B
+\fB--ppm\fP \fIerror\fP
+Set receiver error in parts per million (default 0)
+.TP
+.B
+\fB--help\fP
+Show help
+.SH DIAGNOSTICS
+The Debug mode is a visual help to improve the detection algorithm or to
+understand why the program is not working for a given input.
+.PP
+In this mode messages are displayed in an ASCII-art style graphical
+representation, where the individial magnitude bars sampled at 2Mhz are
+displayed.
+.PP
+An index shows the sample number, where 0 is the sample where the first Mode S
+peak was found. Some additional background noise is also added before the
+first peak to provide some context.
+.PP
+Select frames to log using the following flags:
+.TP
+.B
+d
+Log frames decoded with errors
+.TP
+.B
+D
+Log frames decoded with zero errors
+.TP
+.B
+c
+Log frames with bad CRC
+.TP
+.B
+C
+Log frames with good CRC
+.TP
+.B
+p
+Log frames with bad preamble
+.TP
+.B
+n
+Log network debugging info
+.TP
+.B
+j
+Log frames to frames.js, loadable by debug.html
+.SH EXAMPLES
+.TP
+The most basic usage is with no flags, which will open the first found rtl-sdr device and begin printing out hex dumps of the received packets.
+Most people will either run this in interactive mode or as a daemon.  
+.PP
+Interactive mode
+.PP
+.nf
+.fam C
+        dump1090 --interactive
+
+.fam T
+.fi
+Daemon mode
+.PP
+.nf
+.fam C
+        dump1090 --net --quiet &
+
+.fam T
+.fi
+You can also use \fBdump1090\fP as a network hub for multiple receivers by using
+.PP
+.nf
+.fam C
+        dump1090 --net-only
+
+.fam T
+.fi
+.SH BUGS
+Report bugs with the program to the project's github page
+<https://github.com/MalcolmRobb/dump1090/>
+
+.SH AUTHORS
+Dump1090 was originally written by Salvatore Sanfilippo <antirez at gmail.com>.
+This version is now maintained by Malcolm Robb <support at attavionics.com>.
+This was packaged for Debian by Matthew Ernisse <mernisse at ub3rgeek.net>.
+.RE
+.PP
+
diff --git a/debian/dump1090.debhelper.log b/debian/dump1090.debhelper.log
new file mode 100644
index 0000000..0924d1f
--- /dev/null
+++ b/debian/dump1090.debhelper.log
@@ -0,0 +1,47 @@
+dh_auto_configure
+dh_auto_build
+dh_auto_test
+dh_prep
+dh_installdirs
+dh_auto_install
+dh_install
+dh_installdocs
+dh_installchangelogs
+dh_installexamples
+dh_installman
+dh_installcatalogs
+dh_installcron
+dh_installdebconf
+dh_installemacsen
+dh_installifupdown
+dh_installinfo
+dh_installinit
+dh_installmenu
+dh_installmime
+dh_installmodules
+dh_installlogcheck
+dh_installlogrotate
+dh_installpam
+dh_installppp
+dh_installudev
+dh_installwm
+dh_installxfonts
+dh_installgsettings
+dh_bugfiles
+dh_ucf
+dh_lintian
+dh_gconf
+dh_icons
+dh_perl
+dh_usrlocal
+dh_link
+dh_compress
+dh_fixperms
+dh_strip
+dh_makeshlibs
+dh_shlibdeps
+dh_installdeb
+dh_gencontrol
+dh_md5sums
+dh_builddeb
+dh_builddeb
diff --git a/debian/dump1090.dirs b/debian/dump1090.dirs
index 7faf9e1..ca882bb 100644
--- a/debian/dump1090.dirs
+++ b/debian/dump1090.dirs
@@ -1,4 +1,2 @@
 usr/bin
 usr/sbin
-usr/share/dump1090/public_html
-
diff --git a/debian/dump1090.manpages b/debian/dump1090.manpages
new file mode 100644
index 0000000..51b1f1f
--- /dev/null
+++ b/debian/dump1090.manpages
@@ -0,0 +1 @@
+debian/*.1 
diff --git a/debian/dump1090.postinst.debhelper b/debian/dump1090.postinst.debhelper
new file mode 100644
index 0000000..431f417
--- /dev/null
+++ b/debian/dump1090.postinst.debhelper
@@ -0,0 +1,6 @@
+# Automatically added by dh_installinit
+if [ -x "/etc/init.d/dump1090" ]; then
+	update-rc.d dump1090 defaults >/dev/null
+	invoke-rc.d dump1090 start || exit $?
+fi
+# End automatically added section
diff --git a/debian/dump1090.postrm.debhelper b/debian/dump1090.postrm.debhelper
new file mode 100644
index 0000000..fcda6ba
--- /dev/null
+++ b/debian/dump1090.postrm.debhelper
@@ -0,0 +1,5 @@
+# Automatically added by dh_installinit
+if [ "$1" = "purge" ] ; then
+	update-rc.d dump1090 remove >/dev/null
+fi
+# End automatically added section
diff --git a/debian/dump1090.prerm.debhelper b/debian/dump1090.prerm.debhelper
new file mode 100644
index 0000000..9374ac0
--- /dev/null
+++ b/debian/dump1090.prerm.debhelper
@@ -0,0 +1,5 @@
+# Automatically added by dh_installinit
+if [ -x "/etc/init.d/dump1090" ]; then
+	invoke-rc.d dump1090 stop || exit $?
+fi
+# End automatically added section
diff --git a/debian/dump1090.substvars b/debian/dump1090.substvars
new file mode 100644
index 0000000..e907dfc
--- /dev/null
+++ b/debian/dump1090.substvars
@@ -0,0 +1,2 @@
+shlibs:Depends=libc6 (>= 2.4), libc6 (>= 2.13-28), libgcc1 (>= 1:4.4.0), libusb-1.0-0 (>= 2:1.0.9)
+misc:Depends=
diff --git a/debian/files b/debian/files
new file mode 100644
index 0000000..2d42d36
--- /dev/null
+++ b/debian/files
@@ -0,0 +1 @@
+dump1090_1.09.0608.14-2_armhf.deb utils extra
diff --git a/debian/lintian-overrides b/debian/lintian-overrides
deleted file mode 100644
index 0f08d1a..0000000
--- a/debian/lintian-overrides
+++ /dev/null
@@ -1,4 +0,0 @@
-binary-without-manpage usr/sbin/dump1090
-binary-without-manpage usr/sbin/ppup1090
-binary-without-manpage usr/bin/view1090
-new-package-should-close-itp-bug
diff --git a/debian/patches/00-makefile.patch b/debian/patches/00-makefile.patch
index e2e5c9e..4ced030 100644
--- a/debian/patches/00-makefile.patch
+++ b/debian/patches/00-makefile.patch
@@ -1,6 +1,6 @@
 --- a/Makefile
 +++ b/Makefile
-@@ -4,18 +4,20 @@
+@@ -4,18 +4,35 @@
  #
  PROGNAME=dump1090
  
@@ -8,10 +8,6 @@
 -BINDIR=$(PREFIX)/bin
 -SHAREDIR=$(PREFIX)/share/$(PROGNAME)
 -EXTRACFLAGS=-DHTMLPATH=\"$(SHAREDIR)\"
--endif
--
--CFLAGS=-O2 -g -Wall -W `pkg-config --cflags librtlsdr`
--LIBS=`pkg-config --libs librtlsdr` -lpthread -lm
 +BINDIR=$(DESTDIR)/usr/bin
 +SBINDIR=$(DESTDIR)/usr/sbin
 +SHAREDIR=$(DESTDIR)/usr/share/$(PROGNAME)
@@ -23,15 +19,32 @@
 +CFLAGS += $(shell dpkg-buildflags --get CXXFLAGS)
 +LIBS=$(shell pkg-config --libs librtlsdr) -lpthread -lm
 +LDFLAGS=$(shell dpkg-buildflags --get LDFLAGS)
- CC=gcc
++CC=gcc
++
++ARCH=$(shell uname -m)
++
++# ppup1090 requires coaa1090.obj which is an ARM binary.
++# So only build ppup1090 on an ARM platform.
++ifneq (,$(findstring arm, $(ARCH)))
++	ARCH=arm
++else
++	ARCH=other
+ endif
+ 
+-CFLAGS=-O2 -g -Wall -W `pkg-config --cflags librtlsdr`
+-LIBS=`pkg-config --libs librtlsdr` -lpthread -lm
+-CC=gcc
++all: all-$(ARCH)
++install: installbin-$(ARCH) installhtml
+ 
  
--
 -all: dump1090 view1090
-+all: dump1090 ppup1090 view1090
++all-other: dump1090 view1090
++all-arm: dump1090 ppup1090 view1090
  
  %.o: %.c
  	$(CC) $(CFLAGS) $(EXTRACFLAGS) -c $<
-@@ -23,8 +25,23 @@
+@@ -23,8 +40,25 @@
  dump1090: dump1090.o anet.o interactive.o mode_ac.o mode_s.o net_io.o
  	$(CC) -g -o dump1090 dump1090.o anet.o interactive.o mode_ac.o mode_s.o net_io.o $(LIBS) $(LDFLAGS)
  
@@ -45,9 +58,11 @@
 -	rm -f *.o dump1090 view1090
 +	rm -f *.o dump1090 ppup1090 view1090
 +
-+install: installbin installhtml
++installbin-other:
++	install -m755 dump1090 $(SBINDIR)
++	install -m755 view1090 $(BINDIR)
 +
-+installbin:
++installbin-arm:
 +	install -m755 dump1090 $(SBINDIR)
 +	install -m755 ppup1090 $(SBINDIR)
 +	install -m755 view1090 $(BINDIR)
diff --git a/debian/ppup1090.1 b/debian/ppup1090.1
new file mode 100644
index 0000000..57d54a6
--- /dev/null
+++ b/debian/ppup1090.1
@@ -0,0 +1,80 @@
+.\"Text automatically generated by txt2man
+.\" Copyright (c) 2014 Matthew John Ernisse <mernisse at ub3rgeek.net>
+.\" All Rights Reserved.
+.\"
+.\"Redistribution and use in source and binary forms,
+.\"with or without modification, are permitted provided
+.\"that the following conditions are met:
+.\"
+.\"    * Redistributions of source code must retain the
+.\"      above copyright notice, this list of conditions
+.\"      and the following disclaimer.
+.\"    * Redistributions in binary form must reproduce
+.\"     the above copyright notice, this list of conditions
+.\"      and the following disclaimer in the documentation
+.\"      and/or other materials provided with the distribution.
+.\"
+.\"THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+.\""AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+.\"LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+.\"FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+.\"COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+.\"INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+.\"BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
+.\"OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+.\"ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
+.\"TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
+.\"USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
+.TH "PPUP1090" "1" "17 August 2014" "" ""
+.SH NAME ppup1090 \- Uploader for COAA Planeplotter
+.SH SYNOPSIS
+.nf
+.fam C
+\fBppup1090\fP \fB--net-pp-ipaddr\fP \fIaddr\fP
+
+.fam T
+.fi
+.fam T
+.fi
+.SH DESCRIPTION
+\fBppup1090\fP allows you to connect to a TCP Beast compliant stream and send
+the messages to COAA's Planeplotter software.
+.SH OPTIONS
+The supported options are as follows:
+.TP
+.B
+\fB--net-bo-ipaddr\fP \fIaddr\fP
+TCP Beast server address (default: 127.0.0.1)
+.TP
+.B
+\fB--net-bo-port\fP \fIport\fP
+TCP Beast server port (default: 30005)
+.TP
+.B
+\fB--net-pp-ipaddr\fP \fIaddr\fP
+IP address for the machine running Planeplotter
+.TP
+.B
+\fB--quiet\fP
+Disable output to stdout.
+.TP
+.B
+\fB--help\fP
+Show help
+.RE
+.PP
+.SH NOTES
+This command only exists on ARM architecture systems due to its dependance
+on a binary-only component.
+.PP
+.SH BUGS
+Report bugs with the program to the project's github page
+<https://github.com/MalcolmRobb/dump1090/>
+.PP
+.SH AUTHORS
+Dump1090 was originally written by Salvatore Sanfilippo <antirez at gmail.com>.
+This version is now maintained by Malcolm Robb <support at attavionics.com>.
+This was packaged for Debian by Matthew Ernisse <mernisse at ub3rgeek.net>.
+.RE
+.PP
diff --git a/debian/rules b/debian/rules
index 999968b..05cc727 100755
--- a/debian/rules
+++ b/debian/rules
@@ -5,13 +5,5 @@ export DEB_BUILD_MAINT_OPTIONS = hardening=+all
 DPKG_EXPORT_BUILDFLAGS = 1
 include /usr/share/dpkg/buildflags.mk
 
-
-# Uncomment this to turn on verbose mode.
-#export DH_VERBOSE=1
-
-build:
-	dh_testdir
-	dh_auto_build 
-
 %:
 	dh $@ 
diff --git a/debian/view1090.1 b/debian/view1090.1
new file mode 100644
index 0000000..3cc61e3
--- /dev/null
+++ b/debian/view1090.1
@@ -0,0 +1,139 @@
+.\"Text automatically generated by txt2man
+.\" Copyright (c) 2014 Matthew John Ernisse <mernisse at ub3rgeek.net>
+.\" All Rights Reserved.
+.\"
+.\"Redistribution and use in source and binary forms,
+.\"with or without modification, are permitted provided
+.\"that the following conditions are met:
+.\"
+.\"    * Redistributions of source code must retain the
+.\"      above copyright notice, this list of conditions
+.\"      and the following disclaimer.
+.\"    * Redistributions in binary form must reproduce
+.\"     the above copyright notice, this list of conditions
+.\"      and the following disclaimer in the documentation
+.\"      and/or other materials provided with the distribution.
+.\"
+.\"THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+.\""AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+.\"LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+.\"FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+.\"COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+.\"INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+.\"BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
+.\"OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+.\"ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
+.\"TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
+.\"USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
+.TH "VIEW1090" "1" "17 August 2014" "" "User Commands"
+.SH NAME view1090 \- Text client for dump1090
+.SH SYNOPSIS
+.nf
+.fam C
+\fBview1090\fP
+\fBview1090\fP \fB--net-bo-ipaddr\fP \fIipaddr\fP \fB--net-bo-port\fP \fIport\fP
+
+.fam T
+.fi
+.fam T
+.fi
+.SH DESCRIPTION
+\fBview1090\fP allows you to connect to a TCP Beast compliant stream and view
+the decoded messages in an ASCII-text table.
+.RE
+.PP
+
+.SH OPTIONS
+The supported options are as follows:
+.TP
+.B
+\fB--interactive\fP
+Display received in a textual table, in real-time.
+.TP
+.B
+\fB--interactive-rows\fP \fInum\fP
+Max number of rows in interactive mode (default: 15)
+.TP
+.B
+\fB--interactive-ttl\fP \fIsec\fP
+Remove from list if idle for \fIsec\fP (default: 60)
+.TP
+.B
+\fB--interactive-rtl1090\fP
+Display flight table in RTL1090 format
+.TP
+.B
+\fB--modeac\fP
+Enable decoding of SSR Modes 3/A & 3/C
+.TP
+.B
+\fB--net-bo-ipaddr\fP \fIIPv4\fP
+TCP Beast server address (default: 127.0.0.1)
+.TP
+.B
+\fB--net-bo-port\fP \fIport\fP
+TCP Beast server port (default: 30005)
+.TP
+.B
+\fB--lat\fP \fIlatitude\fP
+Reference/receiver latitude for surface posn (opt)
+.TP
+.B
+\fB--lon\fP \fIlongitude\fP
+Reference/receiver longitude for surface posn (opt)
+.TP
+.B
+\fB--fix\fP
+Enable single-bits error correction using CRC
+.TP
+.B
+\fB--no-fix\fP
+Disable single-bits error correction using CRC
+.TP
+.B
+\fB--no-crc-check\fP
+Disable messages with broken CRC (discouraged)
+.TP
+.B
+\fB--aggressive\fP
+More CPU for more messages (two bits fixes, \.\.\.)
+.TP
+.B
+\fB--metric\fP
+Use metric units (meters, km/h, \.\.\.)
+.TP
+.B
+\fB--help\fP
+Show help
+.SH EXAMPLES
+The most basic usage is with no flags, which will connect to the dump1090
+instance running on the local host.
+.PP
+.nf
+.fam C
+        view1090 
+
+.fam T
+.fi
+To connect to a remote instance you can specify the IPv4 address of that
+host.
+.PP
+.nf
+.fam C
+        view1090 --net-bo-ipaddr \fIipaddr\fP
+
+
+.fam T
+.fi
+.SH BUGS
+Report bugs with the program to the project's github page
+<https://github.com/MalcolmRobb/dump1090/>
+
+.SH AUTHORS
+Dump1090 was originally written by Salvatore Sanfilippo <antirez at gmail.com>.
+This version is now maintained by Malcolm Robb <support at attavionics.com>.
+This was packaged for Debian by Matthew Ernisse <mernisse at ub3rgeek.net>.
+.RE
+.PP
+

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-hamradio/dump1090.git

More information about the pkg-hamradio-commits mailing list