Bug 283551 [FieldAssist] ContentProposalAdapter Class-JavaDoc and Method-JavaDoc contradict each other
The class documentation says: --8<-- This class is not intended to be subclassed. --8<-- But there are methods like openProposalPopup, closeProposalPopup who state something like this: --8<-- This method is used by subclasses to explicitly invoke the opening of the popup. If there are no proposals to show, the popup will not open and a beep will be sounded. --8<-- So did we opened the class since its first release but forgot to update the JavaDoc of the class?
bundles/org.eclipse.jface/src/org/eclipse/jface/fieldassist/ContentProposalAdapter.java
return text.getShell().isFocusControl()
						|| text.isFocusControl();
			}
		}
		/*
		 * The listener installed on the target control.
		 */
		private Listener targetControlListener;
		/*
		 * The listener installed in order to close the popup.
		 */
		private PopupCloserListener popupCloser;
		/*
		 * The table used to show the list of proposals.
		 */
		private Table proposalTable;
		/*
		 * The proposals to be shown (cached to avoid repeated requests).
		 */
		private IContentProposal[] proposals;
		/*
		 * Secondary popup used to show detailed information about the selected
		 * proposal..
		 */
		private InfoPopupDialog infoPopup;
		/*
		 * Flag indicating whether there is a pending secondary popup update.
		 */
		private boolean pendingDescriptionUpdate = false;
		/*