diff options
| author | Tim Starling <tstarling@wikimedia.org> | 2024-04-29 10:13:28 +1000 |
|---|---|---|
| committer | Tim Starling <tstarling@wikimedia.org> | 2024-04-29 10:47:54 +1000 |
| commit | 917f0a59960d437745b6f87b60f1e48f6cf7416b (patch) | |
| tree | fa73dddae59ab8805b071c561aebd6aa9e6d223a /includes/content | |
| parent | 8c5c0edbfae8e6900a0a967cfcf669c015fea02b (diff) | |
| download | mediawikicore-917f0a59960d437745b6f87b60f1e48f6cf7416b.tar.gz mediawikicore-917f0a59960d437745b6f87b60f1e48f6cf7416b.zip | |
Replace all instances of "per default" with "by default"
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
Diffstat (limited to 'includes/content')
| -rw-r--r-- | includes/content/ContentHandler.php | 4 |
1 files changed, 2 insertions, 2 deletions
diff --git a/includes/content/ContentHandler.php b/includes/content/ContentHandler.php index a5f9ad98bea6..7f11919fbe34 100644 --- a/includes/content/ContentHandler.php +++ b/includes/content/ContentHandler.php @@ -326,7 +326,7 @@ abstract class ContentHandler { abstract public function serializeContent( Content $content, $format = null ); /** - * Applies transformations on export (returns the blob unchanged per default). + * Applies transformations on export (returns the blob unchanged by default). * Subclasses may override this to perform transformations such as conversion * of legacy formats or filtering of internal meta-data. * @@ -356,7 +356,7 @@ abstract class ContentHandler { abstract public function unserializeContent( $blob, $format = null ); /** - * Apply import transformation (per default, returns $blob unchanged). + * Apply import transformation (by default, returns $blob unchanged). * This gives subclasses an opportunity to transform data blobs on import. * * @stable to override |