WARNING: Title underline too short

So I'm trying to build swift-2.2-SNAPSHOT-2015-12-18-a. OSX: 10.11.2 (15C50), Xcode: Version 7.2 (7C68), CMake: 3.4.1, ninja: 1.6.0

$ git show head
commit 0ddf238ad7209fed3b89c0b2300f88d9d3dfb5d0

$ ./utils/build-script -t
...snip...
FAILED: cd /Users/drew/Code/swift-devel/swift/docs && /Library/Frameworks/Python.framework/Versions/3.4/bin/sphinx-build -W -D latex_paper_size=letter -d /Users/drew/Code/swift-devel/build/Ninja-DebugAssert/swift-macosx-x86_64/doctrees -b html . /Users/drew/Code/swift-devel/build/Ninja-DebugAssert/swift-macosx-x86_64/docs/html
Running Sphinx v1.2.2
loading pickled environment... failed: [Errno 2] No such file or directory: '/Users/drew/Code/swift-devel/build/Ninja-DebugAssert/swift-macosx-x86_64/doctrees/environment.pickle'
building [html]: targets for 72 source files that are out of date
updating environment: 72 added, 0 changed, 0 removed
reading sources... [ 1%] ABI
reading sources... [ 2%] ARCOptimization
reading sources... [ 4%] AccessControl
reading sources... [ 5%] AccessControlInStdlib
reading sources... [ 6%] Arrays
reading sources... [ 8%] CallingConvention
reading sources... [ 9%] DebuggingTheCompiler
reading sources... [ 11%] Dependency Analysis
reading sources... [ 12%] DriverInternals
reading sources... [ 13%] DriverParseableOutput
reading sources... [ 15%] ErrorHandling
reading sources... [ 16%] ErrorHandlingRationale
reading sources... [ 18%] Failable Initializers
reading sources... [ 19%] Generics
reading sources... [ 20%] GitWorkflows
reading sources... [ 22%] HighLevelSILOptimizations
reading sources... [ 23%] Import
reading sources... [ 25%] IndexInvalidation
reading sources... [ 26%] LibraryEvolution
reading sources... [ 27%] Literals
reading sources... [ 29%] LogicalObjects
reading sources... [ 30%] Modules
reading sources... [ 31%] MutationModel
reading sources... [ 33%] ObjectInitialization
reading sources... [ 34%] OptimizationTips
reading sources... [ 36%] Pattern Matching
reading sources... [ 37%] SIL
reading sources... [ 38%] SequencesAndCollections
reading sources... [ 40%] Serialization
reading sources... [ 41%] StdlibAPIGuidelines
reading sources... [ 43%] StdlibRationales
reading sources... [ 44%] StoredAndComputedVariables
reading sources... [ 45%] StringDesign
reading sources... [ 47%] Testing
reading sources... [ 48%] TextFormatting
reading sources... [ 50%] TransparentAttr
reading sources... [ 51%] TypeChecker
reading sources... [ 52%] archive/LangRefNew
reading sources... [ 54%] archive/Namespace Level Vars and Top Level Code
reading sources... [ 55%] archive/Objective-C Interoperability
reading sources... [ 56%] archive/Resilience
reading sources... [ 58%] contents
reading sources... [ 59%] proposals/Accessors
reading sources... [ 61%] proposals/ArrayBridge
reading sources... [ 62%] proposals/AttrC
reading sources... [ 63%] proposals/C Pointer Argument Interop
reading sources... [ 65%] proposals/C Pointer Interop Language Model
reading sources... [ 66%] proposals/Concurrency
reading sources... [ 68%] proposals/DeclarationTypeChecker
reading sources... [ 69%] proposals/EnumStyle
reading sources... [ 70%] proposals/Enums
reading sources... [ 72%] proposals/Initialization
reading sources... [ 73%] proposals/InitializerInheritance
reading sources... [ 75%] proposals/InoutCOWOptimization
reading sources... [ 76%] proposals/Inplace
reading sources... [ 77%] proposals/ObjC Interoperation
reading sources... [ 79%] proposals/OptimizerEffects
reading sources... [ 80%] proposals/OptionSets
reading sources... [ 81%] proposals/RemoteMirrors
reading sources... [ 83%] proposals/TypeState
reading sources... [ 84%] proposals/ValueSemantics
reading sources... [ 86%] proposals/WholeModuleOptimization
reading sources... [ 87%] proposals/archive/Memory and Concurrency Model
reading sources... [ 88%] proposals/archive/ProgramStructureAndCompilationModel
reading sources... [ 90%] proposals/archive/UnifiedFunctionSyntax
reading sources... [ 91%] proposals/rejected/Bridging Container Protocols to Class Clusters
reading sources... [ 93%] proposals/rejected/ClassConstruction
reading sources... [ 94%] proposals/rejected/Clonable
reading sources... [ 95%] proposals/rejected/Constructors
reading sources... [ 97%] proposals/rejected/KeywordArguments
reading sources... [ 98%] proposals/valref
reading sources... [100%] weak

