3 ms·
Embedding XML inside a C-comment (as a standard) is just fucked up. Do you have correct syntax highlighting with that? (I don't. But even if emacs would unders
by jackewiehose 9y ago
Embedding XML inside a C-comment (as a standard) is just fucked up. Do you have correct syntax highlighting with that?
(I don't. But even if emacs would understand this, it's still wrong)
- MichaelGG 9y agoYeah, it's a mess. F# got it right, use triple slash to provide a summary. C# should have at least gotten that, instead of forcing so much XML all the time.
- _dcwr 9y agoC++ with Doxygen and Java with Javadoc are much saner formats for this purpose. What's even worse is that Visual Studio 2015 just vomits out that the XML is malformed when I have C++ headers with Doxygen style comments in them. It detects the three slashes and tries to apply C# XML docs parsing to them and that of course fails. Meanwhile NetBeans can handle them no problem and display parsed docs in pop ups.