Merge branch 'defunct-vegandocs'

NAMESPACE

@@ -100,7 +100,6 @@ importFrom(graphics, abline, arrows, axis, barplot, box, contour,
 import(permute) ## vegan depends on permute: import everything
 importFrom(utils, news, vignette, combn, flush.console, modifyList,
            object.size, read.fortran, read.fwf, str)
-importFrom(tools, Rd2txt, startDynamicHelp)
 importFrom(grDevices, bmp, check.options, chull, col2rgb, dev.off,
            heat.colors, jpeg, palette, pdf, png, postscript, rainbow,
            rgb, svg, tiff, xfig, xy.coords)

NEWS.md

@@ -64,6 +64,10 @@
   **vegan3d**). _This is experimental, and we may go to direct error,
   depending on user experience: please comment!_
 
+* relic function `vegandocs` is officially defunct. Better tools to
+  read **vegan** documentation are `browseVignettes("vegan")` and
+  `news(package="vegan")`.
+
 # vegan 2.6-6.1
 
 ## Bug Fixes

R/vegandocs.R

@@ -6,13 +6,11 @@
     doc <- match.arg(doc)
     if (doc == "NEWS") {
         .Defunct('news(package="vegan")')
-        news(package = "vegan")
     } else if (doc %in% vignette(package="vegan")$results[, "Item"]) {
         .Defunct('browseVignettes("vegan")')
-        vignette(doc, package = "vegan")
     } else if (doc == "permutations") {
         .Defunct('browseVignettes("permute")')
-        vignette(doc, package = "permute")
-    } else  # last resort
-        file.show(system.file(package="vegan", doc))
+    } else { # last resort
+        .Defunct(gettextf('file.show(system.file(package="vegan", "%s"))', doc))
+    }
 }