<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Wed Feb 07 21:13:35 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-1912] Document configuration options in installation docs</title>
                <link>https://jira.mongodb.org/browse/CDRIVER-1912</link>
                <project id="10030" key="CDRIVER">C Driver</project>
                    <description>&lt;p&gt;We should list, and document, each configuration option of libbson and mongoc. Both standard configure options and our custom ones.&lt;/p&gt;

&lt;p&gt;&amp;#8211;&lt;/p&gt;

&lt;p&gt;libbson&apos;s README.md has info on config options like `--enable-static`.  libmongoc&apos;s README does not, nor does the mongoc docs site.&lt;/p&gt;

&lt;p&gt;I think it would help users to mention that and other common autolib/configure options in an easy-to-find location.&lt;/p&gt;</description>
                <environment></environment>
        <key id="330777">CDRIVER-1912</key>
            <summary>Document configuration options in installation docs</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="jesse@mongodb.com">A. Jesse Jiryu Davis</assignee>
                                    <reporter username="david.golden@mongodb.com">David Golden</reporter>
                        <labels>
                    </labels>
                <created>Wed, 9 Nov 2016 17:49:44 +0000</created>
                <updated>Sat, 28 Jan 2017 13:05:48 +0000</updated>
                            <resolved>Fri, 27 Jan 2017 03:18:59 +0000</resolved>
                                                    <fixVersion>1.6.0</fixVersion>
                                    <component>docs</component>
                                        <votes>0</votes>
                                    <watches>1</watches>
                                                                                                                <comments>
                            <comment id="1487485" author="xgen-internal-githook" created="Sat, 28 Jan 2017 13:05:48 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{u&apos;username&apos;: u&apos;ajdavis&apos;, u&apos;name&apos;: u&apos;A. Jesse Jiryu Davis&apos;, u&apos;email&apos;: u&apos;jesse@mongodb.com&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/CDRIVER-1912&quot; title=&quot;Document configuration options in installation docs&quot; class=&quot;issue-link&quot; data-issue-key=&quot;CDRIVER-1912&quot;&gt;&lt;del&gt;CDRIVER-1912&lt;/del&gt;&lt;/a&gt; update installation instructions&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/mongo-c-driver/commit/bbd15c11c68b1d5b7a0ae7691bbea3c04b63f73b&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/mongo-c-driver/commit/bbd15c11c68b1d5b7a0ae7691bbea3c04b63f73b&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="1485293" author="xgen-internal-githook" created="Wed, 25 Jan 2017 20:07:41 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{u&apos;username&apos;: u&apos;ajdavis&apos;, u&apos;name&apos;: u&apos;A. Jesse Jiryu Davis&apos;, u&apos;email&apos;: u&apos;jesse@mongodb.com&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/CDRIVER-1912&quot; title=&quot;Document configuration options in installation docs&quot; class=&quot;issue-link&quot; data-issue-key=&quot;CDRIVER-1912&quot;&gt;&lt;del&gt;CDRIVER-1912&lt;/del&gt;&lt;/a&gt; update installation instructions&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/libbson/commit/5f574edde7052c89a1927adaada1600655304343&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/libbson/commit/5f574edde7052c89a1927adaada1600655304343&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="1476852" author="david.golden" created="Sat, 14 Jan 2017 04:30:49 +0000"  >&lt;p&gt;Counterexample from &lt;tt&gt;configure --help&lt;/tt&gt;:&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;   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;--enable-rdtscp=[no/yes]&lt;/span&gt;&lt;/pre&gt;
			&lt;/td&gt;
		&lt;/tr&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-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;                        Use rdtscp for per-cpu counters [default=no]&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;What is this for?  When would I want to use it?  When should I avoid it?&lt;/p&gt;

&lt;p&gt;Ditto stuff like the shm_counters.  The mongocxx evergreen config disables them.  The Travis config does not.  Why?&lt;/p&gt;

&lt;p&gt;It&apos;s your call, but I wouldn&apos;t have opened this if we weren&apos;t wondering why the config options are different in different CI systems, etc.&lt;/p&gt;</comment>
                            <comment id="1476851" author="jesse" created="Sat, 14 Jan 2017 03:58:04 +0000"  >&lt;p&gt;I propose &lt;b&gt;not&lt;/b&gt; doing this, since ./configure --help correctly documents both the standard options and our custom options, for libbson and libmongoc. I don&apos;t see any value in copying a description of each standard option into our HTML docs, particularly since they&apos;ll vary according to what version of the Autotools you have installed. It&apos;s their job, not ours, to document these.&lt;/p&gt;

&lt;p&gt;I do see the value in documenting our projects&apos; custom options in HTML. But there is also a cost: We must remember to update the HTML when we update the Autotools configuration, and inevitably we&apos;ll forget. I think this cost outweighs the value.&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_12550" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>2|hrboiv:</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>

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