llvm-project/lldb/source/API
Adrian Prantl 05097246f3 Reflow paragraphs in comments.
This is intended as a clean up after the big clang-format commit
(r280751), which unfortunately resulted in many of the comment
paragraphs in LLDB being very hard to read.

FYI, the script I used was:

import textwrap
import commands
import os
import sys
import re
tmp = "%s.tmp"%sys.argv[1]
out = open(tmp, "w+")
with open(sys.argv[1], "r") as f:
  header = ""
  text = ""
  comment = re.compile(r'^( *//) ([^ ].*)$')
  special = re.compile(r'^((([A-Z]+[: ])|([0-9]+ )).*)|(.*;)$')
  for line in f:
      match = comment.match(line)
      if match and not special.match(match.group(2)):
          # skip intentionally short comments.
          if not text and len(match.group(2)) < 40:
              out.write(line)
              continue

          if text:
              text += " " + match.group(2)
          else:
              header = match.group(1)
              text = match.group(2)

          continue

      if text:
          filled = textwrap.wrap(text, width=(78-len(header)),
                                 break_long_words=False)
          for l in filled:
              out.write(header+" "+l+'\n')
              text = ""

      out.write(line)

os.rename(tmp, sys.argv[1])

Differential Revision: https://reviews.llvm.org/D46144

