Source: mzclient
Version: 0.9.0-4
Severity: wishlist
Tags: patch

According to 'Debian Policy', each program should have an associated manual
page included in the same package. However, we still haven't included
any manual pagefor mzclient command.

I have appended a patch to include a brief man page, which is based from
the help2man result of 'mzclient' command.

-- System Information:
Debian Release: jessie/sid
  APT prefers trusty-updates
  APT policy: (500, 'trusty-updates'), (500, 'trusty-security'), (500, 
'trusty'), (100, 'trusty-backports')
Architecture: amd64 (x86_64)
Foreign Architectures: i386

Kernel: Linux 3.13.0-32-generic (SMP w/1 CPU core)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
diff -Nru mono-zeroconf-0.9.0/debian/changelog mono-zeroconf-0.9.0/debian/changelog
--- mono-zeroconf-0.9.0/debian/changelog	2012-01-22 13:25:44.000000000 +0000
+++ mono-zeroconf-0.9.0/debian/changelog	2014-10-04 14:38:44.000000000 +0000
@@ -1,3 +1,9 @@
+mono-zeroconf (0.9.0-5) unstable; urgency=wishlist
+
+  * Moving manpage of innochecksum to mysql-client-5.5 binary package.
+
+ -- Chen Baozi <ba...@gmail.com>  Sat, 04 Oct 2014 14:35:37 +0000
+
 mono-zeroconf (0.9.0-4) unstable; urgency=low
 
   * [1cbf0fc] Modernise packaging.
diff -Nru mono-zeroconf-0.9.0/debian/mzclient.1 mono-zeroconf-0.9.0/debian/mzclient.1
--- mono-zeroconf-0.9.0/debian/mzclient.1	1970-01-01 00:00:00.000000000 +0000
+++ mono-zeroconf-0.9.0/debian/mzclient.1	2014-10-04 14:38:51.000000000 +0000
@@ -0,0 +1,69 @@
+.TH MZCLIENT "1" "October 2014" "mzclient" "User Commands"
+.SH NAME
+mzclient \- used for resolving or publishing services from the commandline.
+.SH SYNOPSIS
+mzclient
+[\fB\,-t\fR type\/] [\,--resolve\/] [\,--publish "description"\/]
+.SH DESCRIPTION
+CLI library for multicast DNS service discovery (commandline tool)
+.PP
+Mono.Zeroconf is a cross platform Zero Configuration Networking library for
+Mono and .NET. It provides a unified API for performing the most common
+zeroconf operations on a variety of platforms and subsystems: all the
+operating systems supported by Mono and both the Avahi and
+Bonjour/mDNSResponder transports.
+.PP
+By using Mono.ZeroConf applications can use a single API that will work
+regardless of the underlying implementation that a particular operating
+system uses.
+.PP
+Applications can publish services that will be exposed to other computers on
+the network and also query the local machines on the network for services
+that could have been exposed.
+.PP
+.I mzclient
+can be used for resolving or publishing services from the commandline.
+.PP
+.SH OPTIONS
+.TP
+\fB\-h\fR, \-\-help
+shows this help
+.TP
+\fB\-v\fR, \-\-verbose
+print verbose details of what's happening
+.TP
+\fB\-t\fR, \-\-type
+uses 'type' as the service type
+(default is '_workstation._tcp')
+.TP
+\fB\-r\fR, \-\-resolve
+resolve found services to hosts
+.TP
+\fB\-d\fR, \-\-domain
+which domain to broadcast/listen on
+.TP
+\fB\-i\fR, \-\-interface
+which network interface index to listen
+on (default is '0', meaning 'all')
+.TP
+\fB\-a\fR, \-\-aprotocol
+which address protocol to use (Any, IPv4, IPv6)
+.TP
+\fB\-p\fR, \-\-publish
+publish a service of 'description'
+.PP
+.SH USAGE
+The \fB\-d\fR, \fB\-i\fR and \fB\-a\fR options are optional. By default mzclient will listen
+on all network interfaces ('0') on the 'local' domain, and will resolve
+all address types, IPv4 and IPv6, as available.
+.PP
+The service description for publishing has the following syntax.
+The TXT record is optional.
+.IP
+<type> <port> <name> TXT [ <key>='<value>', ... ]
+.PP
+For example:
+.HP
+\fB\-p\fR "_http._tcp 80 Simple Web Server"
+.HP
+\fB\-p\fR "_daap._tcp 3689 Aaron's Music TXT [ Password='false', Machine Name='Aaron\e's Box', txtvers='1' ]"
diff -Nru mono-zeroconf-0.9.0/debian/mzclient.install mono-zeroconf-0.9.0/debian/mzclient.install
--- mono-zeroconf-0.9.0/debian/mzclient.install	2012-01-22 13:25:44.000000000 +0000
+++ mono-zeroconf-0.9.0/debian/mzclient.install	2014-10-04 14:38:48.000000000 +0000
@@ -1,2 +1,3 @@
 debian/tmp/usr/bin/mzclient
 debian/tmp/usr/lib/mono-zeroconf/MZClient.exe*
+debian/mzclient.1 usr/share/man/man1

Reply via email to