<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Wed Feb 07 21:14:34 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-2227] &quot;Commands with opts&quot; tutorial</title>
                <link>https://jira.mongodb.org/browse/CDRIVER-2227</link>
                <project id="10030" key="CDRIVER">C Driver</project>
                    <description>&lt;p&gt;All the &quot;command_with_opts&quot; functions say:&lt;/p&gt;

&lt;p/&gt;
&lt;div id=&quot;syntaxplugin&quot; class=&quot;syntaxplugin&quot; style=&quot;border: 1px dashed #bbb; border-radius: 5px !important; overflow: auto; max-height: 30em;&quot;&gt;
&lt;table cellspacing=&quot;0&quot; cellpadding=&quot;0&quot; border=&quot;0&quot; width=&quot;100%&quot; style=&quot;font-size: 1em; line-height: 1.4em !important; font-weight: normal; font-style: normal; color: black;&quot;&gt;
		&lt;tbody &gt;
				&lt;tr id=&quot;syntaxplugin_code_and_gutter&quot;&gt;
						&lt;td  style=&quot; line-height: 1.4em !important; padding: 0em; vertical-align: top;&quot;&gt;
					&lt;pre style=&quot;font-size: 1em; margin: 0 10px;  margin-top: 10px;   margin-bottom: 10px;  width: auto; padding: 0;&quot;&gt;&lt;span style=&quot;color: black; font-family: &apos;Consolas&apos;, &apos;Bitstream Vera Sans Mono&apos;, &apos;Courier New&apos;, Courier, monospace !important;&quot;&gt;See :symbol:`mongoc_client_read_command_with_opts` for example usage.&lt;/span&gt;&lt;/pre&gt;
			&lt;/td&gt;
		&lt;/tr&gt;
			&lt;/tbody&gt;
&lt;/table&gt;
&lt;/div&gt;
&lt;p/&gt;

&lt;p&gt;It would be nice if that example was moved into a slightly more thorough &quot;commands with opts&quot; tutorial, that included a table of what &quot;read&quot;, &quot;write&quot;, and &quot;read_write&quot; mean for read preference and read/write concern, also discuss collation, and also include that example code. Link there from all the &quot;opts&quot; parameter lines in the &quot;command_with_opts&quot; pages.&lt;/p&gt;</description>
                <environment></environment>
        <key id="411060">CDRIVER-2227</key>
            <summary>&quot;Commands with opts&quot; tutorial</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="13201">Fixed</resolution>
                                        <assignee username="jesse@mongodb.com">A. Jesse Jiryu Davis</assignee>
                                    <reporter username="jesse@mongodb.com">A. Jesse Jiryu Davis</reporter>
                        <labels>
                    </labels>
                <created>Tue, 1 Aug 2017 16:01:12 +0000</created>
                <updated>Sat, 28 Oct 2023 11:30:33 +0000</updated>
                            <resolved>Tue, 14 Nov 2017 15:43:59 +0000</resolved>
                                                    <fixVersion>1.9.0</fixVersion>
                                    <component>docs</component>
                    <component>libmongoc</component>
                                        <votes>0</votes>
                                    <watches>2</watches>
                                                                                                                <comments>
                            <comment id="1725208" author="jesse" created="Tue, 14 Nov 2017 15:43:51 +0000"  >&lt;p&gt;Good catch &lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=kevin.albertson&quot; class=&quot;user-hover&quot; rel=&quot;kevin.albertson&quot;&gt;kevin.albertson&lt;/a&gt;, the C Driver hasn&apos;t used aggregate&apos;s batchSize for getMore commands in quite some time, if ever: &lt;a href=&quot;https://jira.mongodb.org/browse/CDRIVER-2371&quot; title=&quot;mongoc_collection_aggregate only uses batchSize for first batch&quot; class=&quot;issue-link&quot; data-issue-key=&quot;CDRIVER-2371&quot;&gt;&lt;del&gt;CDRIVER-2371&lt;/del&gt;&lt;/a&gt;.&lt;/p&gt;</comment>
                            <comment id="1725091" author="xgen-internal-githook" created="Tue, 14 Nov 2017 14:15:49 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{&apos;name&apos;: &apos;A. Jesse Jiryu Davis&apos;, &apos;username&apos;: &apos;ajdavis&apos;, &apos;email&apos;: &apos;jesse@mongodb.com&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/CDRIVER-2227&quot; title=&quot;&amp;quot;Commands with opts&amp;quot; tutorial&quot; class=&quot;issue-link&quot; data-issue-key=&quot;CDRIVER-2227&quot;&gt;&lt;del&gt;CDRIVER-2227&lt;/del&gt;&lt;/a&gt; document &quot;opts&quot; fields&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/mongo-c-driver/commit/3085ff26d79dd78f894d9e7834ea163dce024eb6&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/mongo-c-driver/commit/3085ff26d79dd78f894d9e7834ea163dce024eb6&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="1679901" author="kevin.albertson" created="Fri, 22 Sep 2017 19:03:56 +0000"  >&lt;p&gt;Also confusing is the options on &lt;a href=&quot;http://mongoc.org/libmongoc/current/mongoc_collection_aggregate.html&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;mongoc_collection_aggregate&lt;/a&gt;. Passing a batchSize in the opts will only set the batch size in the initial aggregate command, &lt;b&gt;not&lt;/b&gt; the subsequent getMore&apos;s. This seems to be intentional from the code, since there is a check in mongoc_collection_aggregate.c which will explicitly exclude copying over the batch size to the cursor options.  We should keep this ticket open until we (1) figure out if that is the expected behavior and (2) document this and the other options.&lt;/p&gt;</comment>
                    </comments>
                <issuelinks>
                            <issuelinktype id="10012">
                    <name>Related</name>
                                            <outwardlinks description="related to">
                                        <issuelink>
            <issuekey id="464262">CDRIVER-2408</issuekey>
        </issuelink>
            <issuelink>
            <issuekey id="464280">CDRIVER-2409</issuekey>
        </issuelink>
            <issuelink>
            <issuekey id="404882">CDRIVER-2213</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|ht3vbz:</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>