Bug#613946: debian-mime --> DocBook XML

[Osamu Aoki <osamu@debian.org>]

Hi,

Here is DocBook converted one from mime-policy.sgml.

I wonder why this is searate document from policy.  (Too small)

Osamu

<?xml version='1.0'?>
<!-- -*- DocBook -*- -->
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [
<!ENTITY % versiondata SYSTEM "version.ent"> %versiondata; 
]>

<book lang="en">
<!-- This is UTF-8 encoded. -->

<title>The Debian MIME support sub-policy</title>

<bookinfo>

<authorgroup>
<author> <personname> J.H.M. Dassen (Ray)  </personname> <email>jdassen@debian.org</email> </author>
<author> <personname> The Debian Policy mailing List  </personname> <email>debian-policy@lists.debian.org</email> </author>

</authorgroup>
<releaseinfo>version &version;</releaseinfo>

<pubdate>&date;</pubdate>


<abstract>
<para>
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:
</para>
<orderedlist numeration="arabic">
<listitem>
<para>
Julian Gilbey <email>J.D.Gilbey@qmw.ac.uk</email>
</para>
</listitem>
<listitem>
<para>
Manoj Srivastava <email>srivasta@debian.org</email>
</para>
</listitem>
</orderedlist>
</abstract>

<copyright><year> 1999 </year><holder>  .</holder></copyright>
<legalnotice>
<para>
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.
</para>
<para>
This is distributed in the hope that it will be useful, but <emphasis>without
any warranty</emphasis>; without even the implied warranty of merchantability
or fitness for a particular purpose.  See the GNU General Public License for
more details.
</para>
<para>
A copy of the GNU General Public License is available as
<literal>/usr/share/common-licenses/GPL</literal> in the Debian distribution or
on the World Wide Web at <ulink url="http://www.gnu.org/copyleft/gpl.html";>The
GNU General Public Licence</ulink>.  You can also obtain it by writing to the
Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
02110-1301, USA.
</para>
</legalnotice>

</bookinfo>


<chapter id="ch1"><title>About this document</title>
<para>
This document is distributed as the <literal>mime-policy</literal> files in the
Debian package <systemitem role="package"><ulink
url="http://packages.debian.org/debian-policy";>debian-policy</ulink></systemitem>.
It is also available from the Debian web mirrors at <literal><ulink
url="http://www.debian.org/doc/packaging-manuals/mime-policy/";>/doc/packaging-manuals/mime-policy/</ulink></literal>.
</para>
</chapter>

<chapter id="ch2"><title>MIME support mechanism</title>
<para>
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.
</para>
<section id="s2.1"><title>Background</title>
<para>
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).
</para>
<para>
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.
</para>
</section>

<section id="s2.2"><title>MIME support implementation</title>
<para>
The <systemitem role="package">mime-support</systemitem> package provides the
<command>update-mime</command> program which allows packages to register
programs that can show, compose, edit or print MIME types.
</para>
<para>
Packages containing such programs must register them with
<command>update-mime</command> as documented in <citerefentry>
<refentrytitle>update-mime</refentrytitle> <manvolnum>8</manvolnum>
</citerefentry>.  They should <emphasis>not</emphasis> depend on, recommend, or
suggest <command>mime-support</command>.  Instead, they should just put
something like the following in the <literal>postinst</literal> and
<literal>postrm</literal> scripts:
</para>
<screen>
 
  if [ -x /usr/sbin/update-mime ]; then
      update-mime
  fi
</screen>
</section>

</chapter>


</book>