Add a summary comment in all other printers

Moreover:
Remove some redundant comments
Update some summary comments
Update the specification URL for ATA over Ethernet (AoE) protocol

59 files changed, 146 insertions, 90 deletions

diff --git a/print-802_15_4.c b/print-802_15_4.c
index 4a1ef49b..6fe6d35b 100644
--- a/print-802_15_4.c
+++ b/print-802_15_4.c
@@ -20,6 +20,8 @@
  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  */
 
+/* \summary: IEEE 802.15.4 printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-ahcp.c b/print-ahcp.c
index 9f95947d..067b5069 100644
--- a/print-ahcp.c
+++ b/print-ahcp.c
@@ -1,8 +1,4 @@
 /*
- * This module implements decoding of AHCP (Ad Hoc Configuration Protocol) based
- * on draft-chroboczek-ahcp-00 and source code of ahcpd-0.53.
- *
- *
  * Copyright (c) 2013 The TCPDUMP project
  * All rights reserved.
  *
@@ -29,6 +25,10 @@
  * POSSIBILITY OF SUCH DAMAGE.
  */
 
+/* \summary: Ad Hoc Configuration Protocol (AHCP) printer */
+
+/* Based on draft-chroboczek-ahcp-00 and source code of ahcpd-0.53 */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-aoe.c b/print-aoe.c
index d4ac4fb7..97e93df2 100644
--- a/print-aoe.c
+++ b/print-aoe.c
@@ -1,8 +1,4 @@
 /*
- * This module implements decoding of the ATA over Ethernet (AoE) protocol
- * according to the following specification:
- * http://support.coraid.com/documents/AoEr11.txt
- *
  * Copyright (c) 2014 The TCPDUMP project
  * All rights reserved.
  *
@@ -29,6 +25,10 @@
  * POSSIBILITY OF SUCH DAMAGE.
  */
 
+/* \summary: ATA over Ethernet (AoE) protocol printer */
+
+/* specification: http://brantleycoilecompany.com/AoEr11.pdf */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-atalk.c b/print-atalk.c
index cd4812f3..2a674990 100644
--- a/print-atalk.c
+++ b/print-atalk.c
@@ -17,8 +17,6 @@
  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
  * WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
- *
- * Format and print AppleTalk packets.
  */
 
 /* \summary: AppleTalk printer */
diff --git a/print-babel.c b/print-babel.c
index f4e62f34..f8741d7b 100644
--- a/print-babel.c
+++ b/print-babel.c
@@ -26,6 +26,8 @@
  * SUCH DAMAGE.
  */
 
+/* \summary: Babel Routing Protocol printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-bfd.c b/print-bfd.c
index 2950d22e..8a7afbcc 100644
--- a/print-bfd.c
+++ b/print-bfd.c
@@ -13,6 +13,8 @@
  * Original code by Hannes Gredler (hannes@juniper.net)
  */
 
+/* \summary: Bidirectional Forwarding Detection (BFD) printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-bootp.c b/print-bootp.c
index f6d0cbd0..d16bd9db 100644
--- a/print-bootp.c
+++ b/print-bootp.c
@@ -17,8 +17,6 @@
  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
  * WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
- *
- * Format and print bootp packets.
  */
 
 /* \summary: BOOTP and IPv4 DHCP printer */
diff --git a/print-calm-fast.c b/print-calm-fast.c
index a1690c0a..4e4e51af 100644
--- a/print-calm-fast.c
+++ b/print-calm-fast.c
@@ -15,6 +15,8 @@
  * Original code by Ola Martin Lykkja (ola.lykkja@q-free.com)
  */
 
+/* \summary: Communication access for land mobiles (CALM) printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-carp.c b/print-carp.c
index eb893e2a..c650d181 100644
--- a/print-carp.c
+++ b/print-carp.c
@@ -34,6 +34,8 @@
  *
  */
 
