From: daniel Date: Fri, 5 Oct 2012 13:09:09 +0000 (+0200) Subject: copyedit X-Git-Tag: 1.31.0-rc.0~22097^2^2~8^2 X-Git-Url: https://git.cyclocoop.org/%28%28?a=commitdiff_plain;h=1cfa4fc0dcf8ce2fbefa6b3975d3e498fdb7f2e6;p=lhc%2Fweb%2Fwiklou.git copyedit Change-Id: Ifad517560a3374575c08095991fa846fc6bc7ed4 --- diff --git a/RELEASE-NOTES-1.21 b/RELEASE-NOTES-1.21 index 3118386219..74eda0d927 100644 --- a/RELEASE-NOTES-1.21 +++ b/RELEASE-NOTES-1.21 @@ -20,7 +20,7 @@ production. === API changes in 1.21 === * prop=revisions can now report the contentmodel and contentformat, see docs/contenthandler.txt -* action=edit and action=parse now support contentmodel and contentformat parameters to controll the interpretation of +* action=edit and action=parse now support contentmodel and contentformat parameters to control the interpretation of page content; See docs/contenthandler.txt for details. === Languages updated in 1.21 === diff --git a/docs/contenthandler.txt b/docs/contenthandler.txt index bb8341fa46..be3f4a74ba 100644 --- a/docs/contenthandler.txt +++ b/docs/contenthandler.txt @@ -32,17 +32,17 @@ revisions of a page will all have the same content model. Use Revision::getConte == Architecture == -Two class hierarchies are used to provide the functionality associated with the different content models: +Two class hierarchies are used to provide the functionality associated with the different content models: * Content interface (and AbstractContent base class) define functionality that acts on the concrete content of a page, and -* ContentHandler base class provides functionality specific to a content model, but not acting on concrete content. +* ContentHandler base class provides functionality specific to a content model, but not acting on concrete content. The most important function of ContentHandler is to act as a factory for the appropriate implementation of Content. These Content objects are to be used by MediaWiki everywhere, instead of passing page content around as text. All manipulation and analysis of page content must be done via the appropriate methods of the Content object. For each content model, a subclass of ContentHandler has to be registered with $wgContentHandlers. The ContentHandler -object for a given content model can be optained using ContentHandler::getForModelID( $id ). Also Title, WikiPage and +object for a given content model can be obtained using ContentHandler::getForModelID( $id ). Also Title, WikiPage and Revision now have getContentHandler() methods for convenience. ContentHandler objects are singletons that provide functionality specific to the content type, but not directly acting @@ -138,7 +138,7 @@ Note however that the content model and format is only stored if it differs from ContentHandler::getDefaultModelFor( $title ). The default values are represented as NULL in the database, to preserve space. -Storage of content model and format can be disabled alltogether by setting $wgContentHandlerUseDB = false. In that case, +Storage of content model and format can be disabled altogether by setting $wgContentHandlerUseDB = false. In that case, the page's default model (and the model's default format) will be used everywhere. Attempts to store a revision of a page using a model or format different from the default will result in an error.