trafficserver-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From dia...@apache.org
Subject svn commit: r938633 [2/2] - /incubator/trafficserver/site/trunk/docs/v2/sdk/App_DeprecatedFunctions.html
Date Tue, 27 Apr 2010 20:21:25 GMT

Modified: incubator/trafficserver/site/trunk/docs/v2/sdk/App_DeprecatedFunctions.html
URL: http://svn.apache.org/viewvc/incubator/trafficserver/site/trunk/docs/v2/sdk/App_DeprecatedFunctions.html?rev=938633&r1=938632&r2=938633&view=diff
==============================================================================
--- incubator/trafficserver/site/trunk/docs/v2/sdk/App_DeprecatedFunctions.html (original)
+++ incubator/trafficserver/site/trunk/docs/v2/sdk/App_DeprecatedFunctions.html Tue Apr 27 20:21:24 2010
@@ -83,7 +83,7 @@
               <code class="code"><em class="replaceable"><code>src_offset </code></em></code> within the
               marshal buffer <code class="code"><em class="replaceable"><code>src_bufp </code></em></code>
               to the MIME field located at 
-              <code class="code"><em class="replaceable"><code>dest_offset</code></em></code> within the
+              <code class="code"><em class="replaceable"><code>dest_offset </code></em></code> within the
               marshal buffer 
               <code class="code"><em class="replaceable"><code>dest_bufp</code></em></code>.
               <code class="function">INKMimeFieldCopy</code> works correctly even if
@@ -119,16 +119,19 @@
               at <code class="code"><em class="replaceable"><code>src_offset </code></em></code> within the
               marshal buffer <code class="code"><em class="replaceable"><code>src_bufp </code></em></code>
               to the MIME field located at 
-              <code class="code"><em class="replaceable"><code>dest_offset</code></em></code> within the
+              <code class="code"><em class="replaceable"><code>dest_offset </code></em></code> within the
               marshal buffer
-              <code class="code"><em class="replaceable"><code>dest_bufp</code></em></code>.
-              <code class="function">INKMimeFieldCopyValues </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">INKMIMEFieldCopyValues</code> does not copy the
-              field's name.</p></dd>
-</dl></div>
+              <code class="code"><em class="replaceable"><code>dest_bufp</code></em></code>.   </p></dd>
+<dd>
+  <p><code class="function">INKMimeFieldCopyValues </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">INKMIMEFieldCopyValues</code> does not copy the
+    field's name.</p>
+</dd>
+</dl>
+</div>
 </div>
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
@@ -203,18 +206,21 @@
 <dt><span class="term"><b>Description</b></span></dt>
 <dd>
 <p>Returns the name of the field located at
-              <code class="code"><em class="replaceable"><code>offset</code></em></code> within the
-              marshal buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code>.
-              <code class="function">INKMimeFieldNameGet</code> places the length of
-              the returned string in the
-              <code class="code"><em class="replaceable"><code>length</code></em></code> argument. If
-              <code class="code"><em class="replaceable"><code>length</code></em></code> is
-              <code class="code">NULL</code> then no attempt is made to de-reference
-              it.</p>
-<p>Release the returned string with a call to
-              <code class="function">INKHandleStringRelease</code>.</p>
+              <code class="code"><em class="replaceable"><code>offset </code></em></code> within the
+              marshal buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code>.              </p>
 </dd>
-</dl></div>
+<dd>
+  <p><code class="function">INKMimeFieldNameGet</code> places the length of
+    the returned string in the
+    <code class="code"><em class="replaceable"><code>length </code></em></code> argument. If
+    <code class="code"><em class="replaceable"><code>length </code></em></code> is
+    <code class="code">NULL</code>, then no attempt is made to dereference
+    it.</p>
+  <p>Release the returned string with a call to
+    <code class="function">INKHandleStringRelease</code>.</p>
+</dd>
+</dl>
+</div>
 </div>
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
@@ -232,17 +238,22 @@
   <p>Sets the name of the field located at
               <code class="code"><em class="replaceable"><code>offset </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">INKMimeFieldNameSet</code> assumes that name is
-              null-terminated. Otherwise, the length of the string name is
-              taken to be <code class="code"><em class="replaceable"><code>length</code></em></code>.
-              <code class="function">INKMimeFieldNameSet</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">INKMimeFieldNameSet</code>.</p></dd>
-</dl></div>
+              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 -1, then
+    <code class="function">INKMimeFieldNameSet</code> assumes that name is
+    null-terminated. Otherwise, the length of the string name is
+    taken to be <code class="code"><em class="replaceable"><code>length</code></em></code>.    </p>
+</dd>
+<dd>
+  <p><code class="function">INKMimeFieldNameSet</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">INKMimeFieldNameSet</code>.</p>
+</dd>
+</dl>
+</div>
 </div>
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
@@ -259,7 +270,7 @@
               header (see <a href="HTTPHeaders.html#AboutHTTPHeaders" title="About HTTP Headers">About HTTP Headers</a>).
               <code class="function">INKMimeFieldNext</code> returns the location of
               the next field in the list after the field located at
-              <code class="code"><em class="replaceable"><code>offset</code></em></code> within the
+              <code class="code"><em class="replaceable"><code> offset </code></em></code> within the
               marshal buffer
               <code class="code"><em class="replaceable"><code>bufp</code></em></code>.</p>
 <p>Release the returned <code class="function">INKMLoc</code> with a
@@ -304,14 +315,16 @@
 <dd>
   <p>Removes and deletes a value from the MIME field located at
               <code class="code"><em class="replaceable"><code>offset </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">INKMimeFieldValuesCount</code> (<em class="replaceable"><code>bufp,
-              offset</code></em>) - 1, then no operation will be
-              performed.</p></dd>
-</dl></div>
+              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">INKMimeFieldValuesCount</code> <code>(</code><em class="replaceable"><code>bufp,
+      offset</code></em><code>) - 1</code>, then no operation is 
+    performed.</p>
+</dd>
+</dl>
+</div>
 </div>
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
@@ -328,22 +341,26 @@
 <dd>
 <p>Retrieves a string value from within the MIME field
               located at <code class="code"><em class="replaceable"><code>offset </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">INKMimeFieldValuesCount</code>