+/* \summary: Common Address Redundancy Protocol (CARP) printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-cfm.c b/print-cfm.c
index 2d67e84c..745492bd 100644
--- a/print-cfm.c
+++ b/print-cfm.c
@@ -12,11 +12,11 @@
  * LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  * FOR A PARTICULAR PURPOSE.
  *
- * Support for the IEEE Connectivity Fault Management Protocols as per 802.1ag.
- *
  * Original code by Hannes Gredler (hannes@juniper.net)
  */
 
+/* \summary: IEEE 802.1ag Connectivity Fault Management (CFM) protocols printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-dtp.c b/print-dtp.c
index 63bde45b..1d8c66a0 100644
--- a/print-dtp.c
+++ b/print-dtp.c
@@ -12,11 +12,11 @@
  * LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  * FOR A PARTICULAR PURPOSE.
  *
- * Dynamic Trunk Protocol (DTP)
- *
  * Original code by Carles Kishimoto <carles.kishimoto@gmail.com>
  */
 
+/* \summary: Dynamic Trunking Protocol (DTP) printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-eap.c b/print-eap.c
index d9ce2958..ea081d19 100644
--- a/print-eap.c
+++ b/print-eap.c
@@ -16,9 +16,6 @@
  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
  * WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
- *
- * Format and print EAP packets.
- *
  */
 
 /* \summary: Extensible Authentication Protocol (EAP) printer */
diff --git a/print-eigrp.c b/print-eigrp.c
index a56aae71..7e1ffb78 100644
--- a/print-eigrp.c
+++ b/print-eigrp.c
@@ -14,6 +14,8 @@
  * FOR A PARTICULAR PURPOSE.
  */
 
+/* \summary: Enhanced Interior Gateway Routing Protocol (EIGRP) printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-forces.c b/print-forces.c
index 40789611..f98bd061 100644
--- a/print-forces.c
+++ b/print-forces.c
@@ -14,6 +14,10 @@
  *
  */
 
+/* \summary: Forwarding and Control Element Separation (ForCES) Protocol printer */
+
+/* specification: RFC 5810 */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
@@ -25,9 +29,6 @@
 
 static const char tstr[] = "[|forces]";
 
-/*
- * RFC5810: Forwarding and Control Element Separation (ForCES) Protocol
- */
 #define	ForCES_VERS	1
 #define	ForCES_HDRL	24
 #define	ForCES_ALNL	4U
diff --git a/print-ftp.c b/print-ftp.c
index 93591395..a1dd6070 100644
--- a/print-ftp.c
+++ b/print-ftp.c
@@ -11,10 +11,7 @@
  * FOR A PARTICULAR PURPOSE.
  */
 
-#ifndef lint
-static const char rcsid[] _U_ =
-    "@(#) $Header$";
-#endif
+/* \summary: File Transfer Protocol (FTP) printer */
 
 #ifdef HAVE_CONFIG_H
 #include "config.h"
diff --git a/print-geneve.c b/print-geneve.c
index c4645dbe..d565103d 100644
--- a/print-geneve.c
+++ b/print-geneve.c
@@ -15,6 +15,8 @@
  * FOR A PARTICULAR PURPOSE.
  */
 
+/* \summary: Generic Network Virtualization Encapsulation (Geneve) printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-geonet.c b/print-geonet.c
index 420ec5f7..61441a0b 100644
--- a/print-geonet.c
+++ b/print-geonet.c
@@ -15,6 +15,8 @@
  * Original code by Ola Martin Lykkja (ola.lykkja@q-free.com)
  */
 
+/* \summary: ISO CALM FAST and ETSI GeoNetworking printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-hncp.c b/print-hncp.c
index 776675ba..89ece160 100644
--- a/print-hncp.c
+++ b/print-hncp.c
@@ -26,6 +26,8 @@
  * SUCH DAMAGE.
  */
 
+/* \summary: Home Networking Control Protocol (HNCP) printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-http.c b/print-http.c
index b18b8861..0aec7581 100644
--- a/print-http.c
+++ b/print-http.c
@@ -11,10 +11,7 @@
  * FOR A PARTICULAR PURPOSE.
  */
 