llvm-svn: 331197
2018-04-30 16:49:04 +00:00
..
CMakeLists.txt Fix LLVM_LINK_LLVM_DYLIB build (pr35053) 2017-10-31 13:23:19 +00:00
SBAddress.cpp Reflow paragraphs in comments. 2018-04-30 16:49:04 +00:00
SBAttachInfo.cpp *** This commit represents a complete reformatting of the LLDB source code 2016-09-06 20:57:50 +00:00
SBBlock.cpp Move Log from Core -> Utility. 2017-03-03 20:56:28 +00:00
SBBreakpoint.cpp Make breakpoint names real entities. 2017-09-14 20:22:49 +00:00
SBBreakpointLocation.cpp Cut and paste error from r23162. 2017-08-03 19:38:38 +00:00
SBBreakpointName.cpp Reflow paragraphs in comments. 2018-04-30 16:49:04 +00:00
SBBreakpointOptionCommon.cpp [SBBreakpointOptionCommon] Give this class an explicit destructor. 2017-12-07 18:06:06 +00:00
SBBreakpointOptionCommon.h [SBBreakpointOptionCommon] Give this class an explicit destructor. 2017-12-07 18:06:06 +00:00
SBBroadcaster.cpp Move Log from Core -> Utility. 2017-03-03 20:56:28 +00:00
SBCommandInterpreter.cpp Reflow paragraphs in comments. 2018-04-30 16:49:04 +00:00
SBCommandReturnObject.cpp Rename Error -> Status. 2017-05-12 04:51:55 +00:00
SBCommunication.cpp Move Connection and IOObject interfaces to Utility module 2017-06-27 10:33:14 +00:00
SBCompileUnit.cpp Move Log from Core -> Utility. 2017-03-03 20:56:28 +00:00
SBData.cpp Move DataBuffer / DataExtractor and friends from Core -> Utility. 2017-03-04 01:30:05 +00:00
SBDebugger.cpp Reflow paragraphs in comments. 2018-04-30 16:49:04 +00:00
SBDeclaration.cpp Resubmit "Delete the remainder of platform specific code in FileSpec." 2017-03-22 17:33:23 +00:00
SBError.cpp Rename Error -> Status. 2017-05-12 04:51:55 +00:00
SBEvent.cpp Reflow paragraphs in comments. 2018-04-30 16:49:04 +00:00
SBExecutionContext.cpp *** This commit represents a complete reformatting of the LLDB source code 2016-09-06 20:57:50 +00:00
SBExpressionOptions.cpp Use Timeout<> in EvaluateExpressionOptions class 2016-12-06 11:24:51 +00:00
SBFileSpec.cpp Move FileSpec from Host -> Utility. 2017-03-22 18:40:07 +00:00
SBFileSpecList.cpp Move FileSpec from Host -> Utility. 2017-03-22 18:40:07 +00:00
SBFrame.cpp Rename Error -> Status. 2017-05-12 04:51:55 +00:00
SBFunction.cpp Move Log from Core -> Utility. 2017-03-03 20:56:28 +00:00
SBHostOS.cpp Rename Error -> Status. 2017-05-12 04:51:55 +00:00
SBInstruction.cpp Reflow paragraphs in comments. 2018-04-30 16:49:04 +00:00
SBInstructionList.cpp Reflow paragraphs in comments. 2018-04-30 16:49:04 +00:00
SBLanguageRuntime.cpp Update OptionGroup::SetValue to take StringRef. 2016-09-23 17:48:13 +00:00
SBLaunchInfo.cpp Reflow paragraphs in comments. 2018-04-30 16:49:04 +00:00
SBLineEntry.cpp Resubmit "Delete the remainder of platform specific code in FileSpec." 2017-03-22 17:33:23 +00:00
SBListener.cpp Move the definition of SBListener::GetSP() to SBListener.cpp. 2017-03-29 19:32:59 +00:00
SBMemoryRegionInfo.cpp Move classes from Core -> Utility. 2017-02-02 21:39:50 +00:00
SBMemoryRegionInfoList.cpp Move Log from Core -> Utility. 2017-03-03 20:56:28 +00:00
SBModule.cpp Reflow paragraphs in comments. 2018-04-30 16:49:04 +00:00
SBModuleSpec.cpp Reflow paragraphs in comments. 2018-04-30 16:49:04 +00:00
SBPlatform.cpp Move Args.cpp from Interpreter to Utility 2018-04-17 18:53:35 +00:00
SBProcess.cpp Reflow paragraphs in comments. 2018-04-30 16:49:04 +00:00
SBProcessInfo.cpp Expose process instance info via SB API 2017-08-01 07:34:26 +00:00
SBQueue.cpp Move Log from Core -> Utility. 2017-03-03 20:56:28 +00:00
SBQueueItem.cpp Reflow paragraphs in comments. 2018-04-30 16:49:04 +00:00
SBSection.cpp Remove FileSpec::ReadFileContents. 2017-03-06 23:42:14 +00:00
SBSourceManager.cpp Move classes from Core -> Utility. 2017-02-02 21:39:50 +00:00
SBStream.cpp Reflow paragraphs in comments. 2018-04-30 16:49:04 +00:00
SBStringList.cpp Move StringList from Core -> Utility. 2017-03-21 18:25:04 +00:00
SBStructuredData.cpp Move StructuredData from Core to Utility 2017-06-27 10:45:31 +00:00
SBSymbol.cpp Move Log from Core -> Utility. 2017-03-03 20:56:28 +00:00
SBSymbolContext.cpp Move Log from Core -> Utility. 2017-03-03 20:56:28 +00:00
SBSymbolContextList.cpp *** This commit represents a complete reformatting of the LLDB source code 2016-09-06 20:57:50 +00:00
SBTarget.cpp Reflow paragraphs in comments. 2018-04-30 16:49:04 +00:00
SBThread.cpp Reflow paragraphs in comments. 2018-04-30 16:49:04 +00:00
SBThreadCollection.cpp *** This commit represents a complete reformatting of the LLDB source code 2016-09-06 20:57:50 +00:00
SBThreadPlan.cpp Reflow paragraphs in comments. 2018-04-30 16:49:04 +00:00
SBTrace.cpp Implementation of remote packets for Trace data. 2017-05-26 11:46:27 +00:00
SBTraceOptions.cpp Move Timer and TraceOptions from Core to Utility 2017-06-29 14:32:17 +00:00
SBType.cpp Reflow paragraphs in comments. 2018-04-30 16:49:04 +00:00
SBTypeCategory.cpp Reflow paragraphs in comments. 2018-04-30 16:49:04 +00:00
SBTypeEnumMember.cpp Move classes from Core -> Utility. 2017-02-02 21:39:50 +00:00
SBTypeFilter.cpp *** This commit represents a complete reformatting of the LLDB source code 2016-09-06 20:57:50 +00:00
SBTypeFormat.cpp *** This commit represents a complete reformatting of the LLDB source code 2016-09-06 20:57:50 +00:00
SBTypeNameSpecifier.cpp *** This commit represents a complete reformatting of the LLDB source code 2016-09-06 20:57:50 +00:00
SBTypeSummary.cpp *** This commit represents a complete reformatting of the LLDB source code 2016-09-06 20:57:50 +00:00
SBTypeSynthetic.cpp *** This commit represents a complete reformatting of the LLDB source code 2016-09-06 20:57:50 +00:00
SBUnixSignals.cpp Move Log from Core -> Utility. 2017-03-03 20:56:28 +00:00
SBValue.cpp Reflow paragraphs in comments. 2018-04-30 16:49:04 +00:00
SBValueList.cpp Move Log from Core -> Utility. 2017-03-03 20:56:28 +00:00
SBVariablesOptions.cpp *** This commit represents a complete reformatting of the LLDB source code 2016-09-06 20:57:50 +00:00
SBWatchpoint.cpp Move Log from Core -> Utility. 2017-03-03 20:56:28 +00:00
SystemInitializerFull.cpp Reflow paragraphs in comments. 2018-04-30 16:49:04 +00:00
liblldb-private.exports Limit LLDB_EXPORT_ALL_SYMBOLS to lldb symbols 2016-10-29 00:29:15 +00:00
liblldb.exports Fix OSX cmake build 2016-02-18 17:01:40 +00:00
liblldb.xcode.exports