RFR: 8012675: Javadoc for javax.swing.text.html.parser.Parser.handleComment() needs to be updated [v3]

[Damon Nguyen]

> Updated Parser class doc by appending to the doc regarding lack of support for HTML script tags. Adding this information to the "parse" function did not seem as consistent for formatting as adding it to the Parser class doc.

Damon Nguyen has updated the pull request incrementally with three additional commits since the last revision:

 - Updated java doc for clarity. Added test to show behavior.
 - Merge branch '8012675/htmlTagParserDocChange' of github.com:DamonGuy/jdk into 8012675/htmlTagParserDocChange
 - Added debugging statements to better trace handleComments

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

Changes:
  - all: https://git.openjdk.java.net/jdk/pull/7446/files
  - new: https://git.openjdk.java.net/jdk/pull/7446/files/c366a241..c7030add

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

  Stats: 105 lines in 5 files changed: 95 ins; 8 del; 2 mod
  Patch: https://git.openjdk.java.net/jdk/pull/7446.diff
  Fetch: git fetch https://git.openjdk.java.net/jdk pull/7446/head:pull/7446

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