aboutsummaryrefslogtreecommitdiffstats
path: root/wireshark-mime-package.xml
diff options
context:
space:
mode:
authorJeff Morriss <jeff.morriss.ws@gmail.com>2016-04-19 17:45:29 -0400
committerJeff Morriss <jeff.morriss.ws@gmail.com>2016-04-28 19:01:26 +0000
commitc954b1cefca7a34e06c71bcf59a2a0ee75f7cb1d (patch)
treed06499c3c7ae12ca791b75482f35eb3544ecbbbe /wireshark-mime-package.xml
parent363507ea18e154d76654f0d811e89e041273f835 (diff)
Remind wiretap developers where else they need to register their file types.
Chances are they want to include the file extension in wiretap's list of file extensions (for the File->Open dialog) as well as the various files needed for integration with the various desktop environments that Wireshark supports. (I should have put this advice there years ago when creating the freedesktop.org mime-package file.) Add a comment to the mime-package file explaining its purpose, giving a link to the specification, and talking about MIME types and the registration thereof. Change-Id: I60540bf88062b7a90653888534405f6aef4f657c Reviewed-on: https://code.wireshark.org/review/15011 Reviewed-by: Jeff Morriss <jeff.morriss.ws@gmail.com>
Diffstat (limited to 'wireshark-mime-package.xml')
-rw-r--r--wireshark-mime-package.xml27
1 files changed, 27 insertions, 0 deletions
diff --git a/wireshark-mime-package.xml b/wireshark-mime-package.xml
index 01f1c78f99..7493bddd70 100644
--- a/wireshark-mime-package.xml
+++ b/wireshark-mime-package.xml
@@ -1,5 +1,32 @@
<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ This file allows freedesktop.org-compliant desktops (such as GNOME and
+ KDE) to know which files should be opened by what program (and what icon
+ to show for the file in a file browser).
+
+ Both magic and file name glob patterns are supported; glob patterns are
+ preferred since they don't require require opening and reading part of
+ the file to determine its type.
+
+ The specification for this file can be found here:
+ https://standards.freedesktop.org/shared-mime-info-spec/latest/
+
+
+ Note that ideally the MIME types listed here should be IANA-registered:
+
+ https://www.iana.org/assignments/media-types/media-types.xhtml
+
+ If your file type is not registered then using one of the
+ (not-really-a-good-idea and deprecated) x- media types is the only option
+ if you want files to be associated with Wireshark in
+ freedesktop.org-compliant file browsers.
+
+
+ NOTE: if you do add a MIME type here, don't forget to add it to the list
+ of MIME types handled by Wireshark in wireshark.desktop.
+-->
+
<mime-info xmlns="http://www.freedesktop.org/standards/shared-mime-info">
<mime-type type="application/vnd.tcpdump.pcap">
<comment>Packet Capture (PCAP)</comment>