<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Wed Feb 07 21:13:38 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-1930] Document semi-public mongoc_bulk_operation_t functions</title>
                <link>https://jira.mongodb.org/browse/CDRIVER-1930</link>
                <project id="10030" key="CDRIVER">C Driver</project>
                    <description>&lt;p&gt;There are several functions that are part of the API for HLL wrappers to use, but that are not documented.  It would be helpful for these to be documented at least in the source code.&lt;/p&gt;</description>
                <environment></environment>
        <key id="333046">CDRIVER-1930</key>
            <summary>Document semi-public mongoc_bulk_operation_t functions</summary>
                <type id="2" iconUrl="https://jira.mongodb.org/secure/viewavatar?size=xsmall&amp;avatarId=14711&amp;avatarType=issuetype">New Feature</type>
                                            <priority id="3" iconUrl="https://jira.mongodb.org/images/icons/priorities/major.svg">Major - P3</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="jesse@mongodb.com">A. Jesse Jiryu Davis</assignee>
                                    <reporter username="david.golden@mongodb.com">David Golden</reporter>
                        <labels>
                    </labels>
                <created>Sat, 19 Nov 2016 02:05:31 +0000</created>
                <updated>Thu, 25 Jan 2018 18:02:27 +0000</updated>
                            <resolved>Thu, 25 Jan 2018 18:02:27 +0000</resolved>
                                                    <fixVersion>1.10.0</fixVersion>
                                    <component>docs</component>
                                        <votes>0</votes>
                                    <watches>1</watches>
                                                                                                                <comments>
                            <comment id="1785036" author="xgen-internal-githook" created="Thu, 25 Jan 2018 18:02:19 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{&apos;name&apos;: &apos;A. Jesse Jiryu Davis&apos;, &apos;email&apos;: &apos;jesse@mongodb.com&apos;, &apos;username&apos;: &apos;ajdavis&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/CDRIVER-1930&quot; title=&quot;Document semi-public mongoc_bulk_operation_t functions&quot; class=&quot;issue-link&quot; data-issue-key=&quot;CDRIVER-1930&quot;&gt;&lt;del&gt;CDRIVER-1930&lt;/del&gt;&lt;/a&gt; undocument some bulk-op functions&lt;/p&gt;

