Format roxgen comment (alternative to formatR)
Entering edit mode
ZheFrench ▴ 40
Last seen 9 months ago

From BiocCheck :

  • NOTE: Consider shorter lines; 501 lines (14%) are > 80 characters long.

Most of these lines are roxygen comments.

formatR package says :

Also note that single lines of long comments will be wrapped into shorter ones automatically when wrap = TRUE, but roxygen comments will not be wrapped (i.e., comments that begin with #').

Don't tell me I have to do this one line per line. Please.

BiocCheck • 878 views
Entering edit mode
Mike Smith ★ 6.1k
Last seen 1 day ago
EMBL Heidelberg

In my opinion anything tagged as a "NOTE" in the output if BiocCheck is advisory. The package review process is a discussion and, while I can't speak for everyone, I would expect a reviewer to be pragmatic with something like this. If the styling is consistent and still relatively easy to read then I would not expect it to be a mandatory requirement to change line lengths. However if your lines are thousands of characters long and you rely on editor word wrapping I would expect you to be asked to change it - hopefully formatR does something sensible. I put the "indentation is not a multiple of 4 spaces" NOTE in the same category.

If you do want to format Roxygen comments and use RStudio you can press ctrl + shift + / with the cursor inside a Roxygen block and it will automatically format all the lines in the comment block to the default editor line length. This makes it pretty easy to get everything meeting the line length limit.

As an aside, package development questions are best submitted to the devel mailing list at . You'll have to register there as part of the submission too.


Login before adding your answer.

Traffic: 242 users visited in the last hour
Help About
Access RSS

Use of this site constitutes acceptance of our User Agreement and Privacy Policy.

Powered by the version 2.3.6