0.16.0: YAMLMEOW

Breaking

• The SourceKitten CocoaPods podspec used to actually refer to
  SourceKittenFramework, so it has been renamed. Existing pushes to CocoaPods
  trunk will be preserved, but from now on if you use SourceKittenFramework via
  CocoaPods, please specify to use the SourceKittenFramework pod.
  JP Simard

Enhancements

• Add Request.yaml API to create a sourcekit request from yaml
  and expose as a request --yaml [file|text] CLI command.
  Keith Smiley
  #312

Bug Fixes

• None.

0.15.3: SpeedKitten

Breaking

• None.

Enhancements

• Reduce compilation time.
  Norio Nomura

Bug Fixes

• None.

0.15.2: Furry Mammal

Breaking

• None.

Enhancements

• None.

Bug Fixes

• Fix Objective-C enum cases not being documented.
  JP Simard
  #304

0.15.1: Scottish Fold

This is a special Scottish Fold release. I had trouble finding a good release name, so I googled for cat breeds...

Look at this fella:

Anyway, small release:

Breaking

• None.

Enhancements

• Improve performance of Yaml parsing.
  JP Simard
  #289

Bug Fixes

• CXComment.commandName() was returning nil on custom code comments
  since Xcode 8.1. This caused a force unwrap when generating
  documentation. Inline command comment is now used as a
  fallback to catch this edge case.
  Jérémie Girault

0.15.0: Linux Litter

This is the first release of SourceKitten to support Linux, Swift 3 and CocoaPods! 🎉

Breaking

• SourceKitten now requires Xcode 8.0 and Swift 3.0 to build.
  APIs have been adapted to conform to the Swift 3 API Design Guidelines.
  JP Simard
  Norio Nomura

Enhancements

• Add --spm-module [ModuleName] flag to complete to automatically detect
  compiler flags for Swift Package Manager modules. swift build must be run
  prior to support detection.
  vdka
  #270
• Now builds and passes most tests on Linux using the Swift Package Manager with
  Swift 3.0. This requires libsourcekitdInProc.so to be built and located in
  /usr/lib, or in another location specified by the LINUX_SOURCEKIT_LIB_PATH
  environment variable. A preconfigured Docker image is available on Docker Hub
  by the ID of norionomura/sourcekit:30.
  JP Simard
  Norio Nomura
  #179
• Now supports Swift Package Manager on macOS and Linux.
  JP Simard
• Now supports docinfo requests for sourcetext and module keys.
  Erik Abair
• Now supports Objective-C class properties.
  Jérémie Girault
  JP Simard
  #243
• Add podspec to support using SourceKittenFramework with CocoaPods.
  JP Simard

Bug Fixes

• NSString.lines() generated surplus line when string ended with newline
  character.
  Norio Nomura
  #259

0.14.1: Ya Tu Sabes Gatito

This release is the same as 0.14.0, but with a Homebrew distribution fix.
This is the last release to support Swift 2.2 and Swift 2.3.
The next release will require Swift 3.0.

Breaking

• Embedding frameworks needed by sourcekitten was moved from
  SourceKittenFramework Xcode target to the sourcekitten target.
  The SourceKittenFramework.framework product built by the
  SourceKittenFramework target no longer contains unnecessary frameworks or
  multiple copies of the Swift libraries.
  Norio Nomura
• Require passing compiler arguments to index command.
  Brian Gesiak
• Remove --compilerargs CLI flag. Arguments are now passed after --.
  Keith Smiley

Enhancements

• Refactor to unite swift lang syntax types with SwiftLangSyntax protocol.
• Make SwiftDocKey public.
  Evgeny Suvorov
• Swift 2.3 support.
  Syo Ikeda
• The following availability and deprecation values are now exposed for Objective-C APIs.
  • key.always_deprecated
  • key.always_unavailable
  • key.deprecation_message
  • key.unavailable_message
    Jeff Verkoeyen
• Add SwiftDeclarationKind.PrecedenceGroup.
  JP Simard

Bug Fixes

• Fix issue where single-line declaration+bodies would include the body in the
  parsed declaration when generating docs.
  JP Simard
  #45
  jazzy#226
• Fix issue where directories ending with .swift would be considered Swift
  source files.
  JP Simard
  jazzy#586

0.14.0: Ya Tu Sabes Gatito

This is the last release to support Swift 2.2 and Swift 2.3.
The next release will require Swift 3.0.

Breaking

• Embedding frameworks needed by sourcekitten was moved from
  SourceKittenFramework Xcode target to the sourcekitten target.
  The SourceKittenFramework.framework product built by the
  SourceKittenFramework target no longer contains unnecessary frameworks or
  multiple copies of the Swift libraries.
  Norio Nomura
• Require passing compiler arguments to index command.
  Brian Gesiak
• Remove --compilerargs CLI flag. Arguments are now passed after --.
  Keith Smiley

Enhancements

• Refactor to unite swift lang syntax types with SwiftLangSyntax protocol.
• Make SwiftDocKey public.
  Evgeny Suvorov
• Swift 2.3 support.
  Syo Ikeda
• The following availability and deprecation values are now exposed for Objective-C APIs.
  • key.always_deprecated
  • key.always_unavailable
  • key.deprecation_message
  • key.unavailable_message
    Jeff Verkoeyen
• Add SwiftDeclarationKind.PrecedenceGroup.
  JP Simard

Bug Fixes

• Fix issue where single-line declaration+bodies would include the body in the
  parsed declaration when generating docs.
  JP Simard
  #45
  jazzy#226
• Fix issue where directories ending with .swift would be considered Swift
  source files.
  JP Simard
  jazzy#586

0.13.0: FormatKitten

Some good stuff in this release, like reformatting Swift files & generating docs for SwiftPM modules! 🎉

Breaking

• None.

Enhancements

• Add format command that re-indents a Swift file much like pasting into
  Xcode would. This command optionally takes the following parameters:
  • --file (string): relative or absolute path of Swift file to format
  • --no-trim-whitespace: trim trailing whitespace
  • --use-tabs: use tabs to indent
  • --indent-width (integer): number of spaces to indent
    JP Simard
• Add --spm-module [ModuleName] flag to doc to document Swift Package
  Manager modules. Need to run swift build prior to running
  sourcekitten doc. The right Swift toolchain version must also be selected
  (by setting TOOLCHAIN_DIR or similar).
  JP Simard
• Add support TOOLCHAINS environment variable to selecting alternative
  toolchains for loading SourceKitService.
  Norio Nomura

Bug Fixes

• Add support for handling CXCursor_UnexposedDecl declarations when
  documenting Objective-C.
  JP Simard
  realm/jazzy#543

0.12.2: IndexKitten

0.12.2

Breaking

• None.

Enhancements

• Add index command.
  JP Simard

Bug Fixes

• None.

0.12.1: Swift & ObjC in Harmony

Breaking

• None.

Enhancements

• Swift declarations are included when generating Objective-C documentation.
  JP Simard
  realm/jazzy#136

Bug Fixes

• Fixed situations where the wrong documentation comment was found for a
  declaration, or when documentation comments were further than a single line
  away from their declaration and the declaration would be incorrectly
  considered undocumented.
  JP Simard
  realm/jazzy#454
  realm/jazzy#502