Officially support "local" remote state

builtin/providers/terraform/resource_state_test.go

@@ -46,7 +46,7 @@ func testAccCheckStateValue(id, name, value string) resource.TestCheckFunc {
 
 const testAccState_basic = `
 resource "terraform_remote_state" "foo" {
-	backend = "_local"
+	backend = "local"
 
 	config {
 		path = "./test-fixtures/basic.tfstate"

state/remote/remote.go

@@ -19,7 +19,7 @@ type Payload struct {
 	Data []byte
 }
 
-// Factory is the factory function to create a remote client.
+// factory is the factory function to create a remote client.
 type Factory func(map[string]string) (Client, error)
 
 // NewClient returns a new Client with the given type and configuration.
@@ -43,7 +43,5 @@ var BuiltinClients = map[string]Factory{
 	"s3":          s3Factory,
 	"swift":       swiftFactory,
 	"artifactory": artifactoryFactory,
-
-	// This is used for development purposes only.
-	"_local": fileFactory,
+	"local":       fileFactory,
 }

website/source/docs/state/remote/local.html.md

@@ -0,0 +1,36 @@
+---
+layout: "remotestate"
+page_title: "Remote State Backend: local"
+sidebar_current: "docs-state-remote-local"
+description: |-
+  Terraform can store the state locally.
+---
+
+# local
+
+This is just a placeholder
+
+## Example Usage
+
+```
+terraform remote config \
+    -backend=local \
+    -backend-config="path=/path/to/terraform.tfstate"
+```
+
+## Example Referencing
+
+```
+resource "terraform_remote_state" "foo" {
+    backend = "local"
+    config {
+        path = "${path.module}/../../terraform.tfstate"
+    }
+}
+```
+
+## Configuration variables
+
+The following configuration options are supported:
+
+ * `path` - (Required) The path to the `terraform.tfstate` file.