[R] Docs for function arguments format second paragraph as code block · Issue #10329 · dmlc/xgboost (original) (raw)
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:
| \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