Brackets multiple lines apart can match each other

[DavisVaughan]

With the following chunk of documentation, the [ seems to be matching the ] a few lines down, resulting in garbled output

#' My docs
#'
#' @description
#' Hello `[closed, open)`.
#'
#' Hello again `(open, closed]`.
#'
#' @name interval
NULL

The generated man file:

% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/time-point.R
\name{interval}
\alias{interval}
\title{My docs}
\description{
Hello \verb{[closed, open)}.

Hello again \verb{(open, closed]}.

[closed, open)`.

Hello again `(open, closed]: R:closed,\%20open)\%60.\%0A\%0AHello\%20again\%20\%60(open,\%20closed
}

[DavisVaughan]

Possibly related to #720?

I was just able to "fix" it with:

#' My docs
#'
#' @description
#' Hello \[closed, open).
#'
#' Hello again (open, closed].
#'
#' @name interval
NULL

[gaborcsardi]

It is best to write these kind of strings in non-markdown mode. Otherwise the markdown parser with interpret the brackets.

[DavisVaughan]

How do I turn off markdown mode to just write that string?

[DavisVaughan]

Oh maybe this? It seems to work for me

#' My docs
#'
#' @description
#' Hello \code{[closed, open)}.
#'
#' Hello again \code{(open, closed]}.
#'
#' @name interval
NULL

[gaborcsardi]

Yeah, \code{} is perfect for a short piece of text, or @noMd turns it off for a chunk.

[DavisVaughan]

Thanks!