&lt;p&gt;Encourage users to create a fully-configured bulk operation with&lt;br/&gt;
mongoc_collection_create_bulk_operation, instead of creating a partly&lt;br/&gt;
configured one with mongoc_bulk_operation_new and setting various&lt;br/&gt;
fields on it.&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/mongo-c-driver/commit/53567fd51d26ba28a665d37cd3a6d98a5f89b4e0&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/mongo-c-driver/commit/53567fd51d26ba28a665d37cd3a6d98a5f89b4e0&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="1748432" author="xgen-internal-githook" created="Mon, 11 Dec 2017 15:49:20 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{&apos;name&apos;: &apos;Jeremy Mikola&apos;, &apos;email&apos;: &apos;jmikola@gmail.com&apos;, &apos;username&apos;: &apos;jmikola&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/CDRIVER-1930&quot; title=&quot;Document semi-public mongoc_bulk_operation_t functions&quot; class=&quot;issue-link&quot; data-issue-key=&quot;CDRIVER-1930&quot;&gt;&lt;del&gt;CDRIVER-1930&lt;/del&gt;&lt;/a&gt; docs for client and client_session bulk setters&lt;br/&gt;
Branch: r1.9&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/mongo-c-driver/commit/c34de1ed93a71d18a895b02decdefe7b66774e04&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/mongo-c-driver/commit/c34de1ed93a71d18a895b02decdefe7b66774e04&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="1748419" author="xgen-internal-githook" created="Mon, 11 Dec 2017 15:41:27 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{&apos;name&apos;: &apos;Jeremy Mikola&apos;, &apos;email&apos;: &apos;jmikola@gmail.com&apos;, &apos;username&apos;: &apos;jmikola&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/CDRIVER-1930&quot; title=&quot;Document semi-public mongoc_bulk_operation_t functions&quot; class=&quot;issue-link&quot; data-issue-key=&quot;CDRIVER-1930&quot;&gt;&lt;del&gt;CDRIVER-1930&lt;/del&gt;&lt;/a&gt; docs for client and client_session bulk setters&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/mongo-c-driver/commit/557b31a5f419cf62854fcf1eff7b5279475bc7e7&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/mongo-c-driver/commit/557b31a5f419cf62854fcf1eff7b5279475bc7e7&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="1441430" author="david.golden" created="Wed, 23 Nov 2016 17:33:19 +0000"  >&lt;p&gt;We use the following symbols:&lt;/p&gt;
&lt;ul&gt;
	&lt;li&gt;mongoc_bulk_operation_destroy&lt;/li&gt;
	&lt;li&gt;mongoc_bulk_operation_execute&lt;/li&gt;
	&lt;li&gt;mongoc_bulk_operation_get_write_concern&lt;/li&gt;
	&lt;li&gt;mongoc_bulk_operation_insert&lt;/li&gt;
	&lt;li&gt;mongoc_bulk_operation_new&lt;/li&gt;
	&lt;li&gt;mongoc_bulk_operation_remove_many_with_opts&lt;/li&gt;
	&lt;li&gt;mongoc_bulk_operation_remove_one_with_opts&lt;/li&gt;
	&lt;li&gt;mongoc_bulk_operation_replace_one_with_opts&lt;/li&gt;
	&lt;li&gt;mongoc_bulk_operation_set_bypass_document_validation&lt;/li&gt;
	&lt;li&gt;mongoc_bulk_operation_set_client&lt;/li&gt;
	&lt;li&gt;mongoc_bulk_operation_set_collection&lt;/li&gt;
	&lt;li&gt;mongoc_bulk_operation_set_database&lt;/li&gt;
	&lt;li&gt;mongoc_bulk_operation_set_write_concern&lt;/li&gt;
	&lt;li&gt;mongoc_bulk_operation_update_many_with_opts&lt;/li&gt;
	&lt;li&gt;mongoc_bulk_operation_update_one_with_opts&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;At least &lt;tt&gt;mongoc_bulk_operation_new&lt;/tt&gt; is undocumented and you can cross reference the rest from that list.&lt;/p&gt;

&lt;p&gt;If you want to check other symbols outside bulk, the &lt;a href=&quot;https://github.com/mongodb/mongo-cxx-driver/blob/master/src/mongocxx/private/libmongoc_symbols.hh&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;list of symbols&lt;/a&gt; is in the repo.  (Just mentally append &quot;mongoc_&quot; to them.)&lt;/p&gt;</comment>
                            <comment id="1439236" author="bjori" created="Mon, 21 Nov 2016 17:54:26 +0000"  >&lt;p&gt;Crap! All of those functions should definitely be documented, sorry!&lt;br/&gt;
I recently filed a ticket for all (that I saw) exported libbson functions that didn&apos;t have docs yet, but didn&apos;t check mongoc the time: &lt;a href=&quot;https://jira.mongodb.org/browse/CDRIVER-1497&quot; class=&quot;external-link&quot; rel=&quot;nofollow&quot;&gt;https://jira.mongodb.org/browse/CDRIVER-1497&lt;/a&gt;&lt;br/&gt;
Could you please tell us which exact functions you noticed are undocumented and we should prioritize?&lt;br/&gt;
It would help us focus on needed areas that need improvements.&lt;/p&gt;</comment>
                    </comments>
                <issuelinks>
                            <issuelinktype id="10012">
                    <name>Related</name>
                                            <outwardlinks description="related to">
                                        <issuelink>
            <issuekey id="343480">CDRIVER-1984</issuekey>
        </issuelink>
                            </outwardlinks>
                                                        </issuelinktype>
                    </issuelinks>
                <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_12550" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>2|hrb0mv:</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>
                                                                                                                                                                                                                                                                    <customfield id="customfield_10557" key="com.pyxis.greenhopper.jira:gh-sprint">
                        <customfieldname>Sprint</customfieldname>
                        <customfieldvalues>
                                <customfieldvalue id="1558">C Driver 2017 2 - Feb 10, 2018</customfieldvalue>
    <customfieldvalue id="1602">C Driver 2017 2 - Feb 10, 2019</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            </customfields>
    </item>
</channel>
</rss>