trafficserver-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From dia...@apache.org
Subject svn commit: r934183 - /incubator/trafficserver/site/trunk/docs/v2/sdk/MimeHeadersFunctions.html
Date Wed, 14 Apr 2010 20:35:23 GMT
Author: dianes
Date: Wed Apr 14 20:35:23 2010
New Revision: 934183

URL: http://svn.apache.org/viewvc?rev=934183&view=rev
Log:
ts294
huge!

Modified:
    incubator/trafficserver/site/trunk/docs/v2/sdk/MimeHeadersFunctions.html

Modified: incubator/trafficserver/site/trunk/docs/v2/sdk/MimeHeadersFunctions.html
URL: http://svn.apache.org/viewvc/incubator/trafficserver/site/trunk/docs/v2/sdk/MimeHeadersFunctions.html?rev=934183&r1=934182&r2=934183&view=diff
==============================================================================
--- incubator/trafficserver/site/trunk/docs/v2/sdk/MimeHeadersFunctions.html (original)
+++ incubator/trafficserver/site/trunk/docs/v2/sdk/MimeHeadersFunctions.html Wed Apr 14 20:35:23 2010
@@ -20,7 +20,7 @@
         header, then call <code class="function">INKMimeHdrFieldClone</code> after
         <code class="code">READ_REQUEST_HDR_HOOK</code>.</p>
 <p>The Traffic Server MIME header functions are  listed below:</p>
-<ul>
+<ul><b>
 <li><a href="MimeHeadersFunctions.html#INKMimeHdrFieldAppend">INKMimeHdrFieldAppend</a></li>
 <li><a href="MimeHeadersFunctions.html#INKMimeHdrFieldClone">INKMimeHdrFieldClone</a></li>
 <li><a href="MimeHeadersFunctions.html#INKMimeHdrFieldCopy">INKMimeHdrFieldCopy</a></li>
@@ -31,10 +31,24 @@
 <li><a href="MimeHeadersFunctions.html#INKMimeHdrFieldNameGet">INKMimeHdrFieldNameGet</a></li>
 <li><a href="MimeHeadersFunctions.html#INKMimeHdrFieldNameSet">INKMimeHdrFieldNameSet</a></li>
 <li><a href="MimeHeadersFunctions.html#INKMimeHdrFieldNext">INKMimeHdrFieldNext</a></li>
-<li></li>
+
 <li><a href="MimeHeadersFunctions.html#INKMimeHdrFieldNextDup">INKMimeHdrFieldNextDup</a></li>
 <li><a href="MimeHeadersFunctions.html#INKMimeHdrFieldValueAppend">INKMimeHdrFieldValueAppend</a></li>
-<li><a href="MimeHeadersFunctions.html#INKMimeHdrFieldValueDelete">INKMimeHdrFieldValueDelete</a></li>
+<li><a href="MimeHeadersFunctions.html#INKMimeHdrFieldValueAppend">INKMimeHdrFieldValueAppend</a></li>
+<li><a href="MimeHeadersFunctions.html#INKMimeHdrFieldValueDateGet">INKMimeHdrFieldValueDateGet</a></li>
+<li><a href="MimeHeadersFunctions.html#INKMimeHdrFieldValueDateInsert">INKMimeHdrFieldValueDateInsert</a></li>
+<li><a href="MimeHeadersFunctions.html#INKMimeHdrFieldValueDateSet">INKMimeHdrFieldValueDateSet</a></li>
+
+<li><a href="MimeHeadersFunctions.html#INKMimeHdrFieldValueInsert">INKMimeHdrFieldValueInsert</a></li>
+<li><a href="MimeHeadersFunctions.html#INKMimeHdrFieldValueIntGet">INKMimeHdrFieldValueIntGet</a></li>
+<li><a href="MimeHeadersFunctions.html#INKMimeHdrFieldValueIntSet">INKMimeHdrFieldValueIntSet</a></li>
+<li><a href="MimeHeadersFunctions.html#INKMimeHdrFieldValueStringGet">INKMimeHdrFieldValueStringGet</a></li>
+<li><a href="MimeHeadersFunctions.html#INKMimeHdrFieldValueStringInsert">INKMimeHdrFieldValueStringInsert</a></li>
+<li><a href="MimeHeadersFunctions.html#INKMimeHdrFieldValueStringSet">INKMimeHdrFieldValueStringSet</a></li>
+<li><a href="MimeHeadersFunctions.html#INKMimeHdrFieldValueUintGet">INKMimeHdrFieldValueUintGet</a></li>
+<li><a href="MimeHeadersFunctions.html#INKMimeHdrFieldValueUIntInsert">INKMimeHdrFieldValueUIntInsert</a></li>
+<li><a href="MimeHeadersFunctions.html#INKMimeHdrFieldValueUintSet">INKMimeHdrFieldValueUintSet</a></li>
+
 <li><a href="MimeHeadersFunctions.html#INKMimeHdrFieldValuesClear">INKMimeHdrFieldValuesClear</a></li>
 <li><a href="MimeHeadersFunctions.html#INKMimeHdrFieldValuesCount">INKMimeHdrFieldValuesCount</a></li>
 <li><a href="MimeHeadersFunctions.html#INKMimeHdrClone">INKMimeHdrClone</a></li>
@@ -42,7 +56,6 @@
 <li><a href="MimeHeadersFunctions.html#INKMimeHdrCreate">INKMimeHdrCreate</a></li>
 <li><a href="MimeHeadersFunctions.html#INKMimeHdrDestroy">INKMimeHdrDestroy</a></li>
 <li><a href="MimeHeadersFunctions.html#INKMimeHdrFieldFind">INKMimeHdrFieldFind</a></li>
-<li></li>
 <li><a href="MimeHeadersFunctions.html#INKMimeHdrFieldGet">INKMimeHdrFieldGet</a></li>
 <li><a href="MimeHeadersFunctions.html#INKMimeHdrFieldRemove">INKMimeHdrFieldRemove</a></li>
 <li><a href="MimeHeadersFunctions.html#INKMimeHdrFieldsClear">INKMimeHdrFieldsClear</a></li>
@@ -53,7 +66,7 @@
 <li><a href="MimeHeadersFunctions.html#INKMimeParserCreate">INKMimeParserCreate</a></li>
 <li><a href="MimeHeadersFunctions.html#INKMimeParserDestroy">INKMimeParserDestroy</a></li>
 <li><a href="MimeHeadersFunctions.html#INKMimeHdrPrint">INKMimeHdrPrint</a></li>
