diff --git a/docker/resource_docker_container.go b/docker/resource_docker_container.go
index c50aa92b..a5536cd0 100644
--- a/docker/resource_docker_container.go
+++ b/docker/resource_docker_container.go
@@ -259,11 +259,12 @@ func resourceDockerContainer() *schema.Resource {
 			},
 
 			"links": &schema.Schema{
-				Type:     schema.TypeSet,
-				Optional: true,
-				ForceNew: true,
-				Elem:     &schema.Schema{Type: schema.TypeString},
-				Set:      schema.HashString,
+				Type:       schema.TypeSet,
+				Optional:   true,
+				ForceNew:   true,
+				Elem:       &schema.Schema{Type: schema.TypeString},
+				Set:        schema.HashString,
+				Deprecated: "The --link flag is a legacy feature of Docker. It may eventually be removed.",
 			},
 
 			"ip_address": &schema.Schema{