Поиск устаревших сообщений в документации Java

Надежного способа сделать это не будет. Найденный вами текст - неофициальный совет о классе. Этот класс формально НЕ является устаревшим. Устарело означает что-то очень специфическое в контексте Java. Это намного сильнее, чем "использование не рекомендуется в новом коде".

Если класс или член класса В самом деле устарел в Java, вы увидите аннотацию @Deprecated в исходном коде. Это то, на что цепочка инструментов Java обращает внимание. Также может быть тег javadoc @deprecated с объяснением и предложениями альтернатив, где это необходимо. Это то, что превращено в заголовок «Устарело:» в документации javadocs.

Чтобы найти неформальный совет, подобный приведенному вами примеру, вероятно, потребуется поискать в базе кода библиотеки Java или дереве javadoc ключевые фразы, такие как «устаревшие» и «не рекомендуется». Затем вам нужно будет вручную отфильтровать ложные срабатывания.

В большинстве случаев причина, по которой класс устарел, заключается в том, что была найдена лучшая альтернатива или потому, что он просто больше не нужен.

Что касается упомянутого вами deprecated link at the top, я полагаю, вы имеете в виду следующее: https://docs.oracle.com/javase/8/docs/api/deprecated-list.html

Ну, как вы сказали, эти находятся - вся информация, которую вы найдете, и они тоже довольно информативны.

Возьмем, к примеру, конструктор Date(int year, int month, int day), если прокрутить вниз до устаревший раздел конструктора, можно найти следующее:

java.sql.Date(int, int, int)

instead use the constructor Date(long date)

и он делает то же самое для всех классов / методов / интерфейсов, отмеченных аннотацией @Deprecated в JDK.

Кроме того, для StringTokenizer, если вы прочитаете чуть ниже цитированной вами строки, будет сказано следующее:

The following example illustrates how the String.split method can be used to break up a string into its basic tokens:

String[] result = "this is a test".split("\\s");
for (int x=0; x<result.length; x++)
    System.out.println(result[x]);

По сути, StringTokenizer больше не нужен, потому что объект String теперь имеет метод split, что делает StringTokenizer бесполезным.