-</ul>
+</b></ul>
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h4 class="title">
 <a name="INKMimeHdrFieldAppend"></a>INKMimeHdrFieldAppend</h4></div></div></div>
@@ -136,19 +149,21 @@
                 field located at
                 <code class="code"><em class="replaceable"><code>dest_field </code></em></code> within the
                 marshal buffer
-                <code class="code"><em class="replaceable"><code>dest_bufp</code></em></code>.
-                <code class="function">INKMimeHdrFieldCopy</code> works correctly even
-                if <code class="code"><em class="replaceable"><code>src_bufp </code></em></code> and
-                <code class="code"><em class="replaceable"><code>dest_bufp </code></em></code> point to
-                different marshal buffers.</p>
-<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note">
-<tr>
-<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="images/docbook/note.png" /></td>
-<th align="left">Note</th>
-</tr>
-<tr><td align="left" valign="top"><p>You must first create the destination MIME field
-                  before you can copy into it.</p></td></tr>
-</table></div>
+                <code class="code"><em class="replaceable"><code>dest_bufp</code></em></code>.                </p>
+</dd>
+<dd>
+  <p><code class="function">INKMimeHdrFieldCopy</code> works correctly even
+    if <code class="code"><em class="replaceable"><code>src_bufp </code></em></code> and
+    <code class="code"><em class="replaceable"><code>dest_bufp </code></em></code> point to
+    different marshal buffers.</p>
+  <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note">
+    <tr>
+      <td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="images/docbook/note.png" /></td>
+      <th align="left">Note</th>
+      </tr>
+    <tr><td align="left" valign="top"><p>You must first create the destination MIME field
+      before you can copy into it.</p></td></tr>
+    </table></div>
 </dd>
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>
@@ -179,13 +194,17 @@
                 field located at
                 <code class="code"><em class="replaceable"><code>dest_field </code></em></code> within the
                 marshal buffer
-                <code class="code"><em class="replaceable"><code>dest_bufp</code></em></code>.
-                <code class="function">INKMimeHdrFieldCopyValues</code> works correctly
-                even if <code class="code"><em class="replaceable"><code>src_bufp </code></em></code> and
-                <code class="code"><em class="replaceable"><code>dest_bufp </code></em></code> point to
-                different marshal buffers.
-                <code class="function">INKMimeHdrFieldCopyValues</code> does not copy
-                the field's name.</p></dd>
+                <code class="code"><em class="replaceable"><code>dest_bufp</code></em></code>.                </p></dd>
+<dd>
+  <p><code class="function">INKMimeHdrFieldCopyValues</code> works correctly
+    even if <code class="code"><em class="replaceable"><code>src_bufp </code></em></code> and
+    <code class="code"><em class="replaceable"><code>dest_bufp </code></em></code> point to
+    different marshal buffers.    </p>
+</dd>
+<dd>
+  <p><code class="function">INKMimeHdrFieldCopyValues</code> does not copy
+    the field's name.</p>
+</dd>
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>
 <p><code class="code">INK_SUCCESS</code> if successful.</p>
@@ -279,11 +298,13 @@
 <dd>
   <p>Returns the name of the field located at
                 <code class="code"><em class="replaceable"><code>field </code></em></code> within the
-                marshal buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code>.
-                <code class="function">INKMimeHdrFieldNameGet</code> places the length
-                of the returned string in the
-                <code class="code"><em class="replaceable"><code>length </code></em></code>
-                argument.</p></dd>
+                marshal buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code>.                </p></dd>
+<dd>
+  <p><code class="function">INKMimeHdrFieldNameGet</code> places the length
+    of the returned string in the
+    <code class="code"><em class="replaceable"><code>length </code></em></code>
+    argument.</p>
+</dd>
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>
 <p>A pointer to the name of the specified field within the
@@ -318,18 +339,21 @@
 <p>Sets the name of the field located at
                 <code class="code"><em class="replaceable"><code>field </code></em></code> within the
                 marshal buffer <code class="code"><em class="replaceable"><code>bufp </code></em></code> to
-                the string <code class="code"><em class="replaceable"><code>name</code></em></code>. If
-                <code class="code"><em class="replaceable"><code>length </code></em></code> is -1, then
-                <code class="function">INKMimeHdrFieldNameSet</code> assumes the name
-                is null-terminated. Otherwise, the length of the string
-                <code class="code"><em class="replaceable"><code>name </code></em></code> is taken to be
-                <code class="code"><em class="replaceable"><code>length</code></em></code>.
-                <code class="function">INKMimeHdrFieldNameSet</code> copies the string
-                to within <code class="code"><em class="replaceable"><code>bufp</code></em></code>, so it
-                is okay to modify or delete
-                <code class="code"><em class="replaceable"><code>name </code></em></code> after calling
-                <code class="function">INKMimeHdrFieldNameSet</code>. When possible, use the <code class="code">INK_MIME_FIELD_XXX</code> tokens
-                for <code class="code"><em class="replaceable"><code> name </code></em></code>.</p>
+                the string <code class="code"><em class="replaceable"><code>name</code></em></code>. </p>
+</dd>
+<dd>
+  <p>If <code class="code"><em class="replaceable"><code>length </code></em></code> is <code>-1</code>, then <code class="function">INKMimeHdrFieldNameSet</code> assumes the name
+    is null-terminated. Otherwise, the length of the string
+    <code class="code"><em class="replaceable"><code>name </code></em></code> is taken to be
+    <code class="code"><em class="replaceable"><code>length</code></em></code>.    </p>
+</dd>
+<dd>
+  <p><code class="function">INKMimeHdrFieldNameSet</code> copies the string
+    to within <code class="code"><em class="replaceable"><code>bufp</code></em></code>, so it
+    is okay to modify or delete
+    <code class="code"><em class="replaceable"><code>name </code></em></code> after calling
+    <code class="function">INKMimeHdrFieldNameSet</code>. When possible, use the <code class="code">INK_MIME_FIELD_XXX</code> tokens
+    for <code class="code"><em class="replaceable"><code> name </code></em></code>.</p>
 </dd>
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>
@@ -352,7 +376,7 @@
 <dt><span class="term"><b>Description</b></span></dt>
 <dd>
   <p>Conceptually, MIME fields are listed in a MIME
