jazzy swift input

command.sh

xcrun swift-ide-test -print-comments -source-filename=sample/Musician.swift

in.swift

//
//  Musician.swift
//  JazzyApp
//

/**
 Musician models jazz musicians.
 From Ellington to Marsalis, this class has you covered.
*/
class Musician {
    /**
     The name of the musician. i.e. "John Coltrane"
    */
    var name: String

    /**
     The year the musician was born. i.e. 1926
    */
    var birthyear: UInt

    /**
     Initialize a Musician.
     Don't forget to have a name and an birthyear.

     @warning Jazz can be addicting.
     Please be careful out there.

     @param name      The name of the musician.
     @param birthyear The year the musician was born.

     @return          An initialized Musician instance.
    */
    init(name: String, birthyear: UInt) {
        self.name = name
        self.birthyear = birthyear
    }
}

out.xml

<?xml version="1.0"?>
<jazzy>
  <Class file="parser/ASTDump/Musician.swift" line="10" column="7">
    <Name>Musician</Name>
    <USR>s:C14swift_ide_test8Musician</USR>
    <Declaration>class Musician</Declaration>
    <Abstract>
      <Para>Musician models jazz musicians. From Ellington to Marsalis, this class has you covered.</Para>
    </Abstract>
  </Class>
  <Other file="parser/ASTDump/Musician.swift" line="14" column="9">
    <Name>name</Name>
    <USR>s:vC14swift_ide_test8Musician4nameSS</USR>
    <Declaration>var name: String</Declaration>
    <Abstract>
      <Para>The name of the musician. i.e. "John Coltrane"</Para>
    </Abstract>
  </Other>
  <Other file="parser/ASTDump/Musician.swift" line="19" column="9">
    <Name>birthyear</Name>
    <USR>s:vC14swift_ide_test8Musician9birthyearSu</USR>
    <Declaration>var birthyear: UInt</Declaration>
    <Abstract>
      <Para>The year the musician was born. i.e. 1926</Para>
    </Abstract>
  </Other>
  <Function file="parser/ASTDump/Musician.swift" line="33" column="5">
    <Name>init(name:birthyear:)</Name>
    <USR>s:FC14swift_ide_test8MusiciancFMS0_FT4nameSS9birthyearSu_S0_</USR>
    <Declaration>init(name: String, birthyear: UInt)</Declaration>
    <Abstract>
      <Para>Initialize a Musician. Don't forget to have a name and an birthyear.</Para>
    </Abstract>
    <Discussion>
      <Para>@warning Jazz can be addicting. Please be careful out there.</Para>
      <Para>@param name      The name of the musician. @param birthyear The year the musician was born.</Para>
      <Para>@return          An initialized Musician instance.</Para>
    </Discussion>
  </Function>
</jazzy>