diff --git a/README.md b/README.md
index 5575b3c..ec6f5af 100644
--- a/README.md
+++ b/README.md
@@ -218,7 +218,7 @@
 
 ### glide rebuild
 
-Re-run `go install` on the packages in the `glide.yaml` file. This
+Runs `go install` on the packages in the `glide.yaml` file. This
 (along with `glide install` and `glide update`) pays special attention
 to the contents of the `subpackages:` directive in the YAML file.
 
@@ -234,6 +234,8 @@
 will create the `.a` files, which can have a positive impact on your
 build times.
 
+**This feature is deprecated and will be removed before Glide 1.0.0**
+
 ### glide tree
 
 Glide includes a few commands that inspect code and give you details
@@ -359,36 +361,6 @@
 `github.com/kylelemons/go-gypsy` and not
 `github.com/kylelemons/go-gypsy/yaml`.
 
-### Controlling package and subpackage builds
-
-In addition to fetching packages, Glide builds the packages with `go
-install`. The YAML file can give special instructions about how to build
-a package. Example:
-
-```yaml
-package: github.com/technosophos/glide
-import:
-  - package: github.com/kylelemons/go-gypsy
-    subpackages:
-      - yaml
-  - package: github.com/Masterminds/cookoo
-    subpackages:
-      - .
-      - cli
-      - web
-  - package: github.com/crowdmob/amz
-    subpackages:
-      - ...
-```
-
-According to the above, the following packages will be built:
-
-1. The `go-gypsy/yaml` package
-2. The `cookoo` package (`.`), along with `cookoo/web` and `cookoo/cli`
-3. Everything in `amz` (`...`)
-
-See the `docs/` folder for more examples.
-
 ## Supported Version Control Systems
 
 The Git, SVN, Mercurial (Hg), and Bzr source control systems are supported. This