<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Wed Feb 07 21:59:20 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>[CXX-482] Please make docs for C, C++ drivers match docs for Java driver</title>
                <link>https://jira.mongodb.org/browse/CXX-482</link>
                <project id="11980" key="CXX">C++ Driver</project>
                    <description>&lt;p&gt;I wanted to write MongoDB benchmark clients in C++ to avoid problems from Java GC stalls and to re-learn modern C++. &lt;/p&gt;

&lt;p&gt;For the C driver the API section documents types but not functions.&lt;br/&gt;
&lt;a href=&quot;http://api.mongodb.org/c/current/?_ga=1.108812482.1512114027.1402327973&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;http://api.mongodb.org/c/current/?_ga=1.108812482.1512114027.1402327973&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;For the C++ driver I get confused.&lt;/p&gt;
&lt;ul&gt;
	&lt;li&gt;there is the &quot;legacy&quot; driver and the &quot;26compat&quot; driver but sometimes the 26compat driver is described as the legacy-26compat driver. And the name &quot;26compat&quot; makes me think there isn&apos;t a version for use with 2.8&lt;/li&gt;
	&lt;li&gt;the API page doesn&apos;t have anything for 26compat &amp;#8211; &lt;a href=&quot;http://api.mongodb.org/cxx/?_ga=1.82181590.1512114027.1402327973&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;http://api.mongodb.org/cxx/?_ga=1.82181590.1512114027.1402327973&lt;/a&gt;&lt;/li&gt;
	&lt;li&gt;the wiki page could use more sections for 26compat (testing)&lt;/li&gt;
