Documentations from the standard library not included in the generated HTML docs.

[maybe-raven]

I got a struct that conforms to SequenceType, and the documentation for the method generate() is provided in the standard library. I can even view it in Xcode.

But in the HTML docs generated by jazzy, it says undocumented. Even the declaration is all wrong.

I believe this is a bug. But if it's not, please tell me how should I set the settings so that (a) it includes standard library docs and (b) makes the declaration display correctly like it does in Xcode.

[segiddins]

Can you include some more information about the code you're trying to document so we can reproduce this ?

[maybe-raven]

The code for the method I mentioned above is just like this. I didn't write any documentation or comment for it, because it's already provided in the standard library for SequenceType.

This is the declaration for generate() in the generated header file for the standard library.

By the way, I didn't set any parameter while I invoke jazzy. I just cd to my project directory and said jazzy.

[segiddins]

Ah. In that case, this is actually a feature request that's being tracked at #190.

[maybe-raven]

Then what about the wrong declaration?
The declaration for generate() should be

public func generate() –> Generator

or

public func generate() –> CircularGenerator<T>

not

public struct CircularCollection<T> : SequenceType

At least, a method declaration should start with a func keyword not a struct, right?

[segiddins]

ah yeah I missed that bit

[jpsim]

@CCDSY you seem to have found a bug where if the declaration cannot be parsed, it falls back on the parent declaration.

[jpsim]

Fixed in #441.