When I try to parse this header I get the error message Error: couldn't find 'NSFileHandle' for extension.. If I add empty declarations for all the types the parser can't find, like so:

class NSFileHandle {}

struct String {}

protocol Streamable {}
protocol OutputStreamType {}

I get the error message

events.js:72
        throw er; // Unhandled 'error' event
              ^
Error: write EPIPE
    at errnoException (net.js:904:11)
    at Object.afterWrite (net.js:720:19)

I get the following errors at the end of running nom install

npm ERR! Darwin 14.3.0
npm ERR! argv "node" "/usr/local/bin/npm" "install"
npm ERR! node v0.12.2
npm ERR! npm  v2.7.4
npm ERR! code ELIFECYCLE

npm ERR! [email protected] install: `node-gyp rebuild`
npm ERR! Exit status 1
npm ERR! 
npm ERR! Failed at the [email protected] install script 'node-gyp rebuild'.
npm ERR! This is most likely a problem with the pcre package,
npm ERR! not with npm itself.
npm ERR! Tell the author that this fails on your system:
npm ERR!     node-gyp rebuild
npm ERR! You can get their info via:
npm ERR!     npm owner ls pcre
npm ERR! There is likely additional logging output above.

npm ERR! Please include the following file with any support request:
npm ERR!     /Users/travis/Development/swiftdoc-parser/npm-debug.log

There's a ton of other messages that look iffy as well. Here's a link to my terminal output: https://www.dropbox.com/s/c3uifbsabdsrdsk/terminalOutput.txt?dl=0

Here's a link to the npm log: https://www.dropbox.com/s/5yog82jpyn3mc9h/npm-debug.log?dl=0

I upgraded node and npm but still no go. Partial capture of error message below.

make: *** [Release/obj.target/shell/execsync.o] Error 1 gyp ERR! build error gyp ERR! stack Error:make` failed with exit code: 2 gyp ERR! stack at ChildProcess.onExit (/usr/local/lib/node_modules/npm/node_modules/node-gyp/lib/build.js:276:23) gyp ERR! stack at emitTwo (events.js:106:13) gyp ERR! stack at ChildProcess.emit (events.js:192:7) gyp ERR! stack at Process.ChildProcess._handle.onexit (internal/child_process.js:215:12) gyp ERR! System Darwin 16.3.0 gyp ERR! command "/usr/local/Cellar/node/7.5.0/bin/node" "/usr/local/lib/node_modules/npm/node_modules/node-gyp/bin/node-gyp.js" "rebuild" gyp ERR! cwd /Users/jchulani/Developer/tools/swiftdoc-parser/node_modules/execsyncs gyp ERR! node -v v7.5.0 gyp ERR! node-gyp -v v3.5.0 gyp ERR! not ok npm ERR! Darwin 16.3.0 npm ERR! argv "/usr/local/Cellar/node/7.5.0/bin/node" "/usr/local/bin/npm" "install" npm ERR! node v7.5.0 npm ERR! npm v4.1.2 npm ERR! code ELIFECYCLE

npm ERR! [email protected] install: node-gyp rebuild npm ERR! Exit status 1 npm ERR! npm ERR! Failed at the [email protected] install script 'node-gyp rebuild'. npm ERR! Make sure you have the latest version of node.js and npm installed. npm ERR! If you do, this is most likely a problem with the execsyncs package, npm ERR! not with npm itself. npm ERR! Tell the author that this fails on your system: npm ERR! node-gyp rebuild npm ERR! You can get information on how to open an issue for this project with: npm ERR! npm bugs execsyncs npm ERR! Or if that isn't available, you can get their info via: npm ERR! npm owner ls execsyncs npm ERR! There is likely additional logging output above.`

http://swiftdoc.org/protocol/SinkType/

Original:

///   func f(g: (X)->Void) { ... g(a) ...}
///
/// the following generates better code::

is converted to:

| func f(g: (X)->Void) { .**g(a) ...}
 the following generates better code:**

Maybe it caused by following: https://github.com/SwiftDocOrg/swiftdoc-parser/blob/master/lib%2Fswiftdoc-builder.js#L106

                .replace(/\.\. ([^:]+)::/g, '**$1:**')       // incorrect format for inline header?

Is excluding line ending needed?

I am having difficulty having my Swift Package Manager-based Linux Swift project work with the swiftdoc-parser. We use C Modulemaps for adding support for C libraries. When I use index.js for producing the documentation, I get the following error:

module.js:340
    throw err;
          ^
Error: Cannot find module '../build/Release/pcre'
    at Function.Module._resolveFilename (module.js:338:15)
    at Function.Module._load (module.js:280:25)
    at Module.require (module.js:364:17)
    at require (module.js:380:17)
    at Object.<anonymous> (/home/rfdickerson/mil/swiftdoc-parser/node_modules/pcre/lib/pcre.js:1:74)
    at Module._compile (module.js:456:26)
    at Object.Module._extensions..js (module.js:474:10)
    at Module.load (module.js:356:32)
    at Function.Module._load (module.js:312:12)
    at Module.require (module.js:364:17)

At this point, does swiftdoc-parser work for Swift.org projects or just XCode?

Great project! The information is presented in a much nicer way than apple does with their website. Any thoughts of extending this interface to the cocoa frameworks with an emphasis on interacting with swift?

As seen in Issue #2, using opening and closing braces on one line breaks the parser:

class NSFileHandle {}
struct String {}
// etc

leads to this error:

events.js:72
     throw er; // Unhandled 'error' event
           ^
Error: write EPIPE
     at errnoException (net.js:904:11)
     at Object.afterWrite (net.js:720:19)

This comments for this declaration:

func stride<T : Strideable>(from start: T, through end: T, by stride: T.Stride) -> StrideThrough<T>

are currently:

Return the sequence of values (start, start + stride, start + stride + stride, .**last) where last is the last value in the progression less than or equal to end.

.. Note:** There is no guarantee that end is an element of the sequence.