Are there any good packages for doc comments?
As an absolute addict of documentation-driven design, the one thing I keep finding myself struggling with when coding in emacs is doc comments.
Especially python doc comments, when trying to follow the Google style guide, are very frustrating because it's almost impossible to indent them correctly by default.
Of course yasnippet does a good job at solving that with a little bit of setup. But it's a annoying if you switch between languages a lot - emacs' great strength is that it knows how to handle so many out of the box. I'd prefer not to spend 2-3 hours hacking a snippet before I can work.
There are a few language-specific packages, but they generally aren't very consistent and outdated or buggy.
Surely there must be a better way, considering many languages share doc comment styles anyway (javadoc seems to be particularly common, for example).
Posted Oct 24, 2016, 12:09 PM UTC
You could also try out org-babel. But I'm not aware of any major pieces of software that use literate programming...
I'm definitely looking for a more standard solution.
Literate programming is nice, but it's better at explaining code than at explaining interfaces, and it's not how my current projects work.