Format roxgen comment (alternative to formatR)
2
1
Entering edit mode
ZheFrench ▴ 60
@zhefrench-11689
Last seen 11 weeks ago
France

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 • 1.4k views
ADD COMMENT
6
Entering edit mode
Mike Smith ★ 6.6k
@mike-smith
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 https://stat.ethz.ch/mailman/listinfo/bioc-devel . You'll have to register there as part of the submission too.

ADD COMMENT

Login before adding your answer.

Traffic: 695 users visited in the last hour
Help About
FAQ
Access RSS
API
Stats

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

Powered by the version 2.3.6