load_plugin_texdomain() PHPDoc doesn't document return value.

[jdgrimes]

Since 2.8 (#10286), load_plugin_textdomain() has had a boolean return value, but it doesn't have the @return tag documenting this in its docblock. (Prior to 2.8, it did not return a value.)

[SergeyBiryukov]

Related: [11680], [25458].

We didn't add @since for other load_*_textdomain() functions in [25458], so I guess it's not necessary here.

[SergeyBiryukov]

In 28924:

Document @return value for load_plugin_textdomain(). props jdgrimes.

Document $path parameter for load_child_theme_textdomain().

fixes #28690.

[DrewAPicture]

Replying to SergeyBiryukov:

Related: [11680], [25458].

We didn't add @since for other load_*_textdomain() functions in [25458], so I guess it's not necessary here.

We probably should have, especially since we're working so hard to make sure our docs are as complete as possible these days :)

[nacin]

Given this dates to 2.8, I don't think it's worth trying to go back in time to document changes made long ago. If we're going to do that, we're gonna want to do it for everything.

[SergeyBiryukov]

In 28938:

Add @since for get_translations_for_domain().

props DrewAPicture.
see #28690.

[SergeyBiryukov]

Replying to nacin:

Given this dates to 2.8, I don't think it's worth trying to go back in time to document changes made long ago. If we're going to do that, we're gonna want to do it for everything.

Yeah, that's what I thought.