deprecate category_description() in favor of get_category_description()

[westi]

Nice idea. Not for 2.8

[ramiy]

if you liked this change, check #9882 too.

[Denis-de-Bernardy]

patch needs a slight update to change the versions, else probably good to go

[peaceablewhale]

How about tag_description(), which was introduced in 2.8?

[ramiy]

ver.2

[ramiy]

sorry, here is the latest

[ramiy]

category_description() & tag_description()

[ramiy]

• category_description() deprecate in favor of get_category_description()
• tag_description() deprecate in favor of get_tag_description()

The old function are still in use in deprecated.php file.

[nacin]

This is a good idea, though I'm not convinced this is worth it. If we're going to do this, we'll need to rename term_description() as well.

[ramiy]

nacin, we can rename term_description() as well.

[nacin]

Replying to ramiy:

nacin, we can rename term_description() as well.

I wasn't convinced it was worth it because that's three functions to rename, simply for get_* consistency. Surely we have other functions that don't start with "get_", especially those that also don't start with "the_", that return a value. I suppose this is considered a template tag, so I understand why we should probably do it here.

[ramiy]

category_description() & tag_description() & term_description()

[ericlewis]

Seems more properly categorized Taxonomy, this doesn't look like Inline Docs to me

[DrewAPicture]

refresh + docs fixes

[DrewAPicture]

9927.6.patch​ is a refresh at r25361, and fixes the formatting for the deprecated functions.

[wonderboymusic]

category-template.php is full of deprecate-able funcs, but there are too many uses in the wild for this to be worth worrying about right now: ​https://github.com/search?l=php&p=1&q=category_description&type=Code&utf8=%E2%9C%93