<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Thu Feb 08 05:06:39 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>[SERVER-44680] Improve build system help text</title>
                <link>https://jira.mongodb.org/browse/SERVER-44680</link>
                <project id="10000" key="SERVER">Core Server</project>
                    <description>&lt;p&gt;The help text for many of the scons flags is confusing. The help text for &lt;tt&gt;--use-system-mongo-c&lt;/tt&gt; at least seems straightforward:&lt;/p&gt;

&lt;p&gt;&lt;tt&gt;--use-system-mongo-c=&lt;span class=&quot;error&quot;&gt;&amp;#91;on|off|auto&amp;#93;&lt;/span&gt;&lt;/tt&gt;&lt;/p&gt;

&lt;p&gt;I&apos;m clearly meant to write either &lt;tt&gt;&amp;#45;&amp;#45;use-system-mongo-c=on&lt;/tt&gt; or &lt;tt&gt;&amp;#45;&amp;#45;use-system-mongo-c=off&lt;/tt&gt; or &lt;tt&gt;&amp;#45;&amp;#45;use-system-mongo-c=auto&lt;/tt&gt;. Simple enough. But the help text for &lt;tt&gt;&amp;#45;&amp;#45;use-system-icu&lt;/tt&gt; is baffling:&lt;/p&gt;

&lt;p&gt;&lt;tt&gt;&amp;#45;&amp;#45;use-system-icu=USE-SYSTEM-ICU&lt;/tt&gt;&lt;/p&gt;

&lt;p&gt;Is this telling me to write literally &lt;tt&gt;&amp;#45;&amp;#45;use-system-icu=USE-SYSTEM-ICU&lt;/tt&gt;? Or am I supposed to use just &lt;tt&gt;&amp;#45;&amp;#45;use-system-icu&lt;/tt&gt;? Or am I meant to infer that &lt;tt&gt;USE-SYSTEM-ICU&lt;/tt&gt; should be replaced with &lt;tt&gt;on&lt;/tt&gt;, &lt;tt&gt;off&lt;/tt&gt;, or &lt;tt&gt;auto&lt;/tt&gt;?&lt;/p&gt;

&lt;p&gt;I can probably experiment to figure out what I need to use, but it would be better if the help text were clearer.&lt;/p&gt;</description>
                <environment></environment>
        <key id="1007150">SERVER-44680</key>
            <summary>Improve build system help text</summary>
                <type id="1" iconUrl="https://jira.mongodb.org/secure/viewavatar?size=xsmall&amp;avatarId=14703&amp;avatarType=issuetype">Bug</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="4">Incomplete</resolution>
                                        <assignee username="andrew.morrow@mongodb.com">Andrew Morrow</assignee>
                                    <reporter username="ryandesign">Ryan Schmidt</reporter>
                        <labels>
                    </labels>
                <created>Sat, 16 Nov 2019 14:03:51 +0000</created>
                <updated>Wed, 20 Nov 2019 22:06:10 +0000</updated>
                            <resolved>Wed, 20 Nov 2019 22:06:10 +0000</resolved>
                                    <version>4.2.1</version>
                                                    <component>Build</component>
                                        <votes>0</votes>
                                    <watches>3</watches>
                                                                                                                <comments>
                            <comment id="2555570" author="acm" created="Wed, 20 Nov 2019 22:05:53 +0000"  >&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=ryandesign&quot; class=&quot;user-hover&quot; rel=&quot;ryandesign&quot;&gt;ryandesign&lt;/a&gt; - I don&apos;t think there is a way to fix this, unfortunately. It is an issue with &lt;tt&gt;optparse&lt;/tt&gt;, and that is built into SCons, not something we can change. I&apos;m going to close the ticket as &quot;Won&apos;t Fix&quot;, and hopefully future versions of SCons will behave better.&lt;/p&gt;</comment>
                            <comment id="2549445" author="acm" created="Tue, 19 Nov 2019 17:12:35 +0000"  >&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=ryandesign&quot; class=&quot;user-hover&quot; rel=&quot;ryandesign&quot;&gt;ryandesign&lt;/a&gt; - This appears to be an artifact of the fact that SCons uses the python &lt;tt&gt;optparse&lt;/tt&gt; package internally. The &lt;tt&gt;optparse&lt;/tt&gt; package allows one to set a &quot;metavar&quot; when declaring an option. If the metavar is set, it will be placed after an &lt;tt&gt;=&lt;/tt&gt; on the help text for the option. If not set, the default value for &lt;tt&gt;metavar&lt;/tt&gt; is the upper-case name of the option. This can make some sense for options that take arguments, like &lt;tt&gt;&amp;#45;&amp;#45;build-dir&lt;/tt&gt;. However, for flag like options like the various &lt;tt&gt;&amp;#45;&amp;#45;use-system-x&lt;/tt&gt; things, it doesn&apos;t make much sense. Oddly, there doesn&apos;t seem to be any way to disable this behavior of adding some metavar. I&apos;ve experimented with explicitly setting &lt;tt&gt;nargs=0&lt;/tt&gt;, and setting &lt;tt&gt;metavar=None&lt;/tt&gt;. But so far, I can&apos;t find a way to convince &lt;tt&gt;optparse&lt;/tt&gt; to stop producing this annoying text. And setting the `metavar` to something other than the default (which is the upper-case&apos;d name of the flag) doesn&apos;t really improve the situation, because options that don&apos;t take arguments would still display as &lt;tt&gt;&amp;#45;&amp;#45;some-option=SOME-METAVAR&lt;/tt&gt;. I&apos;ve checked in with the SCons developers to see if they can think of a way around it. Unfortunately, it may just be something we can&apos;t really control. &lt;/p&gt;

