[TS-265] Deprecated APIs has misleading (wrong?) comments in ts/ts.h

• Type: Bug
• Status: Closed
• Priority: Minor
• Resolution: Fixed
• Fix Version/s: 2.1.2
• Component/s: TS API
• Assignee: Leif Hedstrom
• Reporter: Leif Hedstrom
• Created: 22/Mar/10 17:34
• Updated: 25/Aug/10 02:52
• Resolved: 30/Jun/10 18:25

Description

In ts/ts.h, there's a number of APIs marked as deprecated, and suggesting new APIs which I can't seem to find anywhere:

// --------------------------------------------------------------------------
// Deprecated MIME field functions in SDK3.0

/** @deprecated Use INKMimeHdrFieldAppend() instead */
inkapi INKReturnCode INKMimeHdrFieldInsert(INKMBuffer bufp, INKMLoc hdr, INKMLoc field, int idx);

/** @deprecated Use INKMimeHdrFieldStringInsert() instead */
inkapi INKReturnCode INKMimeHdrFieldValueInsert(INKMBuffer bufp, INKMLoc hdr, INKMLoc field, const char *value, int length, int idx);

/** @deprecated Use INKMimeHdrFieldIntInsert() instead */
inkapi INKReturnCode INKMimeHdrFieldValueInsertInt(INKMBuffer bufp, INKMLoc hdr, INKMLoc field, int value, int idx);

/** @deprecated Use INKMimeHdrFieldUintInsert() instead */
inkapi INKReturnCode INKMimeHdrFieldValueInsertUint(INKMBuffer bufp, INKMLoc hdr, INKMLoc field, unsigned int value, int idx);

/** @deprecated Use INKMimeHdrFieldDateInsert() instead */
inkapi INKReturnCode INKMimeHdrFieldValueInsertDate(INKMBuffer bufp, INKMLoc hdr, INKMLoc field, time_t value, int idx);

/** @deprecated Use INKMimeHdrFieldStringGet() instead */
inkapi const char *INKMimeHdrFieldValueGet(INKMBuffer bufp, INKMLoc hdr, INKMLoc field, int idx, int *value_len_ptr);

/** @deprecated Use INKMimeHdrFieldIntGet() instead */
inkapi int INKMimeHdrFieldValueGetInt(INKMBuffer bufp, INKMLoc hdr, INKMLoc field, int idx);

/** @deprecated Use INKMimeHdrFieldUintGet() instead */
inkapi unsigned int INKMimeHdrFieldValueGetUint(INKMBuffer bufp, INKMLoc hdr, INKMLoc field, int idx);

/** @deprecated Use INKMimeHdrFieldDateGet() instead */
inkapi time_t INKMimeHdrFieldValueGetDate(INKMBuffer bufp, INKMLoc hdr, INKMLoc field, int idx);

/** @deprecated Use INKMimeHdrFieldStringSet() instead */
inkapi INKReturnCode INKMimeHdrFieldValueSet(INKMBuffer bufp, INKMLoc hdr, INKMLoc field, int idx, const char *value, int length);

/** @deprecated Use INKMimeHdrFieldIntSet() instead */
inkapi INKReturnCode INKMimeHdrFieldValueSetInt(INKMBuffer bufp, INKMLoc hdr, INKMLoc field, int idx, int value);

/** @deprecated Use INKMimeHdrFieldUintSet() instead */
inkapi INKReturnCode INKMimeHdrFieldValueSetUint(INKMBuffer bufp, INKMLoc hdr, INKMLoc field, int idx, unsigned int value);

/** @deprecated Use INKMimeHdrFieldDateSet() instead */
inkapi INKReturnCode INKMimeHdrFieldValueSetDate(INKMBuffer bufp, INKMLoc hdr, INKMLoc field, int idx, time_t value);

/** @deprecated Use INKMimeHdrFieldDestroy() instead */
inkapi INKReturnCode INKMimeHdrFieldDelete(INKMBuffer bufp, INKMLoc hdr, INKMLoc field);