1
0
Fork 0
mirror of https://github.com/eclipse-cdt/cdt synced 2025-07-30 04:15:35 +02:00

- added javadoc

This commit is contained in:
Alena Laskavaia 2010-03-18 15:01:55 +00:00
parent e79f9bc741
commit eadd67178c
2 changed files with 24 additions and 12 deletions

View file

@ -13,38 +13,47 @@ package org.eclipse.cdt.codan.core.model;
import org.eclipse.core.resources.IResource;
/**
* Interface that checker must implement. CDT Checker must be able to process a resource.
* Interface that checker must implement. CDT Checker must be able to process a
* resource.
*
* Clients may implement and extend this interface.
*
* <p>
* <strong>EXPERIMENTAL</strong>. This class or interface has been added as
* part of a work in progress. There is no guarantee that this API will
* work or that it will remain the same.
* <strong>EXPERIMENTAL</strong>. This class or interface has been added as part
* of a work in progress. There is no guarantee that this API will work or that
* it will remain the same.
* </p>
*
* @noextend This interface is not intended to be extended by clients.
* @noimplement This interface is not intended to be implemented by clients. Extend AbstractChecker class instead.
* @noimplement This interface is not intended to be implemented by clients.
* Extend AbstractChecker class instead.
*/
public interface IChecker {
/**
* Main method that checker should implement that actually detects errors
* @param resource - resource to run on
*
* @param resource
* - resource to run on
* @return true if need to traverse children
*/
boolean processResource(IResource resource);
/**
* Implement this method to trim down type of resource you are interested in,
* usually it will be c/c++ files only
* @param resource - resource to run on
* Implement this method to trim down type of resource you are interested
* in, usually it will be c/c++ files only
*
* @param resource
* - resource to run on
* @return
*/
boolean enabledInContext(IResource resource);
/**
* Checker must implement this method to determine if it can run in editor
* "as you type", checker must be really light weight to run in this mode
* "as you type", checker must be really light weight to run in this mode.
* Checker must also must implement IRunnableInEditorChecker if it returns
* true. Checker can return false if check is non-trivial and takes a long
* time.
*
* @return true if need to be run in editor as user types, and false
* otherwise

View file

@ -13,10 +13,13 @@ package org.eclipse.cdt.codan.core.model;
/**
* Interface for checkers that can be run when user is typing, checker has to be
* very quick to run in this mode
* <p>
* <strong>EXPERIMENTAL</strong>. This class or interface has been added as part
* of a work in progress. There is no guarantee that this API will work or that
* it will remain the same.
* </p>
*
* @noextend This interface is not intended to be extended by clients.
* @noimplement This interface is not intended to be implemented by clients.
* Extend AbstractChecker class instead.
*/
public interface IRunnableInEditorChecker {
/**