[Mediawiki-api] BREAKING CHANGE to list=categorymembers
Roan Kattouw
roan.kattouw at home.nl
Thu Feb 7 15:27:58 UTC 2008
Great, sent this e-mail to the wrong address and didn't notice until
three days later...
In r30533 [1], the following changes were made to list=categorymembers:
* The cmtitle parameter was added, which is intended to replace
cmcategory in the long run. The difference is that cmtitle requires the
Category: prefix, whereas cmcategory does not. (Example:
cmtitle=Category:Living_people and cmcategory=Living_people)
* The cmcategory parameter is now deprecated, and WILL BE REMOVED in
early March (probably around March 3rd)
* A few error messages have been changed:
** <error code="cmparam_category" info="Category parameter is required">
was changed to <error code="cmnotitle" info="Either the cmcategory or
the cmtitle parameter is required">
*** The message will be changed to "The cmtitle parameter is required"
in early March (when cmcategory has been removed). The error code
(cmnotitle) won't change.
** <error code="cmparam_category" info="Category name $1 is not valid">
was changed to <error code="cminvalidcategory" info="The category name
you entered is invalid">
*** This error will also be thrown if cmtitle is a valid title but not
in the Category: namespace.
** <error code="cmtitleandcategory" info="The cmcategory and cmtitle
parameters can't be used together">
*** This error will be removed once cmcategory has been removed (in
early March), because it won't make sense anymore at that time
For extra clarity: this doesn't break any code *yet*. Users of
list=categorymembers have until *early March* to update their code,
after that code using the cmcategory will break.
Roan Kattouw (Catrope)
[1] http://svn.wikimedia.org/viewvc/mediawiki?view=rev&revision=30533
More information about the Mediawiki-api
mailing list