&lt;/ul&gt;
</description>
                <environment></environment>
        <key id="179915">CXX-482</key>
            <summary>Please make docs for C, C++ drivers match docs for Java driver</summary>
                <type id="4" iconUrl="https://jira.mongodb.org/secure/viewavatar?size=xsmall&amp;avatarId=14710&amp;avatarType=issuetype">Improvement</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="andrew.morrow@mongodb.com">Andrew Morrow</assignee>
                                    <reporter username="mdcallag">Mark Callaghan</reporter>
                        <labels>
                            <label>legacy-cxx</label>
                    </labels>
                <created>Wed, 21 Jan 2015 15:26:57 +0000</created>
                <updated>Fri, 23 Jan 2015 23:26:50 +0000</updated>
                            <resolved>Fri, 23 Jan 2015 23:26:47 +0000</resolved>
                                                    <fixVersion>legacy-1.0.0-rc4</fixVersion>
                                                        <votes>0</votes>
                                    <watches>5</watches>
                                                                                                                <comments>
                            <comment id="811048" author="acm" created="Thu, 22 Jan 2015 20:49:32 +0000"  >&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=mdcallag&quot; class=&quot;user-hover&quot; rel=&quot;mdcallag&quot;&gt;mdcallag&lt;/a&gt; FYI I&apos;ve added some notes to the testing wiki page explaining the differences on the 26compat branch. See the linked wiki diff in &lt;a href=&quot;https://jira.mongodb.org/browse/CXX-485&quot; title=&quot;Update testing wiki page&quot; class=&quot;issue-link&quot; data-issue-key=&quot;CXX-485&quot;&gt;&lt;del&gt;CXX-485&lt;/del&gt;&lt;/a&gt; for changes.&lt;/p&gt;</comment>
                            <comment id="810194" author="acm" created="Thu, 22 Jan 2015 00:48:35 +0000"  >&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=mdcallag&quot; class=&quot;user-hover&quot; rel=&quot;mdcallag&quot;&gt;mdcallag&lt;/a&gt; Since I&apos;ve filed other tickets for the issues with the C++ Driver 26compat docs (&lt;a href=&quot;https://jira.mongodb.org/browse/CXX-484&quot; title=&quot;Generate documentation for 26compat releases&quot; class=&quot;issue-link&quot; data-issue-key=&quot;CXX-484&quot;&gt;&lt;del&gt;CXX-484&lt;/del&gt;&lt;/a&gt;) and the outdated wiki (&lt;a href=&quot;https://jira.mongodb.org/browse/CXX-485&quot; title=&quot;Update testing wiki page&quot; class=&quot;issue-link&quot; data-issue-key=&quot;CXX-485&quot;&gt;&lt;del&gt;CXX-485&lt;/del&gt;&lt;/a&gt;), I&apos;m going to close this ticket tomorrow, unless you have a specific reason you would like it kept open, in which case please just let me know.&lt;/p&gt;

&lt;p&gt;Thanks,&lt;br/&gt;
Andrew&lt;/p&gt;</comment>
                            <comment id="810152" author="mdcallag" created="Wed, 21 Jan 2015 23:58:39 +0000"  >&lt;p&gt;Thanks for the prompt responses. I see now that the C API has lots of documentation once I click on the types.&lt;/p&gt;</comment>
                            <comment id="810121" author="acm" created="Wed, 21 Jan 2015 23:27:13 +0000"  >&lt;p&gt;Hi &lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=mdcallag&quot; class=&quot;user-hover&quot; rel=&quot;mdcallag&quot;&gt;mdcallag&lt;/a&gt; -&lt;/p&gt;

&lt;p&gt;A few comments in addition to what Tyler wrote above:&lt;/p&gt;

&lt;ul class=&quot;alternate&quot; type=&quot;square&quot;&gt;
	&lt;li&gt;As Tyler mentioned, the C driver documentation organizes the functions by the principle type on which the functions operate.&lt;/li&gt;
	&lt;li&gt;I agree the documentation for the 26compat stream is not ideal. I&apos;ve filed a ticket to generate separate documentation, not pointing into the outdated server docs, for the next 26compat point release. Watch &lt;a href=&quot;https://jira.mongodb.org/browse/CXX-484&quot; title=&quot;Generate documentation for 26compat releases&quot; class=&quot;issue-link&quot; data-issue-key=&quot;CXX-484&quot;&gt;&lt;del&gt;CXX-484&lt;/del&gt;&lt;/a&gt;, and when that closes the relevant docs should be available along side the documentation for the legacy release stream. In the meantime, the following link should reflect the contents of 26compat very closely: &lt;a href=&quot;http://api.mongodb.org/cplusplus/2.6.1/&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;http://api.mongodb.org/cplusplus/2.6.1/&lt;/a&gt;&lt;/li&gt;
	&lt;li&gt;I&apos;ve filed &lt;a href=&quot;https://jira.mongodb.org/browse/CXX-485&quot; title=&quot;Update testing wiki page&quot; class=&quot;issue-link&quot; data-issue-key=&quot;CXX-485&quot;&gt;&lt;del&gt;CXX-485&lt;/del&gt;&lt;/a&gt; to improve the wiki page re testing. That page is out of date with respect to both the 26compat branch and the legacy branch, so clearly could use some attention.&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;In the meantime, if you have specific questions that the documentation is not answering, the C and C++ developers monitor mongodb-user and mongodb-dev closely and will be happy to answer any questions there.&lt;/p&gt;

&lt;p&gt;Thanks,&lt;br/&gt;
Andrew&lt;/p&gt;
</comment>
                            <comment id="809923" author="michael.paik" created="Wed, 21 Jan 2015 20:59:48 +0000"  >&lt;p&gt;To be clear, this isn&apos;t actually from me - this is a DOCS ticket that I moved to Drivers that Bernie then moved to C++. I&apos;ve got no skin in the game.&lt;/p&gt;</comment>
                            <comment id="809917" author="tyler@10gen.com" created="Wed, 21 Jan 2015 20:57:22 +0000"  >&lt;p&gt;Hey Michael,&lt;/p&gt;

&lt;p&gt;That seems like a worthwhile goal. Thanks for being interested.&lt;/p&gt;

&lt;p&gt;This project is for the C++ drivers only. Any questions about the C driver should be filed as within the CDRIVER project. I would file a ticket there myself for your issue but I&apos;m not sure I understand what you mean by &quot;the C driver api section documents types but not functions&quot;. The existing documentation does, in fact, document functions but they are documented within the section for a specific type. For example, the &lt;a href=&quot;http://api.mongodb.org/c/current/mongoc_collection_t.html&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;documentation for mongoc_collection_t&lt;/a&gt; includes documentation for mongoc_collection_insert which operates on a mongoc_collection_t.&lt;/p&gt;

&lt;p&gt;The C++ driver is confusing. There are 3 of them, one which is called 26compat, another called legacy, and the future one which will just be called &quot;The C&amp;#43;&amp;#43;(11) driver&quot;. The 26compat driver is meant to be 2.6compat-ible and was extracted directly from the MongoDB 2.6 source tree. The legacy driver has various enhancements  to that code while maintaining the overall API and cruft of the existing driver and the new C++11 driver is brand new and being written from scratch.&lt;/p&gt;

&lt;p&gt;We are encouraging users to use the legacy driver now and the C++11 driver when it is released (hence the name legacy for the existing one).&lt;/p&gt;

&lt;p&gt;The API page does document the 26compat driver as &lt;a href=&quot;http://api.mongodb.org/cplusplus/&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;C++(Server) &amp;#8211; Deprecated&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;We probably won&apos;t update the wiki page for 26compat as we don&apos;t want people to actually use it outside of requiring a drop in replacement for code written against the client that existed in the server circa MongoDB 2.6.&lt;/p&gt;</comment>
                    </comments>
                <issuelinks>
                            <issuelinktype id="10010">
                    <name>Duplicate</name>
                                                                <inwardlinks description="is duplicated by">
                                        <issuelink>
            <issuekey id="180052">CXX-484</issuekey>
        </issuelink>
            <issuelink>
            <issuekey id="180054">CXX-485</issuekey>
        </issuelink>
                            </inwardlinks>
                                    </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|hs5mwf:</customfieldvalue>

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