<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Thu Feb 08 09:00:30 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>[JAVA-3817] Filters.regex() Javadocs reference &quot;options&quot; even for overloads without them</title>
                <link>https://jira.mongodb.org/browse/JAVA-3817</link>
                <project id="10006" key="JAVA">Java Driver</project>
                    <description>&lt;p&gt;There are three different overloads of &lt;tt&gt;com.mongodb.client.model.Filters.regex()&lt;/tt&gt;:&lt;/p&gt;
&lt;ul&gt;
	&lt;li&gt;&lt;a href=&quot;http://mongodb.github.io/mongo-java-driver/4.1/apidocs/mongodb-driver-core/com/mongodb/client/model/Filters.html#regex(java.lang.String,java.lang.String)&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;regex&#8203;(String fieldName, String pattern)&lt;/a&gt;&lt;/li&gt;
	&lt;li&gt;&lt;a href=&quot;http://mongodb.github.io/mongo-java-driver/4.1/apidocs/mongodb-driver-core/com/mongodb/client/model/Filters.html#regex(java.lang.String,java.lang.String,java.lang.String)&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;regex&#8203;(String fieldName, String pattern, String options)&lt;/a&gt;&lt;/li&gt;
	&lt;li&gt;&lt;a href=&quot;http://mongodb.github.io/mongo-java-driver/4.1/apidocs/mongodb-driver-core/com/mongodb/client/model/Filters.html#regex(java.lang.String,java.util.regex.Pattern)&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;regex&#8203;(String fieldName, Pattern pattern)&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;&#160;All three of these overloads have the same Javadoc text:&lt;/p&gt;

&lt;p&gt;&lt;cite&gt;Creates a filter that matches all documents where the value of the field matches the given regular expression pattern with the given options applied.&lt;/cite&gt;&lt;/p&gt;

&lt;p&gt;&#160;However, only one of these methods actually takes in options.&#160; The &lt;tt&gt;(String, String)&lt;/tt&gt; variation corresponds to no options, and the &lt;tt&gt;(String, Pattern)&lt;/tt&gt; variation presumably uses the compiled &lt;tt&gt;Pattern&lt;/tt&gt;&apos;s &lt;a href=&quot;https://docs.oracle.com/javase/7/docs/api/java/util/regex/Pattern.html#flags()&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;match flags&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;I would expect the two overloads that lack an &quot;options&quot; argument to either not mention it, or to specify how it actually affects the options rather than reference nonexistent &quot;given options&quot;.&lt;/p&gt;</description>
                <environment></environment>
        <key id="1444598">JAVA-3817</key>
            <summary>Filters.regex() Javadocs reference &quot;options&quot; even for overloads without them</summary>
                <type id="4" iconUrl="https://jira.mongodb.org/secure/viewavatar?size=xsmall&amp;avatarId=14710&amp;avatarType=issuetype">Improvement</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="13201">Fixed</resolution>
                                        <assignee username="brian.deleonardis@mongodb.com">Brian DeLeonardis</assignee>
                                    <reporter username="matthew.j.justin@gmail.com">Matthew Justin</reporter>
                        <labels>
                    </labels>
                <created>Mon, 17 Aug 2020 21:03:28 +0000</created>
                <updated>Sat, 28 Oct 2023 11:21:35 +0000</updated>
                            <resolved>Tue, 1 Sep 2020 14:22:53 +0000</resolved>
                                    <version>4.1.0</version>
                                    <fixVersion>4.2.0</fixVersion>
                                    <component>Documentation</component>
                                        <votes>0</votes>
                                    <watches>1</watches>
                                                                                                                <comments>
                            <comment id="3370002" author="xgen-internal-githook" created="Tue, 1 Sep 2020 14:21:35 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{&apos;name&apos;: &apos;Brian DeLeonardis&apos;, &apos;email&apos;: &apos;bdeleonardis1@gmail.com&apos;, &apos;username&apos;: &apos;bdeleonardis1&apos;}
&lt;p&gt;Message: Fix Filters.regex Javadoc&lt;/p&gt;

&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/browse/JAVA-3817&quot; title=&quot;Filters.regex() Javadocs reference &amp;quot;options&amp;quot; even for overloads without them&quot; class=&quot;issue-link&quot; data-issue-key=&quot;JAVA-3817&quot;&gt;&lt;del&gt;JAVA-3817&lt;/del&gt;&lt;/a&gt;&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/mongo-java-driver/commit/7eb10ad08102f894e9066546879503710b7817d5&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/mongo-java-driver/commit/7eb10ad08102f894e9066546879503710b7817d5&lt;/a&gt;&lt;/p&gt;</comment>
                    </comments>
                    <attachments>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                                                                                                                                                                                        <customfield id="customfield_10011" key="com.atlassian.jira.plugin.system.customfieldtypes:radiobuttons">
                        <customfieldname>Backwards Compatibility</customfieldname>
                        <customfieldvalues>
                                <customfieldvalue key="10038"><![CDATA[Fully Compatible]]></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_12550" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>2|hxlwj3:</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>