tomaz
tomaz
I agree it's not ideal, although didn't find good solution to have it work both ways and decide on case by case. This would require some syntax outside Markdown default....
It should just work (I think :), the same way as in code comments.
That's correct - it's so that you can include multiple paragraphs, lists etc. You can only end it with another `@bug` or `@warning`. So for the moment being use them...
This is definitely not a feature :)
The warning you get is likely from using brackets like this: `[object resourcePath]`. Current version doesn't handle this too well, especially when inside code blocks (where it should ignore everything...
Yes, you can post example file (or fraction if it's long one).
This is possible explanation. Unit tests were neglected for a long time...
There is some escaping implemented at this point, but it's not including all symbols. I do it case by case :) Will need to check if there's some method that...
Try increasing verbosity (`--verbose 3` - or 4-6) to get some more information about what's going on.
Did you upgrade Xcode recently? Something may have changed in docsetutil which appledoc uses behind the scenes to generate docset structure. This may also explain #546