&lt;p&gt;CC &lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=mathew.robinson&quot; class=&quot;user-hover&quot; rel=&quot;mathew.robinson&quot;&gt;mathew.robinson&lt;/a&gt; in case he has any thoughts.&lt;/p&gt;</comment>
                            <comment id="2545469" author="acm" created="Sun, 17 Nov 2019 23:06:33 +0000"  >&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=ryandesign&quot; class=&quot;user-hover&quot; rel=&quot;ryandesign&quot;&gt;ryandesign&lt;/a&gt; - This is either an issue with how we we are declaring these options, or with how SCons presents the help text for properly declared options. I suspect it is the former. &lt;/p&gt;</comment>
                            <comment id="2544581" author="ryandesign" created="Sat, 16 Nov 2019 14:17:30 +0000"  >&lt;p&gt;Sorry I messed up the formatting. It looked fine before I submitted it. The syntax for this editor is unusual. I also cannot find an Edit button for me to be able to try to fix it.&lt;/p&gt;</comment>
                    </comments>
                    <attachments>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                <customfield id="customfield_10050" key="com.atlassian.jira.toolkit:comments">
                        <customfieldname># Replies</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>4.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_18555" key="com.onresolve.jira.groovy.groovyrunner:scripted-field">
                        <customfieldname># of Sprints</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1.0</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    <customfield id="customfield_10055" key="com.atlassian.jira.ext.charting:firstresponsedate">
                        <customfieldname>Date of 1st Reply</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>Sun, 17 Nov 2019 23:06:33 +0000</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10052" key="com.atlassian.jira.toolkit:dayslastcommented">
                        <customfieldname>Days since reply</customfieldname>
                        <customfieldvalues>
                                        4 years, 12 weeks ago
    
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_18254" key="com.onresolve.jira.groovy.groovyrunner:scripted-field">
                        <customfieldname>Dependencies</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue><![CDATA[]]></customfieldvalue>


                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_15850" key="com.atlassian.jira.plugins.jira-development-integration-plugin:devsummary">
                        <customfieldname>Development</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    <customfield id="customfield_10057" key="com.atlassian.jira.toolkit:lastusercommented">
                        <customfieldname>Last comment by Customer</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>true</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                            <customfield id="customfield_10056" key="com.atlassian.jira.toolkit:lastupdaterorcommenter">
                        <customfieldname>Last commenter</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>andrew.morrow@mongodb.com</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_11151" key="com.atlassian.jira.toolkit:LastCommentDate">
                        <customfieldname>Last public comment date</customfieldname>
                        <customfieldvalues>
                            4 years, 12 weeks ago
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                    <customfield id="customfield_10032" key="com.atlassian.jira.plugin.system.customfieldtypes:select">
                        <customfieldname>Operating System</customfieldname>
                        <customfieldvalues>
                                <customfieldvalue key="10026"><![CDATA[ALL]]></customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                <customfield id="customfield_10051" key="com.atlassian.jira.toolkit:participants">
                        <customfieldname>Participants</customfieldname>
                        <customfieldvalues>
                                        <customfieldvalue>andrew.morrow@mongodb.com</customfieldvalue>
            <customfieldvalue>ryandesign</customfieldvalue>
    
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                        <customfield id="customfield_14254" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Product Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1|hw3i47:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                <customfield id="customfield_12550" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>2|hvoegn:</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_23361" key="com.onresolve.jira.groovy.groovyrunner:scripted-field">
                        <customfieldname>Requested By</customfieldname>
                        <customfieldvalues>
                                

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                        <customfield id="customfield_10557" key="com.pyxis.greenhopper.jira:gh-sprint">
                        <customfieldname>Sprint</customfieldname>
                        <customfieldvalues>
                                <customfieldvalue id="3442">Dev Platform 2019-12-02</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10053" key="com.atlassian.jira.ext.charting:timeinstatus">
                        <customfieldname>Time In Status</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_22870" key="com.onresolve.jira.groovy.groovyrunner:scripted-field">
                        <customfieldname>Triagers</customfieldname>
                        <customfieldvalues>
                                

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                    <customfield id="customfield_14350" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>serverRank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1|hw34dj:</customfieldvalue>

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