-                header (see <a href="GuideTSHTTPHdrSyst.html" title="Guide to Traffic Server HTTP Header System">Guide to Traffic Server HTTP Header System</a>).
+                header (see the <a href="GuideTSHTTPHdrSyst.html" title="Guide to Traffic Server HTTP Header System">Guide to  Traffic Server's HTTP Header System</a>).
                 <code class="function">INKMimeHdrFieldNext</code> returns the location
                 of the next <code class="code"><em class="replaceable"><code>field </code></em></code> in
                 the list, after the field located at
@@ -400,12 +424,12 @@
 <dt><span class="term"><b>Description</b></span></dt>
 <dd>
 <p>MIME headers <u>can</u> contain more than one MIME field with
-                the same name. While previous versions of Traffic Server joined
+                the same name. Previous versions of Traffic Server joined
                 multiple fields with the same name into one field with
-                composite values, this behavior comes at a performance cost
-                and causes compatability issues  with  older clients
-                and servers. Future versions of Traffic Server will cease
-                coalescing duplicate fields.</p>
+                composite values, but this behavior came at a performance cost
+                and caused compatability issues  with  older clients
+                and servers. The current version of Traffic Server does not
+                coalesce duplicate fields.</p>
 <p>Your plugins should check for the presence of duplicate
                 fields and iterate over duplicate fields via 
                 <code class="function">INKMimeHdrFieldNextDup. INKMimeHdrFieldNextDup</code>
@@ -466,18 +490,21 @@
                 <code class="code"><em class="replaceable"><code>value </code></em></code> to a specific
                 value in the MIME field located at
                 <code class="code"><em class="replaceable"><code>field </code></em></code> within the
-                marshal buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code>.
-                The effect of <code class="function">INKMimeHdrFieldValueAppend</code>
-                is as if the previous value was retrieved, the string
-                <code class="code"><em class="replaceable"><code>value </code></em></code> was appended to
-                it, and this new string was stored back in the MIME field at
-                the same position. The
-                <code class="code"><em class="replaceable"><code>idx </code></em></code> parameter
-                specifies which value in the field to append to. If
-                <code class="code"><em class="replaceable"><code>idx </code></em></code> is not between 0
-                and <code class="function">INKMimeHdrFieldValuesCount</code>
-                (<code class="code"><em class="replaceable"><code>bufp, hdr, field</code></em></code>) - 1,
-                then no operation is performed.</p></dd>
+                marshal buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code>.                </p></dd>
+<dd>
+  <p>The effect of <code class="function">INKMimeHdrFieldValueAppend</code>
+    is as if the previous value was retrieved, the string
+    <code class="code"><em class="replaceable"><code>value </code></em></code> was appended to
+    it, and this new string was stored back in the MIME field at
+    the same position. </p>
+</dd>
+<dd>
+  <p>The <code class="code"><em class="replaceable"><code>idx </code></em></code> parameter
+    specifies which value in the field to append to. If
+    <code class="code"><em class="replaceable"><code>idx </code></em></code> is not between <code>0</code> and <code class="function">INKMimeHdrFieldValuesCount
+    (</code><code class="code"><em class="replaceable"><code>bufp, hdr, field</code></em></code><code>) - 1</code>,
+    then no operation is performed.</p>
+</dd>
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>
 <p><code class="code">INK_SUCCESS</code> if the string is successfully
@@ -503,11 +530,12 @@
                 <code class="code"><em class="replaceable"><code>value </code></em></code> from within the
                 MIME field located at
                 <code class="code"><em class="replaceable"><code>field </code></em></code> within the
-                marshal buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code>.
-                All values are stored as strings within the MIME field.
-                <code class="function">INKMimeHdrFieldValueDateGet</code> parses the
-                string <code class="code"><em class="replaceable"><code>value </code></em></code> to return
-                an integer date representation.</p></dd>
+                marshal buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code>.                </p></dd>
+<dd>
+  <p>All values are stored as strings within the MIME field. <code class="function">INKMimeHdrFieldValueDateGet</code> parses the
+    string <code class="code"><em class="replaceable"><code>value </code></em></code> to return
+    an integer date representation.</p>
+</dd>
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>
 <p>The date <code class="code"><em class="replaceable"><code>value </code></em></code>
@@ -536,11 +564,13 @@
                 <code class="code"><em class="replaceable"><code>value </code></em></code> into the MIME
                 field located at <code class="code"><em class="replaceable"><code>field </code></em></code>
                 within the marshal buffer
-                <code class="code"><em class="replaceable"><code>bufp</code></em></code>. All values are
-                stored as strings within the MIME field.
-                <code class="function">INKMimeHdrFieldValueDateInsert</code> simply
-                formats the date into a string and then calls
-                <code class="function">INKMimeHdrFieldValueInsert</code>.</p></dd>
+                <code class="code"><em class="replaceable"><code>bufp</code></em></code>. </p></dd>
+<dd>
+  <p>All values are
+    stored as strings within the MIME field. <code class="function">INKMimeHdrFieldValueDateInsert</code> simply
+    formats the date into a string and then calls
+    <code class="function">INKMimeHdrFieldValueInsert</code>.</p>
+</dd>
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>
 <p><code class="code">INK_SUCCESS</code> if the API is called
@@ -596,13 +626,14 @@
 <dd>
   <p>Removes and deletes a value from the MIME field located
                 at <code class="code"><em class="replaceable"><code>field </code></em></code> within the
-                marshal buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code>.
-                The <code class="code"><em class="replaceable"><code>idx </code></em></code> parameter
-                specifies which value should be deleted. If
-                <code class="code"><em class="replaceable"><code>idx </code></em></code> is not between 0
-                and <code class="function">INKMimeHdrFieldValuesCount</code>
-                (<code class="code"><em class="replaceable"><code>bufp, hdr, field</code></em></code>) - 1,
-                then no operation is performed.</p></dd>
+                marshal buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code>.                </p></dd>
+<dd>
+  <p>The <code class="code"><em class="replaceable"><code>idx </code></em></code> parameter
+    specifies which value should be deleted. If
+    <code class="code"><em class="replaceable"><code>idx </code></em></code> is not between <code>0</code> and <code class="function">INKMimeHdrFieldValuesCount</code><code>
+    (</code><code class="code"><em class="replaceable"><code>bufp, hdr, field</code></em></code><code>) - 1</code>,
+    then no operation is performed.</p>
+</dd>
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>
 <p><code class="code">INK_SUCCESS</code> if successful.</p>
@@ -627,17 +658,20 @@
   <p>Retrieves an integer value from within the MIME field
                 located at <code class="code"><em class="replaceable"><code>field </code></em></code>
                 within the marshal buffer
-                <code class="code"><em class="replaceable"><code>bufp </code></em></code>. The
-                <code class="code"><em class="replaceable"><code>idx </code></em></code> parameter
-                specifies which value within the field to retrieve. The fields
-                are numbered from 0 to
-                <code class="function">INKMimeHdrFieldValuesCount</code>
-                (<code class="code"><em class="replaceable"><code>bufp, hdr, field</code></em></code>) -
-                1. If <code class="code"><em class="replaceable"><code>idx </code></em></code> does not lie
-                within that range, then <code>INKMimeHdrFieldValueIntGet</code> returns <code>(int) 0</code>.
-                All values are stored as strings within the MIME field; <code class="function">INKMimeHdrFieldValueIntGet</code> parses the
-                string <code class="code"><em class="replaceable"><code>value </code></em></code> to return
-        an integer.</p></dd>
+        <code class="code"><em class="replaceable"><code>bufp </code></em></code>. </p></dd>
+<dd>
+  <p>The <code class="code"><em class="replaceable"><code>idx </code></em></code> parameter
+    specifies which value within the field to retrieve. The fields
+    are numbered from <code>0</code> to <code class="function">INKMimeHdrFieldValuesCount</code><code>
+      (</code><code class="code"><em class="replaceable"><code>bufp, hdr, field</code></em></code><code>) -
+        1</code>. If <code class="code"><em class="replaceable"><code>idx </code></em></code> does not lie
+    within that range, then <code>INKMimeHdrFieldValueIntGet</code> returns <code>(int) 0</code>.    </p>
+</dd>
+<dd>
+  <p>All values are stored as strings within the MIME field; <code class="function">INKMimeHdrFieldValueIntGet</code> parses the
+    string <code class="code"><em class="replaceable"><code>value </code></em></code> to return
+    an integer.</p>
+</dd>
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>
 <p>The integer value from the specified MIME field.</p>
@@ -666,24 +700,25 @@
                 <code class="code"><em class="replaceable"><code>value </code></em></code> into the MIME
                 field located at <code class="code"><em class="replaceable"><code>field </code></em></code>
                 within the marshal buffer
-                <code class="code"><em class="replaceable"><code>bufp</code></em></code>. The
-                <code class="code"><em class="replaceable"><code>idx </code></em></code> parameter
-                specifies where the inserted value should be placed with respect
-                to the other values already in the MIME field. If
-                <code class="code"><em class="replaceable"><code>idx </code></em></code> is 0, then the
-                value is prepended to the list of values in the field.
-                Increasing values of
-                <code class="code"><em class="replaceable"><code>idx </code></em></code> places the value
-                farther down the list of values. If
-                <code class="code"><em class="replaceable"><code>idx </code></em></code> is -1, then the
-                <code class="code"><em class="replaceable"><code>value </code></em></code> is appended to
-                the list of values. Normal usage is to specify -1 for
-                <code class="code"><em class="replaceable"><code>idx </code></em></code> so that the value
-                is appended to the list of values. All values are stored as
-                strings within the MIME field. 
-                <code class="function">INKMimeHdrFieldValueIntInsert</code> simply
-                formats the integer into a string and then calls
-                <code class="function">INKMimeHdrFieldValueInsert</code>.</p></dd>
+        <code class="code"><em class="replaceable"><code>bufp</code></em></code>. </p></dd>
+<dd>
+  <p>The <code class="code"><em class="replaceable"><code>idx </code></em></code> parameter
+    specifies where the inserted value should be placed with respect
+    to the other values already in the MIME field. If
+    <code class="code"><em class="replaceable"><code>idx </code></em></code> is <code>0</code>, then the
+    value is prepended to the list of values in the field.
+    Increasing values of <code class="code"><em class="replaceable"><code>idx </code></em></code> places the value
+    farther down the list of values. If
+    <code class="code"><em class="replaceable"><code>idx </code></em></code> is <code>-1</code>, then the <code class="code"><em class="replaceable"><code>value </code></em></code> is appended to
+    the list of values. Normal usage is to specify <code>-1</code> for <code class="code"><em class="replaceable"><code>idx </code></em></code> so that the value
+    is appended to the list of values. </p>
+</dd>
+<dd>
+  <p>All values are stored as
+    strings within the MIME field. <code class="function">INKMimeHdrFieldValueIntInsert</code> simply
+    formats the integer into a string and then calls
+    <code class="function">INKMimeHdrFieldValueInsert</code>.</p>
+</dd>
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>
 <p><code class="code">INK_SUCCESS</code> if the API is called
@@ -709,16 +744,20 @@
 <dd>
   <p>Sets a value in the MIME field located at
                 <code class="code"><em class="replaceable"><code>field </code></em></code> within the
-                marshal buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code>.
-                The <code class="code"><em class="replaceable"><code>idx </code></em></code> parameter
-                specifies which value in the field to change. If
-                <code class="code"><em class="replaceable"><code>idx </code></em></code> is not between 0
-                and <code>INKMimeHdrFieldValuesCount </code>(<code class="code"><em class="replaceable"><code>bufp, hdr,
-                field</code></em></code>) - 1, then no operation is
-                performed. All values are stored as strings within the MIME
-                field. <code class="function">INKMimeHdrFieldValueIntSet</code> simply
-                formats the integer into a string and then calls
-                <code class="function">INKMimeHdrFieldValueSet</code>.</p></dd>
+        marshal buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code>.          </p></dd>
+<dd>
+  <p>The <code class="code"><em class="replaceable"><code>idx </code></em></code> parameter
+    specifies which value in the field to change. If
+    <code class="code"><em class="replaceable"><code>idx </code></em></code> is not between <code>0</code> and <code>INKMimeHdrFieldValuesCount (</code><code class="code"><em class="replaceable"><code>bufp, hdr,
+      field</code></em></code><code>) - 1</code>, then no operation is
+    performed. </p>
+</dd>
+<dd>
+  <p>All values are stored as strings within the MIME
+    field. <code class="function">INKMimeHdrFieldValueIntSet</code> simply
+    formats the integer into a string and then calls
+    <code class="function">INKMimeHdrFieldValueSet</code>.</p>
+</dd>
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>
 <p><code class="function">INK_SUCCESS</code> if the API is called
@@ -746,18 +785,22 @@
   <p>Retrieves a string
                 <code class="code"><em class="replaceable"><code>value </code></em></code> from within the
                 MIME <code class="code"><em class="replaceable"><code>field </code></em></code> within the
-                marshal buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code>.
-                The <code class="code"><em class="replaceable"><code>idx </code></em></code> parameter
-                specifies which field to retrieve. The fields are numbered
-                from 0 to <code class="function">INKMimeHdrFieldValuesCount</code>
-                (<code class="code"><em class="replaceable"><code>bufp, hdr, field</code></em></code>) -
-                1. If <code class="code"><em class="replaceable"><code>idx </code></em></code> does not lie
-                within that range, then <code class="code">NULL</code> is returned. The
-                length of the returned string is placed in the
-                <code class="code"><em class="replaceable"><code>value_len </code></em></code> argument. If
-                <code class="code"><em class="replaceable"><code>value_len </code></em></code> is
-                <code class="code">NULL</code>, then no attempt is made to dereference
-                it.</p></dd>
+        marshal buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code>.          </p></dd>
+<dd>
+  <p>The <code class="code"><em class="replaceable"><code>idx </code></em></code> parameter
+    specifies which field to retrieve. The fields are numbered
+    from <code>0</code> to <code class="function">INKMimeHdrFieldValuesCount</code><code>
+      (</code><code class="code"><em class="replaceable"><code>bufp, hdr, field</code></em></code><code>) -
+        1</code>. If <code class="code"><em class="replaceable"><code>idx </code></em></code> does not lie
+    within that range, then <code class="code">NULL</code> is returned. </p>
+</dd>
+<dd>
+  <p>The
+    length of the returned string is placed in the <code class="code"><em class="replaceable"><code>value_len </code></em></code> argument. If
+    <code class="code"><em class="replaceable"><code>value_len </code></em></code> is
+    <code class="code">NULL</code>, then no attempt is made to dereference
+    it.</p>
+</dd>
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>
 <p>A pointer to the specified field
@@ -791,32 +834,35 @@
                 <code class="code"><em class="replaceable"><code>value </code></em></code> into the MIME
                 field located at <code class="code"><em class="replaceable"><code>field </code></em></code>
                 within the marshal buffer
-                <code class="code"><em class="replaceable"><code>bufp</code></em></code>. If
-                <code class="code"><em class="replaceable"><code>len </code></em></code> is -1, then
-                <code class="function">INKMimeHdrFieldValueStringInsert</code> assumes
-                that <code class="code"><em class="replaceable"><code>value </code></em></code> is
-                null-terminated. Otherwise, the length of the string
-                <code class="code"><em class="replaceable"><code>value </code></em></code> is taken to be
-                <code class="code"><em class="replaceable"><code>length</code></em></code>.
-                <code class="function"> INKMimeHdrFieldValueStringInsert</code> copies
-                the string to within
-                <code class="code"><em class="replaceable"><code>bufp</code></em></code>, so it is okay to
-                modify or delete <code class="code"><em class="replaceable"><code>value </code></em></code>
-                after calling
-                <code class="function">INKMimeHdrFieldValueStringSet</code>. The
-                <code class="code"><em class="replaceable"><code>idx </code></em></code> parameter
-                specifies where the inserted value should be placed with respect
-                to the other values already in the MIME field. If
-                <code class="code"><em class="replaceable"><code>idx </code></em></code> is 0, then
-                <code class="function">INKMimeHdrFieldValueStringInsert</code> prepends
-                the value to the list of values in the field. Increasing
-                values of <code class="code"><em class="replaceable"><code>idx </code></em></code> place
-                the value farther down the list of values. If
-                <code class="code"><em class="replaceable"><code>idx </code></em></code> is -1,
-                then <code class="function">INKMimeHdrFieldValueStringInsert</code> appends
-                the value to the list of values. Normal usage is to specify -1
-                for <code class="replaceable">idx </code> so that the value is appended to the  list
-        of values.</p></dd>
+        <code class="code"><em class="replaceable"><code>bufp</code></em></code>. </p></dd>
+<dd>
+  <p>If <code class="code"><em class="replaceable"><code>len </code></em></code> is <code>-1</code>, then <code class="function">INKMimeHdrFieldValueStringInsert</code> assumes
+    that <code class="code"><em class="replaceable"><code>value </code></em></code> is
+    null-terminated. Otherwise, the length of the string
+    <code class="code"><em class="replaceable"><code>value </code></em></code> is taken to be
+    <code class="code"><em class="replaceable"><code>length</code></em></code>.    </p>
+</dd>
+<dd>
+  <p><code class="function">INKMimeHdrFieldValueStringInsert</code> copies
+    the string to within
+    <code class="code"><em class="replaceable"><code>bufp</code></em></code>, so it is okay to
+    modify or delete <code class="code"><em class="replaceable"><code>value </code></em></code>
+    after calling
+    <code class="function">INKMimeHdrFieldValueStringSet</code>. </p>
+</dd>
+<dd>
+  <p>The <code class="code"><em class="replaceable"><code>idx </code></em></code> parameter
+    specifies where the inserted value should be placed with respect
+    to the other values already in the MIME field. If
+    <code class="code"><em class="replaceable"><code>idx </code></em></code> is <code>0</code>, then <code class="function">INKMimeHdrFieldValueStringInsert</code> prepends
+    the value to the list of values in the field. Increasing
+    values of <code class="code"><em class="replaceable"><code>idx </code></em></code> place
+    the value farther down the list of values. If
+    <code class="code"><em class="replaceable"><code>idx </code></em></code> is<code> -1</code>,
+    then <code class="function">INKMimeHdrFieldValueStringInsert</code> appends
+    the value to the list of values. Normal usage is to specify<code> -1</code> for <code class="replaceable">idx </code> so that the value is appended to the  list
+    of values.</p>
+</dd>
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>
 <p><code class="code">INK_SUCCESS</code> if the API is called
@@ -844,24 +890,29 @@
 <p>Sets a value in the MIME field located at
                 <code class="code"><em class="replaceable"><code>field </code></em></code> within the
                 marshal buffer <code class="code"><em class="replaceable"><code>bufp </code></em></code> to
-                the string <code class="code"><em class="replaceable"><code>value</code></em></code>. If
-                <code class="code"><em class="replaceable"><code>len </code></em></code> is -1, then it is
-                assumed that <code class="code"><em class="replaceable"><code>value </code></em></code> is
-                null-terminated. Otherwise, the length of the string
-                <code class="code"><em class="replaceable"><code>value </code></em></code> is taken to be
-                <code class="code"><em class="replaceable"><code>len</code></em></code>. The string is
-                copied to within <code class="code"><em class="replaceable"><code>bufp</code></em></code>,
-                so it is okay to modify or delete
-                <code class="code"><em class="replaceable"><code>value </code></em></code> after calling
-                <code class="function">INKMimeHdrFieldValueStringSet</code>. The
-                <code class="code"><em class="replaceable"><code>idx </code></em></code> parameter
-                specifies which value in the field to change. If
-                <code class="code"><em class="replaceable"><code>idx </code></em></code> is not between 0
-                and <code class="function">INKMimeHdrFieldValuesCount</code>
-                (<code class="code"><em class="replaceable"><code>bufp, hdr, field</code></em></code>) - 1, 
-                then no operation will be performed. If
-                <code class="code"><em class="replaceable"><code>idx </code></em></code> is set to -1, then
-                all the MIME field values are returned.  </p>
+                the string <code class="code"><em class="replaceable"><code>value</code></em></code>. </p>
+</dd>
+<dd>
+  <p>If <code class="code"><em class="replaceable"><code>len </code></em></code> is <code>-1</code>, then it is
+    assumed that <code class="code"><em class="replaceable"><code>value </code></em></code> is
+    null-terminated. Otherwise, the length of the string
+    <code class="code"><em class="replaceable"><code>value </code></em></code> is taken to be
+    <code class="code"><em class="replaceable"><code>len</code></em></code>. </p>
+</dd>
+<dd>
+  <p>The string is
+    copied to within <code class="code"><em class="replaceable"><code>bufp</code></em></code>,
+    so it is okay to modify or delete
+    <code class="code"><em class="replaceable"><code>value </code></em></code> after calling
+    <code class="function">INKMimeHdrFieldValueStringSet</code>. </p>
+</dd>
+<dd>
+  <p>The <code class="code"><em class="replaceable"><code>idx </code></em></code> parameter
+    specifies which value in the field to change. If
+    <code class="code"><em class="replaceable"><code>idx </code></em></code> is not between <code>0</code> and <code class="function">INKMimeHdrFieldValuesCount</code>
+    <code>(</code><code class="code"><em class="replaceable"><code>bufp, hdr, field</code></em></code><code>) - 1</code>, 
+    then no operation will be performed. If <code class="code"><em class="replaceable"><code>idx </code></em></code> is set to <code>-1</code>, then
+    all the MIME field values are returned. </p>
 </dd>
 <dt><b>Example</b></dt>
 <dd>
@@ -869,7 +920,7 @@
     the MIME field is <code class="code">MyField: value1</code>,<code class="code">
       value2</code>, <code class="code">value3</code>. If
     <code class="function">INKMimeHdrFieldGet</code> is called with
-    <code class="code"><em class="replaceable"><code>idx </code></em></code> set to -1, then it will
+    <code class="code"><em class="replaceable"><code>idx </code></em></code> set to <code>-1</code>, then it will
     return a pointer to "<code class="code">value1</code>, <code class="code">value2</code>,
     <code class="code">value3</code>".</p>
   <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note">
@@ -902,24 +953,29 @@
                 <code class="code"><em class="replaceable"><code>value </code></em></code> from within the
                 MIME field located at
                 <code class="code"><em class="replaceable"><code>field </code></em></code> within the
-                marshal buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code>.
-                The <code class="code"><em class="replaceable"><code>idx </code></em></code> parameter
-                specifies which field to retrieve. The fields are numbered
-                from 0 to <code class="function">INKMimeHdrFieldValuesCount</code>
-                (<code class="code"><em class="replaceable"><code>bufp, hdr, field</code></em></code>) -
-                1. If <code class="code"><em class="replaceable"><code>idx </code></em></code> does not lie
-                within that range, then 
-                <code class="function">INKMimeHdrFieldValueGetUnit</code> returns
-                <code>(unsigned int) 0</code>. All values are stored as strings within the
-                MIME field. <code class="function">INKMimeHdrFieldValueUintGet</code>
-                parses the string
-                <code class="code"><em class="replaceable"><code>value </code></em></code> to return an
-                unsigned integer.</p>
-<p>It is not possible to determine if
-                <code class="function">INKMimeHdrFieldValueUintGet</code> is returning
-                an unsigned <code>int</code> value in error. If you need to check for
-                errors in MIME header field values, then you can fetch the header
-                as a string and examine it (see the example below). </p>
+                marshal buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code>.                </p>
+</dd>
+<dd>
+  <p>The <code class="code"><em class="replaceable"><code>idx </code></em></code> parameter
+    specifies which field to retrieve. The fields are numbered
+    from <code>0</code> to <code class="function">INKMimeHdrFieldValuesCount</code>
+    <code>(</code><code class="code"><em class="replaceable"><code>bufp, hdr, field</code></em></code><code>) -
+      1</code>. If <code class="code"><em class="replaceable"><code>idx </code></em></code> does not lie
+    within that range, then 
+    <code class="function">INKMimeHdrFieldValueGetUnit</code> returns
+    <code>(unsigned int) 0</code>. </p>
+</dd>
+<dd>
+  <p>All values are stored as strings within the
+    MIME field. <code class="function">INKMimeHdrFieldValueUintGet</code>
+    parses the string
+    <code class="code"><em class="replaceable"><code>value </code></em></code> to return an
+    unsigned integer.</p>
+  <p>It is not possible to determine if
+    <code class="function">INKMimeHdrFieldValueUintGet</code> is returning
+    an unsigned <code>int</code> value in error. If you need to check for
+    errors in MIME header field values, then you can fetch the header
+    as a string and examine it (see the example below). </p>
 </dd>
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>
@@ -971,8 +1027,8 @@ handle_string (INKHttpTxn txnp, INKCont 
 
     /* Terminate the string */
     output_string[len] = '\0';
-/* Now that you have the MIME fields as a string, you can do whatever
-       you want to do with it. For example: you can print it or 
+/* Now that you have the MIME fields as a string, you can do 
+       whatever you want with it. For example: you can print it or 
        make sure it's an unsigned integer, either by using the
        atol C function or by scanning each ASCII character.  */ 
     INKDebug("my-plugin", "%s", output_string);
@@ -999,20 +1055,24 @@ handle_string (INKHttpTxn txnp, INKCont 
                 <code class="code"><em class="replaceable"><code>value </code></em></code> into the MIME
                 field located at <code class="code"><em class="replaceable"><code>field </code></em></code>
                 within the marshal buffer
-                <code class="code"><em class="replaceable"><code>bufp</code></em></code>. The
-                <code class="code"><em class="replaceable"><code>idx </code></em></code> parameter
-                specifies where the inserted value should be placed with respect
-                to  other values already in the MIME field. If<code class="code"><em class="replaceable"><code> idx</code></em> </code>is 0, then the value is prepended to the
-                list of values in the field. Increasing values of <code class="code"><em class="replaceable"><code>idx </code></em></code>  simply places the
-                value farther down on the list of values. If
-                <code class="code"><em class="replaceable"><code>idx </code></em></code> is -1, then the
-                value is appended to the list of values. Normal usage is
-                to specify -1 for <code class="code"><em class="replaceable"><code>idx </code></em></code>
-                so that the value will be appended to the existing list of values. All
-                values are stored as strings within the MIME field.
-                <code class="function">INKMimeHdrFieldValueUIntInsert</code> simply
-                formats the unsigned integer into a string and then calls
-        <code class="function">INKMimeHdrFieldValueStringInsert</code>.</p></dd>
+        <code class="code"><em class="replaceable"><code>bufp</code></em></code>. </p></dd>
+<dd>
+  <p>The <code class="code"><em class="replaceable"><code>idx </code></em></code> parameter
+    specifies where the inserted value should be placed with respect
+    to  other values already in the MIME field. If<code class="code"><em class="replaceable"><code> idx</code></em> </code>is <code>0</code>, then the value is prepended to the
+    list of values in the field. Increasing values of <code class="code"><em class="replaceable"><code>idx </code></em></code>  simply places the
+    value farther down on the list of values. If
+    <code class="code"><em class="replaceable"><code>idx </code></em></code> is <code>-1</code>, then the
+    value is appended to the list of values. Normal usage is
+    to specify <code>-1</code> for <code class="code"><em class="replaceable"><code>idx </code></em></code>
+    so that the value will be appended to the existing list of values. </p>
+</dd>
+<dd>
+  <p>All
+    values are stored as strings within the MIME field. <code class="function">INKMimeHdrFieldValueUIntInsert</code> simply
+    formats the unsigned integer into a string and then calls
+    <code class="function">INKMimeHdrFieldValueStringInsert</code>.</p>
+</dd>
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>
 <p><code class="code">INK_SUCCESS</code> if the API is called
@@ -1041,17 +1101,20 @@ handle_string (INKHttpTxn txnp, INKCont 
                 <code class="code"><em class="replaceable"><code>field </code></em></code> within the
                 marshal buffer <code class="code"><em class="replaceable"><code>bufp </code></em></code> to
                 the unsigned integer
-                <code class="code"><em class="replaceable"><code>value</code></em></code>. The
-                <code class="code"><em class="replaceable"><code>idx </code></em></code> parameter
-                specifies which value in the field to change. If
-                <code class="code"><em class="replaceable"><code>idx </code></em></code> is not between 0
-                and <code class="function">INKMimeHdrFieldValuesCount</code>
-                (<code class="code"><em class="replaceable"><code>bufp, hdr, field</code></em></code>) - 1,
-                then no operation is performed. All values are stored as
-                strings within the MIME field.
-                <code class="function">INKMimeHdrFieldValueUintSet</code> simply
-                formats the unsigned integer into a string and then calls
-                <code class="function">INKMimeHdrFieldValueStringSet</code>.</p></dd>
+        <code class="code"><em class="replaceable"><code>value</code></em></code>. </p></dd>
+<dd>
+  <p>The <code class="code"><em class="replaceable"><code>idx </code></em></code> parameter
+    specifies which value in the field to change. If
+    <code class="code"><em class="replaceable"><code>idx </code></em></code> is not between <code> 0</code> and <code class="function">INKMimeHdrFieldValuesCount</code>
+    <code>(</code><code class="code"><em class="replaceable"><code>bufp, hdr, field</code></em></code><code>) - 1</code>,
+    then no operation is performed. </p>
+</dd>
+<dd>
+  <p>All values are stored as
+    strings within the MIME field. <code class="function">INKMimeHdrFieldValueUintSet</code> simply
+    formats the unsigned integer into a string and then calls
+    <code class="function">INKMimeHdrFieldValueStringSet</code>.</p>
+</dd>
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>
 <p><code class="code">INK_SUCCESS</code> if the API is called
@@ -1159,20 +1222,22 @@ handle_string (INKHttpTxn txnp, INKCont 
                 header located at
                 <code class="code"><em class="replaceable"><code>dest_hdr_loc </code></em></code> within
                 the marshal buffer
-                <code class="code"><em class="replaceable"><code>dest_bufp</code></em></code>.
-                <code class="function">INKMimeHdrCopy</code> works correctly even if
-                <code class="code"><em class="replaceable"><code>src_bufp </code></em></code> and
-                <code class="code"><em class="replaceable"><code>dest_bufp </code></em></code> point to
-                different marshal buffers.</p>
-<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note">
-<tr>
-<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="images/docbook/note.png" /></td>
-<th align="left">Note</th>
-</tr>
-<tr><td align="left" valign="top"><p>Make sure  the destination marshal buffer and
-                  destination MIME header location have been created before
-                  copying (see the example below).</p></td></tr>
-</table></div>
+                <code class="code"><em class="replaceable"><code>dest_bufp</code></em></code>.                </p>
+</dd>
+<dd>
+  <p><code class="function">INKMimeHdrCopy</code> works correctly even if
+    <code class="code"><em class="replaceable"><code>src_bufp </code></em></code> and
+    <code class="code"><em class="replaceable"><code>dest_bufp </code></em></code> point to
+    different marshal buffers.</p>
+  <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note">
+    <tr>
+      <td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="images/docbook/note.png" /></td>
+      <th align="left">Note</th>
+      </tr>
+    <tr><td align="left" valign="top"><p>Make sure  the destination marshal buffer and
+      the destination MIME header location have been created before
+      copying (see the example below).</p></td></tr>
+    </table></div>
 </dd>
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>
@@ -1267,20 +1332,20 @@ copyResponseMimeHdr (INKCont pCont, INKH
   <p>Retrieves a MIME field from within the MIME header
                 located at <code class="code"><em class="replaceable"><code>loc </code></em></code> within
                 the marshal buffer
-                <code class="code"><em class="replaceable"><code>bufp</code></em></code>. The
-                <code class="code"><em class="replaceable"><code>name </code></em></code> and
-                <code class="code"><em class="replaceable"><code>length </code></em></code> parameters
-                specify which field to retrieve. For each MIME field in the
-                MIME header, a case-insensitive string comparison is done
-                between the field name and
-                <code class="code"><em class="replaceable"><code>name</code></em></code>. The
-                <code class="code"><em class="replaceable"><code>length </code></em></code> parameter
-                specifies the length of  the string that  
-                <code class="code"><em class="replaceable"><code>name </code></em></code> points to. If
-                <code class="code"><em class="replaceable"><code>length </code></em></code> is -1, then
-                <code class="code"><em class="replaceable"><code>name </code></em></code> is assumed to be
-                null-terminated. If the requested field cannot be found, then 0
-        is returned.</p></dd>
+        <code class="code"><em class="replaceable"><code>bufp</code></em></code>. </p></dd>
+<dd>
+  <p>The <code class="code"><em class="replaceable"><code>name </code></em></code> and
+    <code class="code"><em class="replaceable"><code>length </code></em></code> parameters
+    specify which field to retrieve. For each MIME field in the
+    MIME header, a case-insensitive string comparison is done
+    between the field name and
+    <code class="code"><em class="replaceable"><code>name</code></em></code>. The
+    <code class="code"><em class="replaceable"><code>length </code></em></code> parameter
+    specifies the length of  the string that  
+    <code class="code"><em class="replaceable"><code>name </code></em></code> points to. If
+    <code class="code"><em class="replaceable"><code>length </code></em></code> is <code>-1</code>, then <code class="code"><em class="replaceable"><code> name </code></em></code> is assumed to be
+    null-terminated. If the requested field cannot be found, then <code>0</code> is returned.</p>
+</dd>
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>
 <p>The location of the retrieved MIME header. Release with
@@ -1304,13 +1369,15 @@ copyResponseMimeHdr (INKCont pCont, INKH
   <p>Retrieves a MIME field from within the MIME header
                 located at <code class="code"><em class="replaceable"><code>hdr_loc </code></em></code>
                 within the marshal buffer
-                <code class="code"><em class="replaceable"><code>bufp</code></em></code>. The
-                <code class="code"><em class="replaceable"><code>idx </code></em></code> parameter
-                specifies which field to retrieve. The fields are numbered
-                from 0 to <code class="function">INKMimeHdrFieldsCount</code>
-                (<code class="code"><em class="replaceable"><code>bufp, hdr_loc</code></em></code>) - 1.
-                If <code class="code"><em class="replaceable"><code>idx </code></em></code> does not lie
-                within that range, then 0 is returned.</p></dd>
+        <code class="code"><em class="replaceable"><code>bufp</code></em></code>. </p></dd>
+<dd>
+  <p>The <code class="code"><em class="replaceable"><code>idx </code></em></code> parameter
+    specifies which field to retrieve. The fields are numbered
+    from <code>0</code> to <code class="function">INKMimeHdrFieldsCount</code>
+    <code>(</code><code class="code"><em class="replaceable"><code>bufp, hdr_loc</code></em></code><code>) - 1</code>.
+    If <code class="code"><em class="replaceable"><code>idx </code></em></code> does not lie
+    within that range, then <code>0</code> is returned.</p>
+</dd>
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>
 <p>The location of the MIME field from within the MIME
@@ -1455,17 +1522,21 @@ copyResponseMimeHdr (INKCont pCont, INKH
                 been allocated, and both
                 <code class="code"><em class="replaceable"><code>bufp </code></em></code> and
                 <code class="code"><em class="replaceable"><code>hdr_loc </code></em></code> must point
-                within that header. The
-                <code class="code"><em class="replaceable"><code>start </code></em></code> argument points
-                to the current position of the buffer being parsed and the
-                <code class="code"><em class="replaceable"><code>end </code></em></code> argument points to
-                one byte after the end of the buffer. Upon return,
-                <code class="code"><em class="replaceable"><code>start </code></em></code> is modified to
-                point past the last character parsed. It is possible to parse
-                a MIME header a single byte at a time using repeated calls to
-                <code class="function">INKMimeHdrParse</code>. As long as an error does
-                not occur, the <code>INKMimeHdrParse</code> function  consumes that
-        single byte and asks for more.</p></dd>
+        within that header. </p></dd>
+<dd>
+  <p>The <code class="code"><em class="replaceable"><code>start </code></em></code> argument points
+    to the current position of the buffer being parsed and the
+    <code class="code"><em class="replaceable"><code>end </code></em></code> argument points to
+    one byte after the end of the buffer. Upon return,
+    <code class="code"><em class="replaceable"><code>start </code></em></code> is modified to
+    point past the last character parsed. </p>
+</dd>
+<dd>
+  <p>It is possible to parse
+    a MIME header a single byte at a time using repeated calls to <code class="function">INKMimeHdrParse</code>. As long as an error does
+    not occur, the <code>INKMimeHdrParse</code> function  consumes that
+    single byte and asks for more.</p>
+</dd>
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>
 <p><code class="code">INK_PARSE_ERROR</code>  if an error occurs.</p>
@@ -1534,7 +1605,7 @@ copyResponseMimeHdr (INKCont pCont, INKH
 <dt><span class="term"><b>Description</b></span></dt>
 <dd>
   <p>Destroys the specified MIME
-                <code class="code"><em class="replaceable"><code>parser </code></em></code> and frees the
+                <code class="code"><em class="replaceable"><code> parser </code></em></code> and frees the
                 associated memory.</p></dd>
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>



Mime
View raw message