Bazelrc featureset: launch.bazelrc, hover, flaginfo (#20)

Author: pcj

README.md

@@ -12,13 +12,32 @@ Bazel Support for Visual Studio Code.
 <td style="text-align: center">VSCode</td>
 </tr></table>
 
+## Features:
+
+- `bazel` and `starlark` files (`BUILD`, `.bazel`, `WORKSPACE`, `*.bzl`, `.star`, `*.sky`):
+  - syntax highlighting
+  - formatting & linting diagnostics (via `buildifier`)
+  - hover to get links to bazel documentation
+  - hover to get bazel rule & starlark function reference (via experimental Starlark Language
+    Server)
+
+- `bazelrc` files (`*.bazelrc`):
+  - syntax highlighting
+  - hover to get flag reference & links to bazel docs / bazel codesearch
+  - completion for all 834 available flags by command (includes undocumented flags).
+- `launch.bazelrc` file (a file where you can stash frequently executed commands):
+  - syntax highlighting
+  - hover over command name to get a "codelens" (click to run the command)
+  - repeat previous command for iterative development (`shift+ctrl+space`)
+  - custom problem matcher for rules_go output
+
 
 <table border-collapse="collapse" style="margin: 1rem 0">
 <tr><td style="border: 1px solid rgba(255,255,255,0.16)">
 
 ## Syntax Highlighting
 
-This extension contributes a language grammar for:
+This extension contributes language grammars for syntax highlighting of:
 
 1. **bazel** files (`WORKSPACE`, `BUILD`, `*.bazel`, `*.bzl`)
 2. plain **starlark** files (`.sky` and `.star`)
@@ -84,7 +103,7 @@ This extension contributes a HoverProvider that looks for built-in symbols in st
 
 This extension contributes a language server for bazel & starlark files.  
 
-> NOTE: currently this feature is **Disabled** by default.  To enable it, visit the extension settings and set `feature.starlark.lsp.enabled: true`.
+> NOTE: currently this feature is **Disabled** by default.  To enable it, visit the [extension settings](command://workbench.action.openSettings)) and set `feature.starlark.lsp.enabled: true`.
 
 The Starlark Language Server implements a hoverProvider for builtin starlark
 language functions (e.g. `len`, `print`, etc), builtin bazel functions (e.g.
@@ -96,6 +115,45 @@ language functions (e.g. `len`, `print`, etc), builtin bazel functions (e.g.
 </table>
 
 
+
+<table border-collapse="collapse" style="margin: 1rem 0">
+<tr><td style="border: 1px solid rgba(255,255,255,0.16)">
+
+## Bazelrc Features
+
+This extension provides the following features to assist with `*.bazelrc` files:
+
+1. A language grammar (syntax highlighting)
+2. Hover provider: hover over a flag name for documentation & links to additional support.
+3. Completion: suggestions for flag names when you type dash-dash sequence (`--`).
+
+![hover-flag](https://user-images.githubusercontent.com/50580/87987703-4c2dcb80-ca9c-11ea-95f0-430b1d8856e7.gif)
+
+</tr></tr>
+</table>
+
+
+<table border-collapse="collapse" style="margin: 1rem 0">
+<tr><td style="border: 1px solid rgba(255,255,255,0.16)">
+
+## Launch.Bazelrc Feature
+
+This extension has special support for files named `launch.bazelrc`.  A
+`launch.bazelrc` is a text file where you can store common commands & flag combinations.  It has the same 
+
+1. Be syntax highlighted
+
+2. A language grammar (syntax highlighting)
+3. Hover provider: hover over a flag name for documentation & links to additional support.
+4. Completion: suggestions for flag names when you type dash-dash sequence (`--`).
+
+![hover-flag](https://user-images.githubusercontent.com/50580/87987703-4c2dcb80-ca9c-11ea-95f0-430b1d8856e7.gif)
+
+</tr></tr>
+</table>
+
+
+
 ## Requirements
 
 Portions of this plugin may rely on the [bzl tool](https://build.bzl.io).  You