Add PHPDoc blocks to all functions

[TheWitness]

Summary

Adds PHPDoc blocks (description + purpose/invocation-context sentence,
@param, @return, and applicable @global tags) to every PHP
function definition in this plugin. Documentation only — no functional
changes.

Files covered: display.php, poller_intropage.php, setup.php,
include/database.php, include/tab.php, include/settings.php,
include/functions.php, and all panellib/*.php panel modules
(alert, analyze, busiest, graphs, mactrack, misc, poller, syslog,
system, thold, top5).

Embedded JavaScript functions (e.g. selectAllPerms() inside
<script> blocks) were identified and excluded, since they are not PHP
functions.

Validation

• php -l passed on every modified file.
• Verified the count of documented functions matches the count of real
  PHP function definitions in each file (JS-only matches excluded).

[Copilot]

Copilot review overview

🟡 Changes recommended

Several PHPDoc return, global-variable, and platform descriptions are inaccurate and should be corrected.

Get a fresh assessment by requesting another Copilot review.

Review effort: Lite
Findings: 17

Open (17)

• Document display_information() boolean return type · New
• Document bytes formatter's string|int return type · New
• Document callback's returned panel array · New
• Document callback's returned panel array · New
• Document callback's bool|null return type · New
• Document callback's returned panel array · New
• Document callback's returned panel array · New
• Document callback's returned panel array · New
• Document callback's returned panel array · New
• Document callback's returned panel array · New
• Document callback's returned panel array · New
• Document the actual 48-hour trend view · New
• Document callback's returned panel array · New
• Document callback's returned panel array · New
• Document callback's returned panel array · New
• Document callback's returned panel array · New
• Document checks as the processed panel count · New

What changed in this PR

Adds PHPDoc blocks to PHP functions across the Intropage plugin, with no intended runtime changes.

Changes:

• Documents hooks, helpers, panel callbacks, database operations, and UI functions.
• Adds parameter, return, global, and invocation-context descriptions.
• Corrects inaccurate return and global-variable documentation before approval.

File	Description
setup.php	Documents plugin lifecycle and panel APIs.
poller_intropage.php	Documents poller helpers and statistics gathering.
panellib/​top5.php	Documents top-five panels.
panellib/​thold.php	Documents Thold panels.
panellib/​system.php	Documents system panels.
panellib/​syslog.php	Documents Syslog panels.
panellib/​poller.php	Documents poller panels.
panellib/​misc.php	Documents miscellaneous panels.
panellib/​mactrack.php	Documents MacTrack panels.
panellib/​graphs.php	Documents graph panels.
panellib/​busiest.php	Documents busiest-device panels.
panellib/​analyze.php	Documents analysis panels.
panellib/​alert.php	Documents alert panels.
include/​tab.php	Documents header-tab integration.
include/​settings.php	Documents settings and user administration hooks.
include/​functions.php	Documents core dashboard utilities.
include/​database.php	Documents schema setup and upgrades.
display.php	Documents dashboard rendering.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.