<Swing Dev> RFR: 8049700: Deprecate obsolete classes and methods in javax/swing/plaf/basic [v8]

[Tejpal Rebari]

> Please review the following fix for jdk17.
> In this fix i have deprecated and marked for removal following classes and methods 
>    public void intervalAdded(ListDataEvent e)
>    public void intervalRemoved(ListDataEvent e)
>    protected boolean lt(File a, File b) in BasicDirectoryModel.java
> 
>    inner class PropertyChangeHandler, VSBChangeListener, HSBChangeListener, 
>    ViewportChangeHandler in BasicScrollPaneUI.java
>    inner class MouseInputHandler in BasicMenuItemUI.java
>    method BasicToolBarUI.java#createFloatingFrame
> 
> From 8049700 not deprecated the paintText(Graphics g, JComponent c, Rectangle textRect, String text) method in BasicButtonUI  as AquaButtonUI, MetalButtonUI and MetalToggleButtonUI overrides it.
> Similarly not deprecated ChangeHandler of BasicMenuUI as AquaMenuUI and MotifMenuUI uses this class.

Tejpal Rebari has updated the pull request with a new target base due to a merge or a rebase. The incremental webrev excludes the unrelated changes brought in by the merge/rebase. The pull request contains eight additional commits since the last revision:

 - Merge remote-tracking branch 'upstream/master' into 8049700
 - removed forRemoval
 - removed deprecation from methods of class which is also getting deprecated
 - removed jdk version from @deprecated javadoc tag
 - updated documentation
 - Merge remote-tracking branch 'upstream/master' into 8049700
 - minor correction
 - initial fix

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

Changes:
  - all: https://git.openjdk.java.net/jdk/pull/1958/files
  - new: https://git.openjdk.java.net/jdk/pull/1958/files/7dd2b39a..88a8c475

Webrevs:
 - full: https://webrevs.openjdk.java.net/?repo=jdk&pr=1958&range=07
 - incr: https://webrevs.openjdk.java.net/?repo=jdk&pr=1958&range=06-07

  Stats: 69867 lines in 2030 files changed: 41455 ins; 17817 del; 10595 mod
  Patch: https://git.openjdk.java.net/jdk/pull/1958.diff
  Fetch: git fetch https://git.openjdk.java.net/jdk pull/1958/head:pull/1958

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