RE: About `r' and `g' in Package Menu mode

[Drew Adams]

> > I think the main difference is that `r' will download the archive
> > contents again, whereas `g' only rebuilds the tabulated list of packages
> > that have been downloaded previously.
> >
> > So use `r' to check if some archive contains updated packages, and use
> > `g' for example to revert the install/delete marks you've made in the
> > buffer.
> 
> I see.  Thanks for your explanation.

Now that you understand, maybe check the existing doc and see if you
think it makes things clear enough.  If you don't think so, consider
filing a bug report, to help others too: `M-x report-emacs-bug'.