HBASE-30235 Fix Javadoc syntax errors

[gianmarcoschifone]

Fix Javadoc syntax errors reported by the JDK javadoc tool.

This updates malformed Javadoc in a few comments by escaping raw <...> text with {@code ...} and converting a raw @see URL to a valid link.

Validated with javadoc -Xdoclint:syntax on the affected files.

[liuxiaocs7]

Hi, @gianmarcoschifone, please refer the doc(https://hbase.apache.org/docs/building-and-developing/developer-guidelines#commit) to update the commit msg and PR title, thanks!

[gianmarcoschifone]

@liuxiaocs7 I'm not sure there is a relevant issue about this, should I create a new issue?

[romani]

@gianmarcoschifone
Please create quick issue HBASE-XXXX in their Jira tracker system. And reference in commit as prefix.

[gianmarcoschifone]

@gianmarcoschifone Please create quick issue HBASE-XXXX in their Jira tracker system. And reference in commit as prefix.

@romani I will request an account on Jira, it will need some sort of approval

[gianmarcoschifone]

@liuxiaocs7 Done, thank you for guidance

[PDavid]

Many thanks, nice, clean and minimal fix. Looks good to me. 👍

[PDavid]

We have a code format checker (spotless) in the project which now found some formatting issue:s

patch has 23 errors when running spotless:check, run spotless:apply to fix.

See: https://github.com/apache/hbase/actions/runs/27770162291?pr=8376

Can you please run mvn spotless:apply to format all files and commit the changes?

[gianmarcoschifone]

@PDavid Done, amended the commit

[liuxiaocs7]

Thanks @gianmarcoschifone and @PDavid, let's wait the CI green!

[guluo2016]

Thanks a lot!

[guluo2016]

@gianmarcoschifone Thanks for your contribution, please raise PR for branch-2.

[PDavid]

Congrats for your first contribution @gianmarcoschifone!

[gianmarcoschifone]

please raise PR for branch-2

@guluo2016 done, #8415