The [existing 
documentation](https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/net/URL.html#constructor-deprecation)
 when rendered was hard to read as the entire string was in a `pre` and 
rendered in the same font.  Coupled with the fact the the first URL would 
contain a space this made it hard to scan as you had no visual clues and had to 
backtrack to re-read what the sentence was trying to say.

Switch to using inline definition using {@code} and swapped the order so that 
the string without spaces came first negating any need for back tracking when 
scanning

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

Commit messages:
 - make the reading of URL encoding issues easier to read

Changes: https://git.openjdk.org/jdk/pull/30074/files
  Webrev: https://webrevs.openjdk.org/?repo=jdk&pr=30074&range=00
  Issue: https://bugs.openjdk.org/browse/JDK-8379567
  Stats: 2 lines in 1 file changed: 0 ins; 0 del; 2 mod
  Patch: https://git.openjdk.org/jdk/pull/30074.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/30074/head:pull/30074

PR: https://git.openjdk.org/jdk/pull/30074

Reply via email to