-              (<code class="code"><em class="replaceable"><code>bufp, offset</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> will be returned. The length
-              of the returned string is placed in the
-              <code class="code"><em class="replaceable"><code>length </code></em></code> argument. If
-              <code class="code"><em class="replaceable"><code>length </code></em></code> is
-              <code class="code">NULL, </code> then no attempt is made to dereference
-              it.</p>
-<p>Release the returned string with a call to
-              <code class="function">INKHandleStringRelease</code>.</p>
+              the marshal buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code>.              </p>
 </dd>
-</dl></div>
+<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">INKMimeFieldValuesCount</code>
+    <code>(</code><code class="code"><em class="replaceable"><code>bufp, offset</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>length </code></em></code> argument. If
+    <code class="code"><em class="replaceable"><code>length </code></em></code> is
+    <code class="code">NULL, </code> then no attempt is made to dereference
+    it.</p>
+  <p>Release the returned string with a call to
+    <code class="function">INKHandleStringRelease</code>.</p>
+</dd>
+</dl>
+</div>
 </div>
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
@@ -358,19 +375,23 @@
 <dt><span class="term"><b>Description</b></span></dt>
 <dd>
   <p>Retrieves a date value from within the MIME field located
-              at <code class="code"><em class="replaceable"><code>offset </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">INKMimeFieldValuesCount</code>
-              (<code class="code"><em class="replaceable"><code>bufp, offset</code></em></code>) - 1. If
-              <code class="code"><em class="replaceable"><code>idx </code></em></code> does not lie within
-              that range, thrn <code class="function">INKMimeFieldValueGetDate</code>
-              returns (<code class="code">time_t</code>) 0. All values are stored as
-              strings within the MIME field.
-              <code class="function">INKMimeFieldValueGetDate</code> parses the string
-              value to return an integer date representation.</p></dd>
-</dl></div>
+              at <code class="code"><em class="replaceable"><code> offset </code></em></code> within the
+          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">INKMimeFieldValuesCount</code>
+    (<code class="code"><em class="replaceable"><code>bufp, offset</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">INKMimeFieldValueGetDate</code>
+    returns <code>(</code><code class="code">time_t</code><code>) 0</code>. </p>
+</dd>
+<dd>
+  <p>All values are stored as
+    strings within the MIME field. <code class="function">INKMimeFieldValueGetDate</code> parses the string
+    value to return an integer date representation.</p>
+</dd>
+</dl>
+</div>
 </div>
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
@@ -386,18 +407,22 @@
 <dd>
   <p>Retrieves an integer value from within the MIME field
               located at <code class="code"><em class="replaceable"><code>offset </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">INKMimeFieldValuesCount</code>
-              (<code class="code"><em class="replaceable"><code>bufp, offset</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">INKMimeFieldValueGetInt</code> returns
-              (<code class="code">int</code>) 0. All values are stored as strings within
-              the MIME field. <code class="function">INKMimeFieldValueGetInt</code>
-              parses the string value to return an integer.</p></dd>
-</dl></div>
+          the 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 within the field to retrieve. The fields
+    are numbered from <code>0</code> to <code class="function">INKMimeFieldValuesCount</code><code>
+      (</code><code class="code"><em class="replaceable"><code>bufp, offset</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">INKMimeFieldValueGetInt</code> returns
+    <code>(</code><code class="code">int</code><code>) 0</code>. </p>
+</dd>
+<dd>
+  <p>All values are stored as strings within
+    the MIME field. <code class="function">INKMimeFieldValueGetInt</code>
+    parses the string value to return an integer.</p>
+</dd>
+</dl>
+</div>
 </div>
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
@@ -414,18 +439,21 @@
   <p>Retrieves an unsigned integer value from within the MIME
               field located at <code class="code"><em class="replaceable"><code>offset </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">INKMimeFieldValuesCount</code>
-              (<code class="code"><em class="replaceable"><code>bufp, offset</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">INKMimeFieldValueGetUnit</code>
-              returns (<code class="code">unsigned int</code>) 0. All values are stored as
-              strings within the MIME field.
-              <code class="function">INKMimeFieldValueGetUint</code> parses the string
-              value to return an unsigned integer.</p></dd>
-</dl></div>
+          <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">INKMimeFieldValuesCount</code>
+    <code>(</code><code class="code"><em class="replaceable"><code>bufp, offset</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">INKMimeFieldValueGetUnit</code>
+    returns <code>(</code><code class="code">unsigned int</code><code>) 0</code>. </p>
+</dd>
+<dd>
+  <p>All values are stored as
+    strings within the MIME field. <code class="function">INKMimeFieldValueGetUint</code> parses the string
+    value to return an unsigned integer.</p>
+</dd>
+</dl>
+</div>
 </div>
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
@@ -444,28 +472,33 @@
               <code class="code"><em class="replaceable"><code>value </code></em></code> into the MIME
               field located at <code class="code"><em class="replaceable"><code>offset </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 <code class="code"><em class="replaceable"><code>value</code></em></code>
-              should be put 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 <code class="code"><em class="replaceable"><code>value </code></em></code> 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
-              <code class="code"><em class="replaceable"><code>value </code></em></code> further 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
-              <code class="code"><em class="replaceable"><code>value</code></em></code> is appended to the
-              list of values. All values are stored as strings within the MIME
-              field. <code class="function">INKMimeFieldValueInsertDate</code> simply
-              formats the date into a string and then calls
-              <code class="function">INKMimeFieldValueInsert</code>.</p>
-<p>Release the returned <code class="function">INKMLoc</code> with a
-              call to <code class="function">INKHandleMLocRelease</code>.</p>
+              <code class="code"><em class="replaceable"><code>bufp</code></em></code>. </p>
 </dd>
-</dl></div>
+<dd>
+  <p>The <code class="code"><em class="replaceable"><code>idx </code></em></code> parameter specifies
+    where the inserted <code class="code"><em class="replaceable"><code>value</code></em></code>
+    should be put 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 <code class="code"><em class="replaceable"><code>value </code></em></code> is
+    prepended to the list of values in the field. Increasing values
+    of <code class="code"><em class="replaceable"><code>idx </code></em></code> place the
+    <code class="code"><em class="replaceable"><code>value </code></em></code> further 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
+    <code class="code"><em class="replaceable"><code>value </code></em></code> is appended to the
+    list of values. </p>
+</dd>
+<dd>
+  <p>All values are stored as strings within the MIME
+    field. <code class="function">INKMimeFieldValueInsertDate</code> simply
+    formats the date into a string and then calls
+    <code class="function">INKMimeFieldValueInsert</code>.</p>
+  <p>Release the returned <code class="function">INKMLoc</code> with a
+    call to <code class="function">INKHandleMLocRelease</code>.</p>
+</dd>
+</dl>
+</div>
 </div>
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
@@ -484,28 +517,33 @@
               <code class="code"><em class="replaceable"><code>value </code></em></code> into the MIME
               field located at <code class="code"><em class="replaceable"><code>offset </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 <code class="code"><em class="replaceable"><code>value</code></em></code>
-              should be put 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 <code class="code"><em class="replaceable"><code>value </code></em></code> 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
-              <code class="code"><em class="replaceable"><code>value </code></em></code> further 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
-              <code class="code"><em class="replaceable"><code>value </code></em></code> is appended to the
-              list of values. All values are stored as strings within the MIME
-              field. <code class="function">INKMimeFieldValueInsertInt</code> simply
-              formats the integer into a string and then calls
-              <code class="function">INKMimeFieldValueInsert</code>.</p>
-<p>Release the returned <code class="function">INKMLoc</code> with a
-              call to <code class="function">INKHandleMLocRelease</code>.</p>
+              <code class="code"><em class="replaceable"><code>bufp</code></em></code>. </p>
 </dd>
-</dl></div>
+<dd>
+  <p>The <code class="code"><em class="replaceable"><code>idx </code></em></code> parameter specifies
+    where the inserted <code class="code"><em class="replaceable"><code>value </code></em></code>
+    should be put 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 <code class="code"><em class="replaceable"><code>value </code></em></code> 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
+    <code class="code"><em class="replaceable"><code>value </code></em></code> further 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
+    <code class="code"><em class="replaceable"><code>value </code></em></code> is appended to the
+    list of values. </p>
+</dd>
+<dd>
+  <p>All values are stored as strings within the MIME
+    field. <code class="function">INKMimeFieldValueInsertInt</code> simply
+    formats the integer into a string and then calls
+    <code class="function">INKMimeFieldValueInsert</code>.</p>
+  <p>Release the returned <code class="function">INKMLoc</code> with a
+    call to <code class="function">INKHandleMLocRelease</code>.</p>
+</dd>
+</dl>
+</div>
 </div>
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
@@ -524,29 +562,33 @@
               <code class="code"><em class="replaceable"><code>value </code></em></code> into the MIME
               field located at <code class="code"><em class="replaceable"><code>offset </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 <code class="code"><em class="replaceable"><code>value</code></em></code>
-              should be put 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 <code class="code"><em class="replaceable"><code>value </code></em></code> will be
-              prepended to the list of values in the field. Increasing values
-              of <code class="code"><em class="replaceable"><code>idx </code></em></code> will place the
-              <code class="code"><em class="replaceable"><code>value </code></em></code> further 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>
-              will be 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 <code class="code"><em class="replaceable"><code>value </code></em></code> will be
-              appended to the list of values. All values are stored as strings
-              within the MIME field.
-              <code class="function">INKMimeFieldValueInsertUint</code> simply formats
-              the unsigned integer into a string and then calls
-              <code class="function">INKMimeFieldValueInsert</code>.</p>
-              <p>Release the returned <code class="function">INKMLoc</code> with a
-              call to <code class="function">INKHandleMLocRelease</code>.</p>
+            <code class="code"><em class="replaceable"><code>bufp</code></em></code>. </p>
 </dd>
-</dl></div>
+<dd>
+  <p>The <code class="code"><em class="replaceable"><code>idx </code></em></code> parameter specifies
+    where the inserted <code class="code"><em class="replaceable"><code>value </code></em></code>
+    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 <code class="code"><em class="replaceable"><code>value </code></em></code> is
+    prepended to the list of values in the field. Increasing values
+    of <code class="code"><em class="replaceable"><code>idx </code></em></code>  place the
+    <code class="code"><em class="replaceable"><code>value </code></em></code> further 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 <code class="code"><em class="replaceable"><code>value </code></em></code> is
+    appended to the list of values. </p>
+</dd>
+<dd>
+  <p>All values are stored as strings
+    within the MIME field. <code class="function">INKMimeFieldValueInsertUint</code> simply formats
+    the unsigned integer into a string and then calls
+    <code class="function">INKMimeFieldValueInsert</code>.</p>
+  <p>Release the returned <code class="function">INKMLoc</code> with a
+    call to <code class="function">INKHandleMLocRelease</code>.</p>
+</dd>
+</dl>
+</div>
 </div>
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
@@ -577,7 +619,7 @@
 <dt><span class="term"><b>Description</b></span></dt>
 <dd>
   <p>Returns a count of the number of values in the MIME field
-              located at <code class="code"><em class="replaceable"><code>offset </code></em></code> within
+              located at <code class="code"><em class="replaceable"><code> offset </code></em></code> within
               the marshal buffer
               <code class="code"><em class="replaceable"><code>bufp</code></em></code>.</p></dd>
 </dl></div>
@@ -600,22 +642,27 @@
               <code class="code"><em class="replaceable"><code>offset </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>length </code></em></code> is -1, then it is
+              <code class="code"><em class="replaceable"><code>length </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>length</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">INKMimeFieldValueSet</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">INKMimeFieldValuesCount</code>
-              (<code class="code"><em class="replaceable"><code>bufp, offset</code></em></code>) - 1, then
-              no operation will be performed.</p></dd>
-</dl></div>
+          <code class="code"><em class="replaceable"><code>length</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's okay to modify or delete
+    <code class="code"><em class="replaceable"><code>value </code></em></code> after calling
+    <code class="function">INKMimeFieldValueSet</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">INKMimeFieldValuesCount</code>
+    <code>(</code><code class="code"><em class="replaceable"><code>bufp, offset</code></em></code><code>) - 1</code>, then
+    no operation is performed.</p>
+</dd>
+</dl>
+</div>
 </div>
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
@@ -629,23 +676,26 @@
               <em class="replaceable"><code>idx</code></em>, time_t
               <em class="replaceable"><code>value</code></em>) </code></p></dd>
 <dt><span class="term"><b>Description</b></span></dt>
-<dd><p>Sets a value in the MIME field located at
-              <code class="code"><em class="replaceable"><code>offset</code></em></code> within the
+<dd>
+  <p>Sets a value in the MIME field located at 
+              <code class="code"><em class="replaceable"><code> offset </code></em></code> within the
               marshal buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code> to
-              the data <code class="code">value</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">INKMimeFieldValuesCount</code>
-              (<code class="code"><em class="replaceable"><code>bufp, offset</code></em></code>) - 1 then
-              no operation will be performed. All values are stored as strings
-              within the MIME field.
-              <code class="function">INKMimeFieldValueSetDate</code> simply formats the
-              date into a string and then calls
-              <code class="function">INKMimeFieldValueSet</code>.</p></dd>
-<dt><span class="term">First release</span></dt>
-<dd><p>Traffic Server 3.0</p></dd>
-</dl></div>
+          the data <code class="code">value</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">INKMimeFieldValuesCount</code>
+    <code>(</code><code class="code"><em class="replaceable"><code>bufp, offset</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">INKMimeFieldValueSetDate</code> simply formats the
+    date into a string and then calls
+    <code class="function">INKMimeFieldValueSet</code>.</p>
+</dd>
+</dl>
+</div>
 </div>
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
@@ -663,18 +713,22 @@
   <p>Sets a value in the MIME field located at
               <code class="code"><em class="replaceable"><code>offset </code></em></code> within the
               marshal buffer <code class="code"><em class="replaceable"><code>bufp </code></em></code> to
-              the 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">INKMimeFieldValuesCount</code>
-              (<code class="code"><em class="replaceable"><code>bufp, offset</code></em></code>) - 1, then
-              no operation will be performed. All values are stored as strings
-              within the MIME field.
-              <code class="function">INKMimeFieldValueSetInt</code> simply formats the
-              integer into a string and then calls
-              <code class="function">INKMimeFieldValueSet</code>.</p></dd>
-</dl></div>
+          the integer <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">INKMimeFieldValuesCount</code>
+    <code>(</code><code class="code"><em class="replaceable"><code>bufp, offset</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">INKMimeFieldValueSetInt</code> simply formats the
+    integer into a string and then calls
+    <code class="function">INKMimeFieldValueSet</code>.</p>
+</dd>
+</dl>
+</div>
 </div>
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
@@ -693,23 +747,28 @@
               <code class="code"><em class="replaceable"><code>offset </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">INKMimeFieldValuesCount</code>
-              (<code class="code"><em class="replaceable"><code>bufp, offset</code></em></code>) - 1, then
-              no operation will be performed. All values are stored as strings
-              within the MIME field.
-              <code class="function">INKMimeFieldValueSetUint</code> simply formats the
-              unsigned integer into a string and then calls
-              <code class="function">INKMimeFieldValueSet</code>.</p></dd>
-</dl></div>
+          <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">INKMimeFieldValuesCount</code>
+    <code>(</code><code class="code"><em class="replaceable"><code>bufp, offset</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">INKMimeFieldValueSetUint</code> simply formats the
+    unsigned integer into a string and then calls
+    <code class="function">INKMimeFieldValueSet</code>.</p>
+</dd>
+</dl>
+</div>
 </div>
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
 <a name="INKMimeHdrFieldValueGet"></a>INKMimeHdrFieldValueGet</h3></div></div></div>
 <p>Gets a specified field value from a MIME header.</p>
+<p><b>Note:</b> This API is <u>deprecated</u> and has been replaced by <code class="function">INKMimeHdrFieldValueStringGet</code>.</p>
 <div class="variablelist"><dl>
 <dt><span class="term"><b>Prototype</b></span></dt>
 <dd><p><code class="code">const char* INKMimeHdrFieldValueGet (INKMBuffer
@@ -722,20 +781,22 @@
 <dd>
 <p>Retrieves a string 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 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> will be returned. The
-              length of the returned string is placed in the
-              <code class="code"><em class="replaceable"><code>value_len_ptr </code></em></code> argument.
-              If <code class="code"><em class="replaceable"><code>value_len_ptr </code></em></code> is
-              <code class="code">NULL</code>, then no attempt is made to dereference
-              it.</p>
-<p>This API has been deprecated by
-              <code class="function">INKMimeHdrFieldValueStringGet</code>.</p>
+              the 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> will be returned. </p>
+</dd>
+<dd>
+  <p>The
+    length of the returned string is placed in the <code class="code"><em class="replaceable"><code>value_len_ptr </code></em></code> argument.
+    If <code class="code"><em class="replaceable"><code>value_len_ptr </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 value in the MIME header.
@@ -747,6 +808,7 @@
 <div class="titlepage"><div><div><h3 class="title">
 <a name="INKMimeHdrFieldValueGetDate"></a>INKMimeHdrFieldValueGetDate</h3></div></div></div>
 <p>Gets date value from a MIME field.</p>
+<p><b>Note:</b> This API is <u>deprecated</u> and has been replaced by <code class="function">INKMimeHdrFieldValueDateGet</code>.</p>
 <div class="variablelist"><dl>
 <dt><span class="term"><b>Prototype</b></span></dt>
 <dd><p><code class="code">time_t INKMimeHdrFieldValueGetDate (INKMBuffer
@@ -758,20 +820,22 @@
 <dd>
 <p>Retrieves a date 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 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">INKMimeHdrFieldValueGetDate</code> returns
-              (<code class="code">time_t</code>) 0. All values are stored as strings within
-              the MIME field. <code class="function">INKMimeHdrFieldValueGetDate</code>
-              parses the string value to return an integer date
-              representation.</p>
-<p>This API has been deprecated by
-              <code class="function">INKMimeHdrFieldValueDateGet</code>.</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">INKMimeHdrFieldValueGetDate</code> returns
+    <code>(</code><code class="code">time_t</code><code>) 0</code>. </p>
+</dd>
+<dd>
+  <p>All values are stored as strings within
+    the MIME field. <code class="function">INKMimeHdrFieldValueGetDate</code>
+    parses the string value to return an integer date
+    representation.</p>
 </dd>
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd><p>The date value from the specified MIME header.</p></dd>
@@ -781,6 +845,7 @@
 <div class="titlepage"><div><div><h3 class="title">
 <a name="INKMimeHdrFieldValueGetInt"></a>INKMimeHdrFieldValueGetInt</h3></div></div></div>
 <p>Gets an integer field value in a MIME field.</p>
+<p><b>Note:</b> This API is <u>deprecated</u> and has been replaced by <code class="function">INKMimeHdrFieldValueIntGet</code>.</p>
 <div class="variablelist"><dl>
 <dt><span class="term"><b>Prototype</b></span></dt>
 <dd><p><code class="code">int INKMimeHdrFieldValueGetInt (INKMBuffer
@@ -793,29 +858,33 @@
 <dd>
 <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 class="function">INKMimeHdrFieldValueGetInt</code> returns
-              (<code class="code">int</code>) 0. All values are stored as strings within
-              the MIME field. <code class="function">INKMimeHdrFieldValueGetInt</code>
-              parses the string value to return an integer.</p>
-<p>This API has been deprecated by
-              <code class="function">INKMimeHdrFieldValueIntGet</code>.</p>
+              the 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 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 class="function">INKMimeHdrFieldValueGetInt</code> returns
+    <code>(</code><code class="code">int</code><code>) 0</code>. </p>
+</dd>
+<dd>
+  <p>All values are stored as strings within
+    the MIME field. <code class="function">INKMimeHdrFieldValueGetInt</code>
+    parses the string value to return an integer.</p>
 </dd>
 <dt><span class="term"><b>Returns</b></span></dt>
-<dd><p>The interger value from the specified MIME field.</p></dd>
+<dd>
+  <p>The integer value from the specified MIME field.</p></dd>
 </dl></div>
 </div>
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
 <a name="INKMimeHdrFieldValueGetUInt"></a>INKMimeHdrFieldValueGetUInt</h3></div></div></div>
 <p>Gets unsigned integer field value in a MIME field.</p>
+<p><b>Note:</b> This API is <u>deprecated</u> and has been replaced by <code class="function">INKMimeHdrFieldValueUIntGet</code>.</p>
 <div class="variablelist"><dl>
 <dt><span class="term"><b>Prototype</b></span></dt>
 <dd><p><code class="code">unsigned int INKMimeHdrFieldValueGetUInt (INKMBuffer
@@ -830,33 +899,27 @@
               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.
+              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 class="code">unsigned int</code>) 0. All values are stored as strings
-              within the MIME field.
-              <code class="function">INKMimeHdrFieldValueGetUInt</code> parses the
+              <code>(</code><code class="code">unsigned int</code><code>) 0</code>. All values are stored as strings
+              within the MIME field. <code class="function">INKMimeHdrFieldValueGetUInt</code> parses the
               string value to return an unsigned integer.</p>
 <p>It is not possible to determine if
               <code class="function">INKMimeHdrFieldValueGetUInt</code> is returning an
-              unsigned int value in error. If you need to check for errors in
-              MIME header field values, you can fetch the header as a string
-              and examine it. Here is some sample code that fetches MIME
-              headers from marshal buffers into strings using
-              <code class="function">INKMimeHdrFieldValueGet</code> instead. The
-              context of this example is that the plugin is processing an HTTP
-              transaction and has access to a transaction.</p>
-<p>This API has been deprecated by
-              <code class="function">INKMimeHdrFieldValueUIntGet</code>.</p>
+              <code>unsigned 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. </p>
 </dd>
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd><p>The unsigned integer value from the specified MIME
               field.</p></dd>
 <dt><span class="term"><b>Example</b></span></dt>
-<dd><pre class="programlisting">static void
+<dd>
+  Below is some sample code that fetches MIME headers from marshal buffers into strings using <code>INKMimeHdrFieldValueGet</code> instead. The context of this example is that the plugin is processing an HTTP transaction and has access to a transaction.
+<pre class="programlisting">static void
 handle_string (INKHttpTxn txnp, INKCont contp) {
     INKMBuffer bufp;
     INKMLoc hdr_loc;
@@ -878,7 +941,7 @@ handle_string (INKHttpTxn txnp, INKCont 
         goto done;
     } 
     /* Obtain the value of the content length (normally an 
-     * unsigned int) as a string. */
+     *unsigned int) as a string. */
     value=INKMimeHdrFieldValueGet (bufp, hdr_loc, field, 0, &amp;len); 
  
     if ((!value) || (len&lt;=0))}
@@ -895,9 +958,9 @@ 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, print it, or 
-       make sure it's an unsigned integer: either by using the
-       atol C function or by scanning each ASCII character.  */ 
+       whatever you want with it.  For example: you can print it
+       or make sure it's an unsigned integer (by using the
+       atol C function or by scanning each ASCII character).  */ 
     INKDebug("my-plugin", "%s", output_string);
      
     /* Release handles and allocated memory. */    
@@ -909,6 +972,7 @@ handle_string (INKHttpTxn txnp, INKCont 
 <a name="INKMimeHdrFieldValueInsert"></a>INKMimeHdrFieldValueInsert</h3></div></div></div>
 <p>Inserts a value into a specified location within a MIME
         field.</p>
+<p><b>Note:</b> This API is <u>deprecated</u> and has been replaced by <code class="function">INKMimeHdrFieldValueStringInsert</code>.</p>
 <div class="variablelist"><dl>
 <dt><span class="term"><b>Prototype</b></span></dt>
 <dd><p><code class="code">INKMLoc INKMimeHdrFieldValueInsert (INKMBuffer
@@ -924,42 +988,45 @@ 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>. If
-              <code class="code"><em class="replaceable"><code>length </code></em></code> is -1, then
-              <code class="function">INKMimeHdrFieldValueInsert</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>.
-              INKMimeHdrFieldValueInsert 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">INKMimeHdrFieldValueSet</code>. The
-              <code class="code"><em class="replaceable"><code>idx </code></em></code> parameter specifies
-              where the inserted <code class="code"><em class="replaceable"><code>value </code></em></code>
-              should be put 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">INKMimeHdrFieldValueInsert</code> prepends
-              the <code class="code"><em class="replaceable"><code>value </code></em></code> to the list of
-              values in the field. Increasing values of
-              <code class="code"><em class="replaceable"><code>idx </code></em></code> place the
-              <code class="code"><em class="replaceable"><code>value </code></em></code> further down the
-              list of values. If <code class="code"><em class="replaceable"><code>idx </code></em></code>
-              is -1, then <code class="function">INKMimeHdrFieldValueInsert</code> appends
-              the <code class="code"><em class="replaceable"><code>value </code></em></code> 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
-              <code class="code"><em class="replaceable"><code>value </code></em></code> is appended to the
-              list of values.</p>
-<p>This API has been deprecated by
-              <code class="function">INKMimeHdrFieldValueStringInsert</code>.</p>
+              <code class="code"><em class="replaceable"><code>bufp</code></em></code>. </p>
 </dd>
-</dl></div>
+<dd>
+  <p>If <code class="code"><em class="replaceable"><code>length </code></em></code> is <code>-1</code>, then <code class="function">INKMimeHdrFieldValueInsert</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>INKMimeHdrFieldValueInsert</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">INKMimeHdrFieldValueSet</code>. </p>
+</dd>
+<dd>
+  <p>The <code class="code"><em class="replaceable"><code>idx </code></em></code> parameter specifies
+    where the inserted <code class="code"><em class="replaceable"><code>value </code></em></code>
+    should be put 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">INKMimeHdrFieldValueInsert</code> prepends
+    the <code class="code"><em class="replaceable"><code>value </code></em></code> to the list of
+    values in the field. Increasing values of
+    <code class="code"><em class="replaceable"><code>idx </code></em></code> place the
+    <code class="code"><em class="replaceable"><code>value </code></em></code> further 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">INKMimeHdrFieldValueInsert</code> appends
+    the <code class="code"><em class="replaceable"><code>value </code></em></code> 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
+    <code class="code"><em class="replaceable"><code>value </code></em></code> is appended to the
+    list of values.</p>
+</dd>
+</dl>
+</div>
 </div>
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
 <a name="INKMimeHdrFieldValueInsertDate"></a>INKMimeHdrFieldValueInsertDate</h3></div></div></div>
 <p>Inserts a date value into a MIME field.</p>
+<p><b>Note:</b> This API is <u>deprecated</u> and  has been replaced by <code class="function">INKMimeHdrFieldValueDateInsert</code>.</p>
 <div class="variablelist"><dl>
 <dt><span class="term"><b>Prototype</b></span></dt>
 <dd><p><code class="code">INKMLoc INKMimeHdrFieldValueInsertDate (INKMBuffer
@@ -974,42 +1041,46 @@ 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 <code class="code"><em class="replaceable"><code>value </code></em></code>
-              should be put 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 <code class="code"><em class="replaceable"><code>value </code></em></code> 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
-              <code class="code"><em class="replaceable"><code>value </code></em></code> further 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
-              <code class="code"><em class="replaceable"><code>value </code></em></code> is appended to the
-              list of values. All values are stored as strings within the MIME
-              field. <code class="function">INKMimeHdrFieldValueInsertDate</code>
-              simply formats the date into a string and then calls
-              <code class="function">INKMimeHdrFieldValueInsert</code>.</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>Do not use the return value
-                (<code class="function">INKMLoc</code>) of this function. Future
-                versions will be changed to void.</p></td></tr>
-</table></div>
-<p>This API has been deprecated by
-              <code class="function">INKMimeHdrFieldValueDateInsert</code>.</p>
+              <code class="code"><em class="replaceable"><code>bufp</code></em></code>. </p>
 </dd>
-</dl></div>
+<dd>
+  <p>The <code class="code"><em class="replaceable"><code>idx </code></em></code> parameter specifies
+    where the inserted <code class="code"><em class="replaceable"><code>value </code></em></code>
+    should be put 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 <code class="code"><em class="replaceable"><code>value </code></em></code> 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
+    <code class="code"><em class="replaceable"><code>value </code></em></code> further 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
+    <code class="code"><em class="replaceable"><code>value </code></em></code> is appended to the
+    list of values. </p>
+</dd>
+<dd>
+  <p>All values are stored as strings within the MIME
+    field. <code class="function">INKMimeHdrFieldValueInsertDate</code>
+    simply formats the date into a string and then calls
+    <code class="function">INKMimeHdrFieldValueInsert</code>.</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>Do not use the return value
+      (<code class="function">INKMLoc</code>) of this function. Future
+      versions will be changed to <code>void</code>.</p></td></tr>
+    </table></div>
+</dd>
+</dl>
+</div>
 </div>
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
 <a name="INKMimeHdrFieldValueInsertInt"></a>INKMimeHdrFieldValueInsertInt</h3></div></div></div>
 <p>Inserts an integer value into a MIME field.</p>
+<p><b>Note:</b> This API is <u>deprecated</u> and has been succeeded by <code class="function">INKMimeHdrFieldValueIntInsert</code>.</p>
 <div class="variablelist"><dl>
 <dt><span class="term"><b>Prototype</b></span></dt>
 <dd><p><code class="code">INKMLoc INKMimeHdrFieldValueInsertInt (INKMBuffer
@@ -1024,33 +1095,37 @@ 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 <code class="code"><em class="replaceable"><code>value</code></em></code>
-              should be put 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 <code class="code"><em class="replaceable"><code>value </code></em></code> 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
-              <code class="code"><em class="replaceable"><code>value </code></em></code> further 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
-              <code class="code"><em class="replaceable"><code>value </code></em></code> is appended to the
-              list of values. All values are stored as strings within the MIME
-              field. <code class="function">INKMimeHdrFieldValueInsertInt</code> simply
-              formats the integer into a string and then calls
-              <code class="function">INKMimeHdrFieldValueInsert</code>.</p>
-<p>This API has been deprecated by
-              <code class="function">INKMimeHdrFieldValueIntInsert</code>.</p>
+              <code class="code"><em class="replaceable"><code>bufp</code></em></code>. </p>
 </dd>
-</dl></div>
+<dd>
+  <p>The <code class="code"><em class="replaceable"><code>idx </code></em></code> parameter specifies
+    where the inserted <code class="code"><em class="replaceable"><code>value </code></em></code>
+    should be put 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 <code class="code"><em class="replaceable"><code>value </code></em></code> 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
+    <code class="code"><em class="replaceable"><code>value </code></em></code> further 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
+    <code class="code"><em class="replaceable"><code>value </code></em></code> is appended to the
+    list of values. </p>
+</dd>
+<dd>
+  <p>All values are stored as strings within the MIME
+    field. <code class="function">INKMimeHdrFieldValueInsertInt</code> simply
+    formats the integer into a string and then calls
+    <code class="function">INKMimeHdrFieldValueInsert</code>.</p>
+</dd>
+</dl>
+</div>
 </div>
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
 <a name="INKMimeHdrFieldValueInsertUInt"></a>INKMimeHdrFieldValueInsertUInt</h3></div></div></div>
 <p>Inserts an unsigned integer value into a MIME field.</p>
+<p><b>Note:</b> This API is <u>deprecated</u> and  has been succeeded by <code class="function">INKMimeHdrFieldValueUIntInsert</code>.</p>
 <div class="variablelist"><dl>
 <dt><span class="term"><b>Prototype</b></span></dt>
 <dd><p><code class="code">INKMLoc INKMimeHdrFieldValueInsertUInt (INKMBuffer
@@ -1065,34 +1140,36 @@ 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 <code class="code"><em class="replaceable"><code>value </code></em></code>
-              should be put 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 <code class="code"><em class="replaceable"><code>value </code></em></code> will be
-              prepended to the list of values in the field. Increasing values
-              of <code class="code"><em class="replaceable"><code>idx</code></em></code> will place the
-              <code class="code"><em class="replaceable"><code>value</code></em></code> further 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>
-              will be 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 <code class="code"><em class="replaceable"><code>value </code></em></code> will be
-              appended to the list of values. All values are stored as strings
-              within the MIME field.
-              <code class="function">INKMimeHdrFieldValueInsertUInt</code> simply
-              formats the unsigned integer into a string and then calls
-              <code class="function">INKMimeHdrFieldValueInsert</code>.</p>
-<p>This API has been deprecated by
-              <code class="function">INKMimeHdrFieldValueUIntInsert</code>.</p>
+              <code class="code"><em class="replaceable"><code>bufp</code></em></code>. </p>
 </dd>
-</dl></div>
+<dd>
+  <p>The <code class="code"><em class="replaceable"><code>idx </code></em></code> parameter specifies
+    where the inserted <code class="code"><em class="replaceable"><code>value </code></em></code>
+    should be put 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 <code class="code"><em class="replaceable"><code>value </code></em></code>is
+    prepended to the list of values in the field. Increasing values
+    of <code class="code"><em class="replaceable"><code>idx </code></em></code>  place the
+    <code class="code"><em class="replaceable"><code>value </code></em></code> further 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 <code class="code"><em class="replaceable"><code>value </code></em></code> is
+    appended to the list of values.</p>
+</dd>
+<dd>
+  <p> All values are stored as strings
+    within the MIME field. <code class="function">INKMimeHdrFieldValueInsertUInt</code> simply
+    formats the unsigned integer into a string and then calls
+    <code class="function">INKMimeHdrFieldValueInsert</code>.</p>
+</dd>
+</dl>
+</div>
 </div>
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
 <a name="INKMimeHdrFieldValueSet"></a>INKMimeHdrFieldValueSet</h3></div></div></div>
 <p>Sets a value in a MIME field.</p>
+<p><b>Note:</b> This API is <u>deprecated</u> and has been succeeded by <code class="function">INKMimeHdrFieldValueStringSet</code>.</p>
 <div class="variablelist"><dl>
 <dt><span class="term"><b>Prototype</b></span></dt>
 <dd><p><code class="code">void INKMimeHdrFieldValueSet (INKMBuffer
@@ -1107,31 +1184,36 @@ handle_string (INKHttpTxn txnp, INKCont 
 <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>length </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>length</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">INKMimeHdrFieldValueSet</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.</p>
-<p>This API has been deprecated by
-              <code class="function">INKMimeHdrFieldValueStringSet</code>.</p>
+              string <code class="code"><em class="replaceable"><code>value</code></em></code>. </p>
 </dd>
-</dl></div>
+<dd>
+  <p>If <code class="code"><em class="replaceable"><code>length </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>length</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">INKMimeHdrFieldValueSet</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>
+</dl>
+</div>
 </div>
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
 <a name="INKMimeHdrFieldValueSetDate"></a>INKMimeHdrFieldValueSetDate</h3></div></div></div>
-<p>Sets a date value in a MIME field.</p>
+<p>Sets the date value in a MIME field.</p>
 <div class="variablelist"><dl>
 <dt><span class="term"><b>Prototype</b></span></dt>
 <dd><p><code class="code">void INKMimeHdrFieldValueSetDate (INKMBuffer
@@ -1145,23 +1227,28 @@ handle_string (INKHttpTxn txnp, INKCont 
   <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 date 
-              <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 the
-              <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. All values are stored as
-              strings within the MIME field.
-              <code class="function">INKMimeHdrFieldValueSetDate</code> simply formats
-              the date into a string and then calls
-              <code class="function">INKMimeHdrFieldValueSet</code>.</p></dd>
-</dl></div>
+          <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 the
+    <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">INKMimeHdrFieldValueSetDate</code> simply formats
+    the date into a string and then calls
+    <code class="function">INKMimeHdrFieldValueSet</code>.</p>
+</dd>
+</dl>
+</div>
 </div>
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
 <a name="INKMimeHdrFieldValueSetInt"></a>INKMimeHdrFieldValueSetInt</h3></div></div></div>
 <p>Sets an integer value within a MIME field.</p>
+<p><b>Note:</b> This API is <u>deprecated</u> and has been succeeded by <code class="function">INKMimeHdrFieldValueIntSet</code>.</p>
 <div class="variablelist"><dl>
 <dt><span class="term"><b>Prototype</b></span></dt>
 <dd><p><code class="code">void INKMimeHdrFieldValueSetInt (INKMBuffer
@@ -1175,27 +1262,30 @@ handle_string (INKHttpTxn txnp, INKCont 
 <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
-              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 will be performed. All values are stored as
-              strings within the MIME field.
-              <code class="function">INKMimeHdrFieldValueSetInt</code> simply formats
-              the integer into a string and then calls
-              <code class="function">INKMimeHdrFieldValueSet</code>.</p>
-<p>This API has been deprecated by
-              <code class="function">INKMimeHdrFieldValueIntSet</code>.</p>
+              integer <code class="code"><em class="replaceable"><code>value</code></em></code>. </p>
 </dd>
-</dl></div>
+<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">INKMimeHdrFieldValueSetInt</code> simply formats
+    the integer into a string and then calls
+    <code class="function">INKMimeHdrFieldValueSet</code>.</p>
+</dd>
+</dl>
+</div>
 </div>
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
 <a name="INKMimeHdrFieldValueSetUInt"></a>INKMimeHdrFieldValueSetUInt</h3></div></div></div>
 <p>Sets a value in a MIME field to a specified unsigned
         integer.</p>
+<p><b>Note:</b> This API is <u>deprecated</u> and has been replaced by <code class="function">INKMimeHdrFieldValueUIntSet</code>.</p>
 <div class="variablelist"><dl>
 <dt><span class="term"><b>Prototype</b></span></dt>
 <dd><p><code class="code">void INKMimeHdrFieldValueSetUInt (INKMBuffer
@@ -1209,26 +1299,29 @@ handle_string (INKHttpTxn txnp, INKCont 
 <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
-              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 will be performed. All values are stored as
-              strings within the MIME field.
-              <code class="function">INKMimeHdrFieldValueSetUInt</code> simply formats
-              the unsigned integer into a string and then calls
-              <code class="function">INKMimeHdrFieldValueSet</code>.</p>
-<p>This API has been deprecated by
-              <code class="function">INKMimeHdrFieldValueUIntSet</code>.</p>
+              unsigned integer <code class="code"><em class="replaceable"><code>value</code></em></code>.              </p>
 </dd>
-</dl></div>
+<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">INKMimeHdrFieldValueSetUInt</code> simply formats
+    the unsigned integer into a string and then calls
+    <code class="function">INKMimeHdrFieldValueSet</code>.</p>
+</dd>
+</dl>
+</div>
 </div>
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
 <a name="INKMimeHdrFieldDelete"></a>INKMimeHdrFieldDelete</h3></div></div></div>
 <p>Destroys a MIME header field.</p>
+<p><b>Note:</b> This API is <u>deprecated</u> and has been replaced by <code class="function">INKMimeHdrFieldDestroy</code>.</p>
 <div class="variablelist"><dl>
 <dt><span class="term"><b>Prototype</b></span></dt>
 <dd><p><code class="code">void INKMimeHdrFieldDelete (INKMBuffer
@@ -1246,15 +1339,14 @@ handle_string (INKHttpTxn txnp, INKCont 
 <p>Make sure you release the <code class="function">INKMLoc</code>
               handle field with a call to
               <code class="function">INKHandleMLocRelease</code>.</p>
-<p>This API has been deprecated by
-              <code class="function">INKMimeHdrFieldDestroy</code>.</p>
 </dd>
 </dl></div>
 </div>
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
 <a name="INKMimeHdrFieldInsert"></a>INKMimeHdrFieldInsert</h3></div></div></div>
-<p>Appends a field in a MIME header.</p>
+<p>Appends a field in a MIME header. </p>
+<p><b>Note: </b>This API is <u>deprecated</u> and has been replaced by <code class="function">INKMimeHdrFieldAppend</code>.</p>
 <div class="variablelist"><dl>
 <dt><span class="term"><b>Prototype</b></span></dt>
 <dd><p><code class="code">void INKMimeHdrFieldInsert (INKMBuffer
@@ -1265,23 +1357,25 @@ handle_string (INKHttpTxn txnp, INKCont 
 <dt><span class="term"><b>Description</b></span></dt>
 <dd>
 <p>Appends the MIME field located at
-              <code class="code"><em class="replaceable"><code>field</code></em></code> within the marshal
+              <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> into 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"><i>idx </i></code> parameter specifies where the inserted field
-              should be put with respect to the other fields already in the
-              MIME header.</p>
-<p>This API has been deprecated by
-              <code class="function">INKMimeHdrFieldAppend</code></p>
+              marshal buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code>. </p>
 </dd>
-</dl></div>
+<dd>
+  <p>The <code class="code"><i>idx </i></code> parameter specifies where the inserted field
+    should be put with respect to the other fields already in the
+    MIME header.</p>
+</dd>
+</dl>
+</div>
 </div>
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
 <a name="INKMimeHdrFieldRetrieve"></a>INKMimeHdrFieldRetrieve</h3></div></div></div>
 <p>Retrieves a MIME header field.</p>
+<p><b>Note:</b> This API is <u>deprecated</u> and has been replaced by <code class="function">INKMimeHdrFieldFind</code>.</p>
 <div class="variablelist"><dl>
 <dt><span class="term"><b>Prototype</b></span></dt>
 <dd><p><code class="code">INKMLoc INKMimeHdrFieldRetrieve (INKMBuffer
@@ -1292,24 +1386,25 @@ handle_string (INKHttpTxn txnp, INKCont 
 <dd>
 <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>retrieved_str </code></em></code> parameter
-              specifies which field to retrieve. For each MIME field in the
-              MIME header, a pointer comparison is done between the field name
-              and <code class="code"><em class="replaceable"><code>retrieved_str</code></em></code>. This
-              is a much quicker retrieval function than
-              <code class="function">INKMimeHdrFieldFind</code>, since it obviates the
-              need for a string comparision. However, 

[... 32 lines stripped ...]


Mime
View raw message