RFR: 8253241: Update comment on java_suspend_self_with_safepoint_check() [v2]

[Richard Reingruber]

> After JDK-8252414 the safepoint/handshake code does not take _suspend_flags into accout anymore in its assessment if a
> thread is safepoint/handshake safe. This change updates the comment on
> JavaThread::java_suspend_self_with_safepoint_check().  I have (not yet) fixed the line breaks (fill-paragraph in emacs
> lingo) for a clearer diff.
> Also I could inline the (*) footnote.

Richard Reingruber has updated the pull request incrementally with one additional commit since the last revision:

  Apply version proposed by dholmes

-------------

Changes:
  - all: https://git.openjdk.java.net/jdk/pull/225/files
  - new: https://git.openjdk.java.net/jdk/pull/225/files/177221cf..e1ac0b9c

Webrevs:
 - full: https://webrevs.openjdk.java.net/?repo=jdk&pr=225&range=01
 - incr: https://webrevs.openjdk.java.net/?repo=jdk&pr=225&range=00-01

  Stats: 4 lines in 1 file changed: 0 ins; 0 del; 4 mod
  Patch: https://git.openjdk.java.net/jdk/pull/225.diff
  Fetch: git fetch https://git.openjdk.java.net/jdk pull/225/head:pull/225

PR: https://git.openjdk.java.net/jdk/pull/225