Warning, treated as error:
/Users/drew/Code/swift-devel/swift/docs/SIL.rst:1197: WARNING: Title underline too short.

Swift Calling Convention @convention(swift)

···

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[13/123] Compiling /Users/drew/Code/swift-devel/b...x-x86_64/stdlib/public/core/macosx/x86_64/Swift.o
/Users/drew/Code/swift-devel/swift/stdlib/public/core/CString.swift:63:3: warning: C-style for statement is deprecated and will be removed in a future version of Swift
  for var i = 0; i < length; ++i {
  ^ ~~~ ~~~~~~ ~~~~~
            in ..<
/Users/drew/Code/swift-devel/swift/stdlib/public/core/Character.swift:123:5: warning: C-style for statement is deprecated and will be removed in a future version of Swift
    for var i = 0; i < 8; ++i {
    ^ ~~~ ~~~~~~ ~~~~~
              in ..<
/Users/drew/Code/swift-devel/swift/stdlib/public/core/HashedCollections.swift.gyb:716:5: warning: C-style for statement is deprecated and will be removed in a future version of Swift
    for var i = lhsNative.startIndex; i != endIndex; i = i.successor() {
    ^
/Users/drew/Code/swift-devel/swift/stdlib/public/core/HashedCollections.swift.gyb:1233:5: warning: C-style for statement is deprecated and will be removed in a future version of Swift
    for var index = lhsNative.startIndex; index != endIndex;
    ^
/Users/drew/Code/swift-devel/swift/stdlib/public/core/HashedCollections.swift.gyb:2116:5: warning: C-style for statement is deprecated and will be removed in a future version of Swift
    for var i = 0; i != capacity; ++i {
    ^ ~~~ ~~~~~~~ ~~~~~
              in ..<
/Users/drew/Code/swift-devel/swift/stdlib/public/core/HashedCollections.swift.gyb:2604:5: warning: C-style for statement is deprecated and will be removed in a future version of Swift
    for var i = 0; i < nativeStorage.capacity; ++i {
    ^ ~~~ ~~~~~~ ~~~~~
              in ..<
/Users/drew/Code/swift-devel/swift/stdlib/public/core/HashedCollections.swift.gyb:3251:5: warning: C-style for statement is deprecated and will be removed in a future version of Swift
    for var b = nativeStorage._next(lastInChain);
    ^
/Users/drew/Code/swift-devel/swift/stdlib/public/core/HashedCollections.swift.gyb:3263:7: warning: C-style for statement is deprecated and will be removed in a future version of Swift
      for b = lastInChain; b != hole; b = nativeStorage._prev(b) {
      ^
/Users/drew/Code/swift-devel/swift/stdlib/public/core/HashedCollections.swift.gyb:2116:5: warning: C-style for statement is deprecated and will be removed in a future version of Swift
    for var i = 0; i != capacity; ++i {
    ^ ~~~ ~~~~~~~ ~~~~~
              in ..<
/Users/drew/Code/swift-devel/swift/stdlib/public/core/HashedCollections.swift.gyb:2604:5: warning: C-style for statement is deprecated and will be removed in a future version of Swift
    for var i = 0; i < nativeStorage.capacity; ++i {
    ^ ~~~ ~~~~~~ ~~~~~
              in ..<
/Users/drew/Code/swift-devel/swift/stdlib/public/core/HashedCollections.swift.gyb:3251:5: warning: C-style for statement is deprecated and will be removed in a future version of Swift
    for var b = nativeStorage._next(lastInChain);
    ^
/Users/drew/Code/swift-devel/swift/stdlib/public/core/HashedCollections.swift.gyb:3263:7: warning: C-style for statement is deprecated and will be removed in a future version of Swift
      for b = lastInChain; b != hole; b = nativeStorage._prev(b) {
      ^
/Users/drew/Code/swift-devel/swift/stdlib/public/core/StringCharacterView.swift:148:7: warning: C-style for statement is deprecated and will be removed in a future version of Swift
      for ; start != end; start._successorInPlace() {
      ^
/Users/drew/Code/swift-devel/swift/stdlib/public/core/Unicode.swift:708:3: warning: C-style for statement is deprecated and will be removed in a future version of Swift
  for var scalar = inputDecoder.decode(&input);
  ^
/Users/drew/Code/swift-devel/swift/stdlib/public/core/UnsafePointer.swift.gyb:213:5: warning: C-style for statement is deprecated and will be removed in a future version of Swift
    for var i = count; --i >= 0; {
    ^
/Users/drew/Code/swift-devel/swift/stdlib/public/core/Prespecialized.swift:33:9: warning: C-style for statement is deprecated and will be removed in a future version of Swift
        for var i2 = 0; i2 < a.count; ++i2 {
        ^ ~~~ ~~~~~~~ ~~~~~~
                   in ..<
/Users/drew/Code/swift-devel/swift/stdlib/public/core/Prespecialized.swift:32:7: warning: C-style for statement is deprecated and will be removed in a future version of Swift
      for var i1 = 0; i1 < a.count; ++i1 {
      ^ ~~~ ~~~~~~~ ~~~~~~
                 in ..<
ninja: build stopped: subcommand failed.
./utils/build-script: command terminated with a non-zero exit status 1, aborting

Some questions about this result:

1. Is it generally expected that snapshot tags should build on OSX? I thought it would be more likely to build than HEAD. Am I wrong? Is it preferred to build HEAD for general use?
2. Has this issue been fixed? I cannot find a reference to "WARNING: Title underline too short" (which might be the failing error? although the output continues for quite some time) on this list or on bugs.swift.org <Issues · apple/swift · GitHub, but presumably somebody has tried to build Swift at some point in the past few days
3. Is there something wrong with my config?

Sorry for asking a "hurr durr how to build" question, but I am still getting oriented with the build system and initial searching did not turn up anything relevant to the Swift project specifically.

Snapshots and HEAD should always build cleanly on all supported platforms, so we ought to fix this. It may be that our buildbots don't have sphinx installed, so the docs aren't getting checked there. Disabling sphinx in your build config should work around it in the meantime.

-Joe

···

On Dec 23, 2015, at 2:05 AM, Drew Crawford via swift-users <swift-users@swift.org> wrote:

So I'm trying to build swift-2.2-SNAPSHOT-2015-12-18-a. OSX: 10.11.2 (15C50), Xcode: Version 7.2 (7C68), CMake: 3.4.1, ninja: 1.6.0

$ git show head
commit 0ddf238ad7209fed3b89c0b2300f88d9d3dfb5d0

$ ./utils/build-script -t
...snip...
FAILED: cd /Users/drew/Code/swift-devel/swift/docs && /Library/Frameworks/Python.framework/Versions/3.4/bin/sphinx-build -W -D latex_paper_size=letter -d /Users/drew/Code/swift-devel/build/Ninja-DebugAssert/swift-macosx-x86_64/doctrees -b html . /Users/drew/Code/swift-devel/build/Ninja-DebugAssert/swift-macosx-x86_64/docs/html
Running Sphinx v1.2.2
loading pickled environment... failed: [Errno 2] No such file or directory: '/Users/drew/Code/swift-devel/build/Ninja-DebugAssert/swift-macosx-x86_64/doctrees/environment.pickle'
building [html]: targets for 72 source files that are out of date
updating environment: 72 added, 0 changed, 0 removed
reading sources... [ 1%] ABI
reading sources... [ 2%] ARCOptimization
reading sources... [ 4%] AccessControl
reading sources... [ 5%] AccessControlInStdlib
reading sources... [ 6%] Arrays
reading sources... [ 8%] CallingConvention
reading sources... [ 9%] DebuggingTheCompiler
reading sources... [ 11%] Dependency Analysis
reading sources... [ 12%] DriverInternals
reading sources... [ 13%] DriverParseableOutput
reading sources... [ 15%] ErrorHandling
reading sources... [ 16%] ErrorHandlingRationale
reading sources... [ 18%] Failable Initializers
reading sources... [ 19%] Generics
reading sources... [ 20%] GitWorkflows
reading sources... [ 22%] HighLevelSILOptimizations
reading sources... [ 23%] Import
reading sources... [ 25%] IndexInvalidation
reading sources... [ 26%] LibraryEvolution
reading sources... [ 27%] Literals
reading sources... [ 29%] LogicalObjects
reading sources... [ 30%] Modules
reading sources... [ 31%] MutationModel
reading sources... [ 33%] ObjectInitialization
reading sources... [ 34%] OptimizationTips
reading sources... [ 36%] Pattern Matching
reading sources... [ 37%] SIL
reading sources... [ 38%] SequencesAndCollections
reading sources... [ 40%] Serialization
reading sources... [ 41%] StdlibAPIGuidelines
reading sources... [ 43%] StdlibRationales
reading sources... [ 44%] StoredAndComputedVariables
reading sources... [ 45%] StringDesign
reading sources... [ 47%] Testing
reading sources... [ 48%] TextFormatting
reading sources... [ 50%] TransparentAttr
reading sources... [ 51%] TypeChecker
reading sources... [ 52%] archive/LangRefNew
reading sources... [ 54%] archive/Namespace Level Vars and Top Level Code
reading sources... [ 55%] archive/Objective-C Interoperability
reading sources... [ 56%] archive/Resilience
reading sources... [ 58%] contents
reading sources... [ 59%] proposals/Accessors
reading sources... [ 61%] proposals/ArrayBridge
reading sources... [ 62%] proposals/AttrC
reading sources... [ 63%] proposals/C Pointer Argument Interop
reading sources... [ 65%] proposals/C Pointer Interop Language Model
reading sources... [ 66%] proposals/Concurrency
reading sources... [ 68%] proposals/DeclarationTypeChecker
reading sources... [ 69%] proposals/EnumStyle
reading sources... [ 70%] proposals/Enums
reading sources... [ 72%] proposals/Initialization
reading sources... [ 73%] proposals/InitializerInheritance
reading sources... [ 75%] proposals/InoutCOWOptimization
reading sources... [ 76%] proposals/Inplace
reading sources... [ 77%] proposals/ObjC Interoperation
reading sources... [ 79%] proposals/OptimizerEffects
reading sources... [ 80%] proposals/OptionSets
reading sources... [ 81%] proposals/RemoteMirrors
reading sources... [ 83%] proposals/TypeState
reading sources... [ 84%] proposals/ValueSemantics
reading sources... [ 86%] proposals/WholeModuleOptimization
reading sources... [ 87%] proposals/archive/Memory and Concurrency Model
reading sources... [ 88%] proposals/archive/ProgramStructureAndCompilationModel
reading sources... [ 90%] proposals/archive/UnifiedFunctionSyntax
reading sources... [ 91%] proposals/rejected/Bridging Container Protocols to Class Clusters
reading sources... [ 93%] proposals/rejected/ClassConstruction
reading sources... [ 94%] proposals/rejected/Clonable
reading sources... [ 95%] proposals/rejected/Constructors
reading sources... [ 97%] proposals/rejected/KeywordArguments
reading sources... [ 98%] proposals/valref
reading sources... [100%] weak

Warning, treated as error:
/Users/drew/Code/swift-devel/swift/docs/SIL.rst:1197: WARNING: Title underline too short.

Swift Calling Convention @convention(swift)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[13/123] Compiling /Users/drew/Code/swift-devel/b...x-x86_64/stdlib/public/core/macosx/x86_64/Swift.o
/Users/drew/Code/swift-devel/swift/stdlib/public/core/CString.swift:63:3: warning: C-style for statement is deprecated and will be removed in a future version of Swift
  for var i = 0; i < length; ++i {
  ^ ~~~ ~~~~~~ ~~~~~
            in ..<
/Users/drew/Code/swift-devel/swift/stdlib/public/core/Character.swift:123:5: warning: C-style for statement is deprecated and will be removed in a future version of Swift
    for var i = 0; i < 8; ++i {
    ^ ~~~ ~~~~~~ ~~~~~
              in ..<
/Users/drew/Code/swift-devel/swift/stdlib/public/core/HashedCollections.swift.gyb:716:5: warning: C-style for statement is deprecated and will be removed in a future version of Swift
    for var i = lhsNative.startIndex; i != endIndex; i = i.successor() {
    ^
/Users/drew/Code/swift-devel/swift/stdlib/public/core/HashedCollections.swift.gyb:1233:5: warning: C-style for statement is deprecated and will be removed in a future version of Swift
    for var index = lhsNative.startIndex; index != endIndex;
    ^
/Users/drew/Code/swift-devel/swift/stdlib/public/core/HashedCollections.swift.gyb:2116:5: warning: C-style for statement is deprecated and will be removed in a future version of Swift
    for var i = 0; i != capacity; ++i {
    ^ ~~~ ~~~~~~~ ~~~~~
              in ..<
/Users/drew/Code/swift-devel/swift/stdlib/public/core/HashedCollections.swift.gyb:2604:5: warning: C-style for statement is deprecated and will be removed in a future version of Swift
    for var i = 0; i < nativeStorage.capacity; ++i {
    ^ ~~~ ~~~~~~ ~~~~~
              in ..<
/Users/drew/Code/swift-devel/swift/stdlib/public/core/HashedCollections.swift.gyb:3251:5: warning: C-style for statement is deprecated and will be removed in a future version of Swift
    for var b = nativeStorage._next(lastInChain);
    ^
/Users/drew/Code/swift-devel/swift/stdlib/public/core/HashedCollections.swift.gyb:3263:7: warning: C-style for statement is deprecated and will be removed in a future version of Swift
      for b = lastInChain; b != hole; b = nativeStorage._prev(b) {
      ^
/Users/drew/Code/swift-devel/swift/stdlib/public/core/HashedCollections.swift.gyb:2116:5: warning: C-style for statement is deprecated and will be removed in a future version of Swift
    for var i = 0; i != capacity; ++i {
    ^ ~~~ ~~~~~~~ ~~~~~
              in ..<
/Users/drew/Code/swift-devel/swift/stdlib/public/core/HashedCollections.swift.gyb:2604:5: warning: C-style for statement is deprecated and will be removed in a future version of Swift
    for var i = 0; i < nativeStorage.capacity; ++i {
    ^ ~~~ ~~~~~~ ~~~~~
              in ..<
/Users/drew/Code/swift-devel/swift/stdlib/public/core/HashedCollections.swift.gyb:3251:5: warning: C-style for statement is deprecated and will be removed in a future version of Swift
    for var b = nativeStorage._next(lastInChain);
    ^
/Users/drew/Code/swift-devel/swift/stdlib/public/core/HashedCollections.swift.gyb:3263:7: warning: C-style for statement is deprecated and will be removed in a future version of Swift
      for b = lastInChain; b != hole; b = nativeStorage._prev(b) {
      ^
/Users/drew/Code/swift-devel/swift/stdlib/public/core/StringCharacterView.swift:148:7: warning: C-style for statement is deprecated and will be removed in a future version of Swift
      for ; start != end; start._successorInPlace() {
      ^
/Users/drew/Code/swift-devel/swift/stdlib/public/core/Unicode.swift:708:3: warning: C-style for statement is deprecated and will be removed in a future version of Swift
  for var scalar = inputDecoder.decode(&input);
  ^
/Users/drew/Code/swift-devel/swift/stdlib/public/core/UnsafePointer.swift.gyb:213:5: warning: C-style for statement is deprecated and will be removed in a future version of Swift
    for var i = count; --i >= 0; {
    ^
/Users/drew/Code/swift-devel/swift/stdlib/public/core/Prespecialized.swift:33:9: warning: C-style for statement is deprecated and will be removed in a future version of Swift
        for var i2 = 0; i2 < a.count; ++i2 {
        ^ ~~~ ~~~~~~~ ~~~~~~
                   in ..<
/Users/drew/Code/swift-devel/swift/stdlib/public/core/Prespecialized.swift:32:7: warning: C-style for statement is deprecated and will be removed in a future version of Swift
      for var i1 = 0; i1 < a.count; ++i1 {
      ^ ~~~ ~~~~~~~ ~~~~~~
                 in ..<
ninja: build stopped: subcommand failed.
./utils/build-script: command terminated with a non-zero exit status 1, aborting

Some questions about this result:

1. Is it generally expected that snapshot tags should build on OSX? I thought it would be more likely to build than HEAD. Am I wrong? Is it preferred to build HEAD for general use?
2. Has this issue been fixed? I cannot find a reference to "WARNING: Title underline too short" (which might be the failing error? although the output continues for quite some time) on this list or on bugs.swift.org <Issues · apple/swift · GitHub, but presumably somebody has tried to build Swift at some point in the past few days
3. Is there something wrong with my config?

Sorry for asking a "hurr durr how to build" question, but I am still getting oriented with the build system and initial searching did not turn up anything relevant to the Swift project specifically.

_______________________________________________
swift-users mailing list
swift-users@swift.org
https://lists.swift.org/mailman/listinfo/swift-users