]> git.donarmstrong.com Git - debian/debian-policy.git/commitdiff
Retire the separate MIME Policy document
authorRuss Allbery <rra@debian.org>
Mon, 26 Dec 2011 18:39:45 +0000 (10:39 -0800)
committerRuss Allbery <rra@debian.org>
Mon, 26 Dec 2011 18:39:45 +0000 (10:39 -0800)
Merge its short contents into Policy 9.7 rather than maintaining a
separate document.

Wording: Ben Finney <ben+debian@benfinney.id.au>
Seconded: Russ Allbery <rra@debian.org>
Seconded: Raphaël Hertzog <hertzog@debian.org>
Seconded: Andrew McMillan <andrew@morphoss.com>
Closes: #89038
.gitignore
Makefile
README.org
debian-mime-policy.desc [deleted file]
debian/changelog
debian/rules
mime-policy.sgml [deleted file]
policy.sgml
upgrading-checklist.sgml

index 5b2eb843fdfdb7ad7faa382a9f0484b3af86dac9..b07ee68501c897cce8ac622794616470927c0a27 100644 (file)
@@ -6,7 +6,6 @@
 /debconf_spec/debconf_specification.txt.gz
 /head.tmp
 /menu-policy.html/
-/mime-policy.html/
 /perl-policy.html/
 /policy.html/
 /stamp-build
index 9ab6801340181b7fb58dd9a554c02838a26c98c8..1f3675cf0858e084c39ece76c4193305020fbe47 100644 (file)
--- a/Makefile
+++ b/Makefile
@@ -2,7 +2,6 @@ include debian/rules
 
 policy.sgml: version.ent
 menu-policy.sgml: version.ent
-mime-policy.sgml: version.ent
 perl-policy.sgml: version.ent
 
 %.txt: %.org
