[4.0] Correct @param docblock parameter types

[PhilETaylor]

Summary of Changes

Method signature changes in docblock only, no code changes

Actual result BEFORE applying this Pull Request

The docblock documented that $id could only be an integer

This is factually incorrect as evidenced by the second param $byName which is a bool that says if the $id is the name (i.e. a string "site/administrator/api/cli etc") then to handle it differently than an integer client id.

There are many places in code where $id is provided as a string of the name and $byName is set to true, further proving the documentation to be incorrect.

Documentation Changes Required

None.

[ChristineWk]

I have tested this item ✅ successfully on c591762

---

_{This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/29882.}

[ChristineWk]

I have tested this item ✅ successfully on 53d213a

---

_{This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/29882.}

[Quy]

From Joomla! Coding Standards

Whereas normal code indenting uses real tabs, all whitespace in a Docblock uses real spaces. This provides better readability in source code browsers. The minimum whitespace between any text elements, such as tags, variable types, variable names and tag descriptions, is two real spaces.

[ChristineWk]

I have not tested this item.

---

_{This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/29882.}
Had the wrong button.

[ChristineWk]

I have tested this item ✅ successfully on f04e476

---

_{This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/29882.}

[Quy]

I have tested this item ✅ successfully on f04e476

---

_{This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/29882.}

[Quy]

RTC

---

_{This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/29882.}

[richard67]

Thanks!