this is quite dumb I’m trying to document a function that is called
and I want to document it. I write a doc string like
but when i try to do
the underscore _ signs do not appear, and k shows up in italic. How would you make the two _ appear ?
Thanks a lot,
Indent the line that bears the name of the function, such that the Markdown parser takes it as a line of code:
More recommendations about how to write the docstrings here:
Also, as a matter of style: normally function names are not written with capital letters.
Thaks, I’ll try that.
Regarding styles, beauty is in the eye of the beholder. I don’t like the Julia standards
The other option is to do:
The slash will keep the underscores from identifying as italics.
While I agree on the fact that beauty is in the eye of the beholder and also have some criticism of the Julia style guide, I yet think you are a little confused. A style guide is (almost) never created because someone is trying to impose some notion of beauty. They are created for consistency and because some conventions have value if everyone follow them and some conventions have inherent value/utility.
That’s not right. Writing
CD\_k\_CUDA(x,W) in the docstring yields:
ERROR: LoadError: syntax: invalid escape sequence
:-/ okay try two slashes:
You probably do want it to end up formatted like code, though. In places where you don’t indent by 4 spaces or have larger code blocks fenced with
```s, I’d use inline markdown backticks: