aprantl created this revision. aprantl added a reviewer: rsmith. Herald added subscribers: kbarton, aheejin, eraman, jgravelle-google, sbc100, nhaehnle, nemanjai, dschuff, jfb, jholewinski, klimek.
Note that I did the same thing for LLVM this morning (https://reviews.llvm.org/D46290). We've been running doxygen with the autobrief option for a couple of years now. This makes the \brief markers into our comments redundant. Since they are a visual distraction and we don't want to encourage more \brief markers in new code either, this patch removes them all. Patch produced by `for i in $(git grep -l '\@brief'); do perl -pi -e 's/\@brief //g' $i & done` `for i in $(git grep -l '\\brief'); do perl -pi -e 's/\\brief //g' $i & done` https://reviews.llvm.org/D46320 Files: docs/LibFormat.rst include/clang-c/BuildSystem.h include/clang-c/CXCompilationDatabase.h include/clang-c/CXErrorCode.h include/clang-c/CXString.h include/clang-c/Documentation.h include/clang-c/Index.h include/clang/ARCMigrate/ARCMT.h include/clang/ARCMigrate/ARCMTActions.h include/clang/AST/APValue.h include/clang/AST/ASTConsumer.h include/clang/AST/ASTContext.h include/clang/AST/ASTDiagnostic.h include/clang/AST/ASTFwd.h include/clang/AST/ASTImporter.h include/clang/AST/ASTLambda.h include/clang/AST/ASTMutationListener.h include/clang/AST/ASTTypeTraits.h include/clang/AST/ASTUnresolvedSet.h include/clang/AST/Attr.h include/clang/AST/Availability.h include/clang/AST/CXXInheritance.h include/clang/AST/CanonicalType.h include/clang/AST/CommentBriefParser.h include/clang/AST/CommentCommandTraits.h include/clang/AST/CommentLexer.h include/clang/AST/CommentSema.h include/clang/AST/DataCollection.h include/clang/AST/Decl.h include/clang/AST/DeclBase.h include/clang/AST/DeclCXX.h include/clang/AST/DeclContextInternals.h include/clang/AST/DeclObjC.h include/clang/AST/DeclOpenMP.h include/clang/AST/DeclTemplate.h include/clang/AST/DeclVisitor.h include/clang/AST/DeclarationName.h include/clang/AST/EvaluatedExprVisitor.h include/clang/AST/Expr.h include/clang/AST/ExprCXX.h include/clang/AST/ExprObjC.h include/clang/AST/ExprOpenMP.h include/clang/AST/ExternalASTSource.h include/clang/AST/LambdaCapture.h include/clang/AST/LocInfoType.h include/clang/AST/Mangle.h include/clang/AST/MangleNumberingContext.h include/clang/AST/NSAPI.h include/clang/AST/NestedNameSpecifier.h include/clang/AST/OpenMPClause.h include/clang/AST/OperationKinds.def include/clang/AST/OperationKinds.h include/clang/AST/ParentMap.h include/clang/AST/PrettyPrinter.h include/clang/AST/QualTypeNames.h include/clang/AST/RawCommentList.h include/clang/AST/RecordLayout.h include/clang/AST/RecursiveASTVisitor.h include/clang/AST/Redeclarable.h include/clang/AST/SelectorLocationsKind.h include/clang/AST/Stmt.h include/clang/AST/StmtCXX.h include/clang/AST/StmtObjC.h include/clang/AST/StmtOpenMP.h include/clang/AST/StmtVisitor.h include/clang/AST/TemplateBase.h include/clang/AST/TemplateName.h include/clang/AST/Type.h include/clang/AST/TypeLoc.h include/clang/AST/TypeOrdering.h include/clang/AST/TypeVisitor.h include/clang/AST/UnresolvedSet.h include/clang/AST/VTTBuilder.h include/clang/AST/VTableBuilder.h include/clang/ASTMatchers/ASTMatchFinder.h include/clang/ASTMatchers/ASTMatchers.h include/clang/ASTMatchers/ASTMatchersInternal.h include/clang/ASTMatchers/ASTMatchersMacros.h include/clang/ASTMatchers/Dynamic/Diagnostics.h include/clang/ASTMatchers/Dynamic/Parser.h include/clang/ASTMatchers/Dynamic/Registry.h include/clang/ASTMatchers/Dynamic/VariantValue.h include/clang/Analysis/Analyses/Consumed.h include/clang/Analysis/Analyses/Dominators.h include/clang/Analysis/Analyses/FormatString.h include/clang/Analysis/Analyses/PostOrderCFGView.h include/clang/Analysis/Analyses/ThreadSafety.h include/clang/Analysis/Analyses/ThreadSafetyCommon.h include/clang/Analysis/Analyses/ThreadSafetyLogical.h include/clang/Analysis/AnalysisDeclContext.h include/clang/Analysis/CFG.h include/clang/Analysis/CallGraph.h include/clang/Analysis/CodeInjector.h include/clang/Analysis/ProgramPoint.h include/clang/Basic/ABI.h include/clang/Basic/AddressSpaces.h include/clang/Basic/AlignedAllocation.h include/clang/Basic/AllDiagnostics.h include/clang/Basic/AttrKinds.h include/clang/Basic/AttrSubjectMatchRules.h include/clang/Basic/Attributes.h include/clang/Basic/Builtins.h include/clang/Basic/BuiltinsWebAssembly.def include/clang/Basic/CapturedStmt.h include/clang/Basic/CommentOptions.h include/clang/Basic/Diagnostic.h include/clang/Basic/DiagnosticError.h include/clang/Basic/DiagnosticIDs.h include/clang/Basic/DiagnosticOptions.h include/clang/Basic/ExceptionSpecificationType.h include/clang/Basic/ExpressionTraits.h include/clang/Basic/FileManager.h include/clang/Basic/FileSystemOptions.h include/clang/Basic/FileSystemStatCache.h include/clang/Basic/IdentifierTable.h include/clang/Basic/LLVM.h include/clang/Basic/Lambda.h include/clang/Basic/LangOptions.def include/clang/Basic/LangOptions.h include/clang/Basic/Linkage.h include/clang/Basic/MacroBuilder.h include/clang/Basic/Module.h include/clang/Basic/ObjCRuntime.h include/clang/Basic/OpenCLOptions.h include/clang/Basic/OpenMPKinds.def include/clang/Basic/OpenMPKinds.h include/clang/Basic/OperatorKinds.h include/clang/Basic/OperatorPrecedence.h include/clang/Basic/PartialDiagnostic.h include/clang/Basic/PrettyStackTrace.h include/clang/Basic/Sanitizers.h include/clang/Basic/SourceLocation.h include/clang/Basic/SourceManager.h include/clang/Basic/SourceManagerInternals.h include/clang/Basic/Specifiers.h include/clang/Basic/SyncScope.h include/clang/Basic/TargetBuiltins.h include/clang/Basic/TargetCXXABI.h include/clang/Basic/TargetInfo.h include/clang/Basic/TargetOptions.h include/clang/Basic/TemplateKinds.h include/clang/Basic/TokenKinds.h include/clang/Basic/TypeTraits.h include/clang/Basic/Version.h include/clang/Basic/VersionTuple.h include/clang/Basic/VirtualFileSystem.h include/clang/Basic/Visibility.h include/clang/Basic/XRayInstr.h include/clang/CodeGen/CGFunctionInfo.h include/clang/CrossTU/CrossTranslationUnit.h include/clang/Driver/Action.h include/clang/Driver/Driver.h include/clang/Driver/Job.h include/clang/Driver/Multilib.h include/clang/Driver/Tool.h include/clang/Driver/ToolChain.h include/clang/Edit/EditsReceiver.h include/clang/Format/Format.h include/clang/Frontend/ASTUnit.h include/clang/Frontend/ChainedDiagnosticConsumer.h include/clang/Frontend/CodeGenOptions.def include/clang/Frontend/CodeGenOptions.h include/clang/Frontend/CommandLineSourceLoc.h include/clang/Frontend/CompilerInstance.h include/clang/Frontend/CompilerInvocation.h include/clang/Frontend/DependencyOutputOptions.h include/clang/Frontend/DiagnosticRenderer.h include/clang/Frontend/FrontendAction.h include/clang/Frontend/FrontendActions.h include/clang/Frontend/FrontendOptions.h include/clang/Frontend/LayoutOverrideSource.h include/clang/Frontend/PrecompiledPreamble.h include/clang/Frontend/SerializedDiagnosticPrinter.h include/clang/Frontend/SerializedDiagnosticReader.h include/clang/Frontend/SerializedDiagnostics.h include/clang/Frontend/TextDiagnostic.h include/clang/Frontend/TextDiagnosticPrinter.h include/clang/Frontend/VerifyDiagnosticConsumer.h include/clang/Index/USRGeneration.h include/clang/Lex/CodeCompletionHandler.h include/clang/Lex/DirectoryLookup.h include/clang/Lex/ExternalPreprocessorSource.h include/clang/Lex/HeaderSearch.h include/clang/Lex/HeaderSearchOptions.h include/clang/Lex/Lexer.h include/clang/Lex/LiteralSupport.h include/clang/Lex/MacroInfo.h include/clang/Lex/ModuleLoader.h include/clang/Lex/ModuleMap.h include/clang/Lex/MultipleIncludeOpt.h include/clang/Lex/PPCallbacks.h include/clang/Lex/PPConditionalDirectiveRecord.h include/clang/Lex/Pragma.h include/clang/Lex/PreprocessingRecord.h include/clang/Lex/Preprocessor.h include/clang/Lex/PreprocessorLexer.h include/clang/Lex/PreprocessorOptions.h include/clang/Lex/Token.h include/clang/Lex/TokenLexer.h include/clang/Lex/VariadicMacroSupport.h include/clang/Parse/ParseAST.h include/clang/Parse/Parser.h include/clang/Parse/RAIIObjectsForParser.h include/clang/Rewrite/Core/RewriteBuffer.h include/clang/Rewrite/Core/Rewriter.h include/clang/Rewrite/Frontend/FixItRewriter.h include/clang/Rewrite/Frontend/FrontendActions.h include/clang/Sema/AnalysisBasedWarnings.h include/clang/Sema/AttributeList.h include/clang/Sema/CodeCompleteConsumer.h include/clang/Sema/DeclSpec.h include/clang/Sema/DelayedDiagnostic.h include/clang/Sema/ExternalSemaSource.h include/clang/Sema/IdentifierResolver.h include/clang/Sema/Initialization.h include/clang/Sema/Lookup.h include/clang/Sema/LoopHint.h include/clang/Sema/MultiplexExternalSemaSource.h include/clang/Sema/ObjCMethodList.h include/clang/Sema/Overload.h include/clang/Sema/Ownership.h include/clang/Sema/ParsedTemplate.h include/clang/Sema/Scope.h include/clang/Sema/ScopeInfo.h include/clang/Sema/Sema.h include/clang/Sema/SemaConsumer.h include/clang/Sema/SemaInternal.h include/clang/Sema/SemaLambda.h include/clang/Sema/Template.h include/clang/Sema/TemplateDeduction.h include/clang/Sema/TemplateInstCallback.h include/clang/Sema/TypoCorrection.h include/clang/Sema/Weak.h include/clang/Serialization/ASTBitCodes.h include/clang/Serialization/ASTDeserializationListener.h include/clang/Serialization/ASTReader.h include/clang/Serialization/ASTWriter.h include/clang/Serialization/ContinuousRangeMap.h include/clang/Serialization/GlobalModuleIndex.h include/clang/Serialization/Module.h include/clang/Serialization/ModuleManager.h include/clang/StaticAnalyzer/Core/AnalyzerOptions.h include/clang/StaticAnalyzer/Core/BugReporter/BugReporter.h include/clang/StaticAnalyzer/Core/BugReporter/BugReporterVisitors.h include/clang/StaticAnalyzer/Core/BugReporter/PathDiagnostic.h include/clang/StaticAnalyzer/Core/Checker.h include/clang/StaticAnalyzer/Core/CheckerManager.h include/clang/StaticAnalyzer/Core/IssueHash.h include/clang/StaticAnalyzer/Core/PathSensitive/APSIntType.h include/clang/StaticAnalyzer/Core/PathSensitive/BlockCounter.h (383 more files...) _______________________________________________ cfe-commits mailing list cfe-commits@lists.llvm.org http://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-commits
