Stabilise Queue test cleanup and normalise documentation markers

[peter-lawrey]

This PR improves Chronicle Queue test stability by centralising background resource cleanup and making queue directory deletion more reliable, especially around mapped file handles and Windows cleanup behaviour.

It also tidies the documentation by replacing non-ASCII punctuation and star-based Enterprise markers with clearer plain-text wording.

Changes

• Add shared QueueTestCommon.drainBackgroundCleanup() helper to:

  • release pending background resources;
  • wait for a GC cycle where supported;
  • release pending background resources again.

• Add QueueTestCommon.deleteDirAfterCleanup(...) for safer test directory deletion after mapped-file cleanup.

• Replace repeated direct calls to BackgroundResourceReleaser.releasePendingResources() across tests with the shared cleanup helper.

• Make tests more robust when deleting queue files or directories after appender/tailer activity.

• Improve AppenderFileHandleLeakTest by:

  • using named timeout/retry constants;
  • closing tailers with try-with-resources;
  • draining cleanup before checking mapped files;
  • shutting down the executor in preAfter().

• Add a TableStoreWriteLockTest case to verify a subprocess can acquire the table-store write lock before timeout.

• Update tests that now need expected-exception handling to extend QueueTestCommon.

• Avoid resetting the security manager on Java 17+.

• Normalise documentation and examples by:

  • replacing smart quotes with ASCII quotes;
  • replacing ★ Enterprise markers with (Enterprise);
  • replacing raw binary .cq4 sample output with [binary cq4 bytes omitted];
  • simplifying Javadoc punctuation to avoid non-ASCII characters.

Risk

Low. The production code changes are limited to documentation/Javadoc wording. The behavioural changes are test-side cleanup and stability improvements.

[sonarqubecloud]

Quality Gate passed

Issues
21 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[sonarqubecloud]

Quality Gate passed

Issues
7 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud