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
setProposals(filterProposals(allProposals, filterText));
			}
		}
		/*
		 * In an async block, request the proposals. This is used when clients
		 * are in the middle of processing an event that affects the widget
		 * content. By using an async, we ensure that the widget content is up
		 * to date with the event.
		 */
		private void asyncRecomputeProposals(final String filterText) {
			if (isValid()) {
				control.getDisplay().asyncExec(new Runnable() {
					public void run() {
						recordCursorPosition();
						recomputeProposals(filterText);
					}
				});
			} else {
				recomputeProposals(filterText);
			}
		}
		/*
		 * Filter the provided list of content proposals according to the filter
		 * text.
		 */
		private IContentProposal[] filterProposals(
				IContentProposal[] proposals, String filterString) {
			if (filterString.length() == 0) {
				return proposals;
			}