Adjust malefirstName to align with its female counterpart, and java naming conventions - maleFirstName (#1519)

* datafaker-1518: added maleFirstName method and deprecated the ill-named malefirstName.
* datafaker-1518: added documentation for deprecation

---------

Co-authored-by: apollo-de <anonnymous@anonymous.com>

Author: apollo-de

src/main/java/net/datafaker/providers/base/Name.java

@@ -72,10 +72,21 @@ public String femaleFirstName() {
 
     /**
      * Returns a random male 'given' name.
+     * @deprecated Use {@link #maleFirstName()} instead.
      *
      * @return a male 'given' name
      */
+    @Deprecated(since = "2.4.3", forRemoval = true)
     public String malefirstName() {
+        return maleFirstName();
+    }
+
+    /**
+     * Returns a random male 'given' name.
+     *
+     * @return a male 'given' name
+     */
+    public String maleFirstName() {
         return resolve("name.male_first_name");
     }
 

src/test/java/net/datafaker/providers/base/NameTest.java

@@ -64,7 +64,7 @@ void testFemaleFirstName() {
 
     @RepeatedTest(10)
     void testMaleFirstName() {
-        assertThat(name.malefirstName()).matches("\\w+");
+        assertThat(name.maleFirstName()).matches("\\w+");
     }
 
     @Test
@@ -131,7 +131,7 @@ void testFemaleFirstName() {
 
         @RepeatedTest(10)
         void testMaleFirstName() {
-            assertThat(name.malefirstName()).matches("\\p{L}+");
+            assertThat(name.maleFirstName()).matches("\\p{L}+");
         }
 
         @Test