Skip to content

docs: clarify thread safety javadoc and fix typos in BmAPI#1058

Merged
confuser merged 1 commit intomasterfrom
fix/clarify-thread-safety-javadoc
Apr 3, 2026
Merged

docs: clarify thread safety javadoc and fix typos in BmAPI#1058
confuser merged 1 commit intomasterfrom
fix/clarify-thread-safety-javadoc

Conversation

@confuser
Copy link
Copy Markdown
Member

@confuser confuser commented Apr 3, 2026

Reword the contradictory "not thread safe and should not be called on the main thread" statement to clearly separate the two constraints: blocking I/O (don't call on the main thread) and lack of internal synchronization (caller must synchronize concurrent access).

Applied to getWarnings, getPlayerNames, getPlayerHistory, getPlayerNameAt, getBanRecords(PlayerData), getMuteRecords, and getBanRecords(IPAddress).

Also fixes:

  • "mutened" -> "muted" typo in three mute method javadocs
  • "warningss" -> "warnings" typo in getWarnings
  • misleading "IP to ban" @param on isBanned, getCurrentBan, and getBanRecords query methods

fixes #953

Reword the contradictory "not thread safe and should not be called on
the main thread" statement to clearly separate the two constraints:
blocking I/O (don't call on the main thread) and lack of internal
synchronization (caller must synchronize concurrent access).

Applied to getWarnings, getPlayerNames, getPlayerHistory,
getPlayerNameAt, getBanRecords(PlayerData), getMuteRecords, and
getBanRecords(IPAddress).

Also fixes:
- "mutened" -> "muted" typo in three mute method javadocs
- "warningss" -> "warnings" typo in getWarnings
- misleading "IP to ban" @param on isBanned, getCurrentBan, and
  getBanRecords query methods
@confuser confuser merged commit 18d4a8a into master Apr 3, 2026
18 checks passed
@confuser confuser deleted the fix/clarify-thread-safety-javadoc branch April 3, 2026 19:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Perplexing documentation for API method

1 participant