Worst Phobos documentation evar!

Jacob Carlborg via Digitalmars-d digitalmars-d at puremagic.com
Wed Dec 31 07:11:27 PST 2014


On 2014-12-30 04:13, Kiith-Sa wrote:

> D blocks in DDoc are usually in:
>
> ---
> code here
> ---
>
> With a Markdown-like syntax, inline code could  be in `inline code here` .
> I admit you would need to escape the backticks, which are very rare,
> especially in inline code fragments. I also admit *that* would force you
> to not reliably use *some* D code fragments *outside* backticks. And I
> find it unlikely that there are more than 3 fragments in entire Phobos doc
> this would break.

You only need to escape backticks in inline code, not code blocks, i.e.

```
auto a = `foo`
```

The above works perfectly fine.

-- 
/Jacob Carlborg


More information about the Digitalmars-d mailing list