[R] Docs for function arguments format second paragraph as code block

[david-cortes]

In a previous PR for R documentation: #9906

The roxygen options were changed to use markdown mode in all docs.

After this change, some docs that have multiple paragraphs are incorrectly putting everything beyond the first paragraph into a code section, such as argument base_margin in xgb.DMatrix:

xgboost/R-package/man/xgb.DMatrix.Rd

Line 99 in 9def441

\if{html}{\out{<div class="sourceCode">}}\preformatted{ In the case of multi-output models, one can also pass multi-dimensional base_margin.

Changing back to non-markdown mode solves the issue (e.g. by adding @noMd), but it's unfortunately not possible to do this only for one function argument, only for a whole .Rd file, so not sure how to solve this.

The affected files can be found by searching for something like this in the man/ folder:

\if{html}{\out{<div class="sourceCode">}}\preformatted{

CC @mayer79

[mayer79]

IMHO we should continue switching to the modern style. I can dedicate more time into this, but some help would be greatly appreciated (sooo much docu...).

Formatting issues like the one you have identified can be fixed, I am pretty sure.

[trivialfis]

but some help would be greatly appreciated

Feel free to ping me if there's anything I can help.

[mayer79]

Fixed in #10733.