Bad parsing or ][ in block code

[zoggy]

The following code is silently parsed incorrectly by odoc:

{@json[
{
  "string": "] [",
  "string2": "][",
}
]}

The problem is with the ][ sequence, but a space between ] and [ is parsed correctly. Using ]\[ does not solve the problem, as the \[is kept in generated html.

[panglesd]

Thanks for the report!
Indeed, the addition of the {[ ...][ ...]} syntax in ocaml-doc/odoc-parser#17 broke any codeblock containing ][...

Maybe a fix would be to have this syntax available only with a delimiter? That is, {delim[ ... ]delim[ ... ]delim} is a code block with an associated output, but {[ ... ][ ... ]} would be a normal code block containing "... ][ ...".

In the meantime, for your usecase, you can use a delimiter to avoid ][ be interpreted as an end to your code block:

{delim@json[
{
  "string": "] [",
  "string2": "][",
}
]delim}

(delimiters for odoc code blocks are similar to the OCaml {delim| ... |delim} for strings)

[zoggy]

Ah, thanks !