Documenting pub's global options.

BUG=
R=kathyw@google.com, rnystrom@google.com

Review URL: https://codereview.appspot.com/76210044