Doraku / DefaultDocumentation

Create a simple markdown documentation from the Visual Studio xml one.
MIT No Attribution
160 stars 26 forks source link

0.6.13 seems to be able to get stuck in an infinite loop using inheritdoc #35

Closed Ellpeck closed 3 years ago

Ellpeck commented 3 years ago

I don't know exactly what causes this issue to occur, but it doesn't happen in 0.6.12, so I assume it's something about the inheritdoc while loop that was added in 0.6.13.

Here is a gist with an xml file that it happens with consistently, for testing purposes.

Doraku commented 3 years ago

Indeed I messed up >_> thanks for the heads up it shouldn't take long to fix.

Ellpeck commented 3 years ago

Great! Side question: Is there a way to make DefaultDocumentation put all of the information about methods, fields and properties of a class into a single file, rather than splitting it up into multiple? If there isn't, then I can open a separate issue with a suggestion if you're also interested in this behavior existing.

Doraku commented 3 years ago

Not currently, at first I intended to allow this kind of customization with #4 but as it hasn't moved at all (no epiphany on how to handle that yet) I might put some configuration to do just that. So yes, feel free to open an issue :) A refactoring of the pages generation is long overdue and it would be a nice thing to add.