FR: Improve warning stacking when documenting a package without the Suggests intalled.

[olivroy]

Hello,
I was wondering if it was possible to improve the stacking of warnings when a suggested package is not installed.

For example, I am re-documenting ggplot2 using devtools::document(), and I don't have the mapproj, Hmisc, interp, multcomp, quantreg, akima.

Would it be possible to have a more legible message.

devtools::document()
There were 13 warnings (use warnings() to see them)
# currently
warnings()
Warning messages:
1: [coord-map.R:32] @param refers to unavailable topic mapproj::mapproject
Caused by error in `find.package()`:
! there is no package called ‘mapproj’
2: [coord-map.R:34] @param refers to unavailable topic mapproj::mapproject
Caused by error in `find.package()`:
! there is no package called ‘mapproj’
3: [coord-map.R:38] @param refers to unavailable topic mapproj::mapproject
Caused by error in `find.package()`:
! there is no package called ‘mapproj’
4: [fortify-multcomp.R:3] @param refers to unavailable topic multcomp::cld
Caused by error in `find.package()`:
! there is no package called ‘multcomp’
5: [geom-contour.R:3] @description refers to unavailable topic
interp::interp
Caused by error in `find.package()`:
! there is no package called ‘interp’
6: [geom-contour.R:3] @description refers to unavailable topic
akima::bilinear
Caused by error in `find.package()`:
! there is no package called ‘akima’
7: [labeller.R:325] @details refers to unavailable topic Hmisc::capitalize
Caused by error in `find.package()`:
! there is no package called ‘Hmisc’
8: [stat-quantilemethods.R:3] @param refers to unavailable topic
quantreg::rq
Caused by error in `find.package()`:
! there is no package called ‘quantreg’
9: [stat-quantilemethods.R:3] @param refers to unavailable topic
quantreg::rqss
Caused by error in `find.package()`:
! there is no package called ‘quantreg’
10: [stat-summary.R:223] @description refers to unavailable topic
Hmisc::smean.cl.boot
Caused by error in `find.package()`:
! there is no package called ‘Hmisc’
11: [stat-summary.R:223] @description refers to unavailable topic
Hmisc::smean.cl.normal
Caused by error in `find.package()`:
! there is no package called ‘Hmisc’
12: [stat-summary.R:223] @description refers to unavailable topic
Hmisc::smean.sdl
Caused by error in `find.package()`:
! there is no package called ‘Hmisc’
13: [stat-summary.R:223] @description refers to unavailable topic
Hmisc::smedian.hilow
Caused by error in `find.package()`:
! there is no package called ‘Hmisc’

For example, it could be grouped by packages and file.
If multiple missing documentations within the same line or field, it would group them instead of creating multiple warnings

devtools::document()

#  proposed output
There were 7 warnings (use warnings() to see them)

warnings()
1:  [coord-map.R:32] @param refers to unavailable topic mapproj::mapproject
    [coord-map.R:34] @param refers to unavailable topic mapproj::mapproject
    [coord-map.R:38] @param refers to unavailable topic mapproj::mapproject
# Caused by error in `find.package()`: # (this line is not necessary)
! there is no package called ‘mapproj’
2: [fortify-multcomp.R:3] @param refers to unavailable topic multcomp::cld
! there is no package called ‘multcomp’
3: [geom-contour.R:3] @description refers to unavailable topic interp::interp
! there is no package called ‘interp’
4: [geom-contour.R:3] @description refers to unavailable topic akima::bilinear
! there is no package called ‘akima’
5: [labeller.R:325] @details refers to unavailable topic Hmisc::capitalize
! there is no package called ‘Hmisc’
6: [stat-quantilemethods.R:3] @param refers to unavailable topics quantreg::rq and quantreg::rqss
! there is no package called ‘quantreg’
7: [stat-summary.R:223] @description refers to unavailable topics Hmisc::smean.cl.boot, Hmisc::smean.sdl, and Hmisc::smedian.hilow
! there is no package called ‘Hmisc’

[hadley]

It would be much easier for me if you just installed those packages 😄 But seriously, figuring out how to aggregate these warnings would be a decent amount of work, and it goes against our recommendation to just install all the suggested packages.