<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Wed Feb 07 21:14:10 UTC 2024

It is possible to restrict the fields that are returned in this document by specifying the 'field' parameter in your request.
For example, to request only the issue key and summary append 'field=key&field=summary' to the URL of your request.
-->
<rss version="0.92" >
<channel>
    <title>MongoDB Jira</title>
    <link>https://jira.mongodb.org</link>
    <description>This file is an XML representation of an issue</description>
    <language>en-us</language>    <build-info>
        <version>9.7.1</version>
        <build-number>970001</build-number>
        <build-date>13-04-2023</build-date>
    </build-info>


<item>
            <title>[CDRIVER-2099] Undocument oldest deprecated functions</title>
                <link>https://jira.mongodb.org/browse/CDRIVER-2099</link>
                <project id="10030" key="CDRIVER">C Driver</project>
                    <description>&lt;p&gt;Rather than rev to 2.0 and actually break API, an alternative way to clean up the user experience of the driver is to remove the oldest and most-regretted APIs from the documentation. This will make it clearer to readers which functions are recommended to accomplish a given task.&lt;/p&gt;</description>
                <environment></environment>
        <key id="367593">CDRIVER-2099</key>
            <summary>Undocument oldest deprecated functions</summary>
                <type id="4" iconUrl="https://jira.mongodb.org/secure/viewavatar?size=xsmall&amp;avatarId=14710&amp;avatarType=issuetype">Improvement</type>
                                            <priority id="4" iconUrl="https://jira.mongodb.org/images/icons/priorities/minor.svg">Minor - P4</priority>
                        <status id="6" iconUrl="https://jira.mongodb.org/images/icons/statuses/closed.png" description="The issue is considered finished, the resolution is correct. Issues which are closed can be reopened.">Closed</status>
                    <statusCategory id="3" key="done" colorName="success"/>
                                    <resolution id="9">Done</resolution>
                                        <assignee username="kevin.albertson@mongodb.com">Kevin Albertson</assignee>
                                    <reporter username="jesse@mongodb.com">A. Jesse Jiryu Davis</reporter>
                        <labels>
                            <label>neweng</label>
                    </labels>
                <created>Fri, 24 Mar 2017 17:21:43 +0000</created>
                <updated>Fri, 12 May 2023 21:23:01 +0000</updated>
                            <resolved>Fri, 12 May 2023 21:23:01 +0000</resolved>
                                                    <fixVersion>1.24.0</fixVersion>
                                    <component>docs</component>
                                        <votes>0</votes>
                                    <watches>2</watches>
                                                                                                                <comments>
                            <comment id="5422122" author="xgen-internal-githook" created="Fri, 12 May 2023 21:22:54 +0000"  >&lt;p&gt;Author: &lt;/p&gt;
{&apos;name&apos;: &apos;Kevin Albertson&apos;, &apos;email&apos;: &apos;kevin.albertson@mongodb.com&apos;, &apos;username&apos;: &apos;kevinAlbs&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/CDRIVER-2099&quot; title=&quot;Undocument oldest deprecated functions&quot; class=&quot;issue-link&quot; data-issue-key=&quot;CDRIVER-2099&quot;&gt;&lt;del&gt;CDRIVER-2099&lt;/del&gt;&lt;/a&gt; Remove some deprecated documentation (#1265)&lt;/p&gt;

&lt;ul&gt;
	&lt;li&gt;remove docs for `bson_md5_*`&lt;/li&gt;
&lt;/ul&gt;


&lt;ul&gt;
	&lt;li&gt;remove documentation for mongoc_matcher_t&lt;/li&gt;
&lt;/ul&gt;


&lt;ul&gt;
	&lt;li&gt;remove documentation for `mongoc_client_get_max_*_size`&lt;/li&gt;
&lt;/ul&gt;


&lt;ul&gt;
	&lt;li&gt;use `BSON_GNUC_DEPRECATED_FOR` in bson_oid_init_sequence&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;The documentation suggests using bson_oid_init as an alternative.&lt;/p&gt;

&lt;ul&gt;
	&lt;li&gt;move &quot;Deprecated&quot; sections above &quot;Synopsis&quot;&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;And uses consistent verbage.&lt;/p&gt;

&lt;ul&gt;
	&lt;li&gt;add missing `BSON_GNUC_DEPRECATED` attributes&lt;/li&gt;
&lt;/ul&gt;


&lt;ul&gt;
	&lt;li&gt;add `warning` and `deprecated` directives&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/mongo-c-driver/commit/c0b51f4e1cec75362a698880feb223ef00e42f72&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/mongo-c-driver/commit/c0b51f4e1cec75362a698880feb223ef00e42f72&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
</comment>
                            <comment id="5251840" author="kevin.albertson" created="Mon, 6 Mar 2023 15:05:23 +0000"  >&lt;p&gt;I suggest removing documentation for API with the &lt;tt&gt;BSON_GNUC_DEPRECATED&lt;/tt&gt; attribute.&lt;br/&gt;
I suggest leaving the documentation for API with the &lt;tt&gt;BSON_GNUC_DEPRECATED_FOR&lt;/tt&gt;, since it may help users find the alternate non-deprecated API.&lt;/p&gt;</comment>
                    </comments>
                    <attachments>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                                                                                                                                                                                                                                                                                                                                    <customfield id="customfield_15850" key="com.atlassian.jira.plugins.jira-development-integration-plugin:devsummary">
                        <customfieldname>Development</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    <customfield id="customfield_21553" key="com.atlassian.jira.plugin.system.customfieldtypes:labels">
                        <customfieldname>Quarter</customfieldname>
                        <customfieldvalues>
                                        <label>FY24Q2</label>
    
                        </customfieldvalues>
                    </customfield>
                                                                                            <customfield id="customfield_12550" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>2|hsx573:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10558" key="com.pyxis.greenhopper.jira:gh-global-rank">
                        <customfieldname>Rank (Obsolete)</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>9223372036854775807</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            </customfields>
    </item>
</channel>
</rss>