[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