XCode 4 (Version 4.2 Build 4C5163c) crashes while trying to open docset in the orginizer

[bubnov]

XCode backtrace:

ASSERTION FAILURE in /SourceCache/IDEDocViewer/IDEDocViewer-833/Classes/IDEDocSetNodeDocumentLocation.m:27
Details: (documentURL) should not be nil.
Object: <IDEDocSetNodeDocumentLocation: 0x20738cea0>
Method: -initWithDocumentURL:locationURL:timestamp:
Thread: <NSThread: 0x200024240>{name = (null), num = 1}
Hints: None
Backtrace:
0 0x000000010099e446 -[IDEAssertionHandler handleFailureInMethod:object:fileName:lineNumber:messageFormat:arguments:](in IDEKit)
1 0x000000010006a1c4 _DVTAssertionFailureHandler (in DVTFoundation)
2 0x000000011841a27e -[IDEDocSetNodeDocumentLocation initWithDocumentURL:locationURL:timestamp:](in IDEDocViewer)
3 0x00000001184252eb +[IDEDocSetStructureNode structureEditorOpenSpecifierForDocumentationSearchNavigableItem:error:](in IDEDocViewer)
4 0x00000001184337cc __56-[IDEDocOrganizerSource _setUpNavigatorAreaObservations]_block_invoke_0 (in IDEDocViewer)
5 0x00007fff855d936a NSKeyValueDidChange (in Foundation)
6 0x00007fff855bca9d -[NSObject(NSKeyValueObserverNotification) didChangeValueForKey:](in Foundation)
7 0x00007fff855d936a NSKeyValueDidChange (in Foundation)
8 0x00007fff855bca9d -[NSObject(NSKeyValueObserverNotification) didChangeValueForKey:](in Foundation)
9 0x00007fff8870eeda -[NSApplication sendAction:to:from:](in AppKit)
10 0x00000001001db4e0 -[DVTApplication sendAction:to:from:](in DVTKit)
11 0x00000001008acb94 -[IDEApplication sendAction:to:from:](in IDEKit)
12 0x00007fff8870ee39 -[NSControl sendAction:to:](in AppKit)
13 0x00000001008fb17f -[IDENavigatorOutlineView sendAction:to:](in IDEKit)
14 0x00007fff887152d9 -[NSTableView _sendAction:to:row:column:](in AppKit)
15 0x00007fff88711ec7 -[NSTableView mouseDown:](in AppKit)
16 0x00007fff887ae4fd -[NSOutlineView mouseDown:](in AppKit)
17 0x00000001008f9ca4 -[IDENavigatorOutlineView mouseDown:](in IDEKit)
18 0x00007fff886b33a7 -[NSWindow sendEvent:](in AppKit)
19 0x00007fff885e8afa -[NSApplication sendEvent:](in AppKit)
20 0x00000001008ac8b1 -[IDEApplication sendEvent:](in IDEKit)
21 0x00007fff8857f6de -[NSApplication run](in AppKit)
22 0x00007fff885783b0 NSApplicationMain (in AppKit)
23 0x0000000100000eec

[bubnov]

Hm, seems like there are no HTML files generated.

But 5 source files was successfully processed:
VERBOSE | Parsed 5 source files.
VERBOSE | Parsing static documents from 0 paths...
VERBOSE | Parsed 0 static document files.

[tomaz]

You can add --print-settings argument to see all used settings to verify you are creating html and docset. Also use --verbose 6 to bump up verbosity to maximum and see if there is some documentation extracted from your source files. Also make sure you're using correct comment formatting.

[bubnov]

Thx, Tomaz! It's helped!
But now I don't understand how to merge some projects documentation into single docset?
Is it possible at all?

[tomaz]

It's only possible if you do a single appledoc run over all the folders. For example: appledoc <options> ~/Path/To/Project1 ~/Path/To/Project2 ~/Path/To/Project3.

[bubnov]

Yes, I've already found this solution. Thx )
But now I have another issue: I want to separate somehow the documentation for both the projects in the docset by "package" (can't find the most precise word for this, sorry).
Is this possible?
Thanks in advance!

P.S. Also, it will be perfect if appledoc could parse C++ methods too. Because many logic placed to this functions.

[tomaz]

Packages you can only do manually with static documentation, for example you could include it on the index page as described here. As for C++ I'm not considering supporting it at the moment, but as it's similar to C functions, it might be added after implementing that functionality (see #2).

[bubnov]

Sorry, Tomaz!

I meant "C" functions, not "C++", my bad =)
So, +1 for #2 )

Thx!