index 2be9c515d3332dc907a64444090a27afd65a4c5a..db4ed520dfb993f19e6750932641c8d87a24e160 100644 (file)
@@ -141,7 +141,6 @@ In addition to the main technical manual, the team currently also maintains:
 + [[http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/][Machine-readable debian/copyright format]]
 + [[http://www.debian.org/doc/packaging-manuals/menu-policy/][Debian Menu sub-policy]]
 + [[http://www.debian.org/doc/packaging-manuals/perl-policy/][Debian Perl Policy]]
-+ [[http://www.debian.org/doc/packaging-manuals/mime-policy/][Debian MIME support sub-policy]]
 + [[http://www.debian.org/doc/packaging-manuals/debconf_specification.html][Debconf Specification]]
 + [[http://www.debian.org/doc/packaging-manuals/virtual-package-names-list.txt][Authoritative list of virtual package names ]]
 
diff --git a/debian-mime-policy.desc b/debian-mime-policy.desc
deleted file mode 100644 (file)
index 512e483..0000000
+++ /dev/null
@@ -1,18 +0,0 @@
-Document: debian-mime-policy
-Title: Debian MIME Policy Manual
-Author: The Debian Policy Mailing list
-Abstract: This manual describes the policy requirements for the MIME
- system in the Debian distribution, describing the rules
- regulating the registration of programs that can handle MIME
- content.
-Section: Debian
-
-Format: debiandoc-sgml
-Files: /usr/share/doc/debian-policy/mime-policy.sgml.gz
-
-Format: text
-Files: /usr/share/doc/debian-policy/mime-policy.txt.gz
-
-Format: HTML
-Index: /usr/share/doc/debian-policy/mime-policy.html/index.html
-Files: /usr/share/doc/debian-policy/mime-policy.html/*.html
index 7b4343f1cb31234a0dcf65f10c5cf45885fd0e0e..b7b3df0e652d4ed6b3bafaf451839a6a60314335 100644 (file)
@@ -25,6 +25,12 @@ debian-policy (3.9.3.0) UNRELEASED; urgency=low
     Seconded: Cyril Brulebois <kibi@debian.org>
     Seconded: Raphaël Hertzog <hertzog@debian.org>
     Closes: #23712
+  * MIME Policy: Retire this document and merge it with Policy
+    Wording: Ben Finney <ben+debian@benfinney.id.au>
+    Seconded: Russ Allbery <rra@debian.org>
+    Seconded: Raphaël Hertzog <hertzog@debian.org>
+    Seconded: Andrew McMillan <andrew@morphoss.com>
+    Closes: #89038
   * Consistently use "Debian source control file" for *.dsc files and
     "Source package control file" for debian/control files.  Patch from
     Charles Plessy.  (Closes: #626796)
index 6a2803303ebf2c4caba99bfa53801dc1b75ca275..c80e34853b3344291933d7928f83b8fce5b30349 100755 (executable)
@@ -32,9 +32,9 @@ LIBDIR          := $(TMPTOP)/usr/share/doc-base
 
 sanitycheck := debian/rules policy.sgml
 
-SGML_FILES := policy menu-policy mime-policy perl-policy upgrading-checklist
-DESC_FILES := copyright-format debian-policy debian-menu-policy debian-perl-policy \
-              debian-mime-policy debconf-spec fhs
+SGML_FILES := policy menu-policy perl-policy upgrading-checklist
+DESC_FILES := copyright-format debian-policy debian-menu-policy \
+             debian-perl-policy debconf-spec fhs
 
 # While we have two versions of the FHS installed in the source package,
 # we need to modify this to handle it.  This is the easiest way to do it.
diff --git a/mime-policy.sgml b/mime-policy.sgml
deleted file mode 100644 (file)
index e05ee4a..0000000
+++ /dev/null
@@ -1,149 +0,0 @@
-<!doctype debiandoc system [
-<!-- include version information so we don't have to hard code it
-     within the document -->
-<!entity % versiondata SYSTEM "version.ent"> %versiondata;
-]>
-<debiandoc>
-  <!--
-  Debian Menu Sub-Policy Manual.
-  Copyright (C)1999 ;
-
-  released under the terms of the GNU General Public License, version
-  2 or (at your option) any later.
-
-  The debian-policy mailing list has taken responsibility for the
-  contents of this document, with the package maintainers responsible
-  for packaging adminstrivia only.  
-  -->
-  
-  <book>
-    <titlepag>
-      <title>The Debian MIME support sub-policy</title>
-      <author>
-       <name>J.H.M. Dassen (Ray)</name>
-       <email>jdassen@debian.org</email>
-      </author>
-      <author>
-       <name>The Debian Policy mailing List</name>
-       <email>debian-policy@lists.debian.org</email>
-      </author>
-      <version>version &version;, &date;</version>
-
-      <abstract>
-       This manual describes the policy requirements for the MIME support
-       system used in the Debian distribution. This
-       document is part of the policy package for Debian. The policy
-       package itself is maintained by a group of maintainers that
-       have no editorial powers. At the moment, the list of
-       maintainers is:
-       <enumlist>
-         <item>
-           <p>Julian Gilbey <email>J.D.Gilbey@qmw.ac.uk</email></p>
-         </item>
-         <item>
-           <p>Manoj Srivastava <email>srivasta@debian.org</email></p>
-         </item>
-       </enumlist>
-      </abstract>
-
-
-      <copyright>
-       <copyrightsummary>
-         Copyright &copy;1999 .
-       </copyrightsummary>
-       <p>
-         This manual is free software; you may redistribute it and/or
-         modify it under the terms of the GNU General Public License
-         as published by the Free Software Foundation; either version
-         2, or (at your option) any later version.
-       </p>
-
-       <p>
-         This is distributed in the hope that it will be useful, but
-         <em>without any warranty</em>; without even the implied
-         warranty of merchantability or fitness for a particular
-         purpose.  See the GNU General Public License for more
-         details.
-         </p>
-       <p>
-         A copy of the GNU General Public License is available as
-         <tt>/usr/share/common-licenses/GPL</tt> in the Debian
-         distribution or on the World Wide Web at <url
-         id="http://www.gnu.org/copyleft/gpl.html" name="The GNU
-         General Public Licence">. You can also obtain it by writing
-         to the Free Software Foundation, Inc., 51 Franklin St, Fifth
-         Floor, Boston, MA 02110-1301, USA.
-       </p>
-      </copyright>
-    </titlepag>
-
-    <toc detail="sect">
-
-    <chapt>
-      <heading>About this document</heading>
-      <p>
-       This document is distributed as the <tt>mime-policy</tt> files
-       in the Debian package
-        <package><url name="debian-policy" id="http://packages.debian.org/debian-policy"></package>.
-       It is also available from the Debian web mirrors at
-       <tt><url name="/doc/packaging-manuals/mime-policy/"
-               id="http://www.debian.org/doc/packaging-manuals/mime-policy/"></tt>.
-      </p>
-    </chapt>
-
-    <chapt>
-      <heading>MIME support mechanism</heading>
-      <p>
-       If you need assistance implementing this sub-policy, please
-       please ask for it on the debian-devel mailing list.  If you
-       have proposals for changes or additions to this sub-policy,
-       please bring it up on debian-policy.
-      </p>
-      <sect>
-        <heading>Background</heading>
-        <p>
-          MIME (Multipurpose Internet Mail Extensions, RFC 1521) is
-          a mechanism for encoding files and datastreams and providing
-          meta-information about them, in particular their type (e.g. audio
-          or video) and format (e.g. PNG, HTML, MP3).
-        </p>
-        
-        <p>
-          Registration of MIME type handlers allows programs like mail
-          user agents and web browsers to to invoke these handlers to
-          view, edit or display MIME types they don't support directly.
-        </p>
-
-      </sect>
-
-      <sect>
-       <heading>MIME support implementation</heading>
-       <p>
-          The <package>mime-support</package> package provides the
-          <prgn>update-mime</prgn> program which allows packages to
-          register programs that can show, compose, edit or print
-          MIME types.
-       </p>
-
-       <p>
-          Packages containing such programs must register them
-          with <prgn>update-mime</prgn> as documented in <manref
-          name="update-mime" section="8">. They should <em>not</em> depend
-          on, recommend, or suggest <prgn>mime-support</prgn>. Instead,
-          they should just put something like the following in the
-          <tt>postinst</tt> and <tt>postrm</tt> scripts:
-
-          <example> 
-  if [ -x /usr/sbin/update-mime ]; then
-      update-mime
-  fi
-          </example>
-       </p>
-      </sect>
-    </chapt>
-  </book>
-</debiandoc>
-<!-- Local variables: -->
-<!-- indent-tabs-mode: t -->
-<!-- End: -->
index 8ad0613f134fec105a51d63dbfa48cde6419f642..79281e97b55a292c4b12982a745cafec1ef84c28 100644 (file)
            <item><ref id="fhs"></item>
            <item><ref id="virtual_pkg"></item>
            <item><ref id="menus"></item>
-           <item><ref id="mime"></item>
            <item><ref id="perl"></item>
            <item><ref id="maintscriptprompt"></item>
            <item><ref id="emacs"></item>
@@ -7301,7 +7300,7 @@ Reloading <var>description</var> configuration...done.
          MIME (Multipurpose Internet Mail Extensions, RFCs 2045-2049)
          is a mechanism for encoding files and data streams and
          providing meta-information about them, in particular their
-         type (e.g.  audio or video) and format (e.g. PNG, HTML,
+         type (e.g. audio or video) and format (e.g. PNG, HTML,
          MP3).
        </p>
 
@@ -7318,11 +7317,25 @@ Reloading <var>description</var> configuration...done.
        </p>
 
        <p>
-         The MIME support policy can be found in the <tt>mime-policy</tt>
-         files in the <tt>debian-policy</tt> package.
-         It is also available from the Debian web mirrors at
-          <tt><url name="/doc/packaging-manuals/mime-policy/"
-               id="http://www.debian.org/doc/packaging-manuals/mime-policy/"></tt>.
+         The <package>mime-support</package> package provides the
+         <prgn>update-mime</prgn> program which allows packages to
+         register programs that can show, compose, edit or print
+         MIME types.
+       </p>
+
+       <p>
+         Packages containing such programs must register them
+         with <prgn>update-mime</prgn> as documented in <manref
+         name="update-mime" section="8">. They should <em>not</em> depend
+         on, recommend, or suggest <prgn>mime-support</prgn>. Instead,
+         they should just put something like the following in the
+         <tt>postinst</tt> and <tt>postrm</tt> scripts:
+
+         <example>
+  if [ -x /usr/sbin/update-mime ]; then
+      update-mime
+  fi
+         </example>
        </p>
 
       </sect>
index 4f698a800ff03e04116737da01decc6d307c6e4f..dc62283d8dd7be32f60159de4729c70f5350a97e 100644 (file)
@@ -73,6 +73,10 @@ Unreleased.
   Debian maintainers involved in the creation of the package (although
   note that the requirement to list copyright information is unchanged).
   </item>
+<tag>mime</tag>
+  <item>Retire this separate document and merge its (short) contents into
+  Policy section 9.7.  There are no changes to the requirements.
+  </item>
 <tag>perl</tag>
   <item>Packages may declare an interest in the <var>perl-major-upgrade</var> 
   trigger to be notified of major upgrades of perl.