docs/reference/html/gmime-changes-2-2.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5 <title>Changes from 2.0 to 2.2</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
   7 <link rel="home" href="index.html" title="GMime 2.6 Reference Manual">
   8 <link rel="up" href="gmime.html" title="Part I. GMime Overview">
   9 <link rel="prev" href="gmime-changes-2-0.html" title="Changes from 1.0 to 2.0">
  10 <link rel="next" href="gmime-changes-2-4.html" title="Changes from 2.2 to 2.4">
  11 <meta name="generator" content="GTK-Doc V1.18 (XML mode)">
  12 <link rel="stylesheet" href="style.css" type="text/css">
  13 </head>
  14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
  16 <td><a accesskey="p" href="gmime-changes-2-0.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  17 <td><a accesskey="u" href="gmime.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
  18 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
  19 <th width="100%" align="center">GMime 2.6 Reference Manual</th>
  20 <td><a accesskey="n" href="gmime-changes-2-4.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
  21 </tr></table>
  22 <div class="refentry">
  23 <a name="gmime-changes-2-2"></a><div class="titlepage"></div>
  24 <div class="refnamediv"><table width="100%"><tr>
  25 <td valign="top">
  26 <h2><span class="refentrytitle">Changes from 2.0 to 2.2</span></h2>
  27 <p>Changes from 2.0 to 2.2 — Incompatible changes made between version 2.0 and version 2.2</p>
  28 </td>
  29 <td valign="top" align="right"></td>
  30 </tr></table></div>
  31 <div class="refsect1">
  32 <a name="idp5050848"></a><h2>Incompatible changes from 2.0 to 2.2</h2>
  33 <p>See also the PORTING document in the toplevel GMime source directory.</p>
  34 <p>There are no incompatible changes between 2.0 and 2.2.</p>
  35 <p>GMime 2.2 is both API and ABI compatible with GMime 2.0 meaning
  36 that any program written for GMime 2.0 will compile fine with GMime
  37 2.2 and any program linked against GMime 2.0's libraries will also
  38 work with GMime 2.2's libraries.</p>
  39 <p>Most of the changes made between 2.0 and 2.2 were internal but there
  40 are a few API changes you should be aware of (as these interfaces will
  41 be deprecated in some future version, probably 3.0).</p>
  42 </div>
  43 <div class="refsect1">
  44 <a name="idp5088336"></a><h2>Replacement interfaces from 2.0 to 2.2</h2>
  45 <div class="itemizedlist"><ul class="itemizedlist" type="disc">
  46 <li class="listitem"><p>
  47 <code class="function">g_mime_utils_8bit_header_decode()</code> has been split
  48 into 2 functions. We now have
  49 <code class="function">g_mime_utils_header_decode_text()</code> and
  50 <code class="function">g_mime_utils_header_decode_phrase()</code>.
  51 <code class="function">g_mime_utils_header_decode_text()</code> no longer
  52 requires encoded-words to be rfc822 atoms.
  53 <code class="function">g_mime_utils_header_decode_phrase()</code> is
  54 still strict in that encoded-words MUST be valid rfc822 atoms.</p></li>
  55 <li class="listitem"><p>
  56 <code class="function">g_mime_utils_8bit_header_encode()</code> has been
  57 renamed to <code class="function">g_mime_utils_header_encode_text()</code> to
  58 be more clear as to what type of header this is supposed to encode. If
  59 you haven't guessed, this function is for encoding rfc822 'text'
  60 headers (such as Subject).</p></li>
  61 <li class="listitem"><p>
  62 <code class="function">g_mime_utils_8bit_header_encode_phrase()</code> has been
  63 renamed to <code class="function">g_mime_utils_header_encode_phrase()</code>
  64 mostly for consistancy with the previous 2 changes.</p></li>
  65 <li class="listitem"><p>
  66 <code class="function">g_mime_charset_name()</code> has been renamed to
  67 <code class="function">g_mime_charset_iconv_name()</code> for clarity.</p></li>
  68 <li class="listitem"><p>
  69 <code class="function">g_mime_charset_locale_name()</code> has been renamed to
  70 <code class="function">g_mime_locale_charset()</code>.</p></li>
  71 <li class="listitem"><p>
  72 <code class="function">g_mime_cipher_context_verify()</code> no longer returns
  73 a <span class="structname">GMimeCipherValidity</span>, instead it returns a
  74 <span class="structname">GMimeSignatureValidity</span> which is far more
  75 useful. Never fear, you may still use the
  76 <span class="structname">GMimeCipherValidity</span> APIs for the time being -
  77 they work fine given a <span class="structname">GMimeSignatureValidity</span>
  78 structure.</p></li>
  79 <li class="listitem"><p>
  80 <code class="function">g_mime_multipart_signed_verify()</code> also now returns
  81 a <span class="structname">GMimeSignatureValidity</span> structure rather than
  82 a <span class="structname">GMimeCipherValidity</span> structure. See changes to
  83 <code class="function">g_mime_cipher_context_verify()</code> for details.</p></li>
  84 </ul></div>
  85 </div>
  86 </div>
  87 <div class="footer">
  88 <hr>
  89           Generated by GTK-Doc V1.18</div>
  90 </body>
  91 </html>