I kind of agree that the info on JPanel’s use of the paint() method is kind of buried on this API page. But it IS there: under the heading “Methods Inherited from the class javax.swing.JComponent”. I would say it is easier to find if you already know it is there.
These API pages also usually have a good explanation, or a link to a relevant section of the official tutorial that covers the class. This entry is no exception.
After a while, navigating through these API’s gets easier and makes more sense. I remember when I first looked at them. I was such a noob I couldn’t figure out how to use the information because they didn’t include code examples. :
Now, I find them hugely helpful.