917f0a5996
According to the dictionary, "per" (or more conventionally "as per") means "according to". Refer OED "per" sense II.3.a. For example: "No value was passed, so return null, as per default". In this sentence, we are not specifying the default, we are referring to the default. This correct usage of "per default" was used nowhere in MediaWiki core as far as I can see. Instead we have "per default" being used to mean "by default", that is, giving the value to use when no explicit value was specified. In OED, the phrase "by default" is blessed with its own section just for computing usage: "P.1.e. Computing. As an option or setting adopted automatically by a computer program whenever an alternative is not specified by the user or programmer. Cf. sense I.7a." There are highly similar pre-computing usages of the same phrase, whereas the phrase "per default" is not mentioned. As a matter of style, I think "per default" should not be used even when it is strictly correct, since the common incorrect usage makes it ambiguous and misleading. Change-Id: Ibcccc65ead864d082677b472b34ff32ff41c60ae
63 lines
2 KiB
PHP
63 lines
2 KiB
PHP
<?php
|
|
/**
|
|
* A title parser service for %MediaWiki.
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License along
|
|
* with this program; if not, write to the Free Software Foundation, Inc.,
|
|
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
|
* http://www.gnu.org/copyleft/gpl.html
|
|
*
|
|
* @file
|
|
* @author Daniel Kinzler
|
|
*/
|
|
|
|
namespace MediaWiki\Title;
|
|
|
|
/**
|
|
* A title parser service for %MediaWiki.
|
|
*
|
|
* This is designed to encapsulate knowledge about conventions for the title
|
|
* forms to be used in the database, in urls, in wikitext, etc.
|
|
*
|
|
* @see https://www.mediawiki.org/wiki/Requests_for_comment/TitleValue
|
|
* @since 1.23
|
|
*/
|
|
interface TitleParser {
|
|
/**
|
|
* Parses the given text and constructs a TitleValue.
|
|
*
|
|
* @note this only parses local page links, interwiki-prefixes etc. are not considered!
|
|
*
|
|
* @param string $text The text to parse
|
|
* @param int $defaultNamespace Namespace to assume by default (usually NS_MAIN)
|
|
*
|
|
* @throws MalformedTitleException If the text is not a valid representation of a page title.
|
|
* @return TitleValue
|
|
*/
|
|
public function parseTitle( $text, $defaultNamespace = NS_MAIN );
|
|
|
|
/**
|
|
* Given a namespace and title, return a TitleValue if valid, or null if invalid.
|
|
*
|
|
* @param int $namespace
|
|
* @param string $text
|
|
* @param string $fragment
|
|
* @param string $interwiki
|
|
*
|
|
* @return TitleValue|null
|
|
*/
|
|
public function makeTitleValueSafe( $namespace, $text, $fragment = '', $interwiki = '' );
|
|
}
|
|
|
|
/** @deprecated class alias since 1.41 */
|
|
class_alias( TitleParser::class, 'TitleParser' );
|