Index: trunk/phase3/maintenance/Doxyfile |
— | — | @@ -16,7 +16,7 @@ |
17 | 17 | PROJECT_NAME = MediaWiki |
18 | 18 | PROJECT_NUMBER = {{CURRENT_VERSION}} |
19 | 19 | OUTPUT_DIRECTORY = {{OUTPUT_DIRECTORY}} |
20 | | -CREATE_SUBDIRS = NO |
| 20 | +CREATE_SUBDIRS = YES |
21 | 21 | OUTPUT_LANGUAGE = English |
22 | 22 | BRIEF_MEMBER_DESC = YES |
23 | 23 | REPEAT_BRIEF = YES |
— | — | @@ -175,7 +175,7 @@ |
176 | 176 | HHC_LOCATION = |
177 | 177 | GENERATE_CHI = NO |
178 | 178 | BINARY_TOC = NO |
179 | | -TOC_EXPAND = NO |
| 179 | +TOC_EXPAND = YES |
180 | 180 | DISABLE_INDEX = NO |
181 | 181 | ENUM_VALUES_PER_LINE = 4 |
182 | 182 | GENERATE_TREEVIEW = YES |
— | — | @@ -191,8 +191,8 @@ |
192 | 192 | PAPER_TYPE = a4wide |
193 | 193 | EXTRA_PACKAGES = |
194 | 194 | LATEX_HEADER = |
195 | | -PDF_HYPERLINKS = NO |
196 | | -USE_PDFLATEX = NO |
| 195 | +PDF_HYPERLINKS = YES |
| 196 | +USE_PDFLATEX = YES |
197 | 197 | LATEX_BATCHMODE = NO |
198 | 198 | LATEX_HIDE_INDICES = NO |
199 | 199 | #--------------------------------------------------------------------------- |
— | — | @@ -207,7 +207,7 @@ |
208 | 208 | #--------------------------------------------------------------------------- |
209 | 209 | # configuration options related to the man page output |
210 | 210 | #--------------------------------------------------------------------------- |
211 | | -GENERATE_MAN = YES |
| 211 | +GENERATE_MAN = NO |
212 | 212 | MAN_OUTPUT = man |
213 | 213 | MAN_EXTENSION = .3 |
214 | 214 | MAN_LINKS = NO |
Index: trunk/phase3/includes/User.php |
— | — | @@ -461,8 +461,13 @@ |
462 | 462 | * addresses like this, if we allowed accounts like this to be created |
463 | 463 | * new users could get the old edits of these anonymous users. |
464 | 464 | * |
| 465 | +<<<<<<< .mine |
| 466 | + * @param $name \type{\string} String to match |
| 467 | + * @return \type{\bool} True or false |
| 468 | +======= |
465 | 469 | * @param $name \type{\string} |
466 | 470 | * @return \type{\bool} |
| 471 | +>>>>>>> .r38752 |
467 | 472 | */ |
468 | 473 | static function isIP( $name ) { |
469 | 474 | return preg_match('/^\d{1,3}\.\d{1,3}\.\d{1,3}\.(?:xxx|\d{1,3})$/',$name) || IP::isIPv6($name); |
— | — | @@ -476,8 +481,13 @@ |
477 | 482 | * is longer than the maximum allowed username size or doesn't begin with |
478 | 483 | * a capital letter. |
479 | 484 | * |
| 485 | +<<<<<<< .mine |
| 486 | + * @param $name \type{\string} String to match |
| 487 | + * @return \type{\bool} True or false |
| 488 | +======= |
480 | 489 | * @param $name \type{\string} |
481 | 490 | * @return \type{\bool} |
| 491 | +>>>>>>> .r38752 |
482 | 492 | */ |
483 | 493 | static function isValidUserName( $name ) { |
484 | 494 | global $wgContLang, $wgMaxNameChars; |
— | — | @@ -530,8 +540,13 @@ |
531 | 541 | * If an account already exists in this form, login will be blocked |
532 | 542 | * by a failure to pass this function. |
533 | 543 | * |
| 544 | +<<<<<<< .mine |
| 545 | + * @param $name \type{\string} String to match |
| 546 | + * @return \type{\bool} True or false |
| 547 | +======= |
534 | 548 | * @param $name \type{\string} |
535 | 549 | * @return \type{\bool} |
| 550 | +>>>>>>> .r38752 |
536 | 551 | */ |
537 | 552 | static function isUsableName( $name ) { |
538 | 553 | global $wgReservedUsernames; |
— | — | @@ -562,8 +577,13 @@ |
563 | 578 | * rather than in isValidUserName() to avoid disrupting |
564 | 579 | * existing accounts. |
565 | 580 | * |
| 581 | +<<<<<<< .mine |
| 582 | + * @param $name \type{\string} String to match |
| 583 | + * @return \type{\bool} True or false |
| 584 | +======= |
566 | 585 | * @param $name \type{\string} |
567 | 586 | * @return \type{\bool} |
| 587 | +>>>>>>> .r38752 |
568 | 588 | */ |
569 | 589 | static function isCreatableName( $name ) { |
570 | 590 | return |
— | — | @@ -576,8 +596,13 @@ |
577 | 597 | /** |
578 | 598 | * Is the input a valid password for this user? |
579 | 599 | * |
| 600 | +<<<<<<< .mine |
580 | 601 | * @param $password \type{\string} Desired password |
| 602 | + * @return \type{\bool} True or false |
| 603 | +======= |
| 604 | + * @param $password \type{\string} Desired password |
581 | 605 | * @return \type{\bool} |
| 606 | +>>>>>>> .r38752 |
582 | 607 | */ |
583 | 608 | function isValidPassword( $password ) { |
584 | 609 | global $wgMinimalPasswordLength, $wgContLang; |
— | — | @@ -602,8 +627,13 @@ |
603 | 628 | * |
604 | 629 | * @todo Check for RFC 2822 compilance (bug 959) |
605 | 630 | * |
| 631 | +<<<<<<< .mine |
606 | 632 | * @param $addr \type{\string} E-mail address |
| 633 | + * @return \type{\bool} True or false |
| 634 | +======= |
| 635 | + * @param $addr \type{\string} E-mail address |
607 | 636 | * @return \type{\bool} |
| 637 | +>>>>>>> .r38752 |
608 | 638 | */ |
609 | 639 | public static function isValidEmailAddr( $addr ) { |
610 | 640 | $result = null; |
— | — | @@ -711,7 +741,11 @@ |
712 | 742 | * Return a random password. Sourced from mt_rand, so it's not particularly secure. |
713 | 743 | * @todo hash random numbers to improve security, like generateToken() |
714 | 744 | * |
| 745 | +<<<<<<< .mine |
| 746 | + * @return \type{\string} New random password |
| 747 | +======= |
715 | 748 | * @return \type{\string} |
| 749 | +>>>>>>> .r38752 |
716 | 750 | */ |
717 | 751 | static function randomPassword() { |
718 | 752 | global $wgMinimalPasswordLength; |
— | — | @@ -972,8 +1006,13 @@ |
973 | 1007 | /** |
974 | 1008 | * Get a given default option value. |
975 | 1009 | * |
| 1010 | +<<<<<<< .mine |
976 | 1011 | * @param $opt \type{\string} Name of option to retrieve |
| 1012 | + * @return \type{\string} Default option value |
| 1013 | +======= |
| 1014 | + * @param $opt \type{\string} Name of option to retrieve |
977 | 1015 | * @return \type{\string} |
| 1016 | +>>>>>>> .r38752 |
978 | 1017 | */ |
979 | 1018 | public static function getDefaultOption( $opt ) { |
980 | 1019 | $defOpts = self::getDefaultOptions(); |
— | — | @@ -986,7 +1025,7 @@ |
987 | 1026 | |
988 | 1027 | /** |
989 | 1028 | * Get a list of user toggle names |
990 | | - * @return \arrayof{\string} |
| 1029 | + * @return \arrayof{\string} Array of user toggle names |
991 | 1030 | */ |
992 | 1031 | static function getToggles() { |
993 | 1032 | global $wgContLang; |
— | — | @@ -1073,8 +1112,13 @@ |
1074 | 1113 | /** |
1075 | 1114 | * Whether the given IP is in the SORBS blacklist. |
1076 | 1115 | * |
| 1116 | +<<<<<<< .mine |
1077 | 1117 | * @param $ip \type{\string} IP to check |
| 1118 | + * @return \type{\bool} True if blacklisted |
| 1119 | +======= |
| 1120 | + * @param $ip \type{\string} IP to check |
1078 | 1121 | * @return \type{\bool} |
| 1122 | +>>>>>>> .r38752 |
1079 | 1123 | */ |
1080 | 1124 | function inSorbsBlacklist( $ip ) { |
1081 | 1125 | global $wgEnableSorbs, $wgSorbsUrl; |
— | — | @@ -1086,9 +1130,15 @@ |
1087 | 1131 | /** |
1088 | 1132 | * Whether the given IP is in a given DNS blacklist. |
1089 | 1133 | * |
| 1134 | +<<<<<<< .mine |
1090 | 1135 | * @param $ip \type{\string} IP to check |
1091 | 1136 | * @param $base \type{\string} URL of the DNS blacklist |
| 1137 | + * @return \type{\bool} True if blacklisted |
| 1138 | +======= |
| 1139 | + * @param $ip \type{\string} IP to check |
| 1140 | + * @param $base \type{\string} URL of the DNS blacklist |
1092 | 1141 | * @return \type{\bool} |
| 1142 | +>>>>>>> .r38752 |
1093 | 1143 | */ |
1094 | 1144 | function inDnsBlacklist( $ip, $base ) { |
1095 | 1145 | wfProfileIn( __METHOD__ ); |
— | — | @@ -1122,7 +1172,11 @@ |
1123 | 1173 | /** |
1124 | 1174 | * Is this user subject to rate limiting? |
1125 | 1175 | * |
| 1176 | +<<<<<<< .mine |
| 1177 | + * @return \type{\bool} True if rate limited |
| 1178 | +======= |
1126 | 1179 | * @return \type{\bool} |
| 1180 | +>>>>>>> .r38752 |
1127 | 1181 | */ |
1128 | 1182 | public function isPingLimitable() { |
1129 | 1183 | global $wgRateLimitsExcludedGroups; |
— | — | @@ -1311,7 +1365,11 @@ |
1312 | 1366 | |
1313 | 1367 | /** |
1314 | 1368 | * Get the user name, or the IP of an anonymous user |
| 1369 | +<<<<<<< .mine |
| 1370 | + * @return \type{\string} User's name or IP address |
| 1371 | +======= |
1315 | 1372 | * @return \type{\string} |
| 1373 | +>>>>>>> .r38752 |
1316 | 1374 | */ |
1317 | 1375 | function getName() { |
1318 | 1376 | if ( !$this->mDataLoaded && $this->mFrom == 'name' ) { |
— | — | @@ -1347,7 +1405,11 @@ |
1348 | 1406 | |
1349 | 1407 | /** |
1350 | 1408 | * Get the user's name escaped by underscores. |
| 1409 | +<<<<<<< .mine |
| 1410 | + * @return \type{\string} Username escaped by underscores |
| 1411 | +======= |
1351 | 1412 | * @return \type{\string} |
| 1413 | +>>>>>>> .r38752 |
1352 | 1414 | */ |
1353 | 1415 | function getTitleKey() { |
1354 | 1416 | return str_replace( ' ', '_', $this->getName() ); |
— | — | @@ -1617,7 +1679,11 @@ |
1618 | 1680 | |
1619 | 1681 | /** |
1620 | 1682 | * Get the user's current token. |
| 1683 | +<<<<<<< .mine |
| 1684 | + * @return \type{\string} Token |
| 1685 | +======= |
1621 | 1686 | * @return \type{\string} |
| 1687 | +>>>>>>> .r38752 |
1622 | 1688 | */ |
1623 | 1689 | function getToken() { |
1624 | 1690 | $this->load(); |
— | — | @@ -1676,7 +1742,11 @@ |
1677 | 1743 | /** |
1678 | 1744 | * Has password reminder email been sent within the last |
1679 | 1745 | * $wgPasswordReminderResendTime hours? |
| 1746 | +<<<<<<< .mine |
| 1747 | + * @return \type{\bool} True or false |
| 1748 | +======= |
1680 | 1749 | * @return \type{\bool} |
| 1750 | +>>>>>>> .r38752 |
1681 | 1751 | */ |
1682 | 1752 | function isPasswordReminderThrottled() { |
1683 | 1753 | global $wgPasswordReminderResendTime; |
— | — | @@ -1690,7 +1760,11 @@ |
1691 | 1761 | |
1692 | 1762 | /** |
1693 | 1763 | * Get the user's e-mail address |
| 1764 | +<<<<<<< .mine |
| 1765 | + * @return \type{\string} User's -mail address |
| 1766 | +======= |
1694 | 1767 | * @return \type{\string} |
| 1768 | +>>>>>>> .r38752 |
1695 | 1769 | */ |
1696 | 1770 | function getEmail() { |
1697 | 1771 | $this->load(); |
— | — | @@ -1720,7 +1794,11 @@ |
1721 | 1795 | |
1722 | 1796 | /** |
1723 | 1797 | * Get the user's real name |
| 1798 | +<<<<<<< .mine |
| 1799 | + * @return \type{\string} User's real name |
| 1800 | +======= |
1724 | 1801 | * @return \type{\string} |
| 1802 | +>>>>>>> .r38752 |
1725 | 1803 | */ |
1726 | 1804 | function getRealName() { |
1727 | 1805 | $this->load(); |
— | — | @@ -1822,7 +1900,11 @@ |
1823 | 1901 | |
1824 | 1902 | /** |
1825 | 1903 | * Get the user's preferred date format. |
| 1904 | +<<<<<<< .mine |
| 1905 | + * @return \type{\string} User's preferred date format |
| 1906 | +======= |
1826 | 1907 | * @return \type{\string} |
| 1908 | +>>>>>>> .r38752 |
1827 | 1909 | */ |
1828 | 1910 | function getDatePreference() { |
1829 | 1911 | // Important migration for old data rows |
— | — | @@ -1840,7 +1922,7 @@ |
1841 | 1923 | |
1842 | 1924 | /** |
1843 | 1925 | * Get the permissions this user has. |
1844 | | - * @return \arrayof{\string} |
| 1926 | + * @return \arrayof{\string} Array of permission names |
1845 | 1927 | */ |
1846 | 1928 | function getRights() { |
1847 | 1929 | if ( is_null( $this->mRights ) ) { |
— | — | @@ -1855,7 +1937,7 @@ |
1856 | 1938 | /** |
1857 | 1939 | * Get the list of explicit group memberships this user has. |
1858 | 1940 | * The implicit * and user groups are not included. |
1859 | | - * @return \arrayof{\string} |
| 1941 | + * @return \arrayof{\string} Array of internal group names |
1860 | 1942 | */ |
1861 | 1943 | function getGroups() { |
1862 | 1944 | $this->load(); |
— | — | @@ -1866,8 +1948,13 @@ |
1867 | 1949 | * Get the list of implicit group memberships this user has. |
1868 | 1950 | * This includes all explicit groups, plus 'user' if logged in, |
1869 | 1951 | * '*' for all accounts and autopromoted groups |
| 1952 | +<<<<<<< .mine |
1870 | 1953 | * @param $recache \type{\bool} Whether to avoid the cache |
| 1954 | + * @return \arrayof{\string} Array of internal group names |
| 1955 | +======= |
| 1956 | + * @param $recache \type{\bool} Whether to avoid the cache |
1871 | 1957 | * @return \arrayof{\string} |
| 1958 | +>>>>>>> .r38752 |
1872 | 1959 | */ |
1873 | 1960 | function getEffectiveGroups( $recache = false ) { |
1874 | 1961 | if ( $recache || is_null( $this->mEffectiveGroups ) ) { |
— | — | @@ -1890,7 +1977,11 @@ |
1891 | 1978 | |
1892 | 1979 | /** |
1893 | 1980 | * Get the user's edit count. |
| 1981 | +<<<<<<< .mine |
| 1982 | + * @return \type{\int} User's edit count |
| 1983 | +======= |
1894 | 1984 | * @return \type{\int} |
| 1985 | +>>>>>>> .r38752 |
1895 | 1986 | */ |
1896 | 1987 | function getEditCount() { |
1897 | 1988 | if ($this->mId) { |
— | — | @@ -1954,7 +2045,11 @@ |
1955 | 2046 | |
1956 | 2047 | /** |
1957 | 2048 | * Get whether the user is logged in |
| 2049 | +<<<<<<< .mine |
| 2050 | + * @return \type{\bool} True or false |
| 2051 | +======= |
1958 | 2052 | * @return \type{\bool} |
| 2053 | +>>>>>>> .r38752 |
1959 | 2054 | */ |
1960 | 2055 | function isLoggedIn() { |
1961 | 2056 | return $this->getID() != 0; |
— | — | @@ -1962,7 +2057,11 @@ |
1963 | 2058 | |
1964 | 2059 | /** |
1965 | 2060 | * Get whether the user is anonymous |
| 2061 | +<<<<<<< .mine |
| 2062 | + * @return \type{\bool} True or false |
| 2063 | +======= |
1966 | 2064 | * @return \type{\bool} |
| 2065 | +>>>>>>> .r38752 |
1967 | 2066 | */ |
1968 | 2067 | function isAnon() { |
1969 | 2068 | return !$this->isLoggedIn(); |
— | — | @@ -1970,7 +2069,11 @@ |
1971 | 2070 | |
1972 | 2071 | /** |
1973 | 2072 | * Get whether the user is a bot |
| 2073 | +<<<<<<< .mine |
| 2074 | + * @return \type{\bool} True or false |
| 2075 | +======= |
1974 | 2076 | * @return \type{\bool} |
| 2077 | +>>>>>>> .r38752 |
1975 | 2078 | * @deprecated |
1976 | 2079 | */ |
1977 | 2080 | function isBot() { |
— | — | @@ -1993,7 +2096,11 @@ |
1994 | 2097 | |
1995 | 2098 | /** |
1996 | 2099 | * Check whether to enable recent changes patrol features for this user |
| 2100 | +<<<<<<< .mine |
| 2101 | + * @return \type{\bool} True or false |
| 2102 | +======= |
1997 | 2103 | * @return \type{\bool} |
| 2104 | +>>>>>>> .r38752 |
1998 | 2105 | */ |
1999 | 2106 | public function useRCPatrol() { |
2000 | 2107 | global $wgUseRCPatrol; |
— | — | @@ -2002,7 +2109,11 @@ |
2003 | 2110 | |
2004 | 2111 | /** |
2005 | 2112 | * Check whether to enable new pages patrol features for this user |
| 2113 | +<<<<<<< .mine |
| 2114 | + * @return \type{\bool} True or false |
| 2115 | +======= |
2006 | 2116 | * @return \type{\bool} |
| 2117 | +>>>>>>> .r38752 |
2007 | 2118 | */ |
2008 | 2119 | public function useNPPatrol() { |
2009 | 2120 | global $wgUseRCPatrol, $wgUseNPPatrol; |
— | — | @@ -2011,7 +2122,7 @@ |
2012 | 2123 | |
2013 | 2124 | /** |
2014 | 2125 | * Get the current skin, loading it if required |
2015 | | - * @return \type{Skin} |
| 2126 | + * @return \type{Skin} Current skin |
2016 | 2127 | * @todo FIXME : need to check the old failback system [AV] |
2017 | 2128 | */ |
2018 | 2129 | function &getSkin() { |
— | — | @@ -2450,7 +2561,11 @@ |
2451 | 2562 | * which will give them a chance to modify this key based on their own |
2452 | 2563 | * settings. |
2453 | 2564 | * |
| 2565 | +<<<<<<< .mine |
| 2566 | + * @return \type{\string} Page rendering hash |
| 2567 | +======= |
2454 | 2568 | * @return \type{\string} |
| 2569 | +>>>>>>> .r38752 |
2455 | 2570 | */ |
2456 | 2571 | function getPageRenderingHash() { |
2457 | 2572 | global $wgContLang, $wgUseDynamicDates, $wgLang; |
— | — | @@ -2485,7 +2600,11 @@ |
2486 | 2601 | |
2487 | 2602 | /** |
2488 | 2603 | * Get whether the user is explicitly blocked from account creation. |
| 2604 | +<<<<<<< .mine |
| 2605 | + * @return \type{\bool} True if blocked |
| 2606 | +======= |
2489 | 2607 | * @return \type{\bool} |
| 2608 | +>>>>>>> .r38752 |
2490 | 2609 | */ |
2491 | 2610 | function isBlockedFromCreateAccount() { |
2492 | 2611 | $this->getBlockedStatus(); |
— | — | @@ -2494,7 +2613,11 @@ |
2495 | 2614 | |
2496 | 2615 | /** |
2497 | 2616 | * Get whether the user is blocked from using Special:Emailuser. |
| 2617 | +<<<<<<< .mine |
| 2618 | + * @return \type{\bool} True if blocked |
| 2619 | +======= |
2498 | 2620 | * @return \type{\bool} |
| 2621 | +>>>>>>> .r38752 |
2499 | 2622 | */ |
2500 | 2623 | function isBlockedFromEmailuser() { |
2501 | 2624 | $this->getBlockedStatus(); |
— | — | @@ -2503,7 +2626,11 @@ |
2504 | 2627 | |
2505 | 2628 | /** |
2506 | 2629 | * Get whether the user is allowed to create an account. |
| 2630 | +<<<<<<< .mine |
| 2631 | + * @return \type{\bool} True if allowed |
| 2632 | +======= |
2507 | 2633 | * @return \type{\bool} |
| 2634 | +>>>>>>> .r38752 |
2508 | 2635 | */ |
2509 | 2636 | function isAllowedToCreateAccount() { |
2510 | 2637 | return $this->isAllowed( 'createaccount' ) && !$this->isBlockedFromCreateAccount(); |
— | — | @@ -2519,7 +2646,7 @@ |
2520 | 2647 | /** |
2521 | 2648 | * Get this user's personal page title. |
2522 | 2649 | * |
2523 | | - * @return \type{Title} |
| 2650 | + * @return \type{Title} User's personal page title |
2524 | 2651 | */ |
2525 | 2652 | function getUserPage() { |
2526 | 2653 | return Title::makeTitle( NS_USER, $this->getName() ); |
— | — | @@ -2528,7 +2655,7 @@ |
2529 | 2656 | /** |
2530 | 2657 | * Get this user's talk page title. |
2531 | 2658 | * |
2532 | | - * @return \type{Title} |
| 2659 | + * @return \type{Title} User's talk page title |
2533 | 2660 | */ |
2534 | 2661 | function getTalkPage() { |
2535 | 2662 | $title = $this->getUserPage(); |
— | — | @@ -2537,7 +2664,11 @@ |
2538 | 2665 | |
2539 | 2666 | /** |
2540 | 2667 | * Get the maximum valid user ID. |
| 2668 | +<<<<<<< .mine |
| 2669 | + * @return \type{\int} %User ID |
| 2670 | +======= |
2541 | 2671 | * @return \type{\int} |
| 2672 | +>>>>>>> .r38752 |
2542 | 2673 | * @static |
2543 | 2674 | */ |
2544 | 2675 | function getMaxID() { |
— | — | @@ -2629,7 +2760,11 @@ |
2630 | 2761 | /** |
2631 | 2762 | * Check if the given clear-text password matches the temporary password |
2632 | 2763 | * sent by e-mail for password reset operations. |
| 2764 | +<<<<<<< .mine |
| 2765 | + * @return \type{\bool} True if matches, false otherwise |
| 2766 | +======= |
2633 | 2767 | * @return \type{\bool} |
| 2768 | +>>>>>>> .r38752 |
2634 | 2769 | */ |
2635 | 2770 | function checkTemporaryPassword( $plaintext ) { |
2636 | 2771 | return self::comparePasswords( $this->mNewpassword, $plaintext, $this->getId() ); |
— | — | @@ -2730,11 +2865,19 @@ |
2731 | 2866 | * Send an e-mail to this user's account. Does not check for |
2732 | 2867 | * confirmed status or validity. |
2733 | 2868 | * |
| 2869 | +<<<<<<< .mine |
2734 | 2870 | * @param $subject \type{\string} Message subject |
2735 | 2871 | * @param $body \type{\string} Message body |
2736 | 2872 | * @param $from \type{\string} Optional From address; if unspecified, default $wgPasswordSender will be used |
| 2873 | + * @param $replyto \type{\string} Reply-to address |
| 2874 | + * @return \twotypes{\bool,WikiError} True on success, a WikiError object on failure |
| 2875 | +======= |
| 2876 | + * @param $subject \type{\string} Message subject |
| 2877 | + * @param $body \type{\string} Message body |
| 2878 | + * @param $from \type{\string} Optional From address; if unspecified, default $wgPasswordSender will be used |
2737 | 2879 | * @param $replyto \type{\string} |
2738 | 2880 | * @return \twotypes{\bool,WikiError} True on success, a WikiError object on failure |
| 2881 | +>>>>>>> .r38752 |
2739 | 2882 | */ |
2740 | 2883 | function sendMail( $subject, $body, $from = null, $replyto = null ) { |
2741 | 2884 | if( is_null( $from ) ) { |
— | — | @@ -2754,8 +2897,13 @@ |
2755 | 2898 | * @note Call saveSettings() after calling this function to commit |
2756 | 2899 | * this change to the database. |
2757 | 2900 | * |
| 2901 | +<<<<<<< .mine |
2758 | 2902 | * @param[out] &$expiration \type{\mixed} Accepts the expiration time |
| 2903 | + * @return \type{\string} New token |
| 2904 | +======= |
| 2905 | + * @param[out] &$expiration \type{\mixed} Accepts the expiration time |
2759 | 2906 | * @return \type{\string} |
| 2907 | +>>>>>>> .r38752 |
2760 | 2908 | * @private |
2761 | 2909 | */ |
2762 | 2910 | function confirmationToken( &$expiration ) { |
— | — | @@ -2772,8 +2920,13 @@ |
2773 | 2921 | |
2774 | 2922 | /** |
2775 | 2923 | * Return a URL the user can use to confirm their email address. |
| 2924 | +<<<<<<< .mine |
2776 | 2925 | * @param $token \type{\string} Accepts the email confirmation token |
| 2926 | + * @return \type{\string} New token URL |
| 2927 | +======= |
| 2928 | + * @param $token \type{\string} Accepts the email confirmation token |
2777 | 2929 | * @return \type{\string} |
| 2930 | +>>>>>>> .r38752 |
2778 | 2931 | * @private |
2779 | 2932 | */ |
2780 | 2933 | function confirmationTokenUrl( $token ) { |
— | — | @@ -2781,8 +2934,13 @@ |
2782 | 2935 | } |
2783 | 2936 | /** |
2784 | 2937 | * Return a URL the user can use to invalidate their email address. |
| 2938 | +<<<<<<< .mine |
2785 | 2939 | * @param $token \type{\string} Accepts the email confirmation token |
| 2940 | + * @return \type{\string} New token URL |
| 2941 | +======= |
| 2942 | + * @param $token \type{\string} Accepts the email confirmation token |
2786 | 2943 | * @return \type{\string} |
| 2944 | +>>>>>>> .r38752 |
2787 | 2945 | * @private |
2788 | 2946 | */ |
2789 | 2947 | function invalidationTokenUrl( $token ) { |
— | — | @@ -2849,7 +3007,11 @@ |
2850 | 3008 | /** |
2851 | 3009 | * Is this user allowed to send e-mails within limits of current |
2852 | 3010 | * site configuration? |
| 3011 | +<<<<<<< .mine |
| 3012 | + * @return \type{\bool} True if allowed |
| 3013 | +======= |
2853 | 3014 | * @return \type{\bool} |
| 3015 | +>>>>>>> .r38752 |
2854 | 3016 | */ |
2855 | 3017 | function canSendEmail() { |
2856 | 3018 | $canSend = $this->isEmailConfirmed(); |
— | — | @@ -2860,7 +3022,11 @@ |
2861 | 3023 | /** |
2862 | 3024 | * Is this user allowed to receive e-mails within limits of current |
2863 | 3025 | * site configuration? |
| 3026 | +<<<<<<< .mine |
| 3027 | + * @return \type{\bool} True if allowed |
| 3028 | +======= |
2864 | 3029 | * @return \type{\bool} |
| 3030 | +>>>>>>> .r38752 |
2865 | 3031 | */ |
2866 | 3032 | function canReceiveEmail() { |
2867 | 3033 | return $this->isEmailConfirmed() && !$this->getOption( 'disablemail' ); |
— | — | @@ -2874,7 +3040,11 @@ |
2875 | 3041 | * confirmed their address by returning a code or using a password |
2876 | 3042 | * sent to the address from the wiki. |
2877 | 3043 | * |
| 3044 | +<<<<<<< .mine |
| 3045 | + * @return \type{\bool} True if conffirmed |
| 3046 | +======= |
2878 | 3047 | * @return \type{\bool} |
| 3048 | +>>>>>>> .r38752 |
2879 | 3049 | */ |
2880 | 3050 | function isEmailConfirmed() { |
2881 | 3051 | global $wgEmailAuthentication; |
— | — | @@ -2895,7 +3065,11 @@ |
2896 | 3066 | |
2897 | 3067 | /** |
2898 | 3068 | * Check whether there is an outstanding request for e-mail confirmation. |
| 3069 | +<<<<<<< .mine |
| 3070 | + * @return \type{\bool} True if pending |
| 3071 | +======= |
2899 | 3072 | * @return \type{\bool} |
| 3073 | +>>>>>>> .r38752 |
2900 | 3074 | */ |
2901 | 3075 | function isEmailConfirmationPending() { |
2902 | 3076 | global $wgEmailAuthentication; |
— | — | @@ -2955,8 +3129,13 @@ |
2956 | 3130 | /** |
2957 | 3131 | * Get the localized descriptive name for a group, if it exists |
2958 | 3132 | * |
| 3133 | +<<<<<<< .mine |
2959 | 3134 | * @param $group \type{\string} Internal group name |
| 3135 | + * @return \type{\string} Localized descriptive group name |
| 3136 | +======= |
| 3137 | + * @param $group \type{\string} Internal group name |
2960 | 3138 | * @return \type{\string} |
| 3139 | +>>>>>>> .r38752 |
2961 | 3140 | */ |
2962 | 3141 | static function getGroupName( $group ) { |
2963 | 3142 | global $wgMessageCache; |
— | — | @@ -2971,8 +3150,13 @@ |
2972 | 3151 | /** |
2973 | 3152 | * Get the localized descriptive name for a member of a group, if it exists |
2974 | 3153 | * |
| 3154 | +<<<<<<< .mine |
2975 | 3155 | * @param $group \type{\string} Internal group name |
| 3156 | + * @return \type{\string} Localized name for group member |
| 3157 | +======= |
| 3158 | + * @param $group \type{\string} Internal group name |
2976 | 3159 | * @return \type{\string} |
| 3160 | +>>>>>>> .r38752 |
2977 | 3161 | */ |
2978 | 3162 | static function getGroupMember( $group ) { |
2979 | 3163 | global $wgMessageCache; |
— | — | @@ -2988,7 +3172,7 @@ |
2989 | 3173 | * Return the set of defined explicit groups. |
2990 | 3174 | * The implicit groups (by default *, 'user' and 'autoconfirmed') |
2991 | 3175 | * are not included, as they are defined automatically, not in the database. |
2992 | | - * @return \arrayof{\string} |
| 3176 | + * @return \arrayof{\string} Array of internal group names |
2993 | 3177 | */ |
2994 | 3178 | static function getAllGroups() { |
2995 | 3179 | global $wgGroupPermissions; |
— | — | @@ -3000,7 +3184,7 @@ |
3001 | 3185 | |
3002 | 3186 | /** |
3003 | 3187 | * Get a list of all available permissions. |
3004 | | - * @return \arrayof{\string} |
| 3188 | + * @return \arrayof{\string} Array of permission names |
3005 | 3189 | */ |
3006 | 3190 | static function getAllRights() { |
3007 | 3191 | if ( self::$mAllRights === false ) { |
— | — | @@ -3017,7 +3201,7 @@ |
3018 | 3202 | |
3019 | 3203 | /** |
3020 | 3204 | * Get a list of implicit groups |
3021 | | - * @return \arrayof{\string} |
| 3205 | + * @return \arrayof{\string} Array of internal group names |
3022 | 3206 | */ |
3023 | 3207 | public static function getImplicitGroups() { |
3024 | 3208 | global $wgImplicitGroups; |
— | — | @@ -3134,8 +3318,13 @@ |
3135 | 3319 | /** |
3136 | 3320 | * Get the description of a given right |
3137 | 3321 | * |
| 3322 | +<<<<<<< .mine |
3138 | 3323 | * @param $right \type{\string} Right to query |
| 3324 | + * @return \type{\string} Localized description of the right |
| 3325 | +======= |
| 3326 | + * @param $right \type{\string} Right to query |
3139 | 3327 | * @return \type{\string} |
| 3328 | +>>>>>>> .r38752 |
3140 | 3329 | */ |
3141 | 3330 | static function getRightDescription( $right ) { |
3142 | 3331 | global $wgMessageCache; |
— | — | @@ -3188,10 +3377,17 @@ |
3189 | 3378 | * Compare a password hash with a plain-text password. Requires the user |
3190 | 3379 | * ID if there's a chance that the hash is an old-style hash. |
3191 | 3380 | * |
| 3381 | +<<<<<<< .mine |
3192 | 3382 | * @param $hash \type{\string} Password hash |
3193 | 3383 | * @param $password \type{\string} Plain-text password to compare |
3194 | 3384 | * @param $userId \type{\string} %User ID for old-style password salt |
| 3385 | + * @return \type{\bool} True if matches, false otherwise |
| 3386 | +======= |
| 3387 | + * @param $hash \type{\string} Password hash |
| 3388 | + * @param $password \type{\string} Plain-text password to compare |
| 3389 | + * @param $userId \type{\string} %User ID for old-style password salt |
3195 | 3390 | * @return \type{\bool} |
| 3391 | +>>>>>>> .r38752 |
3196 | 3392 | */ |
3197 | 3393 | static function comparePasswords( $hash, $password, $userId = false ) { |
3198 | 3394 | $m = false; |