diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTProblem.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTProblem.java index a497f6cb5ce..c10d71cfbdb 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTProblem.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTProblem.java @@ -14,7 +14,7 @@ package org.eclipse.cdt.core.dom.ast; import org.eclipse.cdt.core.parser.IProblem; /** - * Interface for problems in the ast tree. + * Interface for problems in the AST tree. * @noextend This interface is not intended to be extended by clients. * @noimplement This interface is not intended to be implemented by clients. */ diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTProblemDeclaration.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTProblemDeclaration.java index 2c901f4152f..92cda7fea24 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTProblemDeclaration.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTProblemDeclaration.java @@ -11,14 +11,12 @@ package org.eclipse.cdt.core.dom.ast; /** - * This interface represents a parse problem where we tried to match against a - * declaration. + * This interface represents a parse problem where we tried to match against a declaration. * * @noextend This interface is not intended to be extended by clients. * @noimplement This interface is not intended to be implemented by clients. */ public interface IASTProblemDeclaration extends IASTDeclaration, IASTProblemHolder { - /** * @since 5.1 */ diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTProblemHolder.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTProblemHolder.java index 5b104dc6fb3..f35fdcc5d0d 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTProblemHolder.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTProblemHolder.java @@ -11,8 +11,7 @@ package org.eclipse.cdt.core.dom.ast; /** - * This interface represents a base interface to represent a problem owner or - * holder. + * This interface represents a base interface to represent a problem owner or holder. * * @noextend This interface is not intended to be extended by clients. * @noimplement This interface is not intended to be implemented by clients. @@ -22,7 +21,8 @@ public interface IASTProblemHolder { * PROBLEM represents the relationship between a * IASTProblemHolder and its IASTProblem. */ - public static final ASTNodeProperty PROBLEM = new ASTNodeProperty("IASTProblemHolder.PROBLEM - IASTProblem for IASTProblemHolder"); //$NON-NLS-1$ + public static final ASTNodeProperty PROBLEM = + new ASTNodeProperty("IASTProblemHolder.PROBLEM - IASTProblem for IASTProblemHolder"); //$NON-NLS-1$ /** * Get the problem. diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTProblemStatement.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTProblemStatement.java index 02787b618aa..bb202912d22 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTProblemStatement.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTProblemStatement.java @@ -11,14 +11,12 @@ package org.eclipse.cdt.core.dom.ast; /** - * This interface represents a parse problem where we tried to match against a - * statement. + * This interface represents a parse problem where we tried to match against a statement. * * @noextend This interface is not intended to be extended by clients. * @noimplement This interface is not intended to be implemented by clients. */ public interface IASTProblemStatement extends IASTStatement, IASTProblemHolder { - /** * @since 5.1 */ diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTProblemTypeId.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTProblemTypeId.java index ca49cbb9625..6ca7469f1a6 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTProblemTypeId.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTProblemTypeId.java @@ -11,14 +11,12 @@ package org.eclipse.cdt.core.dom.ast; /** - * This interface represents a parse problem where we tried to match against a - * type-id. + * This interface represents a parse problem where we tried to match against a type-id. * * @noextend This interface is not intended to be extended by clients. * @noimplement This interface is not intended to be implemented by clients. */ public interface IASTProblemTypeId extends IASTTypeId, IASTProblemHolder { - /** * @since 5.1 */ diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/parser/IToken.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/parser/IToken.java index c815aed2a3e..179f45637aa 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/parser/IToken.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/parser/IToken.java @@ -17,7 +17,7 @@ package org.eclipse.cdt.core.parser; * @noimplement This interface is not intended to be implemented by clients. */ public interface IToken { - // getters + // Getters. public int getType(); public String getImage(); public char[] getCharImage(); @@ -220,34 +220,34 @@ public interface IToken { @Deprecated public boolean isOperator(); - /** @deprecated use {@link #tAND} @noreference This field is not intended to be referenced by clients. */ + /** @deprecated Use {@link #tAND}. @noreference This field is not intended to be referenced by clients. */ @Deprecated int t_and = 54; - /** @deprecated use {@link #tAMPERASSIGN} @noreference This field is not intended to be referenced by clients. */ + /** @deprecated Use {@link #tAMPERASSIGN}. @noreference This field is not intended to be referenced by clients. */ @Deprecated int t_and_eq = 55; - /** @deprecated use {@link #tAMPER} @noreference This field is not intended to be referenced by clients. */ + /** @deprecated Use {@link #tAMPER}. @noreference This field is not intended to be referenced by clients. */ @Deprecated int t_bitand = 58; - /** @deprecated use {@link #tBITOR} @noreference This field is not intended to be referenced by clients. */ + /** @deprecated Use {@link #tBITOR}. @noreference This field is not intended to be referenced by clients. */ @Deprecated int t_bitor = 59; - /** @deprecated use {@link #tBITCOMPLEMENT} @noreference This field is not intended to be referenced by clients. */ + /** @deprecated Use {@link #tBITCOMPLEMENT}. @noreference This field is not intended to be referenced by clients. */ @Deprecated int tCOMPL= tBITCOMPLEMENT; - /** @deprecated use {@link #tBITCOMPLEMENT} @noreference This field is not intended to be referenced by clients. */ + /** @deprecated Use {@link #tBITCOMPLEMENT}. @noreference This field is not intended to be referenced by clients. */ @Deprecated int t_compl = 66; - /** @deprecated use {@link #tNOT} @noreference This field is not intended to be referenced by clients. */ + /** @deprecated Use {@link #tNOT}. @noreference This field is not intended to be referenced by clients. */ @Deprecated int t_not = 93; - /** @deprecated use {@link #tNOTEQUAL} @noreference This field is not intended to be referenced by clients. */ + /** @deprecated Use {@link #tNOTEQUAL} @noreference This field is not intended to be referenced by clients. */ @Deprecated int t_not_eq = 94; - /** @deprecated use {@link #tOR} @noreference This field is not intended to be referenced by clients. */ + /** @deprecated Use {@link #tOR} @noreference This field is not intended to be referenced by clients. */ @Deprecated int t_or = 96; - /** @deprecated use {@link #tBITORASSIGN} @noreference This field is not intended to be referenced by clients. */ + /** @deprecated Use {@link #tBITORASSIGN}. @noreference This field is not intended to be referenced by clients. */ @Deprecated int t_or_eq = 97; - /** @deprecated use {@link #tXOR} @noreference This field is not intended to be referenced by clients. */ + /** @deprecated Use {@link #tXOR}. @noreference This field is not intended to be referenced by clients. */ @Deprecated int t_xor = 127; - /** @deprecated use {@link #tXORASSIGN} @noreference This field is not intended to be referenced by clients. */ + /** @deprecated Use {@link #tXORASSIGN}. @noreference This field is not intended to be referenced by clients. */ @Deprecated int t_xor_eq = 128; - /** @deprecated don't use it @noreference This field is not intended to be referenced by clients. */ + /** @deprecated Not used. @noreference This field is not intended to be referenced by clients. */ @Deprecated int tMACROEXP = 138; - /** @deprecated don't use it @noreference This field is not intended to be referenced by clients. */ + /** @deprecated Not used. @noreference This field is not intended to be referenced by clients. */ @Deprecated int tCOMMENT = 142; - /** @deprecated don't use it @noreference This field is not intended to be referenced by clients. */ + /** @deprecated Not used. @noreference This field is not intended to be referenced by clients. */ @Deprecated int tBLOCKCOMMENT = 143; } diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/internal/core/dom/parser/AbstractGNUSourceCodeParser.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/internal/core/dom/parser/AbstractGNUSourceCodeParser.java index fc8f9fdbea3..6181e6fc2d9 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/internal/core/dom/parser/AbstractGNUSourceCodeParser.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/internal/core/dom/parser/AbstractGNUSourceCodeParser.java @@ -1338,11 +1338,11 @@ public abstract class AbstractGNUSourceCodeParser implements ISourceCodeParser { while (true) { final boolean ok= acceptInactiveCodeBoundary(codeBranchNesting); if (!ok) { - // we left to an enclosing code branch. If we started in inactive code, it's time to leave. + // We left to an enclosing code branch. If we started in inactive code, it's time to leave. if (!wasActive) return; - // if we started in active code, we need to skip the outer and therefore unrelated + // If we started in active code, we need to skip the outer and therefore unrelated // inactive branches until we hit active code again. try { skipInactiveCode(); @@ -1351,7 +1351,7 @@ public abstract class AbstractGNUSourceCodeParser implements ISourceCodeParser { } codeBranchNesting= Math.min(getCodeBranchNesting() + 1, codeBranchNesting); - // we could be at the start of inactive code so restart the loop + // We could be at the start of inactive code so restart the loop. continue; } @@ -1366,7 +1366,7 @@ public abstract class AbstractGNUSourceCodeParser implements ISourceCodeParser { final int offset = next.getOffset(); declarationMark= next; - next= null; // don't hold on to the token while parsing namespaces, class bodies, etc. + next= null; // Don't hold on to the token while parsing namespaces, class bodies, etc. try { IASTDeclaration declaration= declaration(options); if (((ASTNode) declaration).getLength() == 0 && LTcatchEOF(1) != IToken.tEOC) {