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
private boolean isValid() {
		return control != null && !control.isDisposed()
				&& controlContentAdapter != null;
	}
	/*
	 * Record the control's cursor position.
	 */
	private void recordCursorPosition() {
		if (isValid()) {
			IControlContentAdapter adapter = getControlContentAdapter();
			insertionPos = adapter.getCursorPosition(control);
			
			if (adapter instanceof IControlContentAdapter2) {
				selectionRange = ((IControlContentAdapter2) adapter)
						.getSelection(control);
			}
		}
	}
	/*
	 * Get the proposals from the proposal provider. Gets all of the proposals
	 * without doing any filtering.
	 */
	private IContentProposal[] getProposals() {
		if (proposalProvider == null || !isValid()) {
			return null;
		}
		if (DEBUG) {
			System.out.println(">>> obtaining proposals from provider"); 
		}
		int position = insertionPos;