From 766377cdafbefb0ef65b5d95605f398a117d8bee Mon Sep 17 00:00:00 2001
From: Taylor Blau <me@ttaylorr.com>
Date: Fri, 8 Jun 2018 15:56:49 -0500
Subject: [PATCH] commands/checkout: mark 'git lfs checkout' as deprecated

---
 commands/command_checkout.go     | 10 ++++++++++
 docs/man/git-lfs-checkout.1.ronn |  2 ++
 2 files changed, 12 insertions(+)

diff --git a/commands/command_checkout.go b/commands/command_checkout.go
index d26b0026..32b368d1 100644
--- a/commands/command_checkout.go
+++ b/commands/command_checkout.go
@@ -3,6 +3,7 @@ package commands
 import (
 	"fmt"
 	"os"
+	"strings"
 
 	"github.com/git-lfs/git-lfs/filepathfilter"
 	"github.com/git-lfs/git-lfs/git"
@@ -14,6 +15,15 @@ import (
 
 func checkoutCommand(cmd *cobra.Command, args []string) {
 	requireInRepo()
+
+	msg := []string{
+		"WARNING: 'git lfs checkout' is deprecated and will be removed in v3.0.0.",
+
+		"'git checkout' has been updated in upstream Git to have comparable speeds",
+		"to 'git lfs checkout'.",
+	}
+	fmt.Fprintln(os.Stderr, strings.Join(msg, "\n"))
+
 	ref, err := git.CurrentRef()
 	if err != nil {
 		Panic(err, "Could not checkout")
diff --git a/docs/man/git-lfs-checkout.1.ronn b/docs/man/git-lfs-checkout.1.ronn
index c7dd82f3..adab6a91 100644
--- a/docs/man/git-lfs-checkout.1.ronn
+++ b/docs/man/git-lfs-checkout.1.ronn
@@ -7,6 +7,8 @@ git-lfs-checkout(1) -- Update working copy with file content if available
 
 ## DESCRIPTION
 
+This command is deprecated, and should be replaced with `git checkout`.
+
 Try to ensure that the working copy contains file content for Git LFS objects
 for the current ref, if the object data is available. Does not download any
 content, see git-lfs-fetch(1) for that.