[SPARK-11756][SPARKR] Fix use of aliases - SparkR can not output help information for SparkR:::summary correctly

[felixcheung]

Fix use of aliases and changes uses of @Rdname and @Seealso
@aliases is the hint for ? - it should not be linked to some other name - those should be @Seealso
https://cran.r-project.org/web/packages/roxygen2/vignettes/rd.html

Clean up usage on @family, as multiple use of @family with the same @Rdname is causing duplicated See Also html blocks (like http://spark.apache.org/docs/latest/api/R/count.html)
Also changing some @Rdname for dplyr-like variant for better R user visibility in R doc, eg. rbind, summary, mutate, summarize

@shivaram @yanboliang

[SparkQA]

Test build #46034 has finished for PR 9750 at commit 474d6af.

• This patch passes all tests.
• This patch merges cleanly.
• This patch adds no public classes.

[shivaram]

cc @sun-rui

[felixcheung]

this PR is documentation only, no code change here

[felixcheung]

@yu-iskw would love to have your feedback

[felixcheung]

any more comment?

[shivaram]

@yanboliang Could you help us review this PR by trying it out and seeing if it fixes the issue ?

[yanboliang]

Sorry for late response. It can fix my issue mentioned at JIRA. But I also found new issues that the generated doc of describe will include the summary method for signature PipelineModel which may not make sense. Here I list the USAGE section of describe doc:

describe(x, col, ...)

summary(object, ...)

## S4 method for signature 'DataFrame,character'
describe(x, col, ...)

## S4 method for signature 'DataFrame,ANY'
describe(x)

## S4 method for signature 'DataFrame'
summary(object, ...)

## S4 method for signature 'PipelineModel'
summary(object, ...)

[felixcheung]

It actually is a common practice to include function for types on the same help page of the function name.
As you can see https://stat.ethz.ch/R-manual/R-devel/library/base/html/summary.html
It has summary of data.frame, matrix, factor, lm, glm, on the same page (deeper links for lm & glm)
Since they all have the same name 'summary' - shouldn't they be? Do you think they are semantically very different?

[yanboliang]

OK, got it. LGTM for me. Thanks for your PR.

[shivaram]

shouldnt we add @seealso names here ?

[felixcheung]

name is on the same doc page as column (maybe we should change @rdname to names for R friendliness)

#' @rdname columns
 #' @name names
 setMethod("names",

[shivaram]

Thanks @felixcheung -- LGTM. Had some minor inline comments about adding seealso in places where we removed aliases

[shivaram]

Merging this to master and branch-1.6