-#ifndef lint
-static const char rcsid[] _U_ =
-    "@(#) $Header$";
-#endif
+/* \summary: Hypertext Transfer Protocol (HTTP) printer */
 
 #ifdef HAVE_CONFIG_H
 #include "config.h"
diff --git a/print-ipfc.c b/print-ipfc.c
index 6907ba3e..fc204652 100644
--- a/print-ipfc.c
+++ b/print-ipfc.c
@@ -19,6 +19,10 @@
  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  */
 
+/* \summary: IP over Fibre Channel printer */
+
+/* specification: RFC 2625 */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
@@ -32,10 +36,6 @@
 
 #include "ether.h"
 
-/*
- * RFC 2625 IP-over-Fibre Channel.
- */
-
 struct ipfc_header {
 	u_char  ipfc_dhost[8];
 	u_char  ipfc_shost[8];
diff --git a/print-ipnet.c b/print-ipnet.c
index 7fb2e77a..f71c1455 100644
--- a/print-ipnet.c
+++ b/print-ipnet.c
@@ -1,3 +1,5 @@
+/* \summary: Solaris DLT_IPNET printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-ipx.c b/print-ipx.c
index e7d7046a..d807a66e 100644
--- a/print-ipx.c
+++ b/print-ipx.c
@@ -18,7 +18,6 @@
  * WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  *
- * Format and print Novell IPX packets.
  * Contributed by Brad Parker (brad@fcr.com).
  */
 
diff --git a/print-juniper.c b/print-juniper.c
index 94151c81..a9a9339a 100644
--- a/print-juniper.c
+++ b/print-juniper.c
@@ -15,6 +15,8 @@
  * Original code by Hannes Gredler (hannes@juniper.net)
  */
 
+/* \summary: DLT_JUNIPER_* printers */
+
 #ifndef lint
 #else
 __RCSID("NetBSD: print-juniper.c,v 1.3 2007/07/25 06:31:32 dogcow Exp ");
diff --git a/print-ldp.c b/print-ldp.c
index 45a23fe0..68149bba 100644
--- a/print-ldp.c
+++ b/print-ldp.c
@@ -14,6 +14,8 @@
  *  and Steinar Haug (sthaug@nethelp.no)
  */
 
+/* \summary: Label Distribution Protocol (LDP) printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-lisp.c b/print-lisp.c
index e9a2bc13..47afe503 100644
--- a/print-lisp.c
+++ b/print-lisp.c
@@ -26,9 +26,10 @@
  * POSSIBILITY OF SUCH DAMAGE.
  */
 
+/* \summary: - Locator/Identifier Separation Protocol (LISP) printer */
+
 /*
- * netdissect printer for LISP - Locator/Identifier Separation Protocol
- * RFC 6830
+ * specification: RFC 6830
  *
  *
  * The Map-Register message format is:
diff --git a/print-lldp.c b/print-lldp.c
index a0ca7009..e0539462 100644
--- a/print-lldp.c
+++ b/print-lldp.c
@@ -12,13 +12,13 @@
  * LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  * FOR A PARTICULAR PURPOSE.
  *
- * support for the IEEE Link Discovery Protocol as per 802.1AB
- *
  * Original code by Hannes Gredler (hannes@juniper.net)
  * IEEE and TIA extensions by Carles Kishimoto <carles.kishimoto@gmail.com>
  * DCBX extensions by Kaladhar Musunuru <kaladharm@sourceforge.net>
  */
 
+/* \summary: IEEE 802.1ab Link Layer Discovery Protocol (LLDP) printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-lmp.c b/print-lmp.c
index 30edfc74..f7093374 100644
--- a/print-lmp.c
+++ b/print-lmp.c
@@ -10,13 +10,15 @@
  * LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  * FOR A PARTICULAR PURPOSE.
  *
- * Support for the Link Management Protocol as per rfc 4204.
- *
  * Original code by Hannes Gredler (hannes@juniper.net)
  * Support for LMP service discovery extensions (defined by UNI 1.0) added
  * by Manu Pathak (mapathak@cisco.com), May 2005
  */
 
+/* \summary: Link Management Protocol (LMP) printer */
+
+/* specification: RFC 4204 */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-loopback.c b/print-loopback.c
index 2d5fca5d..10f69310 100644
--- a/print-loopback.c
+++ b/print-loopback.c
@@ -1,9 +1,4 @@
 /*
- * This module implements decoding of the Loopback Protocol, originally
- * defined as the Configuration Testing Protocol. It is based on the following
- * specification:
- * http://www.mit.edu/people/jhawk/ctp.pdf
- *
  * Copyright (c) 2014 The TCPDUMP project
  * All rights reserved.
  *
@@ -30,6 +25,13 @@
  * POSSIBILITY OF SUCH DAMAGE.
  */
 
+/* \summary: Loopback Protocol printer */
+
+/*
+ * originally defined as the Ethernet Configuration Testing Protocol.
+ * specification: http://www.mit.edu/people/jhawk/ctp.pdf
+ */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-lwapp.c b/print-lwapp.c
index 447ca60a..bab3219f 100644
--- a/print-lwapp.c
+++ b/print-lwapp.c
@@ -12,11 +12,13 @@
  * LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  * FOR A PARTICULAR PURPOSE.
  *
- * Support for the Light Weight Access Point Protocol as per RFC 5412
- *
  * Original code by Carles Kishimoto <carles.kishimoto@gmail.com>
  */
 
+/* \summary: Light Weight Access Point Protocol (LWAPP) printer */
+
+/* specification: RFC 5412 */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-m3ua.c b/print-m3ua.c
index e4de7131..1f974b2f 100644
--- a/print-m3ua.c
+++ b/print-m3ua.c
@@ -22,6 +22,10 @@
  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
 
+/* \summary: Message Transfer Part 3 (MTP3) User Adaptation Layer (M3UA) printer */
+
+/* RFC 4666 */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
@@ -33,8 +37,6 @@
 
 static const char tstr[] = " [|m3ua]";
 
-/* RFC 4666 */
-
 #define M3UA_REL_1_0 1
 
 struct m3ua_common_header {
diff --git a/print-medsa.c b/print-medsa.c
index a29bf4a0..1266c9c8 100644
--- a/print-medsa.c
+++ b/print-medsa.c
@@ -19,6 +19,8 @@
  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  */
 
+/* \summary: Marvell Extended Distributed Switch Architecture (MEDSA) printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-mpcp.c b/print-mpcp.c
index 5bd04669..1b9a5d7e 100644
--- a/print-mpcp.c
+++ b/print-mpcp.c
@@ -12,11 +12,11 @@
  * LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  * FOR A PARTICULAR PURPOSE.
  *
- * support for the IEEE MPCP protocol as per 802.3ah
- *
  * Original code by Hannes Gredler (hannes@juniper.net)
  */
 
+/* \summary: IEEE 802.3ah Multi-Point Control Protocol (MPCP) printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-mptcp.c b/print-mptcp.c
index c711754f..e757ea48 100644
--- a/print-mptcp.c
+++ b/print-mptcp.c
@@ -32,6 +32,10 @@
  * SUCH DAMAGE.
  */
 
+/* \summary: Multipath TCP (MPTCP) printer */
+
+/* specification: RFC 6824 */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-msnlb.c b/print-msnlb.c
index d4f66037..5264da49 100644
--- a/print-msnlb.c
+++ b/print-msnlb.c
@@ -26,6 +26,8 @@
  * SUCH DAMAGE.
  */
 
+/* \summary: MS Network Load Balancing's (NLB) heartbeat printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-nflog.c b/print-nflog.c
index 0eefd342..41cbf788 100644
--- a/print-nflog.c
+++ b/print-nflog.c
@@ -25,6 +25,8 @@
  * DAMAGE.
  */
 
+/* \summary: DLT_NFLOG printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-nsh.c b/print-nsh.c
index 0130e6dd..82976a03 100644
--- a/print-nsh.c
+++ b/print-nsh.c
@@ -21,6 +21,10 @@
  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
 
+/* \summary: Network Service Header (NSH) printer */
+
+/* specification: draft-ietf-sfc-nsh-01 */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
@@ -41,10 +45,6 @@ static const struct tok nsh_flags [] = {
 #define NSH_SERVICE_PATH_HDR_LEN 4
 #define NSH_HDR_WORD_SIZE 4U
 
-/*
- * NSH, draft-ietf-sfc-nsh-01 Network Service Header
- */
-
 void
 nsh_print(netdissect_options *ndo, const u_char *bp, u_int len)
 {
diff --git a/print-ntp.c b/print-ntp.c
index 76ae0d11..0689264f 100644
--- a/print-ntp.c
+++ b/print-ntp.c
@@ -18,7 +18,6 @@
  * WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  *
- * Format and print ntp packets.
  *	By Jeffrey Mogul/DECWRL
  *	loosely based on print-bootp.c
  */
diff --git a/print-olsr.c b/print-olsr.c
index 2473dfed..e095ef71 100644
--- a/print-olsr.c
+++ b/print-olsr.c
@@ -13,12 +13,14 @@
  * LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  * FOR A PARTICULAR PURPOSE.
  *
- * Optimized Link State Protocl (OLSR) as per rfc3626
- *
  * Original code by Hannes Gredler <hannes@juniper.net>
  * IPv6 additions by Florian Forster <octo at verplant.org>
  */
 
+/* \summary: Optimized Link State Routing Protocol (OLSR) printer */
+
+/* specification: RFC 3626 */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-openflow-1.0.c b/print-openflow-1.0.c
index a1b9f1e0..ce958430 100644
--- a/print-openflow-1.0.c
+++ b/print-openflow-1.0.c
@@ -56,6 +56,8 @@
  * POSSIBILITY OF SUCH DAMAGE.
  */
 
+/* \summary: OpenFlow protocol version 1.0 printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-openflow.c b/print-openflow.c
index 07f15de6..043adc2e 100644
--- a/print-openflow.c
+++ b/print-openflow.c
@@ -30,6 +30,8 @@
  * POSSIBILITY OF SUCH DAMAGE.
  */
 
+/* \summary: version-independent OpenFlow printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-otv.c b/print-otv.c
index 3490d066..1b051072 100644
--- a/print-otv.c
+++ b/print-otv.c
@@ -13,6 +13,10 @@
  * Original code by Francesco Fondelli (francesco dot fondelli, gmail dot com)
  */
 
+/* \summary: Overlay Transport Virtualization (OTV) printer */
+
+/* specification: draft-hasmit-otv-04 */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-pktap.c b/print-pktap.c
index a49421bb..0680f9e0 100644
--- a/print-pktap.c
+++ b/print-pktap.c
@@ -19,6 +19,8 @@
  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  */
 
+/* \summary: Apple's DLT_PKTAP printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-ppi.c b/print-ppi.c
index 39571540..cb8f3b95 100644
--- a/print-ppi.c
+++ b/print-ppi.c
@@ -2,6 +2,8 @@
  * Oracle
  */
 
+/* \summary: Oracle DLT_PPI printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-resp.c b/print-resp.c
index 5e36edaf..2fed3aee 100644
--- a/print-resp.c
+++ b/print-resp.c
@@ -1,7 +1,4 @@
 /*
- * This file implements decoding of the REdis Serialization Protocol.
- *
- *
  * Copyright (c) 2015 The TCPDUMP project
  * All rights reserved.
  *
@@ -30,6 +27,8 @@
  * Initial contribution by Andrew Darqui (andrew.darqui@gmail.com).
  */
 
+/* \summary: REdis Serialization Protocol (RESP) printer */
+
 #define NETDISSECT_REWORKED
 #ifdef HAVE_CONFIG_H
 #include "config.h"
diff --git a/print-rpki-rtr.c b/print-rpki-rtr.c
index 569bc4ea..24ee3267 100644
--- a/print-rpki-rtr.c
+++ b/print-rpki-rtr.c
@@ -12,11 +12,13 @@
  * LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  * FOR A PARTICULAR PURPOSE.
  *
- * support for the The RPKI/Router Protocol as RFC6810
- *
  * Original code by Hannes Gredler (hannes@juniper.net)
  */
 
+/* \summary: Resource Public Key Infrastructure (RPKI) to Router Protocol printer */
+
+/* specification: RFC 6810 */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-rtsp.c b/print-rtsp.c
index 7b6edb63..54cc930e 100644
--- a/print-rtsp.c
+++ b/print-rtsp.c
@@ -11,10 +11,7 @@
  * FOR A PARTICULAR PURPOSE.
  */
 
-#ifndef lint
-static const char rcsid[] _U_ =
-    "@(#) $Header$";
-#endif
+/* \summary: Real Time Streaming Protocol (RTSP) printer */
 
 #ifdef HAVE_CONFIG_H
 #include "config.h"
diff --git a/print-sflow.c b/print-sflow.c
index 7eecf0a0..37a41b52 100644
--- a/print-sflow.c
+++ b/print-sflow.c
@@ -12,13 +12,15 @@
  * LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  * FOR A PARTICULAR PURPOSE.
  *
- * The SFLOW protocol as per http://www.sflow.org/developers/specifications.php
- *
  * Original code by Carles Kishimoto <carles.kishimoto@gmail.com>
  *
  * Expansion and refactoring by Rick Jones <rick.jones2@hp.com>
  */
 
+/* \summary: sFlow protocol printer */
+
+/* specification: http://www.sflow.org/developers/specifications.php */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-smtp.c b/print-smtp.c
index 56109bdf..0cdcf1d9 100644
--- a/print-smtp.c
+++ b/print-smtp.c
@@ -11,6 +11,8 @@
  * FOR A PARTICULAR PURPOSE.
  */
 
+/* \summary: Simple Mail Transfer Protocol (SMTP) printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-stp.c b/print-stp.c
index e8c73328..f0830293 100644
--- a/print-stp.c
+++ b/print-stp.c
@@ -5,7 +5,6 @@
  * BSD-style license that accompanies tcpdump or the GNU General
  * Public License
  *
- * Format and print IEEE 802.1d spanning tree protocol packets.
  * Contributed by Lennert Buytenhek <buytenh@gnu.org>
  */
 
diff --git a/print-syslog.c b/print-syslog.c
index 08407d53..ff866762 100644
--- a/print-syslog.c
+++ b/print-syslog.c
@@ -14,6 +14,8 @@
  * FOR A PARTICULAR PURPOSE.
  */
 
+/* \summary: Syslog protocol printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-tftp.c b/print-tftp.c
index e635e0c7..5519c686 100644
--- a/print-tftp.c
+++ b/print-tftp.c
@@ -17,8 +17,6 @@
  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
  * WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
- *
- * Format and print trivial file transfer protocol packets.
  */
 
 /* \summary: Trivial File Transfer Protocol (TFTP) printer */
diff --git a/print-tipc.c b/print-tipc.c
index 2809d072..4d8848fc 100644
--- a/print-tipc.c
+++ b/print-tipc.c
@@ -19,6 +19,14 @@
  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  */
 
+/* \summary: Transparent Inter-Process Communication (TIPC) protocol printer */
+
+/*
+ * specification:
+ *	http://tipc.sourceforge.net/doc/draft-spec-tipc-07.html
+ *	http://tipc.sourceforge.net/doc/tipc_message_formats.html
+ */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
@@ -32,13 +40,6 @@
 
 static const char tstr[] = "[|TIPC]";
 
-/*
- * Transparent Inter-Process Communication (TIPC) protocol.
- *
- *	http://tipc.sourceforge.net/doc/draft-spec-tipc-07.html
- *	http://tipc.sourceforge.net/doc/tipc_message_formats.html
- */
-
 #define TIPC_USER_LOW_IMPORTANCE	0
 #define TIPC_USER_MEDIUM_IMPORTANCE	1
 #define TIPC_USER_HIGH_IMPORTANCE	2
diff --git a/print-udld.c b/print-udld.c
index 22ae338d..02921d0e 100644
--- a/print-udld.c
+++ b/print-udld.c
@@ -12,11 +12,13 @@
  * LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  * FOR A PARTICULAR PURPOSE.
  *
- * UNIDIRECTIONAL LINK DETECTION (UDLD) as per RFC5171
- *
  * Original code by Carles Kishimoto <carles.kishimoto@gmail.com>
  */
 
+/* \summary: Cisco UniDirectional Link Detection (UDLD) protocol printer */
+
+/* specification: RFC 5171 */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-vjc.c b/print-vjc.c
index b2132051..3287b9bc 100644
--- a/print-vjc.c
+++ b/print-vjc.c
@@ -19,7 +19,9 @@
  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  */
 
-/* \summary: PPP Van Jacobson compression (RFC1144) printer */
+/* \summary: PPP Van Jacobson compression printer */
+
+/* specification: RFC 1144 */
 
 #ifdef HAVE_CONFIG_H
 #include "config.h"
diff --git a/print-vqp.c b/print-vqp.c
index 76140113..44a21935 100644
--- a/print-vqp.c
+++ b/print-vqp.c
@@ -12,11 +12,11 @@
  * LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  * FOR A PARTICULAR PURPOSE.
  *
- * support for the Cisco prop. VQP Protocol
- *
  * Original code by Carles Kishimoto <Carles.Kishimoto@bsc.es>
  */
 
+/* \summary: Cisco VLAN Query Protocol (VQP) printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-vtp.c b/print-vtp.c
index 854bc49d..a96eeb08 100644
--- a/print-vtp.c
+++ b/print-vtp.c
@@ -12,8 +12,6 @@
  * LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  * FOR A PARTICULAR PURPOSE.
  *
- * VLAN TRUNKING PROTOCOL (VTP)
- *
  * Reference documentation:
  *  http://www.cisco.com/en/US/tech/tk389/tk689/technologies_tech_note09186a0080094c52.shtml
  *  http://www.cisco.com/warp/public/473/21.html
@@ -22,6 +20,8 @@
  * Original code ode by Carles Kishimoto <carles.kishimoto@gmail.com>
  */
 
+/* \summary: Cisco VLAN Trunking Protocol (VTP) printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-vxlan-gpe.c b/print-vxlan-gpe.c
index 92be1e25..a3c214d3 100644
--- a/print-vxlan-gpe.c
+++ b/print-vxlan-gpe.c
@@ -21,6 +21,10 @@
  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
 
+/* \summary: Generic Protocol Extension for VXLAN (VXLAN GPE) printer */
+
+/* specification: draft-ietf-nvo3-vxlan-gpe-01 */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-vxlan.c b/print-vxlan.c
index 8314aa78..052cbe3d 100644
--- a/print-vxlan.c
+++ b/print-vxlan.c
@@ -13,6 +13,10 @@
  * Original code by Francesco Fondelli (francesco dot fondelli, gmail dot com)
  */
 
+/* \summary: Virtual eXtensible Local Area Network (VXLAN) printer */
+
+/* specification: RFC 7348 */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/print-zeromq.c b/print-zeromq.c
index 661b9737..e07f8c69 100644
--- a/print-zeromq.c
+++ b/print-zeromq.c
@@ -1,7 +1,4 @@
 /*
- * This file implements decoding of ZeroMQ network protocol(s).
- *
- *
  * Copyright (c) 2013 The TCPDUMP project
  * All rights reserved.
  *
@@ -28,6 +25,8 @@
  * POSSIBILITY OF SUCH DAMAGE.
  */
 
+/* \summary: ZeroMQ Message Transport Protocol (ZMTP) printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif