<code> replaced with {@code}
authorAlexey Kudravtsev <cdr@intellij.com>
Thu, 8 Dec 2016 13:32:15 +0000 (16:32 +0300)
committerAlexey Kudravtsev <cdr@intellij.com>
Thu, 8 Dec 2016 16:42:17 +0000 (19:42 +0300)
347 files changed:
java/compiler/openapi/src/com/intellij/openapi/compiler/JavaSourceTransformingCompiler.java
java/compiler/openapi/src/com/intellij/openapi/compiler/PackagingCompiler.java
java/compiler/openapi/src/com/intellij/openapi/compiler/TranslatingCompiler.java
java/idea-ui/src/com/intellij/ide/util/newProjectWizard/AddModuleWizard.java
java/idea-ui/src/com/intellij/openapi/roots/ui/configuration/projectRoot/ModuleStructureExtension.java
java/idea-ui/src/com/intellij/openapi/roots/ui/configuration/projectRoot/daemon/ProjectStructureValidator.java
java/java-analysis-api/src/com/intellij/codeInspection/BaseJavaLocalInspectionTool.java
java/java-analysis-api/src/com/intellij/codeInspection/reference/RefJavaElement.java
java/java-analysis-api/src/com/intellij/codeInspection/reference/RefMethod.java
java/java-analysis-impl/src/com/intellij/codeInsight/daemon/impl/quickfix/ChangeStringLiteralToCharInMethodCallFix.java
java/java-analysis-impl/src/org/jetbrains/java/generate/config/InsertNewMethodStrategy.java
java/java-analysis-impl/src/org/jetbrains/java/generate/exception/GenerateCodeException.java
java/java-analysis-impl/src/org/jetbrains/java/generate/psi/PsiAdapter.java
java/java-impl/src/com/intellij/codeInsight/editorActions/JavadocTypedHandler.java
java/java-impl/src/com/intellij/codeInsight/editorActions/smartEnter/JavadocFixer.java
java/java-impl/src/com/intellij/codeInsight/editorActions/smartEnter/PlainEnterProcessor.java
java/java-impl/src/com/intellij/codeInsight/generation/surroundWith/SurroundWithUtil.java
java/java-impl/src/com/intellij/codeInsight/intention/impl/AddOnDemandStaticImportAction.java
java/java-impl/src/com/intellij/codeInsight/intention/impl/AddSingleMemberStaticImportAction.java
java/java-impl/src/com/intellij/codeInsight/intention/impl/config/AssignmentTooltipLinkHandler.java
java/java-impl/src/com/intellij/codeInsight/javadoc/DocumentationDelegateProvider.java
java/java-impl/src/com/intellij/codeInsight/javadoc/JavaDocInfoGenerator.java
java/java-impl/src/com/intellij/ide/todo/nodes/TodoPackageNode.java
java/java-impl/src/com/intellij/psi/codeStyle/arrangement/JavaArrangementParseInfo.java
java/java-impl/src/com/intellij/psi/formatter/java/AbstractJavaBlock.java
java/java-impl/src/com/intellij/psi/formatter/java/JavaFormatterUtil.java
java/java-impl/src/com/intellij/psi/formatter/java/JavaSpacePropertyProcessor.java
java/java-impl/src/com/intellij/psi/formatter/java/MultipleFieldDeclarationHelper.java
java/java-impl/src/com/intellij/psi/formatter/java/wrap/JavaWrapManager.java
java/java-impl/src/com/intellij/psi/formatter/java/wrap/ReservedWrapsProvider.java
java/java-impl/src/com/intellij/psi/formatter/java/wrap/impl/JavaChildWrapArranger.java
java/java-impl/src/com/intellij/psi/impl/source/codeStyle/TabPostFormatProcessor.java
java/java-impl/src/com/intellij/psi/impl/source/codeStyle/javadoc/JDParser.java
java/java-impl/src/com/intellij/refactoring/IntroduceHandlerBase.java
java/java-impl/src/com/intellij/refactoring/util/RefactoringUtil.java
java/java-psi-api/src/com/intellij/codeInsight/AnnotationUtil.java
java/java-psi-api/src/com/intellij/psi/JVMElementFactory.java
java/java-psi-api/src/com/intellij/psi/JavaCodeFragment.java
java/java-psi-api/src/com/intellij/psi/JavaCodeFragmentFactory.java
java/java-psi-api/src/com/intellij/psi/PsiArrayAccessExpression.java
java/java-psi-api/src/com/intellij/psi/PsiArrayInitializerMemberValue.java
java/java-psi-api/src/com/intellij/psi/PsiAssertStatement.java
java/java-psi-api/src/com/intellij/psi/PsiAssignmentExpression.java
java/java-psi-api/src/com/intellij/psi/PsiBreakStatement.java
java/java-psi-api/src/com/intellij/psi/PsiCatchSection.java
java/java-psi-api/src/com/intellij/psi/PsiClassObjectAccessExpression.java
java/java-psi-api/src/com/intellij/psi/PsiConditionalExpression.java
java/java-psi-api/src/com/intellij/psi/PsiContinueStatement.java
java/java-psi-api/src/com/intellij/psi/PsiDisjunctionType.java
java/java-psi-api/src/com/intellij/psi/PsiDoWhileStatement.java
java/java-psi-api/src/com/intellij/psi/PsiExpressionListStatement.java
java/java-psi-api/src/com/intellij/psi/PsiField.java
java/java-psi-api/src/com/intellij/psi/PsiForStatement.java
java/java-psi-api/src/com/intellij/psi/PsiForeachStatement.java
java/java-psi-api/src/com/intellij/psi/PsiIfStatement.java
java/java-psi-api/src/com/intellij/psi/PsiImportStatement.java
java/java-psi-api/src/com/intellij/psi/PsiImportStatementBase.java
java/java-psi-api/src/com/intellij/psi/PsiImportStaticReferenceElement.java
java/java-psi-api/src/com/intellij/psi/PsiImportStaticStatement.java
java/java-psi-api/src/com/intellij/psi/PsiInstanceOfExpression.java
java/java-psi-api/src/com/intellij/psi/PsiLocalVariable.java
java/java-psi-api/src/com/intellij/psi/PsiNameHelper.java
java/java-psi-api/src/com/intellij/psi/PsiNewExpression.java
java/java-psi-api/src/com/intellij/psi/PsiPackageStatement.java
java/java-psi-api/src/com/intellij/psi/PsiReferenceExpression.java
java/java-psi-api/src/com/intellij/psi/PsiReferenceList.java
java/java-psi-api/src/com/intellij/psi/PsiReturnStatement.java
java/java-psi-api/src/com/intellij/psi/PsiSubstitutor.java
java/java-psi-api/src/com/intellij/psi/PsiSwitchLabelStatement.java
java/java-psi-api/src/com/intellij/psi/PsiSwitchStatement.java
java/java-psi-api/src/com/intellij/psi/PsiSynchronizedStatement.java
java/java-psi-api/src/com/intellij/psi/PsiThrowStatement.java
java/java-psi-api/src/com/intellij/psi/PsiTryStatement.java
java/java-psi-api/src/com/intellij/psi/PsiType.java
java/java-psi-api/src/com/intellij/psi/PsiTypeCodeFragment.java
java/java-psi-api/src/com/intellij/psi/PsiVariable.java
java/java-psi-api/src/com/intellij/psi/PsiWhileStatement.java
java/java-psi-api/src/com/intellij/psi/PsiWildcardType.java
java/java-psi-api/src/com/intellij/psi/codeStyle/JavaCodeStyleManager.java
java/java-psi-api/src/com/intellij/psi/util/JavaClassSupers.java
java/java-psi-api/src/com/intellij/psi/util/PsiUtil.java
java/java-psi-api/src/com/intellij/psi/util/TypeConversionUtil.java
java/java-psi-impl/src/com/intellij/psi/controlFlow/ControlFlowUtil.java
java/java-psi-impl/src/com/intellij/psi/impl/source/SourceJavaCodeReference.java
java/java-psi-impl/src/com/intellij/psi/impl/source/tree/java/ParameterListElement.java
java/openapi/src/com/intellij/refactoring/JavaRefactoringActionHandlerFactory.java
java/openapi/src/com/intellij/refactoring/JavaRefactoringFactory.java
java/openapi/src/com/intellij/refactoring/MoveDestination.java
json/src/com/intellij/json/surroundWith/JsonWithObjectLiteralSurrounder.java
platform/analysis-api/src/com/intellij/codeInsight/daemon/EmptyResolveMessageProvider.java
platform/analysis-api/src/com/intellij/codeInsight/intention/IntentionManager.java
platform/analysis-api/src/com/intellij/codeInspection/CommonProblemDescriptor.java
platform/analysis-api/src/com/intellij/codeInspection/InspectionManager.java
platform/analysis-api/src/com/intellij/codeInspection/LocalInspectionTool.java
platform/analysis-api/src/com/intellij/codeInspection/reference/RefGraphAnnotator.java
platform/analysis-api/src/com/intellij/codeInspection/reference/RefManager.java
platform/analysis-api/src/com/intellij/lang/annotation/Annotation.java
platform/annotations/common/src/org/intellij/lang/annotations/Flow.java
platform/annotations/common/src/org/jetbrains/annotations/Contract.java
platform/annotations/common/src/org/jetbrains/annotations/NonNls.java
platform/annotations/java5/src/org/jetbrains/annotations/NotNull.java
platform/annotations/java8/src/org/jetbrains/annotations/NotNull.java
platform/core-api/src/com/intellij/lang/ASTNode.java
platform/core-api/src/com/intellij/lang/Language.java
platform/core-api/src/com/intellij/lang/PsiBuilder.java
platform/core-api/src/com/intellij/lang/WhitespacesAndCommentsBinder.java
platform/core-api/src/com/intellij/lexer/Lexer.java
platform/core-api/src/com/intellij/openapi/components/ApplicationComponent.java
platform/core-api/src/com/intellij/openapi/components/ComponentManager.java
platform/core-api/src/com/intellij/openapi/components/PersistentStateComponent.java
platform/core-api/src/com/intellij/openapi/components/ProjectComponent.java
platform/core-api/src/com/intellij/openapi/editor/colors/TextAttributesKey.java
platform/core-api/src/com/intellij/openapi/fileEditor/FileDocumentManager.java
platform/core-api/src/com/intellij/openapi/module/Module.java
platform/core-api/src/com/intellij/openapi/project/Project.java
platform/core-api/src/com/intellij/openapi/roots/FileIndexFacade.java
platform/core-api/src/com/intellij/openapi/vfs/VfsUtilCore.java
platform/core-api/src/com/intellij/pom/Navigatable.java
platform/core-api/src/com/intellij/psi/ExternallyDefinedPsiElement.java
platform/core-api/src/com/intellij/psi/FileViewProvider.java
platform/core-api/src/com/intellij/psi/PsiDocumentManager.java
platform/core-api/src/com/intellij/psi/PsiElement.java
platform/core-api/src/com/intellij/psi/PsiFile.java
platform/core-api/src/com/intellij/psi/PsiManager.java
platform/core-api/src/com/intellij/psi/PsiNamedElement.java
platform/core-api/src/com/intellij/psi/SmartPointerManager.java
platform/core-api/src/com/intellij/psi/codeStyle/CodeStyleManager.java
platform/core-api/src/com/intellij/ui/SimpleTextAttributes.java
platform/core-api/src/com/intellij/util/Query.java
platform/core-api/src/net/sf/cglib/core/AbstractClassGenerator.java
platform/core-impl/src/com/intellij/indentation/OperationParserHelper.java
platform/core-impl/src/com/intellij/openapi/editor/ex/DocumentEx.java
platform/core-impl/src/com/intellij/openapi/editor/ex/util/SegmentArray.java
platform/core-impl/src/com/intellij/openapi/editor/ex/util/SegmentArrayWithData.java
platform/core-impl/src/com/intellij/openapi/editor/impl/BulkChangesMerger.java
platform/core-impl/src/com/intellij/openapi/editor/impl/PersistentRangeMarkerUtil.java
platform/core-impl/src/com/intellij/openapi/editor/impl/TextChangeImpl.java
platform/core-impl/src/com/intellij/openapi/editor/impl/TextChangesStorage.java
platform/core-impl/src/com/intellij/psi/impl/source/codeStyle/CodeEditUtil.java
platform/core-impl/src/com/intellij/psi/impl/source/resolve/reference/impl/providers/FileReferenceUtil.java
platform/core-impl/src/com/intellij/util/DocumentUtil.java
platform/diff-api/src/com/intellij/ide/diff/DiffElement.java
platform/editor-ui-ex/src/com/intellij/ide/todo/TodoConfiguration.java
platform/indexing-api/src/com/intellij/psi/search/IndexPatternProvider.java
platform/indexing-api/src/com/intellij/psi/search/RequestResultProcessor.java
platform/lang-api/src/com/intellij/codeInsight/daemon/impl/analysis/DefaultHighlightingSettingProvider.java
platform/lang-api/src/com/intellij/codeInsight/editorActions/moveUpDown/StatementUpDownMover.java
platform/lang-api/src/com/intellij/execution/BeforeRunTaskProvider.java
platform/lang-api/src/com/intellij/execution/RunManager.java
platform/lang-api/src/com/intellij/execution/actions/ConsoleActionsPostProcessor.java
platform/lang-api/src/com/intellij/execution/configurations/ConfigurationTemplate.java
platform/lang-api/src/com/intellij/facet/FacetModel.java
platform/lang-api/src/com/intellij/facet/FacetType.java
platform/lang-api/src/com/intellij/facet/autodetecting/FacetDetector.java
platform/lang-api/src/com/intellij/facet/ui/MultipleFacetEditorHelper.java
platform/lang-api/src/com/intellij/formatting/Alignment.java
platform/lang-api/src/com/intellij/formatting/AlignmentFactory.java
platform/lang-api/src/com/intellij/formatting/Block.java
platform/lang-api/src/com/intellij/formatting/CustomFormattingModelBuilder.java
platform/lang-api/src/com/intellij/formatting/DependentSpacingRule.java
platform/lang-api/src/com/intellij/formatting/FormattingDocumentModel.java
platform/lang-api/src/com/intellij/formatting/FormattingModelWithShiftIndentInsideDocumentRange.java
platform/lang-api/src/com/intellij/formatting/Indent.java
platform/lang-api/src/com/intellij/formatting/Spacing.java
platform/lang-api/src/com/intellij/formatting/SpacingBuilder.java
platform/lang-api/src/com/intellij/formatting/Wrap.java
platform/lang-api/src/com/intellij/ide/favoritesTreeView/FavoriteNodeProvider.java
platform/lang-api/src/com/intellij/ide/util/projectWizard/ProjectBuilder.java
platform/lang-api/src/com/intellij/lang/ImportOptimizer.java
platform/lang-api/src/com/intellij/lang/PairedBraceMatcher.java
platform/lang-api/src/com/intellij/lang/documentation/CodeDocumentationProvider.java
platform/lang-api/src/com/intellij/lang/documentation/DocumentationProvider.java
platform/lang-api/src/com/intellij/lang/refactoring/InlineHandler.java
platform/lang-api/src/com/intellij/openapi/editor/PsiAwareLineWrapPositionStrategy.java
platform/lang-api/src/com/intellij/openapi/options/colors/ColorSettingsPage.java
platform/lang-api/src/com/intellij/psi/InjectedLanguagePlaces.java
platform/lang-api/src/com/intellij/psi/LanguageInjector.java
platform/lang-api/src/com/intellij/psi/codeStyle/CodeStyleSettings.java
platform/lang-api/src/com/intellij/psi/codeStyle/CodeStyleSettingsCustomizable.java
platform/lang-api/src/com/intellij/psi/codeStyle/CodeStyleSettingsManager.java
platform/lang-api/src/com/intellij/psi/codeStyle/CodeStyleSettingsProvider.java
platform/lang-api/src/com/intellij/psi/codeStyle/CommonCodeStyleSettings.java
platform/lang-api/src/com/intellij/psi/codeStyle/CommonCodeStyleSettingsManager.java
platform/lang-api/src/com/intellij/psi/codeStyle/FileIndentOptionsProvider.java
platform/lang-api/src/com/intellij/psi/codeStyle/FileTypeIndentOptionsProvider.java
platform/lang-api/src/com/intellij/psi/codeStyle/LanguageCodeStyleSettingsProvider.java
platform/lang-api/src/com/intellij/psi/codeStyle/arrangement/ArrangementEntry.java
platform/lang-api/src/com/intellij/psi/codeStyle/arrangement/ArrangementSettingsSerializer.java
platform/lang-api/src/com/intellij/psi/codeStyle/arrangement/ArrangementUtil.java
platform/lang-api/src/com/intellij/psi/codeStyle/arrangement/Rearranger.java
platform/lang-api/src/com/intellij/psi/codeStyle/arrangement/match/ArrangementEntryMatcher.java
platform/lang-api/src/com/intellij/psi/codeStyle/arrangement/std/ArrangementStandardSettingsAware.java
platform/lang-api/src/com/intellij/psi/codeStyle/arrangement/std/ArrangementUiComponent.java
platform/lang-api/src/com/intellij/psi/codeStyle/arrangement/std/CompositeArrangementSettingsToken.java
platform/lang-api/src/com/intellij/psi/util/PsiUtilBase.java
platform/lang-api/src/com/intellij/refactoring/Refactoring.java
platform/lang-api/src/com/intellij/refactoring/RefactoringActionHandler.java
platform/lang-api/src/com/intellij/refactoring/listeners/RefactoringListenerManager.java
platform/lang-impl/src/com/intellij/application/options/CodeStyleAbstractPanel.java
platform/lang-impl/src/com/intellij/application/options/codeStyle/RightMarginForm.java
platform/lang-impl/src/com/intellij/application/options/codeStyle/arrangement/match/ArrangementMatchingRuleEditor.java
platform/lang-impl/src/com/intellij/codeInsight/actions/MultiCaretCodeInsightAction.java
platform/lang-impl/src/com/intellij/codeInsight/actions/MultiCaretCodeInsightActionHandler.java
platform/lang-impl/src/com/intellij/codeInsight/documentation/AbstractExternalFilter.java
platform/lang-impl/src/com/intellij/codeInsight/documentation/DocumentationManager.java
platform/lang-impl/src/com/intellij/codeInsight/documentation/QuickDocUtil.java
platform/lang-impl/src/com/intellij/codeInsight/editorActions/AutoHardWrapHandler.java
platform/lang-impl/src/com/intellij/codeInsight/editorActions/CopyPastePreProcessor.java
platform/lang-impl/src/com/intellij/codeInsight/editorActions/EnterHandler.java
platform/lang-impl/src/com/intellij/codeInsight/editorActions/PasteHandler.java
platform/lang-impl/src/com/intellij/codeInsight/editorActions/emacs/EmacsProcessingHandler.java
platform/lang-impl/src/com/intellij/codeInsight/editorActions/enter/EnterAfterJavadocTagHandler.java
platform/lang-impl/src/com/intellij/codeInsight/editorActions/enter/EnterAfterUnmatchedBraceHandler.java
platform/lang-impl/src/com/intellij/codeInsight/editorActions/moveUpDown/MoverWrapper.java
platform/lang-impl/src/com/intellij/codeInsight/folding/impl/FoldingPolicy.java
platform/lang-impl/src/com/intellij/codeInsight/folding/impl/PsiNamesElementSignatureProvider.java
platform/lang-impl/src/com/intellij/codeInsight/highlighting/BraceMatcherTerminationAspect.java
platform/lang-impl/src/com/intellij/codeInsight/hint/InspectionDescriptionLinkHandler.java
platform/lang-impl/src/com/intellij/codeInsight/hint/NavigationLinkHandler.java
platform/lang-impl/src/com/intellij/codeInsight/navigation/DocPreviewUtil.java
platform/lang-impl/src/com/intellij/find/FindUtil.java
platform/lang-impl/src/com/intellij/formatting/AbstractBlockAlignmentProcessor.java
platform/lang-impl/src/com/intellij/formatting/AbstractBlockWrapper.java
platform/lang-impl/src/com/intellij/formatting/AlignmentImpl.java
platform/lang-impl/src/com/intellij/formatting/CompositeBlockWrapper.java
platform/lang-impl/src/com/intellij/formatting/CoreFormatterUtil.java
platform/lang-impl/src/com/intellij/formatting/DependantSpacingImpl.java
platform/lang-impl/src/com/intellij/formatting/FormattingProgressCallback.java
platform/lang-impl/src/com/intellij/formatting/FormattingStateId.java
platform/lang-impl/src/com/intellij/formatting/IndentImpl.java
platform/lang-impl/src/com/intellij/formatting/SpacingImpl.java
platform/lang-impl/src/com/intellij/formatting/WhiteSpace.java
platform/lang-impl/src/com/intellij/formatting/WrapImpl.java
platform/lang-impl/src/com/intellij/formatting/alignment/AlignmentInColumnsConfig.java
platform/lang-impl/src/com/intellij/formatting/alignment/AlignmentInColumnsHelper.java
platform/lang-impl/src/com/intellij/formatting/alignment/AlignmentStrategy.java
platform/lang-impl/src/com/intellij/formatting/engine/ApplyChangesState.java
platform/lang-impl/src/com/intellij/formatting/engine/DependentSpacingEngine.java
platform/lang-impl/src/com/intellij/formatting/engine/WrapProcessor.java
platform/lang-impl/src/com/intellij/ide/actions/TemplateKindCombo.java
platform/lang-impl/src/com/intellij/ide/impl/PatchProjectUtil.java
platform/lang-impl/src/com/intellij/ide/macro/MacroManager.java
platform/lang-impl/src/com/intellij/ide/navigationToolbar/ui/NavBarUI.java
platform/lang-impl/src/com/intellij/ide/projectView/impl/NestingTreeStructureProvider.java
platform/lang-impl/src/com/intellij/ide/projectView/impl/nodes/PsiFileSystemItemFilter.java
platform/lang-impl/src/com/intellij/ide/todo/CurrentFileTodosTreeStructure.java
platform/lang-impl/src/com/intellij/ide/todo/FileTree.java
platform/lang-impl/src/com/intellij/ide/todo/SetTodoFilterAction.java
platform/lang-impl/src/com/intellij/ide/todo/TodoPanel.java
platform/lang-impl/src/com/intellij/ide/todo/TodoTreeBuilder.java
platform/lang-impl/src/com/intellij/ide/todo/TodoTreeStructure.java
platform/lang-impl/src/com/intellij/ide/todo/configurable/FilterDialog.java
platform/lang-impl/src/com/intellij/injected/editor/RangeMarkerWindow.java
platform/lang-impl/src/com/intellij/psi/codeStyle/arrangement/MemberOrderService.java
platform/lang-impl/src/com/intellij/psi/codeStyle/arrangement/engine/ArrangementEngine.java
platform/lang-impl/src/com/intellij/psi/formatter/FormatterUtil.java
platform/lang-impl/src/com/intellij/psi/formatter/StaticSymbolWhiteSpaceDefinitionStrategy.java
platform/lang-impl/src/com/intellij/psi/formatter/WhiteSpaceFormattingStrategy.java
platform/lang-impl/src/com/intellij/psi/impl/include/FileIncludeProvider.java
platform/lang-impl/src/com/intellij/psi/impl/source/codeStyle/CodeFormatterFacade.java
platform/lang-impl/src/com/intellij/psi/impl/source/codeStyle/CodeStyleManagerImpl.java
platform/lang-impl/src/com/intellij/psi/impl/source/tree/injected/InjectedLanguageUtil.java
platform/lang-impl/src/com/intellij/refactoring/introduceParameterObject/IntroduceParameterObjectClassDescriptor.java
platform/lang-impl/src/com/intellij/refactoring/introduceParameterObject/IntroduceParameterObjectDelegate.java
platform/lang-impl/src/com/intellij/refactoring/memberPushDown/PushDownDelegate.java
platform/lang-impl/src/com/intellij/refactoring/move/moveFilesOrDirectories/MoveFilesOrDirectoriesUtil.java
platform/lang-impl/src/com/intellij/refactoring/rename/naming/NameSuggester.java
platform/lang-impl/src/com/intellij/ui/EditorTextFieldActionPromoter.java
platform/util-rt/src/com/intellij/execution/rmi/ssl/PrivateKeyReader.java
platform/util-rt/src/com/intellij/openapi/util/text/StringUtilRt.java
platform/util-rt/src/com/intellij/util/ArrayUtilRt.java
platform/util/src/com/intellij/AbstractBundle.java
platform/util/src/com/intellij/openapi/ui/Splittable.java
platform/util/src/com/intellij/openapi/ui/Splitter.java
platform/util/src/com/intellij/openapi/util/Key.java
platform/util/src/com/intellij/openapi/util/RecursionGuard.java
platform/util/src/com/intellij/openapi/util/TextRange.java
platform/util/src/com/intellij/openapi/vfs/CharsetToolkit.java
platform/util/src/com/intellij/openapi/wm/FocusWatcher.java
platform/util/src/com/intellij/ui/ColorUtil.java
platform/util/src/com/intellij/util/containers/ByteArrayList.java
platform/util/src/com/intellij/util/containers/FList.java
platform/util/src/com/intellij/util/containers/JBIterable.java
platform/util/src/com/intellij/util/execution/ParametersListUtil.java
platform/util/src/com/intellij/util/io/zip/JBZipEntry.java
platform/util/src/com/intellij/util/io/zip/JBZipFile.java
platform/util/src/com/intellij/util/io/zip/JBZipOutputStream.java
platform/util/src/com/intellij/util/messages/MessageBus.java
platform/util/src/com/intellij/util/messages/Topic.java
platform/util/src/com/intellij/util/ui/JBInsets.java
platform/util/src/com/intellij/util/ui/WavePainter.java
platform/util/src/com/intellij/util/ui/tree/WideSelectionTreeUI.java
platform/vcs-api/src/com/intellij/openapi/vcs/AbstractVcs.java
platform/vcs-api/src/com/intellij/openapi/vcs/annotate/LineAnnotationAspect.java
platform/vcs-api/src/com/intellij/openapi/vcs/rollback/RollbackProgressListener.java
platform/vcs-api/src/com/intellij/openapi/vcs/ui/Refreshable.java
platform/vcs-api/src/com/intellij/vcsUtil/VcsUtil.java
platform/vcs-impl/src/com/intellij/openapi/vcs/actions/ShowMessageHistoryAction.java
platform/vcs-impl/src/com/intellij/vcsUtil/VcsImplUtil.java
plugins/InspectionGadgets/InspectionGadgetsAnalysis/src/com/siyeh/ig/controlflow/PointlessNullCheckInspection.java
plugins/InspectionGadgets/InspectionGadgetsAnalysis/src/com/siyeh/ig/portability/HardcodedFileSeparatorsInspection.java
plugins/InspectionGadgets/InspectionGadgetsAnalysis/src/com/siyeh/ig/psiutils/CommentTracker.java
plugins/IntelliLang/java-support/org/intellij/plugins/intelliLang/util/AnnotationUtilEx.java
plugins/IntelliLang/src/org/intellij/plugins/intelliLang/inject/config/BaseInjection.java
plugins/cvs/cvs-core/src/com/intellij/cvsSupport2/connections/login/CvsLoginWorker.java
plugins/devkit/src/testAssistant/TestDataGuessByExistingFilesUtil.java
plugins/generate-tostring/src/org/jetbrains/java/generate/GenerateToStringAction.java
plugins/generate-tostring/src/org/jetbrains/java/generate/GenerateToStringWorker.java
plugins/generate-tostring/src/org/jetbrains/java/generate/GenerationUtil.java
plugins/generate-tostring/src/org/jetbrains/java/generate/config/DuplicatePolicy.java
plugins/generate-tostring/src/org/jetbrains/java/generate/config/ReplacePolicy.java
plugins/generate-tostring/src/org/jetbrains/java/generate/element/Element.java
plugins/generate-tostring/src/org/jetbrains/java/generate/template/TemplateResource.java
plugins/generate-tostring/src/org/jetbrains/java/generate/view/MethodExistsDialog.java
plugins/javaFX/src/org/jetbrains/plugins/javaFX/fxml/codeInsight/inspections/JavaFxRedundantPropertyValueInspection.java
plugins/maven/src/main/java/org/jetbrains/idea/maven/services/nexus/Repositories.java
plugins/maven/src/main/java/org/jetbrains/idea/maven/services/nexus/SearchResult.java
plugins/maven/src/main/java/org/jetbrains/idea/maven/services/nexus/SearchResults.java
plugins/properties/src/com/intellij/lang/properties/editor/ResourceBundleUtil.java
plugins/ui-designer-core/src/com/intellij/designer/inspection/AbstractQuickFixManager.java
python/psi-api/src/com/jetbrains/python/psi/FutureFeature.java
python/psi-api/src/com/jetbrains/python/psi/PyDecorator.java
python/psi-api/src/com/jetbrains/python/psi/PyForPart.java
python/psi-api/src/com/jetbrains/python/psi/PyFunction.java
python/psi-api/src/com/jetbrains/python/psi/PyStringLiteralExpression.java
python/psi-api/src/com/jetbrains/python/psi/PySubscriptionExpression.java
python/src/com/jetbrains/python/buildout/BuildoutFacet.java
python/src/com/jetbrains/python/codeInsight/intentions/ConvertFormatOperatorToMethodIntention.java
python/src/com/jetbrains/python/documentation/docstrings/GoogleCodeStyleDocString.java
python/src/com/jetbrains/python/documentation/docstrings/SectionBasedDocString.java
python/src/com/jetbrains/python/editor/PyEmacsHandler.java
python/src/com/jetbrains/python/formatter/PyWhiteSpaceFormattingStrategy.java
python/src/com/jetbrains/python/inspections/PyAssignmentToLoopOrWithParameterInspection.java
python/src/com/jetbrains/python/inspections/PyCallByClassInspection.java
python/src/com/jetbrains/python/psi/PyUtil.java
python/src/com/jetbrains/python/psi/impl/references/PyReferenceImpl.java
python/src/com/jetbrains/python/refactoring/move/moduleMembers/PyMoveSymbolProcessor.java
xml/dom-openapi/src/com/intellij/util/xml/CustomReferenceConverter.java
xml/dom-openapi/src/com/intellij/util/xml/DomElementVisitor.java
xml/dom-openapi/src/com/intellij/util/xml/DomFileDescription.java
xml/impl/src/com/intellij/psi/formatter/xml/XmlFormattingPolicy.java
xml/xml-psi-api/src/com/intellij/psi/XmlElementFactory.java
xml/xml-psi-api/src/com/intellij/psi/xml/XmlAttribute.java
xml/xml-psi-api/src/com/intellij/psi/xml/XmlTag.java
xml/xml-psi-api/src/com/intellij/xml/XmlSchemaProvider.java
xml/xml-psi-impl/src/com/intellij/lang/HtmlScriptContentProvider.java
xml/xml-psi-impl/src/com/intellij/psi/impl/source/html/HtmlConditionalCommentInjector.java

index 5328a1336f93196b16431ab2cb3b62c7b82ec630..2bd50e36344846a33501e7762d386e1f50325561 100644 (file)
@@ -44,11 +44,11 @@ public interface JavaSourceTransformingCompiler extends Compiler {
    * @param originalFile an original file. Since the copy that is supposed to be modified is located outside the project, it is not possible to use PSI for analysis.
    *                     So the original file is provided. Note that it is passed for reference purposes only. It MUST NOT be transformed or changed in any way.
    *                     For example, it is possible to obtain a PsiFile for the original file:<br><br>
-   *                     <code>PsiJavaFile originalPsiJavaFile = (PsiJavaFile)PsiManager.getInstance(project).findFile(originalFile)</code>;<br><br>
+   *                     {@code PsiJavaFile originalPsiJavaFile = (PsiJavaFile)PsiManager.getInstance(project).findFile(originalFile)};<br><br>
    *                     The obtained originalPsiJavaFile can be analysed, searched etc. For transforming the file by the means of PSI, there should be created a copy of the originalPsiJavaFile:<br><br>
-   *                     <code>PsiJavaFile psiFileCopy = (PsiJavaFile)originalPsiJavaFile.copy();</code><br><br>
+   *                     {@code PsiJavaFile psiFileCopy = (PsiJavaFile)originalPsiJavaFile.copy();}<br><br>
    *                     The psiFileCopy can then be transformed, and its text saved to the first "file" argument:<br><br>
-   *                     <code>String text = psiFileCopy.getText();</code><br><br>
+   *                     {@code String text = psiFileCopy.getText();}<br><br>
    *                     <p/>
    *                     <b>Note that transforming files by the means of PSI may considerably slow down the overall make performance.</b>
    * @return true if transform succeeded, false otherwise.
index c4dd497dd2a584f0849933365f87583bef546f72..3b27fe5aaf0ab31289f018adbeba4910b73ff669 100644 (file)
@@ -36,7 +36,7 @@ public interface PackagingCompiler extends FileProcessingCompiler{
    *
    * @param context the current compile context.
    * @param url     the URL of a file in the output directory which will be recompiled.
-   * @param state   the validity state of the file specified by <code>url</code>.
+   * @param state   the validity state of the file specified by {@code url}.
    */
   void processOutdatedItem(CompileContext context, String url, @Nullable ValidityState state);
 }
index 75f9c0d6ed98051aab694f7c15b4c1206a36b1ba..a3a4631b297a9746dd220296db74f38bccb78b4d 100644 (file)
@@ -68,7 +68,7 @@ public interface TranslatingCompiler extends Compiler {
    *
    * @param file    the file to check.
    * @param context the context for the current compile operation.
-   * @return true if can compile the file, false otherwise. If the method returns false, <code>file</code>
+   * @return true if can compile the file, false otherwise. If the method returns false, {@code file}
    *         will not be included in the list of files passed to {@link #compile(CompileContext,Chunk<Module>,com.intellij.openapi.vfs.VirtualFile[], com.intellij.openapi.compiler.TranslatingCompiler.OutputSink)}.
    */
   boolean isCompilableFile(VirtualFile file, CompileContext context);
index 5a97a87f50714e32854d12cb2df63dab54a9cc45..3917e2d7499915bf37f1cc3f5c6c99f5a43346f6 100644 (file)
@@ -139,8 +139,8 @@ public class AddModuleWizard extends AbstractProjectWizard {
    * Allows to ask current wizard to move to the desired step.
    *
    * @param filter  closure that allows to indicate target step - is called with each of registered steps and is expected
-   *                to return <code>true</code> for the step to go to
-   * @return        <code>true</code> if current wizard is navigated to the target step; <code>false</code> otherwise
+   *                to return {@code true} for the step to go to
+   * @return        {@code true} if current wizard is navigated to the target step; {@code false} otherwise
    */
   public boolean navigateToStep(@NotNull Function<Step, Boolean> filter) {
     for (int i = 0, myStepsSize = mySteps.size(); i < myStepsSize; i++) {
index e0ed358b5c02e070a979b1317105e3e84e27eb07..73a2807dcbe9296b84f82629c7f244ee22113c2c 100644 (file)
@@ -73,7 +73,7 @@ public abstract class ModuleStructureExtension {
   }
 
   /**
-   * @return callback or <code>null</code> if not handled
+   * @return callback or {@code null} if not handled
    */
   @Nullable
   public ActionCallback selectOrderEntry(@NotNull final Module module, @Nullable final OrderEntry entry) {
index e648b6c0891c78c1b5be83bd10eea81f4e50a580..6b086b8b8a0d9acb6cfb07bd98ee5a548e639fe0 100644 (file)
@@ -79,7 +79,7 @@ public abstract class ProjectStructureValidator {
   }
 
   /**
-   * @return <code>true</code> if handled
+   * @return {@code true} if handled
    */
   protected boolean addLibraryToDependencies(final Library library, final Project project, final boolean allowEmptySelection) {
     return false;
@@ -87,14 +87,14 @@ public abstract class ProjectStructureValidator {
 
 
   /**
-   * @return <code>true</code> if it handled this element
+   * @return {@code true} if it handled this element
    */
   protected boolean checkElement(ProjectStructureElement element, ProjectStructureProblemsHolder problemsHolder) {
     return false;
   }
 
   /**
-   * @return list of usages or <code>null</code> when it does not handle such element
+   * @return list of usages or {@code null} when it does not handle such element
    */
   @Nullable
   protected List<ProjectStructureElementUsage> getUsagesIn(final ProjectStructureElement element) {
index d9652146aaaf1272797bb705f3f0d3c37f0ce3e7..817697d4f6e924666f8433b7cccf39b117a383e0 100644 (file)
@@ -21,9 +21,9 @@ import org.jetbrains.annotations.NotNull;
 
 /**
  * Implement this abstract class in order to provide new inspection tool functionality. The major API limitation here is
- * subclasses should be stateless. Thus <code>check&lt;XXX&gt;</code> methods will be called in no particular order and
+ * subclasses should be stateless. Thus {@code check<XXX>} methods will be called in no particular order and
  * instances of this class provided by {@link InspectionToolProvider#getInspectionClasses()} will be created on demand.
- * The other important thing is problem anchors (PsiElements) reported by <code>check&lt;XXX&gt;</code> methods should
+ * The other important thing is problem anchors (PsiElements) reported by {@code check<XXX>} methods should
  * lie under corresponding first parameter of one method.
  *
  * @see GlobalInspectionTool
index 7513a2c868b4e01a9fc51b65a01f852c86bc455c..7a5360132b069eac8f13a280442bb877787766a1 100644 (file)
@@ -36,14 +36,14 @@ public interface RefJavaElement extends RefElement {
 
 
   /**
-   * Checks if the element is <code>final</code>.
+   * Checks if the element is {@code final}.
    *
    * @return true if the element is final, false otherwise.
    */
   boolean isFinal();
 
   /**
-   * Checks if the element is <code>static</code>.
+   * Checks if the element is {@code static}.
    *
    * @return true if the element is static, false otherwise.
    */
index 6d082c3020a8939a4f68e7d21ef395db859223ac..20507f2e975c4400846e1f56e6253568342812ca 100644 (file)
@@ -78,8 +78,8 @@ public interface RefMethod extends RefJavaElement {
   boolean isTestMethod();
 
   /**
-   * Checks if the signature of the method matches the signature of the standard <code>main</code>
-   * or <code>premain</code> method.
+   * Checks if the signature of the method matches the signature of the standard {@code main}
+   * or {@code premain} method.
    *
    * @return true if the method can be a main function of the application, false otherwise.
    */
@@ -130,7 +130,7 @@ public interface RefMethod extends RefJavaElement {
   @Nullable String getReturnValueIfSame();
 
   /**
-   * Returns the list of exceptions which are included in the <code>throws</code> list
+   * Returns the list of exceptions which are included in the {@code throws} list
    * of the method but cannot be actually thrown.
    *
    * @return the list of exceptions declared but not thrown, or null if there are no
index 05c04be72875086da6f0a9682599cf86de452cc6..fda9898d7b80e570c89554c0e858f4ef2d96c14f 100644 (file)
@@ -134,7 +134,7 @@ public class ChangeStringLiteralToCharInMethodCallFix implements IntentionAction
   }
 
   /**
-   * @return <code>true</code> if exact TYPEs match
+   * @return {@code true} if exact TYPEs match
    */
   private static boolean findMatchingExpressions(final PsiExpression[] arguments, final PsiMethod existingMethod,
                                                                    final Set<PsiLiteralExpression> result) {
index be9bc241775bd0fbe118f55c5c9d7623c91e52e8..e6d62cadd70bd1ff031ebb3d172fe17eba59da1d 100644 (file)
@@ -22,7 +22,7 @@ import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
 /**
- * Interface that defines a policy for dealing with where to insert a new <code>toString()</code>
+ * Interface that defines a policy for dealing with where to insert a new {@code toString()}
  * method in the javafile.
  */
 public interface InsertNewMethodStrategy {
index 8081574e9811d14803646588bb72dc43eb3f4591..7c4be089580038f916df7512f7ac4221dfd971e9 100644 (file)
@@ -16,7 +16,7 @@
 package org.jetbrains.java.generate.exception;
 
 /**
- * Error generating the javacode for the <code>toString</code> method.
+ * Error generating the javacode for the {@code toString} method.
  * <p/>
  * This exception is usually caused by a Velocity parsing exception.
  */
index c07684795c6413769cd45d36caba792c2ae67e07..f4b3ddbfe2050b87f1cab8186037f5b91cc131f2 100644 (file)
@@ -46,7 +46,7 @@ public class PsiAdapter {
      * Returns true if a field is constant.
      * <p/>
      * This is identified as the name of the field is only in uppercase and it has
-     * a <code>static</code> modifier.
+     * a {@code static} modifier.
      *
      * @param field field to check if it's a constant
      * @return true if constant.
@@ -452,8 +452,8 @@ public class PsiAdapter {
     /**
      * Is the method a getter method?
      * <p/>
-     * The name of the method must start with <code>get</code> or <code>is</code>.
-     * And if the method is a <code>isXXX</code> then the method must return a java.lang.Boolean or boolean.
+     * The name of the method must start with {@code get} or {@code is}.
+     * And if the method is a {@code isXXX} then the method must return a java.lang.Boolean or boolean.
      *
      *
      * @param method  the method
@@ -477,7 +477,7 @@ public class PsiAdapter {
      * The method must be a getter method for a field.
      * Returns null if this method is not a getter.
      * <p/>
-     * The fieldname is the part of the name that is after the <code>get</code> or <code>is</code> part
+     * The fieldname is the part of the name that is after the {@code get} or {@code is} part
      * of the name.
      * <p/>
      * Example: methodName=getName will return fieldname=name
index 7fa23493a074e44980e2537fdb338f3ce142d9d9..992170fd14efeec00b6824d4e73269044d08d6cd 100644 (file)
@@ -62,7 +62,7 @@ public class JavadocTypedHandler extends TypedHandlerDelegate {
    * @param project   current project
    * @param editor    current editor
    * @param file      current file
-   * @return          <code>true</code> if closing tag is inserted; <code>false</code> otherwise
+   * @return          {@code true} if closing tag is inserted; {@code false} otherwise
    */
   private static boolean insertClosingTagIfNecessary(char c, @NotNull Project project, @NotNull Editor editor, @NotNull PsiFile file) {
     if (c != CLOSE_TAG_SYMBOL || !CodeInsightSettings.getInstance().JAVADOC_GENERATE_CLOSING_TAG || !(file instanceof PsiJavaFile)) {
@@ -89,9 +89,9 @@ public class JavadocTypedHandler extends TypedHandlerDelegate {
   }
 
   /**
-   * Tries to derive start tag name assuming that given offset points to position just after <code>'>'</code> symbol.
+   * Tries to derive start tag name assuming that given offset points to position just after {@code '>'} symbol.
    * <p/>
-   * Is expected to return <code>null</code> when offset is not located just after start tag, e.g. the following situations:
+   * Is expected to return {@code null} when offset is not located just after start tag, e.g. the following situations:
    * <pre>
    * <ul>
    *   <li>standalone {@code '>'} symbol (surrounded by white spaces);</li>
@@ -102,7 +102,7 @@ public class JavadocTypedHandler extends TypedHandlerDelegate {
    * 
    * @param text            target text
    * @param afterTagOffset  offset that points after 
-   * @return                tag name if the one is parsed; <code>null</code> otherwise
+   * @return                tag name if the one is parsed; {@code null} otherwise
    */
   @Nullable
   static String getTagName(@NotNull CharSequence text, int afterTagOffset) {
index c42ae65171fd71374c7f3126f371774c2b372946..bb9fb1e165655abbd49fa6e5054cabc582b763f7 100644 (file)
@@ -31,7 +31,7 @@ public class JavadocFixer {
    * 
    * @param editor   target editor
    * @param psiFile  PSI file for the document exposed via the given editor
-   * @return  <code>true</code> if smart completion was performed; <code>false</code> otherwise
+   * @return  {@code true} if smart completion was performed; {@code false} otherwise
    */
   public boolean process(@NotNull Editor editor, @NotNull PsiFile psiFile) {
     // Check parameter description completion.
index c32cbf32875f522f93cd7ff6cfb3a2cd69251735..0c9fc16a855013356ae241eee4a9cc4275288dc0 100644 (file)
@@ -144,9 +144,9 @@ public class PlainEnterProcessor implements EnterProcessor {
    * @param editor      target editor
    * @param codeBlock   target code block to which new empty line is going to be inserted
    * @param element     target element under caret
-   * @return            <code>true</code> if it was found out that the given code block starts with the empty line and caret
+   * @return            {@code true} if it was found out that the given code block starts with the empty line and caret
    *                    is pointed to correct position there, i.e. no additional processing is required;
-   *                    <code>false</code> otherwise
+   *                    {@code false} otherwise
    */
   private static boolean processExistingBlankLine(@NotNull Editor editor, @Nullable PsiCodeBlock codeBlock, @Nullable PsiElement element) {
     PsiWhiteSpace whiteSpace = null;
index 88714e1c53ed46b5424be4d9853d5bd1cf85e1c0..8212a7a88f3dd04a0140d8f1610c161a67671e11 100644 (file)
@@ -152,7 +152,7 @@ public class SurroundWithUtil {
    *   }
    * </pre>
    * The problem is that surround block doesn't contain any indent spaces, hence, the first statement is inserted to the
-   * zero column. But we have a dedicated code style setting <code>'keep comment at first column'</code>, i.e. the comment
+   * zero column. But we have a dedicated code style setting {@code 'keep comment at first column'}, i.e. the comment
    * will not be moved if that setting is checked.
    * <p/>
    * Current method handles that situation.
index fff679cc5b320fe98192d77127fbc536c402f013..308491341884f9c18dc5c5734ddaa5e14a4737aa 100644 (file)
@@ -50,7 +50,7 @@ public class AddOnDemandStaticImportAction extends BaseElementAtCaretIntentionAc
    * Allows to check if static import may be performed for the given element.
    *
    * @param element     element to check
-   * @return            target class that may be statically imported if any; <code>null</code> otherwise
+   * @return            target class that may be statically imported if any; {@code null} otherwise
    */
   @Nullable
   public static PsiClass getClassToPerformStaticImport(@NotNull PsiElement element) {
index 217494f4fcbfe23e2420d3677e93a4633f540519..a3596c582e3b155f2281edf907183f6a2742e475 100644 (file)
@@ -60,7 +60,7 @@ public class AddSingleMemberStaticImportAction extends BaseElementAtCaretIntenti
    * Allows to check if it's possible to perform static import for the target element.
    *
    * @param element     target element that is static import candidate
-   * @return            not-null qualified name of the class which method may be statically imported if any; <code>null</code> otherwise
+   * @return            not-null qualified name of the class which method may be statically imported if any; {@code null} otherwise
    */
   @Nullable
   public static ImportAvailability getStaticImportClass(@NotNull PsiElement element) {
index 906d25acb1de4b92e47092d58690b84d6780fc18..41c24bc5ad14fa0595e02e92d898ee8ea12e50d3 100644 (file)
@@ -22,7 +22,7 @@ import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
 /**
- * Handles tooltip links in format <code>#assignment/escaped_full_tooltip_text</code>.
+ * Handles tooltip links in format {@code #assignment/escaped_full_tooltip_text}.
  * On a click comparison table opens.
  */
 public class AssignmentTooltipLinkHandler extends TooltipLinkHandler {
index d2a398a7e89cac855d5d90a1f17ee683f9114b4c..e79ef3b5869e3ad22a056b81969fbe9ac69aba1c 100644 (file)
@@ -32,7 +32,7 @@ public abstract class DocumentationDelegateProvider {
    * Computes PsiDocCommentOwner to get documentation from.
    * </p>
    * <p>
-   * Suppose there is a <code>Foo#bar()</code> with doc and <code>Baz#bar()</code> without doc:
+   * Suppose there is a {@code Foo#bar()} with doc and {@code Baz#bar()} without doc:
    * <pre>
    * class Foo {
    *   /**
@@ -44,8 +44,8 @@ public abstract class DocumentationDelegateProvider {
    *   void bar() {}
    * }
    * </pre>
-   * If it is needed to display doc from <code>Foo#bar()</code> when doc for <code>Baz#bar()</code> is queried
-   * then this method should return PsiMethod corresponding to <code>Foo#bar()</code> for PsiMethod corresponding to <code>Baz#bar()</code>.
+   * If it is needed to display doc from {@code Foo#bar()} when doc for {@code Baz#bar()} is queried
+   * then this method should return PsiMethod corresponding to {@code Foo#bar()} for PsiMethod corresponding to {@code Baz#bar()}.
    * <br>
    * The copied documentation will include <i>Description copied from</i> link.
    * </p>
index 3abdcbbdbb35f7b52cca571d716e9bccf1814e70..8fd72a6688e9c563d2b02ab22c8cd9171e15fe09 100644 (file)
@@ -335,7 +335,7 @@ public class JavaDocInfoGenerator {
 
   /**
    * Takes a pair of strings representing a relative path and a package name, and returns corresponding pair, where path is stripped of
-   * leading ../ elements, and package name adjusted correspondingly. Returns <code>null</code> if there are more ../ elements than package
+   * leading ../ elements, and package name adjusted correspondingly. Returns {@code null} if there are more ../ elements than package
    * components.
    */
   @Nullable
index 29e8c499f75e5a01d26755d86641bbe7ff0d31af..6b6085739daf3877e16f0b24cea283b7c8dc9a52 100644 (file)
@@ -267,7 +267,7 @@ public final class TodoPackageNode extends PackageElementNode implements Highlig
 
   /**
    * @return read-only iterator of all valid PSI files that can have T.O.D.O items
-   *         and which are located under specified <code>psiDirctory</code>.
+   *         and which are located under specified {@code psiDirctory}.
    */
   public Iterator<PsiFile> getFiles(PackageElement packageElement) {
     ArrayList<PsiFile> psiFileList = new ArrayList<>();
index 4cfd43cc2374737d2ad9b15fca15eb68149a59eb..d8f18f75d79104e2cb1b4960eed8b7c17affd37b 100644 (file)
@@ -192,8 +192,8 @@ public class JavaArrangementParseInfo {
   }
 
   /**
-   * Is expected to be called when new method dependency is detected. Here given <code>'base method'</code> calls
-   * <code>'dependent method'</code>.
+   * Is expected to be called when new method dependency is detected. Here given {@code 'base method'} calls
+   * {@code 'dependent method'}.
    */
   public void registerMethodCallDependency(@NotNull PsiMethod caller, @NotNull PsiMethod callee) {
     myTmpMethodDependencyRoots.remove(callee);
index 5d2e71ef8f89bcb581b7614204d0ff840cc7737e..0879e22851e83be1e4b5627e74b9556582a3d2cb 100644 (file)
@@ -1112,7 +1112,7 @@ public abstract class AbstractJavaBlock extends AbstractBlock implements JavaBlo
    * is refactored
    *
    * @param elementType   target element type
-   * @return              <code>null</code> all the time
+   * @return              {@code null} all the time
    */
   @Nullable
   @Override
index 94d2b7d3686cbc96e1a3dd5759586cf686e17e41..ba83aea16d8ac70b596f784baf73169194629ebf 100644 (file)
@@ -48,19 +48,19 @@ public class JavaFormatterUtil {
    * Allows to answer if given node wraps assignment operation.
    *
    * @param node node to check
-   * @return <code>true</code> if given node wraps assignment operation; <code>false</code> otherwise
+   * @return {@code true} if given node wraps assignment operation; {@code false} otherwise
    */
   public static boolean isAssignment(ASTNode node) {
     return ASSIGNMENT_ELEMENT_TYPES.contains(node.getElementType());
   }
 
   /**
-   * Allows to check if given <code>AST</code> nodes refer to binary expressions which have the same priority.
+   * Allows to check if given {@code AST} nodes refer to binary expressions which have the same priority.
    *
    * @param node1 node to check
    * @param node2 node to check
-   * @return <code>true</code> if given nodes are binary expressions and have the same priority;
-   *         <code>false</code> otherwise
+   * @return {@code true} if given nodes are binary expressions and have the same priority;
+   *         {@code false} otherwise
    */
   public static boolean areSamePriorityBinaryExpressions(ASTNode node1, ASTNode node2) {
     if (node1 == null || node2 == null) {
index 6823a70a782a3ce0931f926f7def1e35c968b760..86a300c48519bd1951be0c088a10a8466e0a834e 100644 (file)
@@ -534,7 +534,7 @@ public class JavaSpacePropertyProcessor extends JavaElementVisitor {
   }
 
   /**
-   * Initializes {@link #myResult} property with {@link Spacing} which <code>'min line feeds'</code> property is defined
+   * Initializes {@link #myResult} property with {@link Spacing} which {@code 'min line feeds'} property is defined
    * from {@link CodeStyleSettings#BLANK_LINES_AROUND_CLASS} value.
    */
   private void setAroundClassSpacing() {
@@ -576,11 +576,11 @@ public class JavaSpacePropertyProcessor extends JavaElementVisitor {
   }
 
   /**
-   * Allows to calculate <code>'min line feed'</code> setting of the {@link Spacing} to be used between two closing braces
+   * Allows to calculate {@code 'min line feed'} setting of the {@link Spacing} to be used between two closing braces
    * (assuming that left AST node that ends with closing brace is given to this method).
    *
    * @param leftNode    left AST node that ends with closing brace
-   * @return            <code>'min line feed'</code> setting of {@link Spacing} object to use for the given AST node and
+   * @return            {@code 'min line feed'} setting of {@link Spacing} object to use for the given AST node and
    *                    closing brace
    */
   private static int getMinLineFeedsBetweenRBraces(ASTNode leftNode) {
index a8a8b35d8d34c7b3495db985fb78b65654ca4977..6e87c6b7a73160bf62336b34407c1ec1f12be731 100644 (file)
@@ -26,7 +26,7 @@ import org.jetbrains.annotations.NotNull;
 public class MultipleFieldDeclarationHelper {
 
   /**
-   * @return <code>true</code> if given node is a non-first part of composite field definition; <code>false</code> otherwise
+   * @return {@code true} if given node is a non-first part of composite field definition; {@code false} otherwise
    */
   public static boolean compoundFieldPart(@NotNull ASTNode node) {
     if (node.getElementType() != JavaElementType.FIELD) {
@@ -45,9 +45,9 @@ public class MultipleFieldDeclarationHelper {
   /**
    * Serves for processing composite field definitions as a single formatting block.
    * <p/>
-   * <code>'Composite field definition'</code> looks like {@code 'int i1, i2 = 2'}. It produces two nodes of type
+   * {@code 'Composite field definition'} looks like {@code 'int i1, i2 = 2'}. It produces two nodes of type
    * {@link JavaElementType#FIELD} - {@code 'int i1'} and {@code 'i2 = 2'}. This method returns the second node if the first one
-   * is given (the given node is returned for <code>'single'</code> fields).
+   * is given (the given node is returned for {@code 'single'} fields).
    *
    * @param child     child field node to check
    * @return          last child field node at the field group identified by the given node if any; given child otherwise
index c607722df7019bc33d0ca3f3535a13ac5f92a526..9b6a26925bd1d020def1038fafac3f8645fb8b62 100644 (file)
@@ -47,7 +47,7 @@ public class JavaWrapManager {
   private final JavaChildBlockWrapFactory myChildBlockFactory;
 
   /**
-   * Creates new <code>JavaWrapManager</code> object with default wrapping services.
+   * Creates new {@code JavaWrapManager} object with default wrapping services.
    */
   public JavaWrapManager() {
     this(new JavaChildWrapArranger(), new JavaChildBlockWrapFactory());
@@ -59,13 +59,13 @@ public class JavaWrapManager {
   }
 
   /**
-   * Tries to define the wrap to use for the {@link Block block} for the given <code>'child'</code> node. It's assumed that
-   * given <code>'child'</code> node is descendant (direct or indirect) of the given <code>'parent'</code> node.
-   * I.e. <code>'parent'</code> node defines usage context for the <code>'child'</code> node.
+   * Tries to define the wrap to use for the {@link Block block} for the given {@code 'child'} node. It's assumed that
+   * given {@code 'child'} node is descendant (direct or indirect) of the given {@code 'parent'} node.
+   * I.e. {@code 'parent'} node defines usage context for the {@code 'child'} node.
    *
    * @param child                   child node which {@link Wrap wrap} is to be defined
-   * @param parent                  direct or indirect parent of the given <code>'child'</code> node. Defines usage context
-   *                                of <code>'child'</code> node processing
+   * @param parent                  direct or indirect parent of the given {@code 'child'} node. Defines usage context
+   *                                of {@code 'child'} node processing
    * @param settings                code style settings to use during wrap definition
    * @param suggestedWrap           wrap suggested to use by clients of current class. I.e. those clients offer wrap to
    *                                use based on their information about current processing state. However, it's possible
@@ -75,8 +75,8 @@ public class JavaWrapManager {
    * @param reservedWrapsProvider   reserved {@code 'element type -> wrap instance'} mappings provider. <b>Note:</b> this
    *                                argument is considered to be a part of legacy heritage and is intended to be removed as
    *                                soon as formatting code refactoring is done
-   * @return                        wrap to use for the given <code>'child'</code> node if it's possible to define the one;
-   *                                <code>null</code> otherwise
+   * @return                        wrap to use for the given {@code 'child'} node if it's possible to define the one;
+   *                                {@code null} otherwise
    */
   @Nullable
   public Wrap arrangeChildWrap(ASTNode child, 
index d166d858b531ad6e66059b90f54c3e14f53a99cc..1bcdb60aa8fed528f319b7c509c8ca16a4fbb789 100644 (file)
@@ -35,7 +35,7 @@ public interface ReservedWrapsProvider {
    * Allows to retrieve predefined {@link Wrap} object for the given element type if any.
    *
    * @param elementType   target element type
-   * @return              predefined wrap for the given element type if any; <code>null</code> otherwise
+   * @return              predefined wrap for the given element type if any; {@code null} otherwise
    */
   @Nullable
   Wrap getReservedWrap(IElementType elementType);
index 8516ba04c0679f2a7d585d79ded0c54e6b0a77c2..867285006e3f8f4d100aefe6c83f05fe169c1777 100644 (file)
@@ -53,8 +53,8 @@ public class JavaChildWrapArranger {
    * Provides implementation of {@link JavaWrapManager#arrangeChildWrap} method.
    *
    * @param child                   child node which {@link Wrap wrap} is to be defined
-   * @param parent                  direct or indirect parent of the given <code>'child'</code> node. Defines usage context
-   *                                of <code>'child'</code> node processing
+   * @param parent                  direct or indirect parent of the given {@code 'child'} node. Defines usage context
+   *                                of {@code 'child'} node processing
    * @param settings                code style settings to use during wrap definition
    * @param suggestedWrap           wrap suggested to use by clients of current class. I.e. those clients offer wrap to
    *                                use based on their information about current processing state. However, it's possible
@@ -64,8 +64,8 @@ public class JavaChildWrapArranger {
    * @param reservedWrapsProvider   reserved {@code 'element type -> wrap instance'} mappings provider. <b>Note:</b> this
    *                                argument is considered to be a part of legacy heritage and is intended to be removed as
    *                                soon as formatting code refactoring is done
-   * @return                        wrap to use for the given <code>'child'</code> node if it's possible to define the one;
-   *                                <code>null</code> otherwise
+   * @return                        wrap to use for the given {@code 'child'} node if it's possible to define the one;
+   *                                {@code null} otherwise
    */
   @SuppressWarnings({"MethodMayBeStatic"})
   @Nullable
index 31358cdc045f0ab4649567b271d70e43910040b0..36bcfaff6c5362e3b850730da1ae82d1b5e7cbe0 100644 (file)
@@ -304,7 +304,7 @@ public class TabPostFormatProcessor implements PostFormatProcessor {
   interface Helper {
 
     /**
-     * @return    previous line indent space if current line is not the first one; <code>null</code> otherwise
+     * @return    previous line indent space if current line is not the first one; {@code null} otherwise
      */
     @Nullable CharSequence getPrevLineIndent();
     
index 2b165194d6271fad81a9968d9290044b2998e61a..ec4455e16457f8fe70d0e58181c02edf5bd50b89 100644 (file)
@@ -368,8 +368,8 @@ public class JDParser {
   }
 
   /**
-   * Processes given string and produces on its basis set of pairs like <code>'(string; flag)'</code> where <code>'string'</code>
-   * is interested line and <code>'flag'</code> indicates if it is wrapped to {@code <pre>} tag.
+   * Processes given string and produces on its basis set of pairs like {@code '(string; flag)'} where {@code 'string'}
+   * is interested line and {@code 'flag'} indicates if it is wrapped to {@code <pre>} tag.
    *
    * @param s   string to process
    * @return    processing result
index 7ed44b33ed3bef75d199a410590dfa057d66b44e..a71f2b491142dc19ff20c5325f3c6a8de8637233 100644 (file)
@@ -83,7 +83,7 @@ public abstract class IntroduceHandlerBase implements RefactoringActionHandler,
   /**
    * @param project
    * @param tempExpr
-   * @param editor editor to highlight stuff in. Should accept <code>null</code>
+   * @param editor editor to highlight stuff in. Should accept {@code null}
    * @return
    */
   protected abstract boolean invokeImpl(Project project, PsiExpression tempExpr,
@@ -92,7 +92,7 @@ public abstract class IntroduceHandlerBase implements RefactoringActionHandler,
   /**
    * @param project
    * @param localVariable
-   * @param editor editor to highlight stuff in. Should accept <code>null</code>
+   * @param editor editor to highlight stuff in. Should accept {@code null}
    * @return
    */
   protected abstract boolean invokeImpl(Project project, PsiLocalVariable localVariable,
index 9da34bc6e30f2fc510104acc9a97801498f24a1b..e8bc507d2375187ff7e27b2323dab72c6f1efc86 100644 (file)
@@ -1013,10 +1013,10 @@ public class RefactoringUtil {
   }
 
   /**
-   * Returns subset of <code>graph.getVertices()</code> that is a tranistive closure (by <code>graph.getTargets()<code>)
-   * of the following property: initialRelation.value() of vertex or <code>graph.getTargets(vertex)</code> is true.
+   * Returns subset of {@code graph.getVertices()} that is a tranistive closure (by <code>graph.getTargets()<code>)
+   * of the following property: initialRelation.value() of vertex or {@code graph.getTargets(vertex)} is true.
    * <p/>
-   * Note that <code>graph.getTargets()</code> is not neccesrily a subset of <code>graph.getVertex()</code>
+   * Note that {@code graph.getTargets()} is not neccesrily a subset of {@code graph.getVertex()}
    *
    * @param graph
    * @param initialRelation
index 70242bbf31fb61cfcd3b5f130a3fa0b29d4f5e86..167fb4de8dc4782cbaad9d66eb3ab5007bc2b549 100644 (file)
@@ -384,7 +384,7 @@ public class AnnotationUtil {
    *
    * @param owner modifier list
    * @param annotations annotations qualified names or patterns. Patterns can have '*' at the end
-   * @return <code>true</code> if annotated of at least one annotation from the annotations list
+   * @return {@code true} if annotated of at least one annotation from the annotations list
    */
   @Contract("null,_ -> false")
   public static boolean checkAnnotatedUsingPatterns(@Nullable PsiModifierListOwner owner, @NotNull Collection<String> annotations) {
index e9e244ca0668370676792f670a2afdca032e889d..3475a4d4929fa6d1a5aa0a9cf23baa8cce393ff2 100644 (file)
@@ -35,7 +35,7 @@ public interface JVMElementFactory {
    * @param name the name of the class to create.
    * @return the created class instance.
    * @throws IncorrectOperationException
-   *          if <code>name</code> is not a valid Java identifier.
+   *          if {@code name} is not a valid Java identifier.
    */
   @NotNull
   PsiClass createClass(@NonNls @NotNull String name) throws IncorrectOperationException;
@@ -45,7 +45,7 @@ public interface JVMElementFactory {
    *
    * @param name the name of the interface to create.
    * @return the created interface instance.
-   * @throws IncorrectOperationException if <code>name</code> is not a valid Java identifier.
+   * @throws IncorrectOperationException if {@code name} is not a valid Java identifier.
    */
   @NotNull
   PsiClass createInterface(@NonNls @NotNull String name) throws IncorrectOperationException;
@@ -55,7 +55,7 @@ public interface JVMElementFactory {
    *
    * @param name the name of the enum to create.
    * @return the created enum instance.
-   * @throws IncorrectOperationException if <code>name</code> is not a valid Java identifier.
+   * @throws IncorrectOperationException if {@code name} is not a valid Java identifier.
    */
   @NotNull
   PsiClass createEnum(@NotNull @NonNls String name) throws IncorrectOperationException;
@@ -66,8 +66,8 @@ public interface JVMElementFactory {
    * @param name the name of the field to create.
    * @param type the type of the field to create.
    * @return the created field instance.
-   * @throws IncorrectOperationException <code>name</code> is not a valid Java identifier
-   *                                     or <code>type</code> represents an invalid type.
+   * @throws IncorrectOperationException {@code name} is not a valid Java identifier
+   *                                     or {@code type} represents an invalid type.
    */
   @NotNull
   PsiField createField(@NotNull @NonNls String name, @NotNull PsiType type) throws IncorrectOperationException;
@@ -78,8 +78,8 @@ public interface JVMElementFactory {
    * @param name       the name of the method to create.
    * @param returnType the return type of the method to create.
    * @return the created method instance.
-   * @throws IncorrectOperationException <code>name</code> is not a valid Java identifier
-   *                                     or <code>type</code> represents an invalid type.
+   * @throws IncorrectOperationException {@code name} is not a valid Java identifier
+   *                                     or {@code type} represents an invalid type.
    */
   @NotNull
   PsiMethod createMethod(@NotNull @NonNls String name, PsiType returnType) throws IncorrectOperationException;
@@ -110,8 +110,8 @@ public interface JVMElementFactory {
    * @param name the name of the parameter to create.
    * @param type the type of the parameter to create.
    * @return the created parameter instance.
-   * @throws IncorrectOperationException <code>name</code> is not a valid Java identifier
-   *                                     or <code>type</code> represents an invalid type.
+   * @throws IncorrectOperationException {@code name} is not a valid Java identifier
+   *                                     or {@code type} represents an invalid type.
    */
   @NotNull
   PsiParameter createParameter(@NotNull @NonNls String name, PsiType type) throws IncorrectOperationException;
@@ -175,7 +175,7 @@ public interface JVMElementFactory {
    *
    * @param name the name of the annotation type to create.
    * @return the created annotation type instance.
-   * @throws IncorrectOperationException if <code>name</code> is not a valid Java identifier.
+   * @throws IncorrectOperationException if {@code name} is not a valid Java identifier.
    */
   @NotNull
   PsiClass createAnnotationType(@NotNull @NonNls String name) throws IncorrectOperationException;
@@ -247,8 +247,8 @@ public interface JVMElementFactory {
   /**
    * Returns the primitive type instance for the specified type name.
    *
-   * @param text the name of a Java primitive type (for example, <code>int</code>)
-   * @return the primitive type instance, or null if <code>name</code> is not a valid
+   * @param text the name of a Java primitive type (for example, {@code int})
+   * @return the primitive type instance, or null if {@code name} is not a valid
    *         primitive type name.
    */
   @Nullable
index 56917cdb7fdf4e372c3bc17356676489d2dc05d0..898a1b406d0e6e806d5a479e4c71e2a0e903b633 100644 (file)
@@ -21,30 +21,30 @@ package com.intellij.psi;
  */
 public interface JavaCodeFragment extends PsiImportHolder, PsiCodeFragment {
   /**
-   * Returns the type corresponding to the <code>this</code> keyword in the code fragment.
+   * Returns the type corresponding to the {@code this} keyword in the code fragment.
    *
-   * @return the type of <code>this</code> in the fragment.
+   * @return the type of {@code this} in the fragment.
    */
   PsiType getThisType();
 
   /**
-   * Sets the type corresponding to the <code>this</code> keyword in the code fragment.
+   * Sets the type corresponding to the {@code this} keyword in the code fragment.
    *
-   * @param psiType the type of <code>this</code> in the fragment.
+   * @param psiType the type of {@code this} in the fragment.
    */
   void setThisType(PsiType psiType);
 
   /**
-   * Returns the type corresponding to the <code>super</code> keyword in the code fragment.
+   * Returns the type corresponding to the {@code super} keyword in the code fragment.
    *
-   * @return the type of <code>super</code> in the fragment.
+   * @return the type of {@code super} in the fragment.
    */
   PsiType getSuperType();
 
   /**
-   * Sets the type corresponding to the <code>super</code> keyword in the code fragment.
+   * Sets the type corresponding to the {@code super} keyword in the code fragment.
    *
-   * @param superType the type of <code>super</code> in the fragment.
+   * @param superType the type of {@code super} in the fragment.
    */
   void setSuperType(PsiType superType);
 
index 250a92248b33a67cd451eeea7d08926361959ed6..9987d5589fe5038a743d69e84dbd2798db97bc6d 100644 (file)
@@ -74,7 +74,7 @@ public abstract class JavaCodeFragmentFactory {
 
   /**
    * Creates a Java type code fragment from the text of the name of a Java type (the name
-   * of a primitive type, array type or class), with <code>void</code> and ellipsis
+   * of a primitive type, array type or class), with {@code void} and ellipsis
    * not treated as a valid type.
    *
    * @param text       the text of the Java type to create.
index 2a2653fa8ca2e9ad4fe80270797bdf5b56d3b470..f7f3fa2cc8eea21717a9c2927b7140824a746741 100644 (file)
@@ -19,7 +19,7 @@ import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
 /**
- * Represents an array access expession, for example, <code>i [1]</code>.
+ * Represents an array access expession, for example, {@code i [1]}.
  */
 public interface PsiArrayAccessExpression extends PsiExpression {
   /**
index 6e7f916a37b521e531ad2b91bdc25c5a5c613eb0..8d15e86fba246b29f883b5178d46189fe858bb5e 100644 (file)
@@ -19,7 +19,7 @@ import org.jetbrains.annotations.NotNull;
 
 /**
  * Represents an array used as a value of an annotation element. For example:
- * <code>@Endorsers({"Children", "Unscrupulous dentists"})</code>
+ * {@code @Endorsers({"Children", "Unscrupulous dentists"})}
  *
  * @author ven
  */
index b83d92856d9efd396bf37c1b067fd5760c23df59..636d3c7af7cf9741e4b9ededae4d97b899dde9a7 100644 (file)
@@ -18,7 +18,7 @@ package com.intellij.psi;
 import org.jetbrains.annotations.Nullable;
 
 /**
- * Represents a Java <code>assert</code> statement.
+ * Represents a Java {@code assert} statement.
  */
 public interface PsiAssertStatement extends PsiStatement{
   /**
index 702831d029e764966049e55d8977d3b0199596d5..9c112b36170c836a5dc16f7c8d44b30cb781c531 100644 (file)
@@ -20,7 +20,7 @@ import org.jetbrains.annotations.Nullable;
 import com.intellij.psi.tree.IElementType;
 
 /**
- * Represents a simple assignment (<code>a=b</code>) or a compound assignment (<code>a+=1</code>) expression.
+ * Represents a simple assignment ({@code a=b}) or a compound assignment ({@code a+=1}) expression.
  */
 public interface PsiAssignmentExpression extends PsiExpression {
   /**
index 77046c5b5ee7c03cdb1f8bd48c60ac56f3761d4f..879df13b113bc3b606c6597847cb657bc189d3c7 100644 (file)
@@ -18,7 +18,7 @@ package com.intellij.psi;
 import org.jetbrains.annotations.Nullable;
 
 /**
- * Represents a Java <code>break</code> statement.
+ * Represents a Java {@code break} statement.
  */
 public interface PsiBreakStatement extends PsiStatement {
   /**
@@ -31,7 +31,7 @@ public interface PsiBreakStatement extends PsiStatement {
 
   /**
    * Returns the statement instance ({@link PsiForStatement}, {@link PsiSwitchStatement} etc.) representing
-   * the statement out of which <code>break</code> transfers control.
+   * the statement out of which {@code break} transfers control.
    *
    * @return the statement instance, or null if the statement is not valid in the context where it is located.
    */
index fc7c7621f3be6c9f9d88f669607e8e6a578c5afa..9bf9f15c0473b2ed76dc8d1e4157dc606fed977a 100644 (file)
@@ -22,7 +22,7 @@ import org.jetbrains.annotations.Nullable;
 import java.util.List;
 
 /**
- * Represents a single <code>catch</code> section of a Java <code>try ... catch</code> statement.
+ * Represents a single {@code catch} section of a Java {@code try ... catch} statement.
  *
  * @author ven
  */
@@ -78,7 +78,7 @@ public interface PsiCatchSection extends PsiElement {
   List<PsiType> getPreciseCatchTypes();
 
   /**
-   * Returns the <code>try</code> statement to which the catch section is attached.
+   * Returns the {@code try} statement to which the catch section is attached.
    *
    * @return the statement instance.
    */
index e97089098f840cd3fb3e6217eaf468d48fa39f51..471ca3fd2fce8c4397309c210cbc93c27021083a 100644 (file)
@@ -18,7 +18,7 @@ package com.intellij.psi;
 import org.jetbrains.annotations.NotNull;
 
 /**
- * Represents a class literal expression (for example, <code>String.class</code>).
+ * Represents a class literal expression (for example, {@code String.class}).
  */
 public interface PsiClassObjectAccessExpression extends PsiExpression {
   /**
index 3051b2a1a9dadb21c0a29193a9b63e0152c6f75a..f0813566de25364d6733a5797349d60e6316ddfe 100644 (file)
@@ -19,7 +19,7 @@ import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
 /**
- * Represents a Java conditional expression (for example, <code>a ? 1 : 2</code>.
+ * Represents a Java conditional expression (for example, {@code a ? 1 : 2}.
  */
 public interface PsiConditionalExpression extends PsiExpression {
   /**
index 0e1c83bf38228d15f4ad5fec82ccd2ae3a715d9a..d3b215e2390f5b3f5ab0e02125b3bf3c80b0ae80 100644 (file)
@@ -18,7 +18,7 @@ package com.intellij.psi;
 import org.jetbrains.annotations.Nullable;
 
 /**
- * Represents a Java <code>continue</code> statement.
+ * Represents a Java {@code continue} statement.
  */
 public interface PsiContinueStatement extends PsiStatement {
   /**
@@ -31,7 +31,7 @@ public interface PsiContinueStatement extends PsiStatement {
 
   /**
    * Returns the statement instance ({@link PsiForStatement}, {@link PsiWhileStatement} etc.) representing
-   * the statement to the next iteration of which <code>continue</code> transfers control.
+   * the statement to the next iteration of which {@code continue} transfers control.
    *
    * @return the statement instance, or null if the statement is not valid in the context where it is located.
    */
index 9753cbd29a414b8e5f422f1c84ea1c7cf6e6b8ef..d09510d1cd26c5fe1a403ad8fdfbe80b48c55adc 100644 (file)
@@ -30,8 +30,8 @@ import java.util.Collections;
 import java.util.List;
 
 /**
- * Composite type resulting from Project Coin's multi-catch statements, i.e. <code>FileNotFoundException | EOFException</code>.
- * In most cases should be threatened via its least upper bound (<code>IOException</code> in the example above).
+ * Composite type resulting from Project Coin's multi-catch statements, i.e. {@code FileNotFoundException | EOFException}.
+ * In most cases should be threatened via its least upper bound ({@code IOException} in the example above).
  */
 public class PsiDisjunctionType extends PsiType.Stub {
   private final PsiManager myManager;
index 5062578469bec4dc3749d34286ae2329638af1f1..ae43da750d3deb007b210ab7f0a764daa5404506 100644 (file)
@@ -18,7 +18,7 @@ package com.intellij.psi;
 import org.jetbrains.annotations.Nullable;
 
 /**
- * Represents a Java <code>do ... while</code> statement.
+ * Represents a Java {@code do ... while} statement.
  */
 public interface PsiDoWhileStatement extends PsiLoopStatement {
   /**
@@ -30,7 +30,7 @@ public interface PsiDoWhileStatement extends PsiLoopStatement {
   PsiExpression getCondition();
 
   /**
-   * Returns the <code>while</code> keyword of the statement.
+   * Returns the {@code while} keyword of the statement.
    *
    * @return the keyword, or null if the statement is incomplete.
    */
index 44b788ff47f17bb24ff87f72a06b11ef63a3589e..1a1e3051ca88fa0b5692ded937962e5304c00a99 100644 (file)
@@ -17,7 +17,7 @@ package com.intellij.psi;
 
 /**
  * Represents the list of expressions separated by commas, used as the initialize
- * or update part of a <code>for</code> loop.
+ * or update part of a {@code for} loop.
  */
 public interface PsiExpressionListStatement extends PsiStatement {
   /**
index 93bd92efc80a7531fe7cc1c60b97cd3e45d7ae62..01030e2fc5bc13fdb4221f66cdceb891a604c6f1 100644 (file)
@@ -38,7 +38,7 @@ public interface PsiField extends PsiMember, PsiVariable, PsiDocCommentOwner {
   };
 
   /**
-   * Adds initializer to the field declaration or, if <code>initializer</code> parameter is null,
+   * Adds initializer to the field declaration or, if {@code initializer} parameter is null,
    * removes the initializer from the field declaration.
    *
    * @param initializer the initializer to add.
index a822b023d484327de3b51978c8a8d7e28a7eb2a2..d6fe48cc98caa2fbe5917a5dd02da981b8f08e99 100644 (file)
@@ -18,7 +18,7 @@ package com.intellij.psi;
 import org.jetbrains.annotations.Nullable;
 
 /**
- * Represents a Java basic <code>for</code> statement.
+ * Represents a Java basic {@code for} statement.
  */
 public interface PsiForStatement extends PsiLoopStatement{
   /**
index 94968f4a37fdd87ee3282a8952a42e15ea19bfdd..8ddbb35364dbb4fd0677327c480a0184dbe032e2 100644 (file)
@@ -19,7 +19,7 @@ import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
 /**
- * Represents a Java enhanced <code>for</code>   statement.
+ * Represents a Java enhanced {@code for}   statement.
  *
  * @author dsl
  */
index 645b8ddfa10392d95377c137e53960c15480dce3..3e0819be354a9aabdab0e2bd3028255742599727 100644 (file)
@@ -20,7 +20,7 @@ import org.jetbrains.annotations.Nullable;
 import org.jetbrains.annotations.NotNull;
 
 /**
- * Represents a Java <code>if</code> or <code>if ... else</code> statement.
+ * Represents a Java {@code if} or {@code if ... else} statement.
  */
 public interface PsiIfStatement extends PsiStatement {
   /**
@@ -42,16 +42,16 @@ public interface PsiIfStatement extends PsiStatement {
   /**
    * Returns the statement which is executed when the condition is true.
    *
-   * @return the statement instance, or null if the statement has no <code>else</code>
+   * @return the statement instance, or null if the statement has no {@code else}
    * part or is incomplete.
    */
   @Nullable
   PsiStatement getElseBranch();
 
   /**
-   * Returns the <code>else</code> keyword of the statement.
+   * Returns the {@code else} keyword of the statement.
    *
-   * @return the keyword instance, or null if the statement has no <code>else</code>
+   * @return the keyword instance, or null if the statement has no {@code else}
    * part.
    */
   @Nullable
@@ -59,7 +59,7 @@ public interface PsiIfStatement extends PsiStatement {
 
   /**
    * Sets the statement which is executed when the condition is false to the specified value.
-   * Adds the <code>else</code> keyword if required.
+   * Adds the {@code else} keyword if required.
    *
    * @param statement the statement to use as the else branch.
    * @throws IncorrectOperationException if the modification fails for some reason (for example,
index 49c14efc25513580b3e6105be5de0b66877db362..51e52d1af288e83796fd82e6a0e5e23d73ab021b 100644 (file)
@@ -18,7 +18,7 @@ package com.intellij.psi;
 import org.jetbrains.annotations.Nullable;
 
 /**
- * Represents a Java <code>import</code> statement.
+ * Represents a Java {@code import} statement.
  */
 public interface PsiImportStatement extends PsiImportStatementBase {
   /**
index 6b7354a57171a65f377aa0df45bc892f35a5b5f6..bbf8a1595bd313fe45a3f49e53d6a975c1ebd150 100644 (file)
@@ -20,7 +20,7 @@ import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
 /**
- * Represents a Java <code>import</code> or <code>import static</code> statement.
+ * Represents a Java {@code import} or {@code import static} statement.
  *
  * @author dsl
  */
index b0572730397395479e310beeb4333228a8facef0..eb0f0da393bb10e513d23b30e9fa902859a163c0 100644 (file)
@@ -18,7 +18,7 @@ package com.intellij.psi;
 import com.intellij.util.IncorrectOperationException;
 
 /**
- * Represents a reference to the member imported by a Java <code>import static</code>
+ * Represents a reference to the member imported by a Java {@code import static}
  * statement.
  *
  * @author dsl
index 411264e1c80af8bc1c8d61c5867580383b4c326b..7ea57091dfdc765c90a1a3e5f781ded9de717b23 100644 (file)
@@ -18,7 +18,7 @@ package com.intellij.psi;
 import org.jetbrains.annotations.Nullable;
 
 /**
- * Represents a Java <code>import static</code> statement.
+ * Represents a Java {@code import static} statement.
  *
  * @author dsl
  */
index 256629164544289d794d4edd4a7d0e813fdc3318..84df0500812c205d29cd8c02b6948df1680d7aff 100644 (file)
@@ -19,11 +19,11 @@ import org.jetbrains.annotations.Nullable;
 import org.jetbrains.annotations.NotNull;
 
 /**
- * Represents a Java <code>instanceof</code> expression.
+ * Represents a Java {@code instanceof} expression.
  */
 public interface PsiInstanceOfExpression extends PsiExpression {
   /**
-   * Returns the expression on the left side of the <code>instanceof</code>.
+   * Returns the expression on the left side of the {@code instanceof}.
    *
    * @return the checked expression.
    */
@@ -31,7 +31,7 @@ public interface PsiInstanceOfExpression extends PsiExpression {
   PsiExpression getOperand();
 
   /**
-   * Returns the type element on the right side of the <code>instanceof</code>.
+   * Returns the type element on the right side of the {@code instanceof}.
    *
    * @return the type element, or null if the expression is incomplete.
    */
index f86a987c3e1579c59909bcfc1f2365f1dbe40443..4d27f301d6e4a8da079a5261911778c181dae909 100644 (file)
@@ -24,7 +24,7 @@ import org.jetbrains.annotations.NotNull;
  */
 public interface PsiLocalVariable extends PsiVariable {
   /**
-   * Adds initializer to the variable declaration statement or, if <code>initializer</code>
+   * Adds initializer to the variable declaration statement or, if {@code initializer}
    * parameter is null, removes initializer from variable.
    *
    * @param initializer the initializer to add.
index 20cc8a0c1c32ee128b7027651486072be1a233c8..061f20217e412720d790eeb76877e831e24c71e5 100644 (file)
@@ -181,9 +181,9 @@ public abstract class PsiNameHelper {
 
   /**
    * Obtains text of all type parameter values in a reference.
-   * They go in left-to-right order: <code>A&lt;List&lt;String&gt, B&lt;Integer&gt;&gt;</code> yields
-   * <code>["List&lt;String&gt", "B&lt;Integer&gt;"]</code>. Parameters of the outer reference are ignored:
-   * <code>A&lt;List&lt;String&gt&gt;.B&lt;Integer&gt;</code> yields <code>["Integer"]</code>
+   * They go in left-to-right order: {@code A<List<String&gt, B<Integer>>} yields
+   * {@code ["List<String&gt", "B<Integer>"]}. Parameters of the outer reference are ignored:
+   * {@code A<List<String&gt>.B<Integer>} yields {@code ["Integer"]}
    *
    * @param referenceText the text of the reference to calculate type parameters for.
    * @return the calculated array of type parameters.
index d8fa9a116251d65c2399a086a82ff4afe863664d..62cee056f4f321a059bbe31084ced67acea8f8a4 100644 (file)
@@ -37,7 +37,7 @@ public interface PsiNewExpression extends PsiCallExpression, PsiConstructorCall
    * an array creation expression.
    *
    * @return the array of expressions for the dimensions, or an empty array if the
-   *         <code>new</code> expression is not an array creation expression.
+   *         {@code new} expression is not an array creation expression.
    */
   @NotNull
   PsiExpression[] getArrayDimensions();
@@ -46,7 +46,7 @@ public interface PsiNewExpression extends PsiCallExpression, PsiConstructorCall
    * Returns the expression specifying the initializer for the created array in
    * an array creation expression.
    *
-   * @return the array initializer expression, or null if the <code>new</code>
+   * @return the array initializer expression, or null if the {@code new}
    *         expression is not an array creation expression or has no initializer.
    */
   @Nullable
@@ -61,7 +61,7 @@ public interface PsiNewExpression extends PsiCallExpression, PsiConstructorCall
   PsiJavaCodeReferenceElement getClassReference();
 
   /**
-   * Returns the anonymous class created by the <code>new</code> expression.
+   * Returns the anonymous class created by the {@code new} expression.
    *
    * @return the anonymous class, or null if the expression does not create an anonymous class.
    */
index 1cbbf2a79ecb365f50e973227ef6dfd46b381d42..21f829a87fab69e93d16d7d2da432e6ace5a7b9c 100644 (file)
@@ -16,7 +16,7 @@
 package com.intellij.psi;
 
 /**
- * Represents a <code>package</code> Java statement.
+ * Represents a {@code package} Java statement.
  */
 public interface PsiPackageStatement extends PsiElement {
   /**
index 2d156118ced1849f5e3316d0081675ef7aa20444..536670d2d6e1ecd322514c2fa925adff85092355 100644 (file)
@@ -33,7 +33,7 @@ public interface PsiReferenceExpression extends PsiExpression, PsiJavaCodeRefere
   PsiExpression getQualifierExpression();
 
   /**
-   * Creates an <code>import static</code> statement importing the referenced member
+   * Creates an {@code import static} statement importing the referenced member
    * from the specified class, or qualifies the reference with the class name if
    * that class is already imported by a regular import statement.
    *
index 724425f9f5ffa71c785e96b405b9572932f0403b..17c94ab9558c5a9a4b5bb13daddd65fc815cd4ab 100644 (file)
@@ -18,8 +18,8 @@ package com.intellij.psi;
 import org.jetbrains.annotations.NotNull;
 
 /**
- * Represents a list of Java classes referenced by the <code>implements</code>,
- * <code>extends</code> or <code>throws</code> clause.
+ * Represents a list of Java classes referenced by the {@code implements},
+ * {@code extends} or {@code throws} clause.
  *
  * @see PsiClass#getExtendsList()
  * @see PsiClass#getImplementsList()
index ea630618da845e5e35f72f8c5f0760c901489aaf..344677ee740130ee32e45d490bc97b1680dfc1f9 100644 (file)
@@ -18,7 +18,7 @@ package com.intellij.psi;
 import org.jetbrains.annotations.Nullable;
 
 /**
- * Represents a Java <code>return</code> statement.
+ * Represents a Java {@code return} statement.
  */
 public interface PsiReturnStatement extends PsiStatement {
   /**
index 49a509b81f63f34202b512d6c9e233fea7a35bed..0ab84e02a80be45b3a9865d8a2839cdc7bff69b2 100644 (file)
@@ -32,10 +32,10 @@ public interface PsiSubstitutor {
   Key<PsiSubstitutor> KEY = KeyWithDefaultValue.<PsiSubstitutor>create("SUBSTITUTOR", EmptySubstitutor.getInstance());
 
   /**
-   * Empty, or natural, substitutor. For any type parameter <code>T</code>,
-   * substitutes type <code>T</code>.
-   * <b>Example:</b> consider class <code>List&lt;E&gt;</code>. <code>this</code>
-   * inside class <code>List</code> has type List with EMPTY substitutor.
+   * Empty, or natural, substitutor. For any type parameter {@code T},
+   * substitutes type {@code T}.
+   * <b>Example:</b> consider class {@code List<E>}. {@code this}
+   * inside class {@code List} has type List with EMPTY substitutor.
    */
   @NotNull
   PsiSubstitutor EMPTY = EmptySubstitutor.getInstance();
@@ -47,13 +47,13 @@ public interface PsiSubstitutor {
    * Does not perform bounds promotion
    *
    * @param typeParameter the parameter to return the mapping for.
-   * @return the mapping for the type parameter, or <code>null</code> for a raw type.
+   * @return the mapping for the type parameter, or {@code null} for a raw type.
    */
   @Nullable
   PsiType substitute(@NotNull PsiTypeParameter typeParameter);
 
   /**
-   * Substitutes type parameters occurring in <code>type</code> with their values.
+   * Substitutes type parameters occurring in {@code type} with their values.
    * If value for type parameter is <code>null<code>, appropriate erasure is returned.
    *
    * @param type the type to substitute the type parameters for.
index dde368b91f866572eaff1732822f0cc33aa596cd..cf2f4c0d39483d5c4a0c5067960f96dae02751e1 100644 (file)
@@ -18,28 +18,28 @@ package com.intellij.psi;
 import org.jetbrains.annotations.Nullable;
 
 /**
- * Represents a single <code>case</code> or <code>default</code> section in a
- * Java <code>switch</code> statement.
+ * Represents a single {@code case} or {@code default} section in a
+ * Java {@code switch} statement.
  */
 public interface PsiSwitchLabelStatement extends PsiStatement {
   /**
-   * Checks if the element represents a <code>default</code> section.
+   * Checks if the element represents a {@code default} section.
    *
-   * @return true if the element represents a <code>default</code> section, false otherwise.
+   * @return true if the element represents a {@code default} section, false otherwise.
    */
   boolean isDefaultCase();
 
   /**
-   * Returns the constant associated with the <code>case</code> block.
+   * Returns the constant associated with the {@code case} block.
    *
    * @return the associated constant, or null if the statement is incomplete or the element
-   * represents a <code>default</code> section.
+   * represents a {@code default} section.
    */
   @Nullable
   PsiExpression getCaseValue();
 
   /**
-   * Returns the <code>switch</code> statement with which the section is associated.
+   * Returns the {@code switch} statement with which the section is associated.
    *
    * @return the associated statement, or null if the element is not valid in its current context.
    */
index baae0524fcc588559f1843968fbb3b1b44f5e18d..395b347dc51882f255dbf440bfc3807c3fa8b4f4 100644 (file)
@@ -18,7 +18,7 @@ package com.intellij.psi;
 import org.jetbrains.annotations.Nullable;
 
 /**
- * Represents a Java <code>switch</code> statement.
+ * Represents a Java {@code switch} statement.
  *
  * @see PsiSwitchLabelStatement
  */
index 1ae7b8a28e0619dcfb622b10fe011ae721244b88..2064b8bccf0cd45319d450d453a7285a901b79c5 100644 (file)
@@ -18,7 +18,7 @@ package com.intellij.psi;
 import org.jetbrains.annotations.Nullable;
 
 /**
- * Represents a Java <code>synchronized</code> statement.
+ * Represents a Java {@code synchronized} statement.
  */
 public interface PsiSynchronizedStatement extends PsiStatement {
   /**
index 27a20361004079d2fa009f8f097c834c969d284d..e272a2cc177d8fdbbd8a47361a9073fc89272efc 100644 (file)
@@ -18,7 +18,7 @@ package com.intellij.psi;
 import org.jetbrains.annotations.Nullable;
 
 /**
- * Represents a Java <code>throw</code> statement.
+ * Represents a Java {@code throw} statement.
  */
 public interface PsiThrowStatement extends PsiStatement {
   /**
index dd5574b5d3223599ff08dc60fe094d1a7dcae8d7..6301f51f7da92119a6f66d3d8fb0944faeb16cb1 100644 (file)
@@ -19,11 +19,11 @@ import org.jetbrains.annotations.Nullable;
 import org.jetbrains.annotations.NotNull;
 
 /**
- * Represents a Java <code>try ... catch ... finally</code> statement.
+ * Represents a Java {@code try ... catch ... finally} statement.
  */
 public interface PsiTryStatement extends PsiStatement {
   /**
-   * Returns the code block executed by the <code>try</code> statement.
+   * Returns the code block executed by the {@code try} statement.
    *
    * @return the code block instance, or null if the statement is incomplete.
    */
@@ -31,7 +31,7 @@ public interface PsiTryStatement extends PsiStatement {
   PsiCodeBlock getTryBlock();
 
   /**
-   * Returns the array of code blocks executed in the <code>catch</code> sections
+   * Returns the array of code blocks executed in the {@code catch} sections
    * of the statement.
    *
    * @return the array of code blocks, or an empty array if the statement has no catch sections.
@@ -40,7 +40,7 @@ public interface PsiTryStatement extends PsiStatement {
   PsiCodeBlock[] getCatchBlocks();
 
   /**
-   * Returns the array of parameters for <code>catch</code> sections.
+   * Returns the array of parameters for {@code catch} sections.
    *
    * @return the array of parameters, or an empty array if the statement has no catch sections.
    */
@@ -48,18 +48,18 @@ public interface PsiTryStatement extends PsiStatement {
   PsiParameter[] getCatchBlockParameters();
 
   /**
-   * Returns the array of <code>catch</code> sections in the statement.
+   * Returns the array of {@code catch} sections in the statement.
    *
-   * @return the array of <code>catch</code> sections, or an empty array if the statement
+   * @return the array of {@code catch} sections, or an empty array if the statement
    * has no catch sections.
    */
   @NotNull
   PsiCatchSection[] getCatchSections();
 
   /**
-   * Returns the code block executed in the <code>finally</code> section.
+   * Returns the code block executed in the {@code finally} section.
    *
-   * @return the code block for the <code>finally</code> section, or null if the statement
+   * @return the code block for the {@code finally} section, or null if the statement
    * does not have one.
    */
   @Nullable
index 03c9bea877ce398e77110d026f3a18b4f5d91ba8..9dd82854aa3c7437ecdb9c1bda238c8d5504fcae 100644 (file)
@@ -140,14 +140,14 @@ public abstract class PsiType implements PsiAnnotationOwner, Cloneable {
   public abstract boolean isValid();
 
   /**
-   * @return true if values of type <code>type</code> can be assigned to rvalues of this type.
+   * @return true if values of type {@code type} can be assigned to rvalues of this type.
    */
   public boolean isAssignableFrom(@NotNull PsiType type) {
     return TypeConversionUtil.isAssignable(this, type);
   }
 
   /**
-   * Checks whether values of type <code>type</code> can be casted to this type.
+   * Checks whether values of type {@code type} can be casted to this type.
    */
   public boolean isConvertibleFrom(@NotNull PsiType type) {
     return TypeConversionUtil.areTypesConvertible(type, this);
@@ -272,7 +272,7 @@ public abstract class PsiType implements PsiAnnotationOwner, Cloneable {
   /**
    * Returns the innermost component type for an array type.
    *
-   * @return the innermost (non-array) component of the type, or <code>this</code> if the type is not
+   * @return the innermost (non-array) component of the type, or {@code this} if the type is not
    *         an array type.
    */
   @NotNull
index 501617930bb1a30253aa58aee4b4c07eccbffcd7..9fb350491e02c7097dbfaa57ccf0778cd8c72668 100644 (file)
@@ -36,10 +36,10 @@ public interface PsiTypeCodeFragment extends JavaCodeFragment {
     throws TypeSyntaxException, NoTypeException;
 
   /**
-   * Checks if <code>void</code> is treated as a valid type for the contents of
+   * Checks if {@code void} is treated as a valid type for the contents of
    * the code fragment.
    *
-   * @return true if <code>void</code> is a valid type, false otherwise.
+   * @return true if {@code void} is a valid type, false otherwise.
    */
   boolean isVoidValid();
 
index 507c57d25d21697e4ff24b271875975c7f17e1b0..030284d1abeaeb6d86fd5ab6d53d56d1ae05bc89 100644 (file)
@@ -62,8 +62,8 @@ public interface PsiVariable extends PsiModifierListOwner, PsiNameIdentifierOwne
   /**
    * Ensures that the variable declaration is not combined in the same statement with
    * other declarations. Also, if the variable is an array, ensures that the array
-   * brackets are used in Java style (<code>int[] a</code>)
-   * and not in C style (<code> int a[]</code>).
+   * brackets are used in Java style ({@code int[] a})
+   * and not in C style ({@code int a[]}).
    *
    * @throws IncorrectOperationException if the modification fails for some reason.
    */
index bdc3f58a875cd81857f2cd075a1439953314ce81..20ad844921fdaf48ebb7bf9bf0c3aaa27d47c2c3 100644 (file)
@@ -18,7 +18,7 @@ package com.intellij.psi;
 import org.jetbrains.annotations.Nullable;
 
 /**
- * Represents a Java <code>while</code> statement.
+ * Represents a Java {@code while} statement.
  */
 public interface PsiWhileStatement extends PsiLoopStatement {
   /**
index 4662aacb3fc3acd73641f30e4bbce0e1cab6e12c..4e1d09ad7ef9b02a4c92c614802159a74bfa019a 100644 (file)
@@ -172,7 +172,7 @@ public class PsiWildcardType extends PsiType.Stub {
   /**
    * Use this method to obtain a bound of wildcard type.
    *
-   * @return <code>null</code> if unbounded, a bound otherwise.
+   * @return {@code null} if unbounded, a bound otherwise.
    */
   @Nullable
   public PsiType getBound() {
@@ -190,9 +190,9 @@ public class PsiWildcardType extends PsiType.Stub {
   }
 
   /**
-   * Returns whether this is a lower bound (<code>? extends XXX</code>).
+   * Returns whether this is a lower bound ({@code ? extends XXX}).
    *
-   * @return <code>true</code> for <code>extends</code> wildcards, <code>false</code> for <code>super</code>
+   * @return {@code true} for {@code extends} wildcards, {@code false} for {@code super}
    *         and unbounded wildcards.
    */
   public boolean isExtends() {
@@ -200,9 +200,9 @@ public class PsiWildcardType extends PsiType.Stub {
   }
 
   /**
-   * Returns whether this is an upper bound (<code>? super XXX</code>).
+   * Returns whether this is an upper bound ({@code ? super XXX}).
    *
-   * @return <code>true</code> for <code>super</code> wildcards, <code>false</code> for <code>extends</code>
+   * @return {@code true} for {@code super} wildcards, {@code false} for {@code extends}
    *         and unbounded wildcards.
    */
   public boolean isSuper() {
@@ -220,12 +220,12 @@ public class PsiWildcardType extends PsiType.Stub {
    * A lower bound that this wildcard imposes on type parameter value.<br>
    * That is:<br>
    * <ul>
-   * <li> for <code>? extends XXX</code>: <code>XXX</code>
-   * <li> for <code>? super XXX</code>: <code>java.lang.Object</code>
-   * <li> for <code>?</code>: <code>java.lang.Object</code>
+   * <li> for {@code ? extends XXX}: {@code XXX}
+   * <li> for {@code ? super XXX}: {@code java.lang.Object}
+   * <li> for {@code ?}: {@code java.lang.Object}
    * </ul>
    *
-   * @return <code>PsiType</code> representing a lower bound. Never returns <code>null</code>.
+   * @return {@code PsiType} representing a lower bound. Never returns {@code null}.
    */
   @NotNull
   public PsiType getExtendsBound() {
@@ -239,12 +239,12 @@ public class PsiWildcardType extends PsiType.Stub {
    * An upper bound that this wildcard imposes on type parameter value.<br>
    * That is:<br>
    * <ul>
-   * <li> for <code>? extends XXX</code>: null type
-   * <li> for <code>? super XXX</code>: <code>XXX</code>
-   * <li> for <code>?</code>: null type
+   * <li> for {@code ? extends XXX}: null type
+   * <li> for {@code ? super XXX}: {@code XXX}
+   * <li> for {@code ?}: null type
    * </ul>
    *
-   * @return <code>PsiType</code> representing an upper bound. Never returns <code>null</code>.
+   * @return {@code PsiType} representing an upper bound. Never returns {@code null}.
    */
   @NotNull
   public PsiType getSuperBound() {
index 2f10f34751812447939added2123bf5edd754912..8c22db6ecbd283dfaad431c915749c9866eca473 100644 (file)
@@ -92,7 +92,7 @@ public abstract class JavaCodeStyleManager {
   public abstract PsiImportList prepareOptimizeImportsResult(@NotNull PsiJavaFile file);
 
   /**
-   * Single-static-import <code>import static classFQN.referenceName;</code> shadows on-demand static imports, like described
+   * Single-static-import {@code import static classFQN.referenceName;} shadows on-demand static imports, like described
    * JLS 6.4.1
    * A single-static-import declaration d in a compilation unit c of package p that imports a {member} named n
    * shadows the declaration of any static {member} named n imported by a static-import-on-demand declaration in c, throughout c.
index 5acfb3cfb4a6ff119ed39b993872059751b3e3e0..015a24581f2f32967455b80e7fee0823c7421d54 100644 (file)
@@ -32,11 +32,11 @@ public abstract class JavaClassSupers {
   }
 
   /**
-   * Calculates substitutor that binds type parameters in <code>superClass</code> with
-   * values that they have in <code>derivedClass</code>, given that type parameters in
-   * <code>derivedClass</code> are bound by <code>derivedSubstitutor</code>.
+   * Calculates substitutor that binds type parameters in {@code superClass} with
+   * values that they have in {@code derivedClass}, given that type parameters in
+   * {@code derivedClass} are bound by {@code derivedSubstitutor}.
    *
-   * @return substitutor or <code>null</code>, if <code>derivedClass</code> doesn't inherit <code>superClass</code>
+   * @return substitutor or {@code null}, if {@code derivedClass} doesn't inherit {@code superClass}
    * @see PsiClass#isInheritor(PsiClass, boolean)
    * @see InheritanceUtil#isInheritorOrSelf(PsiClass, PsiClass, boolean)
    */
index e65a24c418dcd96c0a446caa331ed464b4b22664..d79299b27445634021b0b918fbacc9d0f4348735 100644 (file)
@@ -624,7 +624,7 @@ public final class PsiUtil extends PsiUtilCore {
 
   /**
    * Compares types with respect to type parameter bounds: e.g. for
-   * <code>class Foo&lt;T extends Number&gt;{}</code> types Foo&lt;?&gt; and Foo&lt;? extends Number&gt;
+   * {@code class Foo<T extends Number>{}} types Foo&lt;?&gt; and Foo&lt;? extends Number&gt;
    * would be equivalent
    */
   public static boolean equalOnEquivalentClasses(PsiClassType thisClassType,
index 7202496daab09317a369bdf5193ea952f400ebcd..6d5b540be35fd92b1c4fd3d008278d1742be785b 100644 (file)
@@ -711,8 +711,8 @@ public class TypeConversionUtil {
    *
    * @param left  type to assign to
    * @param right type of value
-   * @return true if value of type <code>right</code> can be assigned to an l-value of
-   *         type <code>left</code>
+   * @return true if value of type {@code right} can be assigned to an l-value of
+   *         type {@code left}
    */
   public static boolean isAssignable(@NotNull PsiType left, @NotNull PsiType right) {
     return isAssignable(left, right, true);
@@ -1084,13 +1084,13 @@ public class TypeConversionUtil {
   private static final Set<String> ourReportedSuperClassSubstitutorExceptions = ContainerUtil.newConcurrentSet();
 
   /**
-   * Calculates substitutor that binds type parameters in <code>superClass</code> with
-   * values that they have in <code>derivedClass</code>, given that type parameters in
-   * <code>derivedClass</code> are bound by <code>derivedSubstitutor</code>.
-   * <code>superClass</code> must be a super class/interface of <code>derivedClass</code> (as in
-   * <code>InheritanceUtil.isInheritorOrSelf(derivedClass, superClass, true)</code>
+   * Calculates substitutor that binds type parameters in {@code superClass} with
+   * values that they have in {@code derivedClass}, given that type parameters in
+   * {@code derivedClass} are bound by {@code derivedSubstitutor}.
+   * {@code superClass} must be a super class/interface of {@code derivedClass} (as in
+   * {@code InheritanceUtil.isInheritorOrSelf(derivedClass, superClass, true)}
    *
-   * @return substitutor (never returns <code>null</code>)
+   * @return substitutor (never returns {@code null})
    * @see PsiClass#isInheritor(PsiClass, boolean)
    * @see InheritanceUtil#isInheritorOrSelf(PsiClass, PsiClass, boolean)
    */
index fa48fe108c43ff48446077b4974d45b3b7bd36db..356ce61b53fc550eeabe5c512fed2e0597a840d4 100644 (file)
@@ -457,9 +457,9 @@ public class ControlFlowUtil {
    *   if (status == FINISHED) LOG.info("Finished"); // can get PREPARING or WORKING here in the case of exception
    * } // --- end of theOuterBlock ---
    * </pre>
-   * In the example above <code>hasObservableThrowExitPoints(theTryBlock) == true</code>,
+   * In the example above {@code hasObservableThrowExitPoints(theTryBlock) == true},
    * because the resulting value of the "status" variable depends on the exceptions being thrown.
-   * In the same example <code>hasObservableThrowExitPoints(theOuterBlock) == false</code>,
+   * In the same example {@code hasObservableThrowExitPoints(theOuterBlock) == false},
    * because no outgoing variables here depend on the exceptions being thrown.
    */
   public static boolean hasObservableThrowExitPoints(final @NotNull ControlFlow flow,
index 9680725c73fdf9e7c98a4fa529fded57d659a3e8..75f9f5e83248e96bd29238a127bffc7eeb757cbe 100644 (file)
@@ -34,7 +34,7 @@ public interface SourceJavaCodeReference {
 
   /**
    * Helper method for ReferenceAdjuster. Tries to qualify this reference as if
-   * it references <code>targetClass</code>. Does not check that it indeed references
+   * it references {@code targetClass}. Does not check that it indeed references
    * targetClass
    */
   void fullyQualify(@NotNull PsiClass targetClass);
index cb7fbea9ff4c6936130a8d728fa3b68dd4743d8b..359ef51e804e8252ae9a70ccaf3e77a870de653c 100644 (file)
@@ -148,7 +148,7 @@ public class ParameterListElement extends CompositeElement implements Constants
   }
 
   /**
-   * @return last node before closing right parenthesis if possible; <code>null</code> otherwise
+   * @return last node before closing right parenthesis if possible; {@code null} otherwise
    */
   @Nullable
   private TreeElement getLastNodeInsideParens() {
@@ -157,7 +157,7 @@ public class ParameterListElement extends CompositeElement implements Constants
   }
 
   /**
-   * @return first node after opening left parenthesis if possible; <code>null</code> otherwise
+   * @return first node after opening left parenthesis if possible; {@code null} otherwise
    */
   @Nullable
   private TreeElement getFirstNodeInsideParens() {
index de1f07a1d98e6f8067c8d07de0189c07b524dd0c..bd1da48b15043a10606d886a22fe07a171870c9f 100644 (file)
@@ -36,7 +36,7 @@ public abstract class JavaRefactoringActionHandlerFactory {
    *
    * {@link RefactoringActionHandler#invoke(com.intellij.openapi.project.Project, com.intellij.psi.PsiElement[], com.intellij.openapi.actionSystem.DataContext)}
    * accepts either a {@link com.intellij.psi.PsiClass}, {@link com.intellij.psi.PsiField} or {@link com.intellij.psi.PsiMethod}.
-   * In latter two cases, <code>elements[0]</code> is a member that will be preselected.
+   * In latter two cases, {@code elements[0]} is a member that will be preselected.
    */
   public abstract RefactoringActionHandler createPullUpHandler();
 
@@ -45,7 +45,7 @@ public abstract class JavaRefactoringActionHandlerFactory {
    *
    * {@link RefactoringActionHandler#invoke(com.intellij.openapi.project.Project, com.intellij.psi.PsiElement[], com.intellij.openapi.actionSystem.DataContext)}
    * accepts either a {@link com.intellij.psi.PsiClass}, {@link com.intellij.psi.PsiField} or {@link com.intellij.psi.PsiMethod}.
-   * In latter two cases, <code>elements[0]</code> is a member that will be preselected.
+   * In latter two cases, {@code elements[0]} is a member that will be preselected.
    */
   public abstract RefactoringActionHandler createPushDownHandler();
 
@@ -53,7 +53,7 @@ public abstract class JavaRefactoringActionHandlerFactory {
    * Creates handler for Use Interface Where Possible refactoring.<p>
    *
    * {@link RefactoringActionHandler#invoke(com.intellij.openapi.project.Project, com.intellij.psi.PsiElement[], com.intellij.openapi.actionSystem.DataContext)}
-   * accepts 1 <code>PsiClass</code>.
+   * accepts 1 {@code PsiClass}.
    * @return
    */
   public abstract RefactoringActionHandler createTurnRefsToSuperHandler();
@@ -70,8 +70,8 @@ public abstract class JavaRefactoringActionHandlerFactory {
    * Creates handler for Introduce Parameter refactoring.<p>
    *
    * {@link RefactoringActionHandler#invoke(com.intellij.openapi.project.Project, com.intellij.psi.PsiElement[], com.intellij.openapi.actionSystem.DataContext)}
-   * accepts either 1 <code>PsiExpression</code>, that will be an initialzier for introduced parameter,
-   * or 1 <code>PsiLocalVariable</code>, that will be replaced with introduced parameter.
+   * accepts either 1 {@code PsiExpression}, that will be an initialzier for introduced parameter,
+   * or 1 {@code PsiLocalVariable}, that will be replaced with introduced parameter.
    */
   public abstract RefactoringActionHandler createIntroduceParameterHandler();
 
@@ -79,7 +79,7 @@ public abstract class JavaRefactoringActionHandlerFactory {
    * Creates handler for Make Method Static refactoring.<p>
    *
    * {@link RefactoringActionHandler#invoke(com.intellij.openapi.project.Project, com.intellij.psi.PsiElement[], com.intellij.openapi.actionSystem.DataContext)}
-   * accepts 1 <code>PsiMethod</code>.
+   * accepts 1 {@code PsiMethod}.
    */
   public abstract RefactoringActionHandler createMakeMethodStaticHandler();
 
@@ -87,7 +87,7 @@ public abstract class JavaRefactoringActionHandlerFactory {
    * Creates handler for Convert To Instance Method refactoring.<p>
    *
    * {@link RefactoringActionHandler#invoke(com.intellij.openapi.project.Project, com.intellij.psi.PsiElement[], com.intellij.openapi.actionSystem.DataContext)}
-   * accepts 1 <code>PsiMethod</code>.
+   * accepts 1 {@code PsiMethod}.
    */
   public abstract RefactoringActionHandler createConvertToInstanceMethodHandler();
 
@@ -95,7 +95,7 @@ public abstract class JavaRefactoringActionHandlerFactory {
    * Creates handler for Replace Constructor With Factory Method refactoring.<p>
    *
    * {@link RefactoringActionHandler#invoke(com.intellij.openapi.project.Project, com.intellij.psi.PsiElement[], com.intellij.openapi.actionSystem.DataContext)}
-   * accepts either a <code>PsiMethod</code> that is a constructor, or a <code>PsiClass</code>
+   * accepts either a {@code PsiMethod} that is a constructor, or a {@code PsiClass}
    * with implicit default constructor.
    */
   public abstract RefactoringActionHandler createReplaceConstructorWithFactoryHandler();
@@ -105,7 +105,7 @@ public abstract class JavaRefactoringActionHandlerFactory {
    * Creates handler for Replace Constructor With Factory Method refactoring.<p>
    *
    * {@link RefactoringActionHandler#invoke(com.intellij.openapi.project.Project, com.intellij.psi.PsiElement[], com.intellij.openapi.actionSystem.DataContext)}
-   * accepts either a <code>PsiClass</code> or any number of <code>PsiField</code>s.
+   * accepts either a {@code PsiClass} or any number of {@code PsiField}s.
    */
   public abstract RefactoringActionHandler createEncapsulateFieldsHandler();
 
@@ -113,7 +113,7 @@ public abstract class JavaRefactoringActionHandlerFactory {
    * Creates handler for Replace Method Code Duplicates refactoring.<p>
    *
    * {@link RefactoringActionHandler#invoke(com.intellij.openapi.project.Project, com.intellij.psi.PsiElement[], com.intellij.openapi.actionSystem.DataContext)}
-   * accepts one <code>PsiMethod</code>.
+   * accepts one {@code PsiMethod}.
    */
   public abstract RefactoringActionHandler createMethodDuplicatesHandler();
 
@@ -121,7 +121,7 @@ public abstract class JavaRefactoringActionHandlerFactory {
    * Creates handler for Change Method/Class Signature refactoring.<p>
    *
    * {@link RefactoringActionHandler#invoke(com.intellij.openapi.project.Project, com.intellij.psi.PsiElement[], com.intellij.openapi.actionSystem.DataContext)}
-   * accepts either 1 <code>PsiMethod</code> or 1 <code>PsiClass</code>
+   * accepts either 1 {@code PsiMethod} or 1 {@code PsiClass}
    */
   public abstract RefactoringActionHandler createChangeSignatureHandler();
 
@@ -129,7 +129,7 @@ public abstract class JavaRefactoringActionHandlerFactory {
    * Creates handler for Extract Superclass refactoring.<p>
    *
    * {@link RefactoringActionHandler#invoke(com.intellij.openapi.project.Project, com.intellij.psi.PsiElement[], com.intellij.openapi.actionSystem.DataContext)}
-   * accepts 1 <code>PsiClass</code>.
+   * accepts 1 {@code PsiClass}.
    */
   public abstract RefactoringActionHandler createExtractSuperclassHandler();
 
@@ -137,7 +137,7 @@ public abstract class JavaRefactoringActionHandlerFactory {
    * Creates handler for Generify (aka Type Cook) refactoring.<p>
    *
    * {@link RefactoringActionHandler#invoke(com.intellij.openapi.project.Project, com.intellij.psi.PsiElement[], com.intellij.openapi.actionSystem.DataContext)}
-   * accepts any number of arbitrary <code>PsiElement</code>s. All code inside these elements will be generified.
+   * accepts any number of arbitrary {@code PsiElement}s. All code inside these elements will be generified.
    */
   public abstract RefactoringActionHandler createTypeCookHandler();
 
@@ -145,7 +145,7 @@ public abstract class JavaRefactoringActionHandlerFactory {
    * Creates handler for Inline refactoring.<p>
    *
    * {@link RefactoringActionHandler#invoke(com.intellij.openapi.project.Project, com.intellij.psi.PsiElement[], com.intellij.openapi.actionSystem.DataContext)}
-   * accepts 1 inlinable <code>PsiElement</code> (method, local variable or constant).
+   * accepts 1 inlinable {@code PsiElement} (method, local variable or constant).
    */
   public abstract RefactoringActionHandler createInlineHandler();
 
@@ -163,7 +163,7 @@ public abstract class JavaRefactoringActionHandlerFactory {
    * Creates handler for Extract Interface refactoring.<p>
    *
    * {@link RefactoringActionHandler#invoke(com.intellij.openapi.project.Project, com.intellij.psi.PsiElement[], com.intellij.openapi.actionSystem.DataContext)}
-   * accepts 1 <code>PsiClass</code>.
+   * accepts 1 {@code PsiClass}.
    */
   public abstract RefactoringActionHandler createExtractInterfaceHandler();
 
@@ -171,8 +171,8 @@ public abstract class JavaRefactoringActionHandlerFactory {
    * Creates handler for Introduce Field refactoring.<p>
    *
    * {@link RefactoringActionHandler#invoke(com.intellij.openapi.project.Project, com.intellij.psi.PsiElement[], com.intellij.openapi.actionSystem.DataContext)}
-   * accepts either 1 <code>PsiExpression</code>, that will be an initialzier for introduced field,
-   * or 1 <code>PsiLocalVariable</code>, that will be replaced with introduced field.
+   * accepts either 1 {@code PsiExpression}, that will be an initialzier for introduced field,
+   * or 1 {@code PsiLocalVariable}, that will be replaced with introduced field.
    */
   public abstract RefactoringActionHandler createIntroduceFieldHandler();
 
@@ -180,7 +180,7 @@ public abstract class JavaRefactoringActionHandlerFactory {
    * Creates handler for Introduce Variable refactoring.<p>
    *
    * {@link RefactoringActionHandler#invoke(com.intellij.openapi.project.Project, com.intellij.psi.PsiElement[], com.intellij.openapi.actionSystem.DataContext)}
-   * accepts 1 <code>PsiExpression</code>, that will be an initialzier for introduced variable.
+   * accepts 1 {@code PsiExpression}, that will be an initialzier for introduced variable.
    */
   public abstract RefactoringActionHandler createIntroduceVariableHandler();
 
@@ -188,8 +188,8 @@ public abstract class JavaRefactoringActionHandlerFactory {
    * Creates handler for Introduce Constant refactoring.<p>
    *
    * {@link RefactoringActionHandler#invoke(com.intellij.openapi.project.Project, com.intellij.psi.PsiElement[], com.intellij.openapi.actionSystem.DataContext)}
-   * accepts either 1 <code>PsiExpression</code>, that will be an initialzier for introduced constant,
-   * or 1 <code>PsiLocalVariable</code>, that will be replaced with introduced constant.
+   * accepts either 1 {@code PsiExpression}, that will be an initialzier for introduced constant,
+   * or 1 {@code PsiLocalVariable}, that will be replaced with introduced constant.
    */
   public abstract RefactoringActionHandler createIntroduceConstantHandler();
 
@@ -197,7 +197,7 @@ public abstract class JavaRefactoringActionHandlerFactory {
    * Creates handler for Invert Boolean refactoring.<p>
    *
    * {@link RefactoringActionHandler#invoke(com.intellij.openapi.project.Project, com.intellij.psi.PsiElement[], com.intellij.openapi.actionSystem.DataContext)}
-   * accepts 1 <code>PsiMethod</code>, that will be inverted
+   * accepts 1 {@code PsiMethod}, that will be inverted
    */
   public abstract RefactoringActionHandler createInvertBooleanHandler();
 }
index 0713b41fce48aa892998c359af3632bd5299eaf8..e625e4fd6bda843419e817fc7cf733f7a98cff03 100644 (file)
@@ -100,7 +100,7 @@ public abstract class JavaRefactoringFactory extends RefactoringFactory {
    * @param parameterInitializer Initializer to use in method calls.
    * @param localVariable local variable that will be replaced
    * @param removeLocalVariable should local variable be removed
-   * @param declareFinal should created parameter be declared <code>final</code>
+   * @param declareFinal should created parameter be declared {@code final}
    */
   public abstract IntroduceParameterRefactoring createIntroduceParameterRefactoring(PsiMethod methodToReplaceIn,
                                                                                     PsiMethod methodToSearchFor,
@@ -115,7 +115,7 @@ public abstract class JavaRefactoringFactory extends RefactoringFactory {
    * @param parameterName Name of new parameter.
    * @param parameterInitializer Initializer to use in method calls.
    * @param expressionToSearchFor expression that should be replaced with parameters
-   * @param declareFinal should created parameter be declared <code>final</code>
+   * @param declareFinal should created parameter be declared {@code final}
    * @param replaceAllOccurences should all occurences of expression be replaced
    */
   public abstract IntroduceParameterRefactoring createIntroduceParameterRefactoring(PsiMethod methodToReplaceIn,
index 229a5dc7fcbea3942abed5e4a7fbb1bdad59e703..56857a05e5eaab3e6fd718850e019c68941e04f0 100644 (file)
@@ -37,7 +37,7 @@ import java.util.Map;
 /**
  * Represents a destination of Move Classes/Packages refactoring.
  * Destination of Move refactoring is generally a single package,
- * and various <code>MoveDestination</code>s control how moved items
+ * and various {@code MoveDestination}s control how moved items
  * will be layouted in directories corresponding to target packages.
  *
  * Instances of this interface can be obtained via methods of {@link RefactoringFactory}.
index 1b342b29eff62eacf24770fac5f2635a255c9e5f..fc57d8733d4ea6c8fd7aec546cbd7c68dc30f466 100644 (file)
@@ -17,7 +17,7 @@ import org.jetbrains.annotations.Nullable;
  * <p/>
  * Examples:
  * <ol>
- * <li>{@code [42]} converts to <code>[{"property": 42}]</code></li>
+ * <li>{@code [42]} converts to {@code [{"property": 42}]}</li>
  * <li><pre>
  * {
  *    "foo": 42,
index 0cba5404e11bb7da9743f684882110d0b434bab6..ccb8cc1034d05ab44c2107dab2ff3fcbc6beb1c5 100644 (file)
@@ -24,7 +24,7 @@ import org.jetbrains.annotations.NotNull;
 public interface EmptyResolveMessageProvider {
 
   /**
-   * Returns custom unresolved message pattern. First, returned value is used as pattern in <code>MessageFormat.format()</code> call.
+   * Returns custom unresolved message pattern. First, returned value is used as pattern in {@code MessageFormat.format()} call.
    * If the call fails, returned value is used as is.
    * @return pattern or message
    * @see XmlHighlightVisitor#getErrorDescription()
index 7494773f7c59c67839bbdd1f03db029d5ef2ded8..1376781c1056c6d2a80ec48b7df0ce47b0e2f991 100644 (file)
@@ -46,10 +46,10 @@ public abstract class IntentionManager  {
 
   /**
    * @deprecated Use {@link #getInstance()} unstead.
-   * Returns instance of <code>IntentionManager</code> for given project.
+   * Returns instance of {@code IntentionManager} for given project.
    *
    * @param project the project for which the instance is returned.
-   * @return instance of the <code>IntentionManager</code> assigned for given project.
+   * @return instance of the {@code IntentionManager} assigned for given project.
    */
   @Deprecated
   public static IntentionManager getInstance(Project project) {
@@ -88,12 +88,12 @@ public abstract class IntentionManager  {
    * Registers an intention action which can be enabled or disabled through the "Intention
    * Settings" dialog. To provide the description and the example code for the intention,
    * the directory with the name equal to {@link IntentionAction#getFamilyName()} needs to
-   * be created under the <code>intentionDescriptions</code> directory of the resource root.
-   * The directory needs to contain three files. <code>description.html</code> provides the
-   * description of the intention, <code>before.java.template</code> provides the sample code
-   * before the intention is invoked, and <code>after.java.template</code> provides the sample
+   * be created under the {@code intentionDescriptions} directory of the resource root.
+   * The directory needs to contain three files. {@code description.html} provides the
+   * description of the intention, {@code before.java.template} provides the sample code
+   * before the intention is invoked, and {@code after.java.template} provides the sample
    * code after invoking the intention. The templates can contain a fragment of code surrounded
-   * with <code>&lt;spot&gt;</code> and <code>&lt;/spot&gt;</code> markers. If present, that fragment
+   * with {@code <spot>} and {@code </spot>} markers. If present, that fragment
    * will be surrounded by a blinking rectangle in the inspection preview pane.
    *
    * @param action   the intention action to register.
index 9e51862f024dc0ceb53e2cab2bcdf9076affb770..5ecf2cb11ed5bf59ae1e78ee868f185deda374f8 100644 (file)
@@ -32,8 +32,8 @@ public interface CommonProblemDescriptor {
 
   /**
    * Returns the template from which the problem description is built. The template may
-   * contain special markers: <code>#ref</code> is replaced with the text of the element
-   * in which the problem has been found, and <code>#loc</code> is replaced with the filename
+   * contain special markers: {@code #ref} is replaced with the text of the element
+   * in which the problem has been found, and {@code #loc} is replaced with the filename
    * and line number in exported inspection results and ignored when viewing within IDEA.
    *
    * @return the template for the problem description.
index 6d899616a626e9ffc29036fe0ddfcb6eb7a8a86c..dbdce739369ab80d1c459fd01988e7c2f7077a73 100644 (file)
@@ -44,7 +44,7 @@ public abstract class InspectionManager {
   /**
    * Factory method for ProblemDescriptor. Should be called from LocalInspectionTool.checkXXX() methods.
    * @param psiElement problem is reported against
-   * @param descriptionTemplate problem message. Use <code>#ref</code> for a link to problem piece of code and <code>#loc</code> for location in source code.
+   * @param descriptionTemplate problem message. Use {@code #ref} for a link to problem piece of code and {@code #loc} for location in source code.
    * @param fix should be null if no fix is provided.
    * @param onTheFly for local tools on batch run
    */
index a2744bc89b90d8acca6e0f80d6a5fba1f8386e7c..a39e0831d0b95b9886e1ea8649d500fcb5439bfb 100644 (file)
@@ -114,7 +114,7 @@ public abstract class LocalInspectionTool extends InspectionProfileEntry {
    * @param file       to check.
    * @param manager    InspectionManager to ask for ProblemDescriptor's from.
    * @param isOnTheFly true if called during on the fly editor highlighting. Called from Inspect Code action otherwise.
-   * @return <code>null</code> if no problems found or not applicable at file level.
+   * @return {@code null} if no problems found or not applicable at file level.
    */
   @Nullable
   public ProblemDescriptor[] checkFile(@NotNull PsiFile file, @NotNull InspectionManager manager, boolean isOnTheFly) {
index e1f139c07ff40be8ac7c382e9fda03aefdd486ee..ebae56ed25d0e5dd8ca4123d6906597db7ae0885 100644 (file)
@@ -47,7 +47,7 @@ public abstract class RefGraphAnnotator {
    *
    * @param refWhat                        the referenced element.
    * @param refFrom                        the referencing element.
-   * @param referencedFromClassInitializer if true, <code>refFrom</code> is a class and the reference
+   * @param referencedFromClassInitializer if true, {@code refFrom} is a class and the reference
    *                                       has been found in its initializer block.
    */
   public void onMarkReferenced(RefElement refWhat,
@@ -60,7 +60,7 @@ public abstract class RefGraphAnnotator {
    *
    * @param refWhat                        the referenced element.
    * @param refFrom                        the referencing element.
-   * @param referencedFromClassInitializer if true, <code>refFrom</code> is a class and the reference
+   * @param referencedFromClassInitializer if true, {@code refFrom} is a class and the reference
    *                                       has been found in its initializer block.
    * @param forReading                     used for reading
    * @param forWriting                     used for writing
@@ -78,7 +78,7 @@ public abstract class RefGraphAnnotator {
    * Called when 'what' element doesn't belong to the selected scope. 
    * @param what                            the referenced element
    * @param from                            the referencing element
-   * @param referencedFromClassInitializer if true, <code>refFrom</code> is a class and the reference
+   * @param referencedFromClassInitializer if true, {@code refFrom} is a class and the reference
    *                                       has been found in its initializer block.
    */
   public void onMarkReferenced(PsiElement what,
index 3cee6c300af499bdd0ba5f18ed84d9430e3d6d11..d0d6ab02c99cb0cf7900fed4234b5fb08ca03281 100644 (file)
@@ -71,7 +71,7 @@ public abstract class RefManager {
    * Creates (if necessary) and returns the reference graph node for the specified module.
    *
    * @param module the module for which the reference graph node is requested.
-   * @return the node for the module, or null if <code>module</code> is null.
+   * @return the node for the module, or null if {@code module} is null.
    */
   @Nullable
   public abstract RefModule getRefModule(Module module);
index 273c21420abf76b31ad019db682376290397672b..429022fb997039e0905c20ba2fc40b09c6de9218 100644 (file)
@@ -361,7 +361,7 @@ public final class Annotation implements Segment {
   /**
    * File level annotations are visualized differently than lesser range annotations by showing a title bar on top of the
    * editor rather than applying text attributes to the text range.
-   * @return <code>true</code> if this particular annotation have been defined as file level.
+   * @return {@code true} if this particular annotation have been defined as file level.
    */
   public boolean isFileLevelAnnotation() {
     return myIsFileLevelAnnotation;
@@ -370,7 +370,7 @@ public final class Annotation implements Segment {
   /**
    * File level annotations are visualized differently than lesser range annotations by showing a title bar on top of the
    * editor rather than applying text attributes to the text range.
-   * @param isFileLevelAnnotation <code>true</code> if this particular annotation should be visualized at file level.
+   * @param isFileLevelAnnotation {@code true} if this particular annotation should be visualized at file level.
    */
   public void setFileLevelAnnotation(final boolean isFileLevelAnnotation) {
     myIsFileLevelAnnotation = isFileLevelAnnotation;
index f1e76bbf9148165503babe31aa0658be85067b70..6d58e9d349ea20c1680aa35328073084cfe4e647 100644 (file)
@@ -22,9 +22,9 @@ import java.lang.annotation.Target;
 
 /**
  * This annotation assists the 'Data flow to this' feature by describing data flow
- * from the method parameter to the corresponding container (e.g. <code>ArrayList.add(item)</code>)
- * or from the container to the method return value (e.g. <code>Set.toArray()</code>)
- * or between method parameters (e.g. <code>System.arraycopy(array1, 0, array2, length)</code>)
+ * from the method parameter to the corresponding container (e.g. {@code ArrayList.add(item)})
+ * or from the container to the method return value (e.g. {@code Set.toArray()})
+ * or between method parameters (e.g. {@code System.arraycopy(array1, 0, array2, length)})
  */
 @Retention(RetentionPolicy.CLASS)
 @Target({ElementType.PARAMETER, ElementType.METHOD})
@@ -34,12 +34,12 @@ public @interface Flow {
    * Allowed values are:<br>
    *
    * <ul>
-   * <li><code>THIS_SOURCE</code> - Means that the data flows from this container.<br>
+   * <li>{@code THIS_SOURCE} - Means that the data flows from this container.<br>
    *     E.g. annotation for java.util.List method get(index) means the method reads contents of list and returns it.<br>
    *     {@code @Flow(source = THIS_SOURCE) T get(int index);}<br>
    * </li>
    * <li>
-   *   <code>this.</code>Field name - means that the data flows from this container some (synthetic) field.<br>
+   *   {@code this.}Field name - means that the data flows from this container some (synthetic) field.<br>
    *   E.g. annotation for java.util.Map.keySet() method here means that it returns data from the map from the field named "keys".<br>
    *   {@code @Flow(source = "this.keys") Set<K> keySet();}
    * </li>
@@ -77,7 +77,7 @@ public @interface Flow {
    * Allowed values are:<br>
    *
    * <ul>
-   * <li><code>THIS_TARGET</code> - Means that the data flows inside this container (of the class the annotated method belongs to).<br>
+   * <li>{@code THIS_TARGET} - Means that the data flows inside this container (of the class the annotated method belongs to).<br>
    *     E.g. annotation for java.util.List method add(element) means the method takes the argument and passes it to this collection.<br>
    *     {@code boolean add(@Flow(target=THIS_TARGET, targetIsContainer=true) E element);}<br>
    * </li>
@@ -88,7 +88,7 @@ public @interface Flow {
    *    means that java.lang.System.arraycopy() method takes its first argument and passes it to the "dest" parameter.
    * </li>
    * <li>
-   *   <code>this.</code>Field name - means that the data flows to this container in some (synthetic) field.<br>
+   *   {@code this.}Field name - means that the data flows to this container in some (synthetic) field.<br>
    *   E.g. annotation for java.util.Map.put(key, value) method here means that it takes the argument 'key' and stores the data in some (hidden) field named "keys".<br>
    *   {@code V put(@Flow(target = "this.keys", targetIsContainer=true) K key, V value);}
    * </li>
index 361a95ba130d622ae67de30fafa627675a31f297..662c347e5704708262f04a80be686f11a5a85dbf 100644 (file)
@@ -39,9 +39,9 @@ import java.lang.annotation.*;
  * <li> fail - the method throws an exception, if the arguments satisfy argument constraints
  * </ul>
  * Examples:<p>
- * <code>@Contract("_, null -&gt; null")</code> - method returns null if its second argument is null<br>
- * <code>@Contract("_, null -&gt; null; _, !null -&gt; !null")</code> - method returns null if its second argument is null and not-null otherwise<br>
- * <code>@Contract("true -&gt; fail")</code> - a typical assertFalse method which throws an exception if <code>true</code> is passed to it<br>
+ * {@code @Contract("_, null -> null")} - method returns null if its second argument is null<br>
+ * {@code @Contract("_, null -> null; _, !null -> !null")} - method returns null if its second argument is null and not-null otherwise<br>
+ * {@code @Contract("true -> fail")} - a typical assertFalse method which throws an exception if {@code true} is passed to it<br>
  *
  */
 @Documented
index 5b5d3f3e19ffb92341f6b5c8facd11ddc8588c78..790ea76daea7219bf455f36ace7726128e4ec81b 100644 (file)
@@ -23,25 +23,25 @@ import java.lang.annotation.*;
  * or does not contain such strings. This annotation is intended to be used by localization tools for
  * detecting strings which should not be reported as requiring localization.
  * <ul>
- * <li>If a method parameter is annotated with <code>NonNls</code>, the strings passed
+ * <li>If a method parameter is annotated with {@code NonNls}, the strings passed
  * as values of this parameter are not reported as requiring localization.
- * Also, if the parameter of a property setter method is annotated with <code>NonNls</code>, values
+ * Also, if the parameter of a property setter method is annotated with {@code NonNls}, values
  * of that property in UI Designer forms are never highlighted as hard-coded strings.</li>
- * <li>If a field is annotated with <code>NonNls</code>, all string literals found in the
+ * <li>If a field is annotated with {@code NonNls}, all string literals found in the
  * initializer of the field are not reported as requiring localization.</li>
- * <li>If a method is called on a field, parameter or local variable annotated with <code>NonNls</code>,
+ * <li>If a method is called on a field, parameter or local variable annotated with {@code NonNls},
  * string literals passed as parameters to the method are not reported as requiring localization.
- * <li>If a field, parameter or local variable annotated with <code>NonNls</code> is passed as a
- * parameter to the <code>equals()</code> method invoked on a string literal, the literal is not
+ * <li>If a field, parameter or local variable annotated with {@code NonNls} is passed as a
+ * parameter to the {@code equals()} method invoked on a string literal, the literal is not
  * reported as requiring localization.</li>
- * <li>If a field, parameter or local variable annotated with <code>NonNls</code> is found at
+ * <li>If a field, parameter or local variable annotated with {@code NonNls} is found at
  * the left side of an assignment expression, all string literals in the right side
  * of the expression are not reported as requiring localization.</li>
- * <li>If a method is annotated with <code>NonNls</code>, string literals returned from the method
+ * <li>If a method is annotated with {@code NonNls}, string literals returned from the method
  * are not reported as requiring localization.</li>
- * <li>If a class is annotated with <code>NonNls</code>, all string literals in
+ * <li>If a class is annotated with {@code NonNls}, all string literals in
  * the class and all its subclasses are not reported as requiring localization.</li>
- * <li>If a package is annotated with <code>NonNls</code>, all string literals in
+ * <li>If a package is annotated with {@code NonNls}, all string literals in
  * the package and all its subpackages are not reported as requiring localization.</li>
  * </ul>
  *
index 3ad6003f554cf13e11ec39505165ba4e0182c05d..d2a16306a11ec40f5c6fe8729d4b738d18a02835 100644 (file)
@@ -19,7 +19,7 @@ package org.jetbrains.annotations;
 import java.lang.annotation.*;
 
 /**
- * An element annotated with NotNull claims <code>null</code> value is <em>forbidden</em>
+ * An element annotated with NotNull claims {@code null} value is <em>forbidden</em>
  * to return (for methods), pass to (parameters) and hold (local variables and fields).
  * Apart from documentation purposes this annotation is intended to be used by static analysis tools
  * to validate against probable runtime errors and element contract violations.
index d71b3c6c086bc0c5c6a9934ae8e823c7ecd45fb6..81d5f86cb64d8e31505735dc58a4695ad020e7fd 100644 (file)
@@ -19,7 +19,7 @@ package org.jetbrains.annotations;
 import java.lang.annotation.*;
 
 /**
- * An element annotated with NotNull claims <code>null</code> value is <em>forbidden</em>
+ * An element annotated with NotNull claims {@code null} value is <em>forbidden</em>
  * to return (for methods), pass to (parameters) and hold (local variables and fields).
  * Apart from documentation purposes this annotation is intended to be used by static analysis tools
  * to validate against probable runtime errors and element contract violations.
index 6477cc1cf996879b15e819c6b3b308ca4838c471..7bc14d750099933639d3f40b49f19c23caf8769c 100644 (file)
@@ -146,7 +146,7 @@ public interface ASTNode extends UserDataHolder {
    * Adds the specified child node at the specified position in the child list.
    *
    * @param child        the child node to add.
-   * @param anchorBefore the node before which the child node is inserted (<code>null</code> to add a child as a last node).
+   * @param anchorBefore the node before which the child node is inserted ({@code null} to add a child as a last node).
    */
   void addChild(@NotNull ASTNode child, @Nullable ASTNode anchorBefore);
 
@@ -167,8 +167,8 @@ public interface ASTNode extends UserDataHolder {
   void removeChild(@NotNull ASTNode child);
 
   /**
-   * Removes a range of nodes from the list of children, starting with <code>firstNodeToRemove</code>,
-   * up to and not including <code>firstNodeToKeep</code>.
+   * Removes a range of nodes from the list of children, starting with {@code firstNodeToRemove},
+   * up to and not including {@code firstNodeToKeep}.
    *
    * @param firstNodeToRemove the first child node to remove from the tree.
    * @param firstNodeToKeep   the first child node to keep in the tree.
@@ -192,7 +192,7 @@ public interface ASTNode extends UserDataHolder {
 
   /**
    * Adds a range of nodes belonging to the same parent to the list of children of this node,
-   * starting with <code>firstChild</code>, up to and not including <code>firstChildToNotAdd</code>.
+   * starting with {@code firstChild}, up to and not including {@code firstChildToNotAdd}.
    *
    * @param firstChild         the first node to add.
    * @param firstChildToNotAdd the first child node following firstChild which will not be added to the tree.
index 44c1c326566d364aa7fa40a9f3436bf34a4770aa..0e3af4ca64f3444022ef633417a795b1792a0305 100644 (file)
@@ -113,8 +113,8 @@ public abstract class Language extends UserDataHolderBase {
   }
 
   /**
-   * @param klass <code>java.lang.Class</code> of the particular language. Serves key purpose.
-   * @return instance of the <code>klass</code> language registered if any.
+   * @param klass {@code java.lang.Class} of the particular language. Serves key purpose.
+   * @return instance of the {@code klass} language registered if any.
    */
   public static <T extends Language> T findInstance(@NotNull Class<T> klass) {
     @SuppressWarnings("unchecked") T t = (T)ourRegisteredLanguages.get(klass);
@@ -123,7 +123,7 @@ public abstract class Language extends UserDataHolderBase {
 
   /**
    * @param mimeType of the particular language.
-   * @return collection of all languages for the given <code>mimeType</code>.
+   * @return collection of all languages for the given {@code mimeType}.
    */
   @NotNull
   public static Collection<Language> findInstancesByMimeType(@Nullable String mimeType) {
index 66b4abd44afdcf6ab39ecf037951b245ec8d90e7..54a517932a1effb0e3a63a2771a61c8c10c6be03 100644 (file)
@@ -81,15 +81,15 @@ public interface PsiBuilder extends UserDataHolder, UserDataHolderUnprotected {
   void setWhitespaceSkippedCallback(@Nullable WhitespaceSkippedCallback callback);
 
   /**
-   * See what token type is in <code>steps</code> ahead
+   * See what token type is in {@code steps} ahead
    * @param steps 0 is current token (i.e. the same {@link PsiBuilder#getTokenType()} returns)
-   * @return type element which getTokenType() will return if we call advance <code>steps</code> times in a row
+   * @return type element which getTokenType() will return if we call advance {@code steps} times in a row
    */
   @Nullable
   IElementType lookAhead(int steps);
 
   /**
-   * See what token type is in <code>steps</code> ahead / behind
+   * See what token type is in {@code steps} ahead / behind
    * @param steps 0 is current token (i.e. the same {@link PsiBuilder#getTokenType()} returns)
    * @return type element ahead or behind, including whitespace / comment tokens
    */
@@ -97,7 +97,7 @@ public interface PsiBuilder extends UserDataHolder, UserDataHolderUnprotected {
   IElementType rawLookup(int steps);
 
   /**
-   * See what token type is in <code>steps</code> ahead / behind current position
+   * See what token type is in {@code steps} ahead / behind current position
    * @param steps 0 is current token (i.e. the same {@link PsiBuilder#getTokenType()} returns)
    * @return offset type element ahead or behind, including whitespace / comment tokens, -1 if first token,
    * getOriginalText().getLength() at end
index a62c2b6077d9fea146df1f84c8b419e1fc6aee7c..4072fba005f51b6e75ebee3135d3e00adc722504 100644 (file)
@@ -49,11 +49,11 @@ public interface WhitespacesAndCommentsBinder {
    * Value returned by right edge processor will be used as a pointer to a token next of element's last token.
    * <p/>
    * <p>Example 1: if a processor for left edge wants to leave all whitespaces and comments out of element's scope
-   * (before it's start) it should return value of <code>tokens.size()</code> placing element's start pointer to a first
+   * (before it's start) it should return value of {@code tokens.size()} placing element's start pointer to a first
    * token after series of whitespaces/comments.
    * <p/>
    * <p>Example 2: if a processor for right edge wants to leave all whitespaces and comments out of element's scope
-   * (after it's end) it should return value of <code>0</code> placing element's end pointer to a first
+   * (after it's end) it should return value of {@code 0} placing element's end pointer to a first
    * whitespace or comment after element's end.
    *
    * @param tokens sequence of whitespace and comment tokens at the element's edge.
index 128b8e1122deffeb03538cd5251efb3b7b3b94fc..12f5dedb15d9c1dedb4f8bc25d806878e132adcd 100644 (file)
@@ -65,7 +65,7 @@ public abstract class Lexer {
   public abstract int getState();
 
   /**
-   * Returns the token at the current position of the lexer or <code>null</code> if lexing is finished.
+   * Returns the token at the current position of the lexer or {@code null} if lexing is finished.
    *
    * @return the current token.
    */
@@ -109,7 +109,7 @@ public abstract class Lexer {
 
   /**
    * Returns the buffer sequence over which the lexer is running. This method should return the
-   * same buffer instance which was passed to the <code>start()</code> method.
+   * same buffer instance which was passed to the {@code start()} method.
    *
    * @return the lexer buffer.
    * @since IDEA 7
@@ -119,8 +119,8 @@ public abstract class Lexer {
 
   /**
    * Returns the offset at which the lexer will stop lexing. This method should return
-   * the length of the buffer or the value passed in the <code>endOffset</code> parameter
-   * to the <code>start()</code> method.
+   * the length of the buffer or the value passed in the {@code endOffset} parameter
+   * to the {@code start()} method.
    *
    * @return the lexing end offset
    */
index 22c7fb2a55673a2053b1cd53f4770622145cf6ae..38d78e516a7de9d0a2bfda5983b445d71bf0c5ab 100644 (file)
@@ -18,7 +18,7 @@ package com.intellij.openapi.components;
 import org.jetbrains.annotations.NotNull;
 
 /**
- * Application-level component's implementation class may implement the <code>ApplicationComponent</code> interface.<br>
+ * Application-level component's implementation class may implement the {@code ApplicationComponent} interface.<br>
  * It may have constructor with parameters that are also application components.
  * <p>
  * <strong>Note that if you register a class as an application component it will be loaded, its instance will be created and
index da830b5e1961ee7c4d4768244bb1908ede1cc7f6..61305d32308abc0bcb963fd71c6acdc87542fdfe 100644 (file)
@@ -64,13 +64,13 @@ public interface ComponentManager extends UserDataHolder, Disposable {
    * Checks whether there is a component with the specified interface class.
    *
    * @param interfaceClass interface class of component to be checked
-   * @return <code>true</code> if there is a component with the specified interface class;
-   * <code>false</code> otherwise
+   * @return {@code true} if there is a component with the specified interface class;
+   * {@code false} otherwise
    */
   boolean hasComponent(@NotNull Class interfaceClass);
 
   /**
-   * Gets all components whose implementation class is derived from <code>baseClass</code>.
+   * Gets all components whose implementation class is derived from {@code baseClass}.
    *
    * @return array of components
    * @deprecated use extension points instead
index b0729ed6ed6ae07f11b6bf92fc965c7275f91d8d..651ba390a667e5dc60c459a171edfa3897553301 100644 (file)
@@ -30,7 +30,7 @@ import org.jetbrains.annotations.Nullable;
 public interface PersistentStateComponent<T> {
   /**
    * @return a component state. All properties, public and annotated fields are serialized. Only values, which differ
-   * from default (i.e. the value of newly instantiated class) are serialized. <code>null</code> value indicates
+   * from default (i.e. the value of newly instantiated class) are serialized. {@code null} value indicates
    * that the returned state won't be stored, as a result previously stored state will be used.
    * @see com.intellij.util.xmlb.XmlSerializer
    */
index da90863cb7c45d3dee610254263408fa0a0e94ee..73b3d734ab6077a45f805c4a5338349b2b9163bd 100644 (file)
@@ -16,7 +16,7 @@
 package com.intellij.openapi.components;
 
 /**
- * Project-level component's implementation class should implement the <code>ProjectComponent</code> interface.
+ * Project-level component's implementation class should implement the {@code ProjectComponent} interface.
  * It should have constructor with a single parameter of {@link com.intellij.openapi.project.Project}
  * type or with no parameters.
  * <p>
index ee7237406924152a1a124746dbc526bea573c657..38bcaf347d1c21bdb246b48caa9b74f7fd75b9f6 100644 (file)
@@ -172,7 +172,7 @@ public final class TextAttributesKey implements Comparable<TextAttributesKey> {
    * A can depend on key B which in turn can depend on key C. So if text attributes neither for A nor for B are found, they will be
    * acquired by the key C.
    * <p>Fallback keys can be used from any place including language's own definitions. Note that there is a common set of keys called
-   * <code>DefaultLanguageHighlighterColors</code> which can be used as a base. Scheme designers are supposed to set colors for these
+   * {@code DefaultLanguageHighlighterColors} which can be used as a base. Scheme designers are supposed to set colors for these
    * keys primarily and using them guarantees that most (if not all) text attributes will be shown correctly for the language
    * regardless of a color scheme.
    *
index b07dc749ab9ad443e830ce93e527de7bf86ae509..591fc7e71944d9e0beea2cfe45d1e6487eda630b 100644 (file)
@@ -39,7 +39,7 @@ public abstract class FileDocumentManager implements SavingRequestor {
    * Returns the document for the specified virtual file.<p/>
    * 
    * Documents are cached on weak or strong references, depending on the nature of the virtual file. If the document for the given virtual file is not yet cached,
-   * the file's contents are read from VFS and loaded into heap memory. An appropriate encoding is used. All line separators are converted to <code>\n</code>.<p/>
+   * the file's contents are read from VFS and loaded into heap memory. An appropriate encoding is used. All line separators are converted to {@code \n}.<p/>
    * 
    * Should be invoked in a read action.
    * 
@@ -74,7 +74,7 @@ public abstract class FileDocumentManager implements SavingRequestor {
 
   /**
    * Saves all unsaved documents to disk. This operation can modify documents that will be saved
-   * (due to 'Strip trailing spaces on Save' functionality). When saving, <code>\n</code> line separators are converted into 
+   * (due to 'Strip trailing spaces on Save' functionality). When saving, {@code \n} line separators are converted into
    * the ones used normally on the system, or the ones explicitly specified by the user. Encoding settings are honored.<p/>
    * 
    * Should be invoked on the event dispatch thread.
@@ -83,7 +83,7 @@ public abstract class FileDocumentManager implements SavingRequestor {
 
   /**
    * Saves the specified document to disk. This operation can modify the document (due to 'Strip
-   * trailing spaces on Save' functionality). When saving, <code>\n</code> line separators are converted into 
+   * trailing spaces on Save' functionality). When saving, {@code \n} line separators are converted into
    * the ones used normally on the system, or the ones explicitly specified by the user. Encoding settings are honored.<p/>
    * 
    * Should be invoked on the event dispatch thread.
index e3e4122f6a5f2379ec8901d17976d3f9a836a917..4090a34a337b84d39f48c7436313f4891de081d6 100644 (file)
@@ -40,7 +40,7 @@ public interface Module extends ComponentManager, AreaInstance, Disposable {
   @NonNls String ELEMENT_TYPE = "type";
 
   /**
-   * Returns the <code>VirtualFile</code> for the module .iml file.
+   * Returns the {@code VirtualFile} for the module .iml file.
    *
    * @return the virtual file instance.
    */
index 4ba32c2e09407774941d108174931aa080b6422d..49a6ff9f0d8c3a1f48a2e4db304b5039fb516ff3 100644 (file)
@@ -44,18 +44,18 @@ public interface Project extends ComponentManager, AreaInstance {
   String getName();
 
   /**
-   * Returns a project base directory - a parent directory of a <code>.ipr</code> file or <code>.idea</code> directory.<br/>
-   * Returns <code>null</code> for default project.
+   * Returns a project base directory - a parent directory of a {@code .ipr} file or {@code .idea} directory.<br/>
+   * Returns {@code null} for default project.
    *
-   * @return project base directory, or <code>null</code> for default project
+   * @return project base directory, or {@code null} for default project
    */
   VirtualFile getBaseDir();
 
   /**
    * Returns a system-independent path to a project base directory (see {@linkplain #getBaseDir()}).<br/>
-   * Returns <code>null</code> for default project.
+   * Returns {@code null} for default project.
    *
-   * @return a path to a project base directory, or <code>null</code> for default project
+   * @return a path to a project base directory, or {@code null} for default project
    */
   @Nullable
   String getBasePath();
@@ -63,10 +63,10 @@ public interface Project extends ComponentManager, AreaInstance {
   /**
    * Returns project descriptor file:
    * <ul>
-   *   <li><code>path/to/project/project.ipr</code> - for file-based projects</li>
-   *   <li><code>path/to/project/.idea/misc.xml</code> - for directory-based projects</li>
+   *   <li>{@code path/to/project/project.ipr} - for file-based projects</li>
+   *   <li>{@code path/to/project/.idea/misc.xml} - for directory-based projects</li>
    * </ul>
-   * Returns <code>null</code> for default project.
+   * Returns {@code null} for default project.
    *
    * @return project descriptor file, or null for default project
    */
@@ -74,7 +74,7 @@ public interface Project extends ComponentManager, AreaInstance {
   VirtualFile getProjectFile();
 
   /**
-   * @return a system-independent path to project file (see {@linkplain #getProjectFile()}) or <code>null</code> for default project.
+   * @return a system-independent path to project file (see {@linkplain #getProjectFile()}) or {@code null} for default project.
    */
   @Nullable
   String getProjectFilePath();
@@ -82,7 +82,7 @@ public interface Project extends ComponentManager, AreaInstance {
   /**
    * Returns presentable project path:
    * {@linkplain #getProjectFilePath()} for file-based projects, {@linkplain #getBasePath()} for directory-based ones.<br/>
-   * * Returns <code>null</code> for default project.
+   * * Returns {@code null} for default project.
    * <b>Note:</b> the word "presentable" here implies file system presentation, not a UI one.
    *
    * @return presentable project path
@@ -93,10 +93,10 @@ public interface Project extends ComponentManager, AreaInstance {
   /**
    * <p>Returns a workspace file:
    * <ul>
-   *   <li><code>path/to/project/project.iws</code> - for file-based projects</li>
-   *   <li><code>path/to/project/.idea/workspace.xml</code> - for directory-based ones</li>
+   *   <li>{@code path/to/project/project.iws} - for file-based projects</li>
+   *   <li>{@code path/to/project/.idea/workspace.xml} - for directory-based ones</li>
    * </ul>
-   * Returns <code>null</code> for default project.
+   * Returns {@code null} for default project.
    *
    * @return workspace file, or null for default project
    */
index 8f0dce494eace410ab87094a69bcda57b9946ee0..0bad3e572c25abf62bd35de8a3cb84e73354f182 100644 (file)
@@ -51,7 +51,7 @@ public abstract class FileIndexFacade {
   public abstract Module getModuleForFile(@NotNull VirtualFile file);
 
   /**
-   * Checks if <code>file</code> is an ancestor of <code>baseDir</code> and none of the files
+   * Checks if {@code file} is an ancestor of {@code baseDir} and none of the files
    * between them are excluded from the project.
    *
    * @param baseDir the parent directory to check for ancestry.
index 2868e00897b8e6c1bbaa948a3aec63c2373e4945..d90bbc2c186300cbd8864fbf36809e95d94f1217 100644 (file)
@@ -58,9 +58,9 @@ public class VfsUtilCore {
    *
    * @param ancestor the file
    * @param file     the file
-   * @param strict   if <code>false</code> then this method returns <code>true</code> if <code>ancestor</code>
-   *                 and <code>file</code> are equal
-   * @return <code>true</code> if <code>ancestor</code> is parent of <code>file</code>; <code>false</code> otherwise
+   * @param strict   if {@code false} then this method returns {@code true} if {@code ancestor}
+   *                 and {@code file} are equal
+   * @return {@code true} if {@code ancestor} is parent of {@code file}; {@code false} otherwise
    */
   public static boolean isAncestor(@NotNull VirtualFile ancestor, @NotNull VirtualFile file, boolean strict) {
     if (!file.getFileSystem().equals(ancestor.getFileSystem())) return false;
@@ -117,7 +117,7 @@ public class VfsUtilCore {
   }
 
   /**
-   * Gets relative path of <code>file</code> to <code>root</code> when it's possible
+   * Gets relative path of {@code file} to {@code root} when it's possible
    * This method is designed to be used for file descriptions (in trees, lists etc.)
    * @param file the file
    * @param root candidate to be parent file (Project base dir, any content roots etc.)
@@ -136,7 +136,7 @@ public class VfsUtilCore {
   }
 
   /**
-   * Gets the relative path of <code>file</code> to its <code>ancestor</code>. Uses <code>separator</code> for
+   * Gets the relative path of {@code file} to its {@code ancestor}. Uses {@code separator} for
    * separating files.
    *
    * @param file      the file
@@ -191,10 +191,10 @@ public class VfsUtilCore {
   }
 
   /**
-   * Makes a copy of the <code>file</code> in the <code>toDir</code> folder and returns it.
+   * Makes a copy of the {@code file} in the {@code toDir} folder and returns it.
    *
    * @param requestor any object to control who called this method. Note that
-   *                  it is considered to be an external change if <code>requestor</code> is <code>null</code>.
+   *                  it is considered to be an external change if {@code requestor} is {@code null}.
    *                  See {@link VirtualFileEvent#getRequestor}
    * @param file      file to make a copy of
    * @param toDir     directory to make a copy in
@@ -207,10 +207,10 @@ public class VfsUtilCore {
   }
 
   /**
-   * Makes a copy of the <code>file</code> in the <code>toDir</code> folder with the <code>newName</code> and returns it.
+   * Makes a copy of the {@code file} in the {@code toDir} folder with the {@code newName} and returns it.
    *
    * @param requestor any object to control who called this method. Note that
-   *                  it is considered to be an external change if <code>requestor</code> is <code>null</code>.
+   *                  it is considered to be an external change if {@code requestor} is {@code null}.
    *                  See {@link VirtualFileEvent#getRequestor}
    * @param file      file to make a copy of
    * @param toDir     directory to make a copy in
@@ -618,7 +618,7 @@ public class VfsUtilCore {
    *
    * @param file1 fist file
    * @param file2 second file
-   * @return common ancestor for the passed files. Returns <code>null</code> if
+   * @return common ancestor for the passed files. Returns {@code null} if
    *         the files do not have common ancestor
    */
   @Nullable
index 71d987766dba805cfdf1513d3d4816285e724527..1af9faf86bbee32d0367529075dcb44316825a29 100644 (file)
@@ -26,17 +26,17 @@ public interface Navigatable {
    * Open editor and select/navigate to the object there if possible.
    * Just do nothing if navigation is not possible like in case of a package
    *
-   * @param requestFocus <code>true</code> if focus requesting is necessary
+   * @param requestFocus {@code true} if focus requesting is necessary
    */
   void navigate(boolean requestFocus);
 
   /**
-   * @return <code>false</code> if navigation is not possible for any reason.
+   * @return {@code false} if navigation is not possible for any reason.
    */
   boolean canNavigate();
 
   /**
-   * @return <code>false</code> if navigation to source is not possible for any reason.
+   * @return {@code false} if navigation to source is not possible for any reason.
    * Source means some kind of editor
    */
   boolean canNavigateToSource();
index 18e094a408b07e304c4a1c4eaffd15f735b82b4b..4d1393a50ac82b6d11aa4d02a8db52cc080cd98c 100644 (file)
@@ -27,7 +27,7 @@ public interface ExternallyDefinedPsiElement extends PsiElement {
    * If inspection started for files with injections founds any problem in them (or their child)
    * it should be able to display them locally. This method allows to define such substitution element.
    * E.g. it may be a class name identifier element for fields/methods injected in that class.<br/>
-   * See <code>ProblemsHolder.redirectProblem()</code> for details.
+   * See {@code ProblemsHolder.redirectProblem()} for details.
    *
    * @return PSI element to which problem descriptions should be redirected
    */
index dc6f94a0cd2a6ac5ce51ab098d2686c51efe6257..018a298517f9167aa7fca3cc2f35f972eaee42e9 100644 (file)
@@ -91,7 +91,7 @@ public interface FileViewProvider extends Cloneable, UserDataHolder {
 
   /**
    * @param target target language
-   * @return PsiFile for given language, or <code>null</code> if the language not present
+   * @return PsiFile for given language, or {@code null} if the language not present
    */
   PsiFile getPsi(@NotNull Language target);
 
index 50ed06b796da800cdeaf10cef1c62c5d383bd31c..5f56ae7e38d15ccdae04b646af4d8463055a5b30 100644 (file)
@@ -62,7 +62,7 @@ public abstract class PsiDocumentManager {
    * Returns the cached PSI file for the specified document.
    *
    * @param document the document for which the PSI file is requested.
-   * @return the PSI file instance, or <code>null</code> if there is currently no cached PSI tree for the file.
+   * @return the PSI file instance, or {@code null} if there is currently no cached PSI tree for the file.
    */
   @Nullable
   public abstract PsiFile getCachedPsiFile(@NotNull Document document);
@@ -71,7 +71,7 @@ public abstract class PsiDocumentManager {
    * Returns the document for the specified PSI file.
    *
    * @param file the file for which the document is requested.
-   * @return the document instance, or <code>null</code> if the file is binary or has no associated document.
+   * @return the document instance, or {@code null} if the file is binary or has no associated document.
    */
   @Nullable
   public abstract Document getDocument(@NotNull PsiFile file);
@@ -80,7 +80,7 @@ public abstract class PsiDocumentManager {
    * Returns the cached document for the specified PSI file.
    *
    * @param file the file for which the document is requested.
-   * @return the document instance, or <code>null</code> if there is currently no cached document for the file.
+   * @return the document instance, or {@code null} if there is currently no cached document for the file.
    */
   @Nullable
   public abstract Document getCachedDocument(@NotNull PsiFile file);
index cb7d891b22dbd8899966b17c4f60405c276d4068..4c769c73b98922b57836a5b3d5149e3ad1a1cff0 100644 (file)
@@ -217,7 +217,7 @@ public interface PsiElement extends UserDataHolder, Iconable {
   /**
    * Returns the PSI element which should be used as a navigation target
    * when navigation to this PSI element is requested. The method can either
-   * return <code>this</code> or substitute a different element if this element
+   * return {@code this} or substitute a different element if this element
    * does not have an associated file and offset. (For example, if the source code
    * of a library is attached to a project, the navigation element for a compiled
    * library class is its source class.)
@@ -230,7 +230,7 @@ public interface PsiElement extends UserDataHolder, Iconable {
   /**
    * Returns the PSI element which corresponds to this element and belongs to
    * either the project source path or class path. The method can either return
-   * <code>this</code> or substitute a different element if this element does
+   * {@code this} or substitute a different element if this element does
    * not belong to the source path or class path. (For example, the original
    * element for a library source file is the corresponding compiled class file.)
    *
@@ -295,7 +295,7 @@ public interface PsiElement extends UserDataHolder, Iconable {
    * Adds a child to this PSI element.
    *
    * @param element the child element to add.
-   * @return the element which was actually added (either <code>element</code> or its copy).
+   * @return the element which was actually added (either {@code element} or its copy).
    * @throws IncorrectOperationException if the modification is not supported or not possible for some reason.
    */
   PsiElement add(@NotNull PsiElement element) throws IncorrectOperationException;
@@ -305,7 +305,7 @@ public interface PsiElement extends UserDataHolder, Iconable {
    *
    * @param element the child element to add.
    * @param anchor  the anchor before which the child element is inserted (must be a child of this PSI element)
-   * @return the element which was actually added (either <code>element</code> or its copy).
+   * @return the element which was actually added (either {@code element} or its copy).
    * @throws IncorrectOperationException if the modification is not supported or not possible for some reason.
    */
   PsiElement addBefore(@NotNull PsiElement element, @Nullable PsiElement anchor) throws IncorrectOperationException;
@@ -315,7 +315,7 @@ public interface PsiElement extends UserDataHolder, Iconable {
    *
    * @param element the child element to add.
    * @param anchor  the anchor after which the child element is inserted (must be a child of this PSI element)
-   * @return the element which was actually added (either <code>element</code> or its copy).
+   * @return the element which was actually added (either {@code element} or its copy).
    * @throws IncorrectOperationException if the modification is not supported or not possible for some reason.
    */
   PsiElement addAfter(@NotNull PsiElement element, @Nullable PsiElement anchor) throws IncorrectOperationException;
@@ -334,8 +334,8 @@ public interface PsiElement extends UserDataHolder, Iconable {
    * Adds a range of elements as children to this PSI element.
    *
    * @param first the first child element to add.
-   * @param last  the last child element to add (must have the same parent as <code>first</code>)
-   * @return the first child element which was actually added (either <code>first</code> or its copy).
+   * @param last  the last child element to add (must have the same parent as {@code first})
+   * @return the first child element which was actually added (either {@code first} or its copy).
    * @throws IncorrectOperationException if the modification is not supported or not possible for some reason.
    */
   PsiElement addRange(PsiElement first, PsiElement last) throws IncorrectOperationException;
@@ -344,9 +344,9 @@ public interface PsiElement extends UserDataHolder, Iconable {
    * Adds a range of elements as children to this PSI element, before the specified anchor element.
    *
    * @param first  the first child element to add.
-   * @param last   the last child element to add (must have the same parent as <code>first</code>)
+   * @param last   the last child element to add (must have the same parent as {@code first})
    * @param anchor the anchor before which the child element is inserted (must be a child of this PSI element)
-   * @return the first child element which was actually added (either <code>first</code> or its copy).
+   * @return the first child element which was actually added (either {@code first} or its copy).
    * @throws IncorrectOperationException if the modification is not supported or not possible for some reason.
    */
   PsiElement addRangeBefore(@NotNull PsiElement first, @NotNull PsiElement last, PsiElement anchor) throws IncorrectOperationException;
@@ -355,9 +355,9 @@ public interface PsiElement extends UserDataHolder, Iconable {
    * Adds a range of elements as children to this PSI element, after the specified anchor element.
    *
    * @param first  the first child element to add.
-   * @param last   the last child element to add (must have the same parent as <code>first</code>)
+   * @param last   the last child element to add (must have the same parent as {@code first})
    * @param anchor the anchor after which the child element is inserted (must be a child of this PSI element)
-   * @return the first child element which was actually added (either <code>first</code> or its copy).
+   * @return the first child element which was actually added (either {@code first} or its copy).
    * @throws IncorrectOperationException if the modification is not supported or not possible for some reason.
    */
   PsiElement addRangeAfter(PsiElement first, PsiElement last, PsiElement anchor) throws IncorrectOperationException;
@@ -393,7 +393,7 @@ public interface PsiElement extends UserDataHolder, Iconable {
    * (along with the children).
    *
    * @param newElement the element to replace this element with.
-   * @return the element which was actually inserted in the tree (either <code>newElement</code> or its copy)
+   * @return the element which was actually inserted in the tree (either {@code newElement} or its copy)
    * @throws IncorrectOperationException if the modification is not supported or not possible for some reason.
    */
   PsiElement replace(@NotNull PsiElement newElement) throws IncorrectOperationException;
@@ -503,7 +503,7 @@ public interface PsiElement extends UserDataHolder, Iconable {
 
   /**
    * Returns the element which should be used as the parent of this element in a tree up
-   * walk during a resolve operation. For most elements, this returns <code>getParent()</code>,
+   * walk during a resolve operation. For most elements, this returns {@code getParent()},
    * but the context can be overridden for some elements like code fragments (see
    * {@link PsiElementFactory#createCodeBlockCodeFragment(String, PsiElement, boolean)}).
    *
index 3f052ae59243a3f2e6dc29975c6ce40d7debb560..c13568cb1d19839a88bf001f11af567568420289 100644 (file)
@@ -86,7 +86,7 @@ public interface PsiFile extends PsiFileSystemItem {
    * PSI trees for each of these languages. (For example, a JSPX file contains JSP,
    * XML and Java trees.)
    *
-   * @return the array of PSI roots, or a single-element array containing <code>this</code>
+   * @return the array of PSI roots, or a single-element array containing {@code this}
    * if the file has only a single language.
    * @deprecated Use {@link FileViewProvider#getAllFiles()} instead.
    */
index f3cd0eb405852a6d8a070839326d6be8f99e0ad9..c122e5cb1bff55d7a94fc3d6ec3b6f812b2f83e8 100644 (file)
@@ -51,7 +51,7 @@ public abstract class PsiManager extends UserDataHolderBase {
    * Returns the PSI file corresponding to the specified virtual file.
    *
    * @param file the file for which the PSI is requested.
-   * @return the PSI file, or null if <code>file</code> is a directory, an invalid virtual file,
+   * @return the PSI file, or null if {@code file} is a directory, an invalid virtual file,
    * or the current project is a dummy or default project.
    */
   @Nullable
index a7dce3d9e743ebecc18f7d110bec116154359637..9f3deae684aa5bb4092f2542d02762655ea6df55 100644 (file)
@@ -40,7 +40,7 @@ public interface PsiNamedElement extends PsiElement{
    * Renames the element.
    *
    * @param name the new element name.
-   * @return the element corresponding to this element after the rename (either <code>this</code>
+   * @return the element corresponding to this element after the rename (either {@code this}
    * or a different element if the rename caused the element to be replaced).
    * @throws IncorrectOperationException if the modification is not supported or not possible for some reason.
    */
index 742071b043739fd7a73a9cd1e41b5dba39ba1d0c..1af4ea0933da8c35244c5292aaf2e0271d165423 100644 (file)
@@ -45,7 +45,7 @@ public abstract class SmartPointerManager {
    * Creates a smart pointer to the specified PSI element.
    *
    * @param element the element to create a pointer to.
-   * @param containingFile the result of <code>element.getContainingFile()</code>.
+   * @param containingFile the result of {@code element.getContainingFile()}.
    * @return the smart pointer instance.
    */
   @NotNull public abstract <E extends PsiElement> SmartPsiElementPointer<E> createSmartPsiElementPointer(@NotNull E element, PsiFile containingFile);
index a72aae5e986fbbf1897670d4f16b0634ee9fdcf0..97b8416241e5932857494c0f3e7d2da4ebe1eead 100644 (file)
@@ -258,7 +258,7 @@ public abstract class CodeStyleManager  {
    * It's possible to configure that (implementation details are insignificant here) and current method serves as a read-only
    * facade for obtaining information if 'sequential' processing is allowed at the moment.
    *
-   * @return      <code>true</code> if 'sequential' formatting is allowed now; <code>false</code> otherwise
+   * @return      {@code true} if 'sequential' formatting is allowed now; {@code false} otherwise
    */
   public abstract boolean isSequentialProcessingAllowed();
 
index db4e18c8dc47ec1b33dd9ea6f69b88bf142d13ef..d1a0ea55fcc7fb13777740868e9c30d24ba38014 100644 (file)
@@ -80,8 +80,8 @@ public final class SimpleTextAttributes {
 
   /**
    * @param style   style of the text fragment.                                       5
-   * @param fgColor color of the text fragment. <code>color</code> can be
-   *                <code>null</code>. In that case <code>SimpleColoredComponent</code> will
+   * @param fgColor color of the text fragment. {@code color} can be
+   *                {@code null}. In that case {@code SimpleColoredComponent} will
    *                use its foreground to paint the text fragment.
    */
   public SimpleTextAttributes(@StyleAttributeConstant int style, Color fgColor) {
@@ -129,7 +129,7 @@ public final class SimpleTextAttributes {
   }
 
   /**
-   * @return wave color. The method can return <code>null</code>. <code>null</code>
+   * @return wave color. The method can return {@code null}. {@code null}
    *         means that color of wave is the same as foreground color.
    */
   @Nullable
index 8560b98716909faec09bab89556fd3c16ebb1211..ff51635322939c613c2ebb59bfd4616389d5ae54 100644 (file)
@@ -33,17 +33,17 @@ public interface Query<Result> extends Iterable<Result> {
   Collection<Result> findAll();
 
   /**
-   * Get the first result or <code>null</code> if no results have been found.
-   * @return first result of the search or <code>null</code> if no results.
+   * Get the first result or {@code null} if no results have been found.
+   * @return first result of the search or {@code null} if no results.
    */
   @Nullable
   Result findFirst();
 
   /**
-   * Process search results one-by-one. All the results will be subsequently fed to a <code>consumer</code> passed.
+   * Process search results one-by-one. All the results will be subsequently fed to a {@code consumer} passed.
    * @param consumer - a processor search results should be fed to.
-   * @return <code>true</code> if the search was completed normally,
-   *         <code>false</code> if the occurrence processing was cancelled by the processor.
+   * @return {@code true} if the search was completed normally,
+   *         {@code false} if the occurrence processing was cancelled by the processor.
    */
   boolean forEach(@NotNull Processor<Result> consumer);
 
index f4b97dfc7d3f042cff224af4841ff90b19665f72..fa4c7c31677fed60176cd62867cf94368886ac27 100644 (file)
@@ -25,7 +25,7 @@ import java.util.*;
 /**
  * Abstract class for all code-generating CGLIB utilities.
  * In addition to caching generated classes for performance, it provides hooks for
- * customizing the <code>ClassLoader</code>, name of the generated class, and transformations
+ * customizing the {@code ClassLoader}, name of the generated class, and transformations
  * applied before generation.
  *
  * intellij changes: made some fields final
@@ -84,11 +84,11 @@ implements ClassGenerator
     }
 
     /**
-     * Set the <code>ClassLoader</code> in which the class will be generated.
-     * Concrete subclasses of <code>AbstractClassGenerator</code> (such as <code>Enhancer</code>)
+     * Set the {@code ClassLoader} in which the class will be generated.
+     * Concrete subclasses of {@code AbstractClassGenerator} (such as {@code Enhancer})
      * will try to choose an appropriate default if this is unset.
      * <p>
-     * Classes are cached per-<code>ClassLoader</code> using a <code>WeakHashMap</code>, to allow
+     * Classes are cached per-{@code ClassLoader} using a {@code WeakHashMap}, to allow
      * the generated classes to be removed when the associated loader is garbage collected.
      * @param classLoader the loader to generate the new class with, or null to use the default
      */
@@ -116,7 +116,7 @@ implements ClassGenerator
 
     /**
      * Whether use and update the static cache of generated classes
-     * for a class with the same properties. Default is <code>true</code>.
+     * for a class with the same properties. Default is {@code true}.
      */
     public void setUseCache(boolean useCache) {
         this.useCache = useCache;
@@ -131,8 +131,8 @@ implements ClassGenerator
 
     /**
      * If set, CGLIB will attempt to load classes from the specified
-     * <code>ClassLoader</code> before generating them. Because generated
-     * class names are not guaranteed to be unique, the default is <code>false</code>.
+     * {@code ClassLoader} before generating them. Because generated
+     * class names are not guaranteed to be unique, the default is {@code false}.
      */
     public void setAttemptLoad(boolean attemptLoad) {
         this.attemptLoad = attemptLoad;
@@ -160,7 +160,7 @@ implements ClassGenerator
     }
 
     /**
-     * Used internally by CGLIB. Returns the <code>AbstractClassGenerator</code>
+     * Used internally by CGLIB. Returns the {@code AbstractClassGenerator}
      * that is being used to generate a class in the current thread.
      */
     public static AbstractClassGenerator getCurrent() {
index a85468a48d76737707042459607435ae1d0081a1..560f28b73a05534e71cdf87d2457426f897aba7a 100644 (file)
@@ -137,14 +137,14 @@ public class OperationParserHelper {
     void advance();
 
     /**
-     * See what token type is in <code>step</code> ahead / benind (including whitespaces)
+     * See what token type is in {@code step} ahead / benind (including whitespaces)
      * @param step 0 is current token, -1 is previous, 1 is next and so on
      * @return IElementType of the required element
      */
     IElementType rawLookup(int step);
 
     /**
-     * See what token type is in <code>step</code> ahead (not including whitespaces)
+     * See what token type is in {@code step} ahead (not including whitespaces)
      * @param step 0 is current token, 1 is next and so on
      * @return IElementType of the required element
      */
index 39cedde8f53594adef51a68626ea1561742a8d6b..9f37ac5b497b8c70942b01f6a651d675400b0f6a 100644 (file)
@@ -38,10 +38,10 @@ public interface DocumentEx extends Document {
   void replaceText(@NotNull CharSequence chars, long newModificationStamp);
 
   /**
-   * Moves text from the <code>[srcStart; srcEnd)</code> range to the <code>dstOffset</code> offset.
+   * Moves text from the {@code [srcStart; srcEnd)} range to the {@code dstOffset} offset.
    * <p/>
    * The benefit to use this method over usual {@link #deleteString(int, int)} and {@link #replaceString(int, int, CharSequence)}
-   * is that {@link #createRangeMarker(int, int, boolean) range markers} from the <code>[srcStart; srcEnd)</code> range have
+   * is that {@link #createRangeMarker(int, int, boolean) range markers} from the {@code [srcStart; srcEnd)} range have
    * a chance to be preserved.
    *
    * @param srcStart  start offset of the text to move (inclusive)
index 114c24b182dc2d7fd8ab3ca597cc9a1d8ec9aa0f..ee1f12253d0d7634896a2d6c3a7fc53919d90444 100644 (file)
@@ -21,7 +21,7 @@ import org.jetbrains.annotations.NotNull;
 /**
  * This class is a data structure specialized for working with the indexed segments, i.e. it holds numerous mappings like
  * {@code 'index <-> (start; end)'} and provides convenient way for working with them, e.g. find index by particular offset that
- * belongs to target <code>(start; end)</code> segment etc.
+ * belongs to target {@code (start; end)} segment etc.
  * <p/>
  * Not thread-safe.
  */
index b6794c436966e45178a955a3c6df121200533820..a8d9738433345a658d4bf5ff7649132f3ba77400 100644 (file)
@@ -18,7 +18,7 @@ package com.intellij.openapi.editor.ex.util;
 import org.jetbrains.annotations.NotNull;
 
 /**
- * Expands {@link SegmentArray} contract in providing ability to attach additional <code>'short'</code> variable to target segment,
+ * Expands {@link SegmentArray} contract in providing ability to attach additional {@code 'short'} variable to target segment,
  * i.e. holds mappings like {@code 'index <-> (data, (start; end))'}.
  * <p/>
  * Not thread-safe.
index c2d8c806038aef4c8b80d719d3777451660f59ca..781d7b61139f204fc36c11deec971543f8d43fee 100644 (file)
@@ -92,11 +92,11 @@ public class BulkChangesMerger {
   /**
    * Allows to perform 'in-place' merge of the given changes to the given array.
    * <p/>
-   * I.e. it's considered that given array contains particular text at <code>[0; length)</code> region and given changes define
+   * I.e. it's considered that given array contains particular text at {@code [0; length)} region and given changes define
    * offsets against it. It's also assumed that given array length is enough to contain resulting text after applying the changes.
    * <p/>
-   * Example: consider that initial text is <code>'12345'</code> and given changes are <code>'remove text at [1; 3) interval'</code>
-   * and <code>'replace text at [4; 5) interval with 'abcde''</code>. Resulting text is <code>'14abcde'</code> then and given array
+   * Example: consider that initial text is {@code '12345'} and given changes are {@code 'remove text at [1; 3) interval'}
+   * and {@code 'replace text at [4; 5) interval with 'abcde''}. Resulting text is {@code '14abcde'} then and given array
    * length should be not less than 7.
    * 
    * @param data      data array
@@ -212,7 +212,7 @@ public class BulkChangesMerger {
     /**
      * Asks current context to update its state in order to point to the first change in a group.
      * 
-     * @return      <code>true</code> if the first change in a group is found; <code>false</code> otherwise
+     * @return      {@code true} if the first change in a group is found; {@code false} otherwise
      */
     @SuppressWarnings({"ForLoopThatDoesntUseLoopVariable"})
     public boolean startGroup() {
index 788bb24ad3aa41fac065356d26f2eaa7e8f2f129..0f1bc4765c91a2d1ab7bc0a387874f3390c8a3f8 100644 (file)
@@ -30,8 +30,8 @@ class PersistentRangeMarkerUtil {
    * @param e             event that describes document change
    * @param rangeStart    target range marker start, for which update strategy should be selected
    * @param rangeEnd      target range marker end
-   * @return              <code>true</code> if target document range referenced by the given range marker should be translated via
-   *                      diff algorithm; <code>false</code> otherwise
+   * @return              {@code true} if target document range referenced by the given range marker should be translated via
+   *                      diff algorithm; {@code false} otherwise
    */
   static boolean shouldTranslateViaDiff(@NotNull DocumentEvent e, int rangeStart, int rangeEnd) {
     if (e.isWholeTextReplaced()) {
index 292a810494a763aadba07e528521880297217d94..0e0c6f319fc1ced8932ba70b014454b659e4f0fa 100644 (file)
@@ -36,8 +36,8 @@ public class TextChangeImpl implements TextChange {
   private int    myEnd;
 
   /**
-   * Shorthand for creating change object with the given arguments where <code>'end index'</code> has the same value as
-   * <code>'start index'</code>.
+   * Shorthand for creating change object with the given arguments where {@code 'end index'} has the same value as
+   * {@code 'start index'}.
    *
    * @param text      text affected by the current change
    * @param start     start index (inclusive) of text range affected by the change encapsulated by the current object
@@ -48,13 +48,13 @@ public class TextChangeImpl implements TextChange {
   }
 
   /**
-   * Creates new <code>TextChange</code> object with the given arguments. It encapsulates information about the change that
+   * Creates new {@code TextChange} object with the given arguments. It encapsulates information about the change that
    * may be applied to the target document.
    *
    * @param text      text that is introduced by the current change
    * @param start     start index of the target document location where current change is to be applied
    * @param end       end index of the target document where current change is to be applied, i.e. it's assumed that current text
-   *                  change appliance to particular document causes replacement of its original text at <code>[start; end)</code>
+   *                  change appliance to particular document causes replacement of its original text at {@code [start; end)}
    *                  interval by the text encapsulated by the current change. I.e. original text is replaced by the new one
    * @throws IllegalArgumentException     if given start or end index in invalid or they are inconsistent to each other
    */
@@ -130,8 +130,8 @@ public class TextChangeImpl implements TextChange {
   /**
    * Difference in document symbols number after current change appliance.
    * <p/>
-   * <b>Note:</b> returned number may be either positive or not. For example it may be negative for <code>'remove'</code>
-   * or <code>'replace'</code> changes (number of text symbols is less than number of symbols at target change interval)
+   * <b>Note:</b> returned number may be either positive or not. For example it may be negative for {@code 'remove'}
+   * or {@code 'replace'} changes (number of text symbols is less than number of symbols at target change interval)
    *
    * @return    difference in document symbols number after current change appliance
    */
@@ -165,7 +165,7 @@ public class TextChangeImpl implements TextChange {
    * Shorthand for calling {@link #isWithinBounds(int, int)} with zero start offset and given length as and end offset
    * 
    * @param length  target length
-   * @return        <code>true</code> if current change is within the target bounds; <code>false</code> otherwise
+   * @return        {@code true} if current change is within the target bounds; {@code false} otherwise
    */
   public boolean isWithinBounds(int length) {
     return isWithinBounds(0, length);
@@ -176,7 +176,7 @@ public class TextChangeImpl implements TextChange {
    * 
    * @param start  target bounds start offset (inclusive)
    * @param end    target bounds end offset (exclusive)
-   * @return       <code>true</code> if current change is within the target bounds; <code>false</code> otherwise 
+   * @return       {@code true} if current change is within the target bounds; {@code false} otherwise
    */
   public boolean isWithinBounds(int start, int end) {
     return myStart >= start && myEnd <= end && myStart <= myEnd;
index 62fdb5153d2e0acf3badbfda7ecfa28f67292266..332ee8c7287225c03ac4b4ea371272388dac9116 100644 (file)
@@ -109,18 +109,18 @@ public class TextChangesStorage {
   /**
    * Store given change merging it with previously stored ones if necessary.
    * <p/>
-   * <b>Note:</b> it's assumed that given change offsets are related to the current state of the text (<code>'client text'</code>),
+   * <b>Note:</b> it's assumed that given change offsets are related to the current state of the text ({@code 'client text'}),
    * i.e. with all stored changes applied to it. Example:
    * <ol>
-   *   <li>Say, we have initial text <code>'12345'</code>;</li>
+   *   <li>Say, we have initial text {@code '12345'};</li>
    *   <li>
-   *     Suppose the change <code>'replace text at [2; 3) range with 'ABC''</code> is applied to it (stored at the current object).
-   *     End-users see the text <code>'12ABC45'</code> now;
+   *     Suppose the change {@code 'replace text at [2; 3) range with 'ABC''} is applied to it (stored at the current object).
+   *     End-users see the text {@code '12ABC45'} now;
    *   </li>
    *   <li>
-   *     This method is called with change like <code>'replace text at [1; 6) range with 'XY''</code>. Change range is assumed to
-   *     be related to the text visible to end-user, not initial one (<code>'12ABC45'</code>, not <code>'12345'</code>).
-   *     I.e. the user will see text <code>'1XY5'</code> now;
+   *     This method is called with change like {@code 'replace text at [1; 6) range with 'XY''}. Change range is assumed to
+   *     be related to the text visible to end-user, not initial one ({@code '12ABC45'}, not {@code '12345'}).
+   *     I.e. the user will see text {@code '1XY5'} now;
    *   </li>
    * </ol>
    *
@@ -329,12 +329,12 @@ public class TextChangesStorage {
    * Example:
    * <pre>
    * <ul>
-   *   <li>Consider that original text is <code>'01234'</code>;</li>
+   *   <li>Consider that original text is {@code '01234'};</li>
    *   <li>
-   *     Consider that two changes are registered: <code>'insert text 'a' at index 1'</code> and
-   *     <code>'insert text 'bc' at index 3'</code>;
+   *     Consider that two changes are registered: {@code 'insert text 'a' at index 1'} and
+   *     {@code 'insert text 'bc' at index 3'};
    *   </li>
-   *   <li><code>'client text'</code> now is <code>'0a12bc34'</code>;</li>
+   *   <li>{@code 'client text'} now is {@code '0a12bc34'};</li>
    *   <li>This